O GSD usa 18 agentes especializados com contextos frescos e ferramentas específicas. Entenda quem é quem, quando é invocado e o princípio de menor privilégio que governa cada um.
| Categoria | Qtd | Agentes |
|---|---|---|
| Pesquisadores | 3 | project-researcher, phase-researcher, ui-researcher |
| Analisadores | 2 | assumptions-analyzer, advisor-researcher |
| Sintetizadores | 1 | research-synthesizer |
| Planejadores | 2 | planner, roadmapper |
| Executores | 1 | executor |
| Checkers | 3 | plan-checker, integration-checker, ui-checker |
| Verificadores | 1 | verifier |
| Auditores | 2 | nyquist-auditor, ui-auditor |
| Mappers | 1 | codebase-mapper |
| Debuggers | 1 | debugger |
| Profilers | 1 | user-profiler |
Cada agente recebe apenas as ferramentas que precisa para sua função:
gsd-executor
Invocado por: /gsd:execute-phase, /gsd:quick
Contexto fresco de 200K tokens por plano. Segue XML de task com precisão, faz commit atômico por tarefa, registra desvios em SUMMARY.md. Invoca node repair em falhas de verificação.
gsd-planner
Invocado por: /gsd:plan-phase, /gsd:quick
Lê PROJECT.md, REQUIREMENTS.md, CONTEXT.md, RESEARCH.md. Cria 2-3 planos atômicos em XML com seções read_first e acceptance_criteria. Agrupa em ondas de dependência.
gsd-debugger
Invocado por: /gsd:debug, /gsd:verify-work (em falhas)
Investigação sistemática pelo método científico. Rastreia hipóteses, evidências e teorias eliminadas. Estado persiste entre resets de contexto. Requer verificação humana antes de marcar resolvido.
gsd-codebase-mapper
Invocado por: /gsd:map-codebase
4 instâncias paralelas analisam tech, arquitetura, qualidade e preocupações. Read-only + write de documentos. Usa Haiku (modelo econômico) pois é extração de padrões sem raciocínio complexo.
gsd-user-profiler
Invocado por: /gsd:profile-user
Analisa histórico de sessões do Claude Code em 8 dimensões comportamentais. Produz USER-PROFILE.md que personaliza as respostas do GSD ao seu estilo de trabalho.
Você pode injetar instruções customizadas (skills) nos agentes via agent_skills no config.json. Isso é útil para padrões de projeto específicos, convenções de equipe ou regras de aceitação.
.planning/config.json
{
"agent_skills": {
"gsd-executor": ["skills/testing-standards", "skills/api-conventions"],
"gsd-planner": ["skills/architecture-rules"],
"gsd-verifier": ["skills/acceptance-criteria"]
}
}Cada path deve ser um diretório com um arquivo SKILL.md. O GSD injeta o conteúdo como bloco <agent_skills> no prompt de spawn do agente.