agent-teams

name: agent-teams description: Team composition knowledge for Claude Code Agent Teams - when to suggest teams, optimal sizing, spawn prompt patterns allowed-tools: []

Agent Teams Composition Skill

You have expertise in composing and orchestrating Claude Code Agent Teams. Use this knowledge when the user's task would benefit from parallel multi-session work.

When to Suggest Agent Teams

Proactively suggest agent teams when:

The user asks for comprehensive code review (suggest 3-reviewer team)
The task involves work across multiple layers (frontend + backend + database)
The user describes a bug with unclear root cause (suggest competing hypothesis investigation)
The user wants to evaluate multiple technologies or approaches (suggest research panel)
The task can be clearly split into independent, file-separated workstreams

Do NOT suggest agent teams when:

The task is sequential or involves same-file edits
A single session or subagent would suffice
The coordination overhead would exceed the benefit
The user is on a tight token budget

Team Templates

Full Review (3 teammates)

Security reviewer + Performance reviewer + Test coverage reviewer. Each reviews independently, then lead synthesizes findings.

Feature Dev (3 teammates)

Architect (plan approval required) + Implementer + Test writer. Architect plans first, implementer follows, test writer validates.

Debug Squad (3-5 teammates)

Each teammate investigates a different hypothesis. Adversarial debate structure -- teammates challenge each other's theories.

Cross-Platform (3 teammates)

iOS developer + Android developer + Shared architect. Each platform teammate owns their own directory. Architect coordinates API contracts.

Full-Stack (3 teammates)

Frontend + Backend + Database. Clear file ownership per layer. Coordinate on API contracts first.

Research Panel (3 teammates)

Simplicity advocate + Performance advocate + Devil's advocate. Each evaluates from a different perspective, then synthesize.

Spawn Prompt Formula

Every spawn prompt should include:

Role: "You are the [role] teammate responsible for [domain]"
Files: "You own files in [directories]. Do not modify files outside your scope."
Focus: "Specifically look for / implement [details]"
Context: "[Project-specific information the teammate needs]"
Deliverable: "Report your findings as [format] / Implement [specific output]"

Cross-Platform Awareness

macOS and Linux: full support (in-process + tmux split panes)
Windows: in-process mode only (automatic with auto setting)
Always use --teammate-mode auto (default) for automatic detection