By zakame
Surgical team collaboration skills for Claude Code, inspired by Fred Brooks' Mythical Man-Month
Introduce the Brooks Surgical Team members, survey the current project, and present a contextual briefing on which roles are most relevant and how to invoke each one
Directly spawn a Brooks Surgical Team using Claude Code Agent Teams — one independent session per role, working in parallel with a shared task list. Skips orientation and goes straight to spawning.
Dispatch when a significant feature or fix is complete and needs review against the original design intent before merging. The Copilot acts as the Surgeon's alter ego: familiar with the design goals, adversarial about correctness. Examples: <example> Context: Surgeon has completed implementation of a planned feature. user: "I've finished the authentication middleware" assistant: "Let me dispatch the Copilot to review against the original spec before we proceed." </example> <example> Context: A bug fix touched multiple files. user: "Fixed the race condition in the queue processor" assistant: "Dispatching the Copilot to verify the fix is complete and hasn't introduced regressions." </example>
Dispatch when encountering framework version differences, subtle language semantics, deprecation warnings, API behavior edge cases, or when a pattern from one context may not apply to the current language or runtime. The Language Lawyer cites the spec, not the assumption. Examples: <example> Context: Surgeon is unsure whether async behavior is consistent across runtime versions. user: "Does this Promise resolution order hold in Node 18 and 20?" assistant: "I'll dispatch the Language Lawyer to verify the spec and runtime behavior before we rely on it." </example> <example> Context: A deprecation warning appeared with an unclear migration path. user: "We're getting a deprecation warning on this API but the docs are vague" assistant: "Dispatching the Language Lawyer to research the exact version timeline and recommended migration." </example>
Dispatch when a feature is designed but test coverage needs independent development, when auditing existing test coverage adversarially, or when the Surgeon needs tests written without the author's confirmation bias. Examples: <example> Context: Surgeon has implemented a new API but wants tests written independently. user: "The payment processing module is implemented" assistant: "I'll dispatch the Tester to develop adversarial test strategy and write the test suite independently, while I continue on the next task." </example> <example> Context: A reported bug was in code with tests — coverage audit needed. user: "A bug slipped through even though we had tests for that module" assistant: "Dispatching the Tester to audit the test suite and identify what the tests were actually testing vs. what they should have been testing." </example>
Copilot CLI or OpenCode — Use at the start of any development session to introduce the Brooks Surgical Team members, survey the current project, and present a contextual briefing on which roles are most relevant and how to invoke each one
Copilot CLI fleet mode or OpenCode task tool — Spawn a Brooks Surgical Team using parallel subagents — one independent agent per role, working in parallel with a shared task list. Skips orientation and goes straight to spawning.
Use when completing any significant feature, fixing a non-trivial bug, or before merging — performs structured code review as the Surgeon's trusted alter ego who knows the full design intent
Use when writing or reviewing READMEs, API docs, specs, commit messages, or any prose that describes how the system works — ensures documentation is accurate, complete, and readable
Use when encountering framework version differences, subtle language semantics, deprecation warnings, API behavior edge cases, or when a pattern from one context may not apply to the current language or runtime
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
A skills plugin that organizes AI-assisted software development around Fred Brooks' Surgical Team model from The Mythical Man-Month (1975). Compatible with GitHub Copilot CLI, Claude Code, and OpenCode.
Instead of every team member working on all parts of a system, the Surgical Team concentrates critical work in one skilled "surgeon" (chief programmer), supported by specialized roles that keep the surgeon focused and productive. This plugin maps those roles to agent skills and dispatch templates.
This project draws from two sources:
Fred Brooks' Surgical Team (Chapter 3, The Mythical Man-Month, 1975), originally conceived by Harlan Mills: a small, highly specialized team organized around a single chief programmer who writes all critical code, supported by a copilot, tester, toolsmith, editor, administrator, language lawyer, and program clerk — each with a distinct, non-overlapping responsibility.
Superpowers by Jesse Vincent: a Claude Code skills framework that demonstrated how composable, role-aware skills can guide an AI agent through disciplined software development workflows. The structure, conventions, and plugin format of this project follow Superpowers' design closely.
The SKILL.md format used here conforms to the Agent Skills open standard, which is supported by GitHub Copilot CLI, Claude Code, and OpenCode.
| Role | Skill | Responsibility |
|---|---|---|
| Surgeon | surgeon | Chief programmer — owns all critical decisions and implementation |
| Copilot | copilot | Alter ego — reviews all of the Surgeon's work against design intent |
| Tester | tester | Adversarial quality — finds failure modes the Surgeon was too optimistic to anticipate |
| Administrator | administrator | Project tracking — manages tasks, blockers, and scope so the Surgeon doesn't have to |
| Editor | editor | Documentation — ensures everything written about the code is accurate and complete |
| Toolsmith | toolsmith | Automation — builds utilities that make the Surgeon permanently faster |
| Language Lawyer | language-lawyer | Edge cases — answers the language/framework questions where being wrong causes subtle bugs |
| Program Clerk | program-clerk | Code organization — keeps the codebase navigable, names accurate, dependencies clean |
You are always the Surgeon. The other roles are invoked as needed — either as inline guidance (the skill guides Claude to perform that role temporarily) or as dispatched subagents (for independent, parallelizable work like code review or test writing).
Register the marketplace, then install the plugin:
copilot plugin marketplace add zakame/skills-marketplace
copilot plugin install brooks-agent-team@zakame-skills-marketplace
Skills are available immediately. To update to a newer version:
copilot plugin update brooks-agent-team
To load skills directly from a local clone — useful when developing or testing changes to the skills themselves:
git clone https://github.com/zakame/brooks-agent-team /path/to/brooks-agent-team
Register the skills directory in a Copilot CLI session:
/skills add /path/to/brooks-agent-team/skills
The copilot, tester, and language-lawyer custom agents are bundled in .github/agents/. For marketplace installs, they are automatically available via /agents after copilot plugin install — no additional setup needed.
For manual installs, if the agents are not discovered automatically, copy them to ~/.copilot/agents/:
cp /path/to/brooks-agent-team/.github/agents/*.agent.md ~/.copilot/agents/
See Dispatch subagent roles for invocation examples.
OpenCode discovers skills from .opencode/skills/, .claude/skills/, and ~/.config/opencode/skills/ (global). Clone this repository to a stable location of your choice, then symlink each skill subdirectory into a discovery path:
git clone https://github.com/zakame/brooks-agent-team /path/to/brooks-agent-team
# Project-level (one-time per project):
mkdir -p .opencode/skills
ln -sf /path/to/brooks-agent-team/skills/* .opencode/skills/
# OR global (available in all projects):
mkdir -p ~/.config/opencode/skills
ln -sf /path/to/brooks-agent-team/skills/* ~/.config/opencode/skills/
To update, run git pull inside /path/to/brooks-agent-team.
OpenCode auto-discovers agent definitions from .opencode/agents/ in your project directory. To make the Copilot, Tester, and Language Lawyer subagents available:
mkdir -p .opencode/agents
cp /path/to/brooks-agent-team/.opencode/agents/*.md .opencode/agents/
npx claudepluginhub zakame/skills-marketplace --plugin brooks-agent-teamOrchestrate multi-agent teams for parallel code review, hypothesis-driven debugging, and coordinated feature development using Claude Code's Agent Teams
General-purpose agent superteam for Claude code - contract-gated verification loops with 7 outer-loop roles, 5-phase orchestration, task form-driven inner-loop cooperation, and structural prevention of premature exits.
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
AI team workflow harness for Claude Code — specialist agents, shared skills, slash commands, hooks, and staged delegation pipeline.
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development
Complete collection of battle-tested Claude Code configs from an Anthropic hackathon winner - agents, skills, hooks, and rules evolved over 10+ months of intensive daily use