agent-teams

Coordinate multiple Claude Code sessions with shared task lists, mailbox messaging, and file-lock claiming.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill agent-teams-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-teams
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/agent-teams
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill agent-teams-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running parallel AI coding sessions on the same codebase often leads to conflicting edits, duplicated work, and no visibility into what each session is doing. This Skill provides the coordination patterns to run a lead session plus multiple teammate sessions safely on one repository. ## Core Features & Use Cases - Team Coordination: Set up a lead session that delegates to 2-5 teammate sessions sharing a task list, mailbox messaging, and file-lock claiming to prevent edit conflicts. - Task Decomposition Guidance: Break work into non-overlapping, independently verifiable tasks with declared dependencies so teammates pick up unblocked work automatically. - Plan Approval & Delegate Mode: Require teammates to submit plans for lead review before implementing, and use Shift+Tab delegate mode so the lead coordinates without editing code. - Use Case: You need to add rate limiting across middleware, Redis config, tests, and docs. Spin up two teammates, decompose into four tasks with dependencies, approve their plans, and let them implement in parallel while you review. ## Quick Start Enable the experimental flag and ask Claude to coordinate a team of sessions to implement a cross-layer feature with decomposed tasks and plan approval.

Frequently Asked Questions about agent-teams

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

FAQPage Schema
How do I run multiple Claude Code sessions on the same repo?

Set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 and start claude; the first session becomes the team lead and later sessions in the same repo join as teammates. Teammates share a task list, mailbox, and file locks, and can message each other directly.

What is the difference between agent teams and subagents?

Teammates are full Claude Code sessions with their own context windows, access to all tools, and direct peer messaging. Subagents are lightweight background workers that only report results back to a parent session.

How many teammates should an agent team have?

Three to five teammates is the productive range. Two works for a build-and-review pair, but beyond five the lead spends more time coordinating than the team saves through parallelism.

When should I use worktrees instead of agent teams?

Use worktrees for isolated feature branch work or when comparing competing approaches to the same problem. Agent teams fit parallel work on non-overlapping files and cross-layer changes spanning API, UI, and tests.

How do agent teams prevent file edit conflicts?

Teammates claim a file lock before editing and release it when the task completes. If two teammates need the same file, one waits or the lead reassigns the task.

What are common agent teams anti-patterns?

Avoid more than five teammates, tasks sharing mutable state or files, skipping plan approval, and the lead implementing code instead of coordinating. Use Shift+Tab delegate mode to keep the lead focused on review and task flow.