AGENT ORCHESTRATION
Plan. Build. Review.
A multi-agent pipeline that takes ideas from plan to production using Claude Code.
Pipelines
Agent Roster
Master coordinator. Breaks work into subtasks and delegates to specialists; never writes code itself.
Lateral thinker. Explores solution space and stress-tests approaches; output goes to the human, never directly to builders.
Research specialist. Finds current documentation, compares libraries, and surfaces best practices online.
Codebase navigator. Fast, cheap mapping of files, dependencies, and patterns before any task begins.
Design authority. Produces written design decisions and file-level plans before any implementation begins.
Data persistence specialist. Sole owner of RLS policies; covers Postgres, Supabase, S3, and local filesystem.
UI specialist. Owns React, TypeScript, Tailwind, browser APIs, accessibility, and client-side state.
Server specialist. Owns API routes, business logic, database queries, auth, and all server-side concerns.
Adversarial reviewer. Actively tries to break code with edge cases; returns FAIL with specifics or PASS when solid.
Test specialist. Writes and runs tests; never marks a task done if tests are red.
Standards checker. Read-only code review returning structured BLOCKER / WARNING / SUGGESTION findings.
Documentation specialist. Updates README, docstrings, CHANGELOG after reviewer sign-off.
.claude/ Structure
When to Use What
| Scenario | Command | Notes |
|---|---|---|
| New feature from scratch | /plan → /build | Run /plan first to generate a design plan, then hand it to /build for full pipeline execution. |
| Clear spec, just build it | /build <plan> | Passes plan directly to the full pipeline — Explorer, Architect, and builders all run in sequence. |
| Harden existing code | /review | Runs explorer → critic → adversarial loop → reviewer; no new code is written, only issues surfaced. |
| Explore options before deciding | /plan | Activates the brainstorming skill, then ideator and architect agents to produce options for human review. |
| Quick everyday task | Lite mode (auto) | Default mode — no command needed. Runs explorer → builder → reviewer automatically for routine asks. |
| Large multi-domain feature | /build (full pipeline) | Full pipeline: explorer → architect → builders → adversarial critic loop → tester → reviewer → author. |