CLAUDE AGENT FLOW

Plan. Build. Review.

Agentic Workflow System within Claude Code - multi-agent pipeline that takes ideas from plan to production.

Model-matched agentsDeep reasoning where it counts, fast execution everywhere else
Enforced code qualityAdversarial critic loop catches issues before anything ships
Unattended executionHand it a plan or task ticket and walk away
Single-shot deliveryWorking, reviewed, tested, and documented code in one run

Adversarial review loops. Domain skills. One command. Claude Agent Flow orchestrates planning, building, and shipping production code using Claude Code.

agent-flow — build session
EXPLORERSpawned — mapping docs/, .claude/agents/, existing patterns…
BUILDERReceived brief: /build @plans/demo.md — starting implementation.
BUILDERWriting visualiser.html — console, flow diagram, controls…
CRITICReviewing… PASS — engine correct, layout verified.

Pipelines

Agents & Domain Skills

Explorer
Haiku

Codebase navigator. Fast, read-only mapping of files, dependencies, and patterns before any task begins.

Critic
Opus

Adversarial reviewer. Actively tries to break code with edge cases; returns FAIL with specifics or PASS when solid.

🌐 Playwright
Researcher
Sonnet

Research specialist. Finds current documentation, compares libraries, and surfaces best practices online.

⌕ WebSearch
Opus · Deep reasoning
Sonnet · Balanced
Haiku · Fast & efficient

Domain Skills — loaded by the pipeline as needed

frontend-rulesUI, CSS, client-side state
backend-rulesAPI routes, business logic, auth
storage-rulesDatabase schema & RLS policies
testing-rulesTest creation & execution
review-rulesBLOCKER / WARNING / SUGGESTION
author-rulesDocs & changelog authoring
critic-rulesAdversarial evaluation standards

What's inside — Three building blocks

Commands

Slash commands like /build, /plan, /review orchestrate the full pipeline — type one word to trigger a complete workflow

🤖

Agents

Three specialised agents (Explorer, Critic, Researcher) plus skill-backed pipeline roles — each with a focused mandate. The adversarial Critic challenges every change before it ships.

Skills

Reusable skill modules injected into agent briefs — design systems, testing frameworks, domain knowledge

Project structure

agent-team/
├── .github/
│   └── workflows/
│       ├── agent-flow-backlog-notify.yml   ← backlog notifications
│       └── agent-flow-review-pr.yml        ← AI PR review
├── .claude/
│   ├── agents/          ← 3 agents
│   ├── commands/        ← /build, /plan, /review…
│   └── skills/          ← skill modules
└── .claude-agent-flow/
    ├── hooks/           ← git & session hooks
    ├── scripts/         ← install & sync scripts
    └── tests/           ← BATS test suite

What's bundled

Tool Purpose Why it's there
Backlog.md CLI Task & backlog management Native task tracking integrated into pipeline
BATS Shell test framework Validates pipeline structure and file integrity
Playwright CLI Browser automation Visual regression and page verification
Mergiraf Merge driver Semantic merge conflict resolution
ShellCheck Shell script linter Keeps hook scripts clean
rsync File sync Plugin and skill sync operations
GNU parallel Parallel execution Speeds up test runs
Early version — under active development. Agent behaviour, commands, and pipeline steps may change as the system evolves. The site reflects the current state of the main branch.