Team

A Claude Code plugin that orchestrates specialized agents to autonomously implement entire features end-to-end, driven by the QRSPI workflow. The orchestrator is the main Claude Code session; it persists pipeline state as artifacts in docs/plans/ and tracks live progress with TodoWrite.

📖 Documentation: team.bostonaholic.dev

Design Philosophy

Each agent does work and returns an artifact. The orchestrator dispatches the next agent based on a phase table. Agents remain decoupled — they know nothing about each other.

Pipeline (QRSPI)

WORKTREE → QUESTION → RESEARCH → DESIGN → STRUCTURE → PLAN → IMPLEMENT → PR

• Worktree — Orchestrator prepares an isolated git worktree first and authors docs/plans/<id>/ inside it, keeping the home checkout's git status clean for the whole run.
• Question — Decompose intent into a full task record (task.md) and neutral research questions (questions.md). The questioner is the only agent that ever sees the user's original description.
• Research (isolated) — Parallel agents (file-finder + researcher) consume only questions.md. They never see the task. This structurally prevents opinion-bias in research findings.
• Design (human gate) — Design author asks open questions interactively, then drafts a ~200-line alignment doc. Humans review here.
• Structure — Break the design into vertical slices with verification checkpoints. Produced autonomously; advances to Plan with no human gate.
• Plan — Tactical implementation plan derived from the structure. Read by the implementer; not human-gated.
• Implement — Test-first (test-architect writes failing tests, mechanical gate confirms) → slice execution (implementer commits each vertical slice atomically) → adversarial verification (5 parallel reviewers + typed failure-class retry loop, max 5 rounds).
• PR — Update changelog, commit, open pull request, surface the tracking item.

Usage

/team Add rate limiting middleware to all API endpoints

For well-understood bugs, skip the QRSPI ceremony:

/team-fix Users see stale cache after profile update

Or run individual phases:

/team-worktree docs/plans/<id>/
/team-question Add rate limiting middleware to all API endpoints
/team-research docs/plans/<id>/
/team-design docs/plans/<id>/
/team-structure docs/plans/<id>/
/team-plan docs/plans/<id>/
/team-implement docs/plans/<id>/
/team-pr docs/plans/<id>/

In a full /team run the home worktree is created automatically at the leading WORKTREE phase. Invoked standalone, /team-worktree consumes plan.md (post-PLAN) — use it for manual recovery or multi-repo setup.

Each downstream command takes the artifact directory docs/plans/<id>/ as its argument.

Install

claude plugin add /path/to/team

Architecture

See docs/architecture.md for the full architecture, the artifact frontmatter schema, and the phase-inference rules.

Components

• 13 agents in agents/ — decoupled workers that read predecessor artifacts from docs/plans/ and write their outputs there
• 30 entry-point + methodology skills in skills/ — slash commands, the standalone /shipit land utility, and shared methodologies
• 4 hooks in hooks/ — safety guards and docs/plans/-aware compaction resilience
• 1 registry at skills/team/registry.json — phase-tagged inventory of the 13 agents
• State lives in docs/plans/<id>/*.md — <id> is <TICKET>-<topic> or <YYYY-MM-DD>-<topic>. Each artifact carries YAML frontmatter (topic, date, phase; gated artifacts also carry approved, approved_at, revision). Live in-session coordination uses TodoWrite.