Getting Started

Getting Started

Run one command

npx buildcrew

The interactive setup handles everything:

  1. Installs 15 agents + orchestrator to .claude/agents/
  2. Playwright MCP β€” asks to install (required for browser testing)
  3. Project harness β€” asks to auto-generate from your codebase
  4. Template picker β€” choose additional harness files (ERD, glossary, etc.)
πŸ’‘

No separate npx buildcrew init needed. One command does it all.

Start working

@buildcrew Add user dashboard

The orchestrator reads your message, picks the right mode, and dispatches agents:

@buildcrew Add user dashboard     β†’ Feature Mode (full pipeline)
@buildcrew μ½”λ“œ κ²€μ‚¬ν•΄μ€˜            β†’ QA Audit (3 parallel subagents)
@buildcrew think: is this worth it? β†’ Think Mode (6 forcing questions)
@buildcrew architecture review     β†’ Architecture Review
@buildcrew design review           β†’ Design Review (8-dimension scoring)
@buildcrew debug: login broken     β†’ Debug Mode
@buildcrew ship                    β†’ Ship Mode

What gets installed

.claude/agents/
β”œβ”€β”€ buildcrew.md        ← orchestrator (199 lines, routes to right agent)
β”œβ”€β”€ planner.md          ← requirements + 4-lens review
β”œβ”€β”€ designer.md         ← UI/UX research + production components
β”œβ”€β”€ developer.md        ← implementation + 3-lens self-review
β”œβ”€β”€ qa-tester.md        ← code-level testing
β”œβ”€β”€ browser-qa.md       ← real browser testing via Playwright
β”œβ”€β”€ reviewer.md         ← 4-specialist code review + auto-fix
β”œβ”€β”€ health-checker.md   ← code quality 0-10 dashboard
β”œβ”€β”€ security-auditor.md ← OWASP + STRIDE audit
β”œβ”€β”€ canary-monitor.md   ← post-deploy health monitoring
β”œβ”€β”€ shipper.md          ← test β†’ version β†’ changelog β†’ PR
β”œβ”€β”€ thinker.md          ← "should we build this?" + design doc
β”œβ”€β”€ architect.md        ← architecture review (before code)
β”œβ”€β”€ design-reviewer.md  ← 8-dimension UX scoring
β”œβ”€β”€ investigator.md     ← root cause debugging
└── qa-auditor.md       ← 3 parallel subagent diff audit

Version auto-update

Agents include version headers. Run npx buildcrew again and outdated agents are automatically updated.

Requirements

Overview