🤖 Subagentes e Git

Subagentes sao instancias do Claude Code lancadas pelo agente principal para executar tarefas isoladas.

Permite escalar trabalho sem poluir o contexto do agente principal.

Pai-filho; isolamento de contexto; delegacao.

A ferramenta interna do Claude Code que cria subagentes com prompt e contexto proprio.

E a interface primaria para orquestrar trabalho paralelo.

Task(prompt); retorno de resultado; escopo limitado.

Subagentes podem ter niveis diferentes de permissao: leitura, escrita ou background.

Escolher o tipo certo evita conflitos e reduz risco.

Principio do menor privilegio; agentes especializados.

O pai envia instrucao e contexto; o filho retorna resultado textual ao terminar.

Entender o fluxo evita perda de informacao entre agentes.

Prompt de entrada; retorno estruturado; sem estado compartilhado.

Worktrees do git permitem que cada subagente trabalhe em arquivos sem conflitar com outros.

Sem isolamento, agentes paralelos pisam uns nos outros.

git worktree; branch temporaria; merge posterior.

Subagentes tem overhead de contexto e custo. Nem toda tarefa justifica paralelismo.

Evita gastar tokens desnecessariamente em tarefas simples.

Overhead vs ganho; tarefas independentes; complexidade minima.

Disparar varias Task tools simultaneamente para tarefas independentes.

Identificar tarefas que nao dependem umas das outras para execucao simultanea.

Usar git worktree add para criar espacos de trabalho isolados por agente.

Executar tarefas longas em background enquanto o agente principal continua.

Reunir os outputs de todos os subagentes e consolidar num resultado final.

Estrategias para lidar com falha parcial: retry, skip ou abort.

Distribuir trabalho para N agentes e reunir resultados num unico ponto.

Encadear agentes onde o output de um alimenta o proximo.

Um agente explora o codebase, outro planeja, outro executa. Separacao de preocupacoes.

Agentes com prompts especificos para testes, docs, lint ou seguranca.

Patterns de retry, fallback e circuit-breaker adaptados para agentes de IA.

Limitar tokens por subagente, usar modelos menores para tarefas simples, medir ROI.

Claude analisa o diff e gera mensagens de commit no padrao conventional commits.

Claude seleciona arquivos logicamente relacionados para commits atomicos.

Pedir ao Claude para revisar o diff antes de confirmar, pegando bugs e inconsistencias.

Claude entende o contexto de ambos os lados e resolve conflitos semanticamente.

Usar branches curtas e focadas que facilitam o trabalho do agente.

Proteger segredos (.env, keys) e evitar que o agente commite arquivos sensiveis.

Claude usa gh pr create para abrir PRs com titulo, descricao e labels automaticos.

Usar Claude para revisar PRs de colegas ou do proprio agente antes do merge.

Integrar os checks do CI no workflow para que o Claude so faca merge quando verde.

Claude le comentarios de review e faz as alteracoes pedidas automaticamente.

Manter um historico linear e legivel com squash merges e rebase interativo.

PRs pequenos, focados, bem descritos e com testes passando: a receita do merge rapido.

Automacoes baseadas em eventos do GitHub: push, PR, schedule.

Usar Claude Code dentro de GitHub Actions para review, fix e deploy automatico.

Rodar test suites em cada push e bloquear merge se falhar.

Deploys automaticos apos merge: Vercel, Railway, Docker, etc.

Dependabot, CodeQL e scans de segredos integrados ao pipeline.

Notificacoes de falha, health checks e rollback automatico.