Claude Code

This guide covers using Flow with Claude Code, Anthropic's command-line coding agent. You will learn:

• How to install the Flow harness for Claude Code
• Where Flow writes its files in a Claude Code project
• How to invoke Flow's skills

Overview

Flow installs into Claude Code natively. The harness docs index becomes a managed block in CLAUDE.md, and every Flow skill becomes a Claude Code skill under .claude/skills/.

This page covers only the Claude Code specifics. If you have not added the Flow package to your project yet, start with the Installation guide.

Installing for Claude Code

Run the harness installer and select Claude Code at the agent prompt:

node ace flow:install

Flow detects Claude Code automatically when a .claude directory or a CLAUDE.md file is present, so it is usually pre-selected. To target it directly and skip the agent prompt, pass the --agent flag:

node ace flow:install --agent=claude

Where Flow writes its files

Installing for Claude Code adds the following to your project:

• .flow/docs/ holds the harness docs. This location is the same for every agent.
• .claude/skills/ gains one directory per installed skill, each named flow-<skill>. The brief skill, for example, lands at .claude/skills/flow-brief/SKILL.md, alongside any reference files that skill ships.
• CLAUDE.md gains the managed harness block: the docs index and the project facts. Flow upserts this block between comment markers and leaves the rest of the file untouched.

The .flow/docs/ directory and the flow- skill directories are added to .gitignore, because the harness is regenerated by re-running the installer.

Invoking skills

Flow's skills are invoked as slash commands. The skill directory name is also the command name, so the skill at .claude/skills/flow-brief/ is invoked as /flow-brief:

/flow-brief checkout-redesign

Every spec-driven workflow skill follows the same /flow-<name> pattern: /flow-blueprint, /flow-assert, /flow-build, /flow-sync, /flow-archive. A skill name with a dot uses a dash in the command, so the build.tdd skill is /flow-build-tdd.

The workflow skills install with disable-model-invocation set, which means Claude will not trigger them on its own. They run only when you type the command, keeping you in control of when the workflow advances. Engineering skills such as CRUDDY controllers are an exception: Claude may invoke them automatically when it recognizes a relevant task, and you can still call them explicitly.

Next steps

• Spec-driven development explains the workflow these skills implement.
• Knowledge base describes the harness docs Claude reads from.