Custom Agents

Install the main SpecFlow skills first. Then add the bundled worker agents only if you want them.

SpecFlow ships three supporting worker agents in agents/:

• coder — implementation worker for 301-spec-implementation, 302-test-implementation, 401-cleanup, and 402-test-correction
• execution-agent — validation worker for test, lint, and build passes
• designer — UI direction worker for 106-ui-design, 107-ui-experience, 108-ui-page-design, and UI-affecting 301-spec-implementation runs

No repo clone required

These commands download the installer script directly from GitHub and run it in one step.

Model Configuration (Important)

The worker agents are currently pre-configured for OpenCode with GitHub Copilot models. If you are not using this environment, you will need to edit the installed agent files to remove the model field, or change it to match your setup.

Recommended Models:

• coder: claude-sonnet-4.6 (requires high reasoning and coding capability)
• execution-agent: claude-haiku-4.5 (fast and cheap, just runs scripts)
• designer: gemini-3.1-pro-preview (UI and visual reasoning)

OpenCode

Global install:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path="$HOME/.config/opencode/agents"

Project-local install:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path=/path/to/project/.opencode/agents

Direct copy to a chosen directory:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path=/path/to/agents-dir

Common target directories:

• Project-local: .opencode/agents/
• User-wide: ~/.config/opencode/agents/

Claude Code

Global install:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path="$HOME/.claude/agents"

Project-local install:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path=/path/to/project/.claude/agents

Direct copy to a chosen directory:

curl -fsSL https://raw.githubusercontent.com/ajelinek/SpecFlow/main/install/install-agents.sh | sh -s -- --path=/path/to/agents-dir

Common target directories:

• Project-local: .claude/agents/
• User-wide: ~/.claude/agents/

Manual Install

If you prefer not to run the installer, download these files and place them in your target agents directory:

• coder.md
• execution-agent.md
• designer.md

Example target directories:

• OpenCode global: ~/.config/opencode/agents/
• OpenCode project-local: .opencode/agents/
• Claude Code global: ~/.claude/agents/
• Claude Code project-local: .claude/agents/

If your Claude setup does not support the model named in one of these files, replace or remove the model field after copying.

Important Split

• Use npx skills add ... for the main SpecFlow install
• Use the curl ... | sh -s -- --path=... installer only if you want the optional worker agents
• Edit copied agent files if you want different model values

These agents are installed separately, but they are the intended support structure for full 301, 302, 401, and 402 runs.