简体中文 · v2.0
Agent Team — Multi-Agent Dev Team for Claude Code
A parallel multi-agent development team running inside Claude Code
Planner designs · Developers code in parallel · Reviewers check · Tester verifies · PM orchestrates
v2.0 is a breaking upgrade. Parallel architecture, three independent budgets, five-class error routing, strict YAML-frontmatter schemas, append-only event log, shared-file coordinator pattern. Migration: see MIGRATION.md.
Prerequisite: Node.js >= 18 (required for the validation scripts; first run of the plugin auto-installs npm deps).
What is this?
Agent Team is a Claude Code plugin that gives you a complete software development team inside your terminal:
| Role | Responsibility | Model |
|---|
| Project Manager (main agent) | Receives requirements, dispatches the team, maintains the event log + boulder.json view, routes errors | — |
| Planner | Analyzes requirements, defines interface/style specs + semantic_constraints, splits modules, produces round-plan.md | opus |
| Developer ×N | Implements assigned modules in parallel; private dev-{module}.md with YAML frontmatter; must paste self_check evidence | opus |
| Reviewer | Two modes: reviewer (parallel review, write report only) + committer (exclusive git add + git commit) | opus |
| Tester ×N | Runs tests in parallel; classifies bugs as A/B/C/D/E; severity auto-derived from impact × frequency matrix | sonnet |
Core mechanics (v2.0):
- Parallel execution — Developers and Testers run concurrently in the same conversation turn (Claude Code's Task tool dispatches them in parallel)
- task_id persistence — when the Tester finds a bug, the PM wakes the original Developer session via the recorded task_id; full context preserved
- Three independent budgets —
reviewer_rejection (3) / bug_fix_a (3) / bug_fix_b (2) + round_total (8). Class-B bugs no longer eat the same pool as reviewer rework.
- Append-only event log — all
boulder.json changes go through boulder-events.jsonl + rebuild-boulder.mjs; no concurrency races
- Hard schema validation — dev-log / round-plan / bug-report all validated against JSON Schema via Node.js scripts
- Shared-file coordinator — to prevent parallel write conflicts: shared files get a single
coordinator; other devs write shared_file_requests instead of editing directly
- Rollback — every round starts with
git tag round-N-baseline; on budget exhaustion, one-click git reset is offered
Quick Start
1. Install the Plugin
Inside Claude Code, register the marketplace and install:
/plugin marketplace add Wievondii/agent-team
/plugin install agent-team@wievondii-agent-team
Alternative — local install from clone:
git clone https://github.com/Wievondii/agent-team.git
Then inside Claude Code:
/plugin marketplace add /absolute/path/to/agent-team
/plugin install agent-team@wievondii-agent-team
2. Activate the Team
/agent-team:team
Then tell the PM what you need:
"Build a landing page with a hero section and contact form"
The team handles everything: plan → parallel develop → integration check → parallel review → commit → parallel test → report.
The first time you run the plugin, the PM's startup hook auto-installs the npm deps the validation scripts need (ajv, fast-glob, proper-lockfile, yaml). The init-project.mjs script also automatically copies the Agent Guard hook to your project and configures .claude/settings.json. You won't notice — it just works.
How It Works (v2.0)
