agent-team-development

Orchestrates parallel Claude Code Agent Teams with worktree isolation and cherry-pick integration.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/cjthompson/claude-code-config --skill agent-team-development-cjthompson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-team-development
Source: https://github.com/cjthompson/claude-code-config/tree/main/plugins/agent-team-development/skills/agent-team-development
Command: npx skills add https://github.com/cjthompson/claude-code-config --skill agent-team-development-cjthompson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI agents on cross-cutting work risks lost commits, conflicting file edits, and premature shutdowns that destroy unintegrated work. This Skill provides an end-to-end workflow for running Claude Code Agent Teams safely, from team design through verified integration. ## Core Features & Use Cases - Team Design and Autonomy Control: Size teams of 3-5 teammates, choose Sonnet or Opus per task, and set self-organizing or lead-controlled autonomy based on task risk. - Worktree Isolation with Squash Contract: Isolate overlapping file edits in detached-HEAD git worktrees, requiring each teammate to squash work into a single commit before reporting. - Ordered Integration and Recovery: Cherry-pick commits in topological dependency order, resolve conflicts, run tests after every pick, and recover from crashed teammates or dirty worktrees. - Use Case: A feature spans frontend, backend, and database layers. Spawn three teammates in isolated worktrees, collect one commit hash per task, cherry-pick in dependency order, verify the full test suite, then shut down the team. ## Quick Start Ask the AI to coordinate this cross-cutting project with an agent team using worktree isolation and cherry-pick integration.

Frequently Asked Questions about agent-team-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple AI agents on one coding project?▼

Use Claude Code Agent Teams: create a team with TeamCreate, define tasks with blockedBy dependencies, spawn 3-5 teammates with self-contained prompts, then integrate their commits via cherry-pick in dependency order before shutting anyone down.

How do I prevent AI agents from conflicting on the same files?▼

Partition file ownership so no two teammates edit the same file. Where overlap is unavoidable, create isolated worktrees with git worktree add --detach so each agent commits independently, then cherry-pick and resolve conflicts during integration.

When should I not use agent teams for a task?▼

Skip teams when tasks are fully independent with no mid-task communication needs; a simpler orchestration strategy fits better. Teams also require the TeamCreate tool, which depends on the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS flag being enabled.

Why does shutting down agents early lose their work?▼

Teammate worktrees are cleaned up at shutdown, destroying any commits not yet cherry-picked by the leader. Always collect all commit hashes, complete integration, and pass the full test suite before sending shutdown requests.

What is the difference between self-organizing and lead-controlled autonomy?▼

Self-organizing teammates call TaskList and claim unblocked tasks themselves, suiting low-risk independent work. Lead-controlled mode has the leader assign every task via TaskUpdate and review output, which fits high-risk or architecturally sensitive tasks.