Claude Dev Team
Multi-agent development workflow with four modes. Pick one based on the user's needs:
| Mode | When to use |
|---|---|
| plan | Need architecture/design before coding |
| dev | Have an approved plan, ready to implement |
| full | End-to-end with user approval gate between plan and dev |
| auto | End-to-end without approval gate |
Before executing any mode, read references/WORKFLOW.md for detailed step-by-step instructions, spawn prompts, and output templates.
Architecture
Plan Phase (plan/full/auto) Dev Phase (dev/full/auto)
Lead (You) Lead (You)
├── architect [teammate] ├── developer [teammate]
├── prod-mgr [teammate] ├── tester [teammate]
└── researcher [subagent] ├── reviewer [teammate]
└── researcher [subagent]
│ │
└──── plan.md (handoff) ─────────┘
Teammates message each other directly (Architect↔PM, Dev↔Tester↔Reviewer). Researcher is a subagent — Lead relays results.
Roles
Researcher (subagent — spawn via Task without team_name)
Research specialist for doc lookups. Queries Context7 for library docs, searches web for best practices, returns structured findings with code examples. Bundled as agents/researcher.md in this plugin — Context7 MCP is auto-configured via .mcp.json.
Architect (teammate — plan phase)
Designs architecture: components, interfaces, file changes, data flow, testing strategy. Debates tradeoffs with PM. Messages design to lead and PM.
Product Manager (teammate — plan phase)
Validates architecture against requirements. Challenges design with concerns. Produces verdict: APPROVED or NEEDS_REVISION with specifics.
Developer (teammate — dev phase)
Implements tasks from plan. No stubs, no TODOs. Matches existing patterns. Iterates with tester on failures, reviewer on issues.
Tester (teammate — dev phase)
Writes and runs tests matching existing patterns. Messages developer with specific failures + root cause. Max 3 fix cycles, then escalates to lead.
Reviewer (teammate — dev phase)
Reviews changed files for completeness, correctness, security, quality, plan adherence. Validates review with /council (quick quality for routine, review security or review architecture for critical concerns). Scans for stubs. Messages developer with file:line + fix suggestions. Max 3 cycles.
Rules
- One team at a time — cleanup plan-team before starting dev-team
- Teammates debate directly (Architect↔PM, Dev↔Tester, Dev↔Reviewer)
- Researcher is always a subagent — Lead relays results
- Plan.md is the single source of truth and handoff artifact
- Every task declares
depends_on; parallel within waves, sequential between - Verify build between waves
- Avoid file conflicts between parallel tasks
- Testing + review are mandatory quality gates
- Always cleanup team before finishing
- Plan mode: do NOT implement — only plan
- If stuck — ask user, don't loop