team-composition-patterns

## Visão geral da skill team-composition-patterns
team-composition-patterns é uma skill de decisão para desenhar equipes multiagente no Claude Code Agent Teams, cobrindo heurísticas de tamanho de equipe, seleção de tipo de agente e escolhas de modo de exibição. É ideal para builders que precisam de configurações repetíveis de times para revisão, depuração ou entrega de features, em vez de prompts ad‑hoc do tipo “suba alguns agentes”.

### O que a skill team-composition-patterns ajuda você a decidir
Ela resolve três bloqueios de adoção: quantos agentes usar, qual subagent_type se encaixa em cada papel e qual modo de exibição funciona no seu ambiente (tmux, iTerm2, in‑process).

### Cenários ideais e resultados esperados
Use quando você precisa de composição consistente de equipe em tarefas como code review, investigação de bugs ou implementação de feature, e quando quer times predefinidos reutilizáveis em vez de repensar papéis toda vez.

### Diferenciais vs prompts genéricos
Ao contrário de prompts genéricos de “criar um time”, a skill codifica heurísticas de tamanho, configurações predefinidas e uma matriz de decisão para seleção de subagent_type ligada às capacidades do agente.

### Quando não é a escolha certa
Se você não usa Claude Code Agent Teams ou só precisa de um único assistente para tarefas simples, essa skill adiciona overhead sem benefício claro.

## Como usar a skill team-composition-patterns
### Instalação e ponto de entrada da skill team-composition-patterns
Instale a skill com: `npx skills add https://github.com/wshobson/agents --skill team-composition-patterns`. A orientação principal está em `plugins/agent-teams/skills/team-composition-patterns/SKILL.md`.

### Leia estes arquivos primeiro para decisões de adoção
Comece por `SKILL.md`, depois leia `references/agent-type-selection.md` para a matriz de decisão de subagent_type e `references/preset-teams.md` para equipes prontas e templates de tarefas.

### Entradas que a skill espera que você forneça
Informe o tipo de tarefa (review/debug/feature/migration), nível de complexidade, restrições (CI vs local) e se os agentes precisam de acesso de escrita. Isso mapeia diretamente para tamanho de equipe e escolhas de subagent_type.

### Transforme um objetivo vago em um prompt forte
Fraco: “spawn a team to review this PR.”  
Forte: “Review 6-file diff touching auth and caching; prioritize security and performance; local dev; need file:line findings and fixes.” Isso permite que a skill escolha um preset de revisão e as dimensões dos revisores.

### Use heurísticas de tamanho de equipe para evitar over/under-spawning
Alinhe a complexidade da tarefa ao tamanho da equipe: simples (1–2), moderada (2–3), complexa (3–4+). Times maiores ajudam quando múltiplas dimensões importam (segurança + performance + arquitetura), não apenas volume de código.

### Use a matriz de decisão de tipo de agente
Use `references/agent-type-selection.md` para escolher o subagent_type. Exemplo: code review → `agent-teams:team-reviewer`; investigação de bug → `agent-teams:team-debugger`; exploração de arquitetura sem edições → Plan ou Explore.

### Aplique primeiro as composições de equipe predefinidas
As definições de times predefinidos (review/debug) são o caminho mais rápido para valor. Elas incluem papéis, áreas de foco e templates de tarefas estruturados para que cada agente tenha uma dimensão e um formato de saída claros.

### Escolha o modo de exibição conforme o ambiente
Se você precisa de várias saídas concorrentes e consegue lidar com painéis de terminal, tmux é recomendado. Para setups mais leves, iTerm2 ou saída in‑process reduzem o atrito.

### Fluxo de trabalho sugerido para usar a skill team-composition-patterns
1) Classifique a tarefa e a complexidade.  
2) Selecione uma equipe predefinida ou uma equipe customizada com base nas dimensões.  
3) Atribua um subagent_type para cada papel.  
4) Escolha o modo de exibição para o seu ambiente.  
5) Forneça um template de tarefa estruturado para cada membro da equipe.

## FAQ da skill team-composition-patterns
### A skill team-composition-patterns serve só para Claude Code Agent Teams?
Sim. Ela foi desenhada em torno de conceitos do Agent Teams como subagent_type e modos de exibição. Sem esse ambiente, a orientação fica menos acionável.

### Como ela difere de um prompt normal de “criar um time”?
Ela entrega regras de decisão para tamanho de equipe, uma matriz para seleção de tipo de agente e equipes predefinidas com templates de tarefa — elementos que um prompt genérico normalmente não oferece.

### Isso é amigável para iniciantes?
Sim, se você seguir as equipes predefinidas. A matriz de decisão pode parecer densa, mas evita erros comuns como dar permissão de escrita a um agente de exploração.

### Quando devo evitar usar?
Evite em tarefas pontuais e de baixo risco onde um agente generalista é suficiente. O overhead de coordenação pode superar os benefícios.

### Ela suporta fluxos customizados como migrações ou auditorias?
Sim. A skill cobre explicitamente workflows não padrão; você cria uma composição de equipe customizada combinando dimensões e escolhendo os papéis de subagent_type apropriados.

## Como melhorar a skill team-composition-patterns
### Forneça dimensões de tarefa mais claras para melhorar o desenho da equipe
Especifique dimensões de review (segurança, performance, arquitetura, testes). Dimensões claras permitem que a skill mapeie papéis de revisores predefinidos e reduza sobreposição.

### Evite modos de falha comuns
Modo de falha: escolher o subagent_type errado (ex.: Plan para uma tarefa que exige edições). Corrija declarando se o agente precisa escrever arquivos e usando a matriz de decisão.

### Use contexto de entrada mais forte para melhorar os resultados
Inclua indicadores de escopo como “multi-file change”, “cross-cutting concern” ou “CI-only environment”. Isso muda o tamanho recomendado da equipe e o modo de exibição.

### Itere após a primeira sugestão de equipe
Se os resultados parecerem superficiais, adicione uma dimensão faltante (ex.: acessibilidade) ou aumente o tamanho da equipe em um. Se as respostas forem redundantes, reduza o tamanho da equipe ou estreite o escopo.

### Crie um template reutilizável para sua organização
Adapte os templates de tarefa predefinidos em `references/preset-teams.md` para as convenções do seu repo (caminhos de arquivo, formato de saída, níveis de severidade). Isso transforma o guia team-composition-patterns em um workflow interno confiável.

### Use a skill team-composition-patterns para decisões de orquestração de agentes
Ao coordenar várias tarefas concorrentes, use a skill para padronizar papéis e capacidades, garantindo a combinação certa de agentes revisores, debuggers, implementadores e líderes para cada trilha.