team-composition-patterns

Design multi-agent team compositions with sizing heuristics, preset configurations, and agent type selection.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill team-composition-patterns-sanketadlak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-composition-patterns
Source: https://github.com/SanketAdlak/PDMProjectDesign/tree/main/.agents/skills/team-composition-patterns
Command: npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill team-composition-patterns-sanketadlak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deciding how many agents to spawn, which roles to assign, and which subagent_type each teammate needs is error-prone: read-only agents get assigned implementation work, teams grow too large, and review dimensions overlap. This Skill provides sizing heuristics, preset team configurations, and agent type selection rules for Claude Code's Agent Teams feature. ## Core Features & Use Cases - Team Sizing Heuristics: Match team size (1-5 agents) to task complexity, from single-dimension reviews to full-stack features. - Preset Team Compositions: Ready-made configurations for review, debug, feature, fullstack, research, security, and migration teams with defined roles and dimensions. - Agent Type Selection: Decision matrix mapping roles to subagent_type values (general-purpose, Explore, Plan, team-reviewer, team-debugger, team-implementer, team-lead) based on tool access needs. - Display Mode Configuration: Guidance for tmux, iTerm2, and in-process teammate display modes for local and CI environments. - Use Case: When planning a security audit, use the Security Team preset to spawn four reviewers covering OWASP vulnerabilities, auth/access control, dependencies, and secrets/configuration. ## Quick Start Ask the agent to design a team composition for your task, for example: "Set up a debug team with three investigators to find the root cause of this failing test."

Frequently Asked Questions about team-composition-patterns

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

FAQPage Schema
How many agents should I spawn for a task?

Match team size to complexity: 1-2 agents for simple tasks, 2-3 for moderate multi-file changes, 3-4 for complex cross-cutting work, and 4-5 for very complex full-stack features. Start with the smallest team covering all required dimensions, since each added teammate increases coordination overhead.

How do I choose the right subagent_type for a teammate?

Choose based on tool needs: use general-purpose or specialized agents (team-reviewer, team-debugger, team-implementer, team-lead) when file modification is required, and read-only agents (Explore, Plan) for research or architecture planning. Never assign implementation tasks to read-only agents.

What preset team compositions are available?

Seven presets exist: Review (3 reviewers), Debug (3 investigators), Feature (1 lead + 2 implementers), Fullstack (1 lead + 3 implementers), Research (3 general-purpose agents), Security (4 reviewers), and Migration (1 lead + 2 implementers + 1 reviewer).

Can I use agent teams in a CI environment without tmux?

Yes, set teammateMode to "in-process" in ~/.claude/settings.json so all teammates run in the same process. This mode works without tmux and suits CI/CD or scripted environments, while tmux and iTerm2 modes are better for interactive development.

Why are two reviewers flagging the same issues?

The review dimensions overlap. Redefine each reviewer's focus area, for example one on correctness and logic, one on security, and one on performance and scalability. Overlapping coverage wastes tokens and produces duplicate findings.

When should I avoid building a large agent team?

Avoid teams of 5 or more agents because coordination overhead grows significantly with each teammate. Consolidate roles so one agent covers multiple dimensions; a 3-agent team covering 2 tasks each usually outperforms a larger team on independent tasks.