Desenvolvimento Guiado por Subagentes

Execute o plano despachando um novo subagente para cada tarefa, com revisão em duas etapas após cada uma: primeiro, revisão de conformidade com a especificação, depois, revisão de qualidade do código.

Princípio central: Novo subagente por tarefa + revisão em duas etapas (especificação e depois qualidade) = alta qualidade, iteração rápida

Quando Usar

digraph when_to_use {
    "Have implementation plan?" [shape=diamond];
    "Tasks mostly independent?" [shape=diamond];
    "Stay in this session?" [shape=diamond];
    "subagent-driven-development" [shape=box];
    "executing-plans" [shape=box];
    "Manual execution or brainstorm first" [shape=box];

    "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
    "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
    "Tasks mostly independent?" -> "Stay in this session?" [label="yes"];
    "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
    "Stay in this session?" -> "subagent-driven-development" [label="yes"];
    "Stay in this session?" -> "executing-plans" [label="no - parallel session"];
}

vs. Executando Planos (sessão paralela):

• Mesma sessão (sem troca de contexto)
• Novo subagente por tarefa (sem poluição de contexto)
• Revisão em duas etapas após cada tarefa: conformidade com a especificação primeiro, depois qualidade do código
• Iteração mais rápida (sem intervenção humana entre as tarefas)

O Processo

digraph process {
    rankdir=TB;

    subgraph cluster_per_task {
        label="Por Tarefa";
        "Despachar subagente implementador (./implementer-prompt.md)" [shape=box];
        "Subagente implementador faz perguntas?" [shape=diamond];
        "Responder perguntas, fornecer contexto" [shape=box];
        "Subagente implementador implementa, testa, commita, auto-revisa" [shape=box];
        "Despachar subagente revisor de especificação (./spec-reviewer-prompt.md)" [shape=box];
        "Subagente revisor de especificação confirma que o código corresponde à especificação?" [shape=diamond];
        "Subagente implementador corrige lacunas na especificação" [shape=box];
        "Despachar subagente revisor de qualidade de código (./code-quality-reviewer-prompt.md)" [shape=box];
        "Subagente revisor de qualidade de código aprova?" [shape=diamond];
        "Subagente implementador corrige problemas de qualidade" [shape=box];
        "Marcar tarefa como concluída em TodoWrite" [shape=box];
    }

    "Ler plano, extrair todas as tarefas com texto completo, anotar contexto, criar TodoWrite" [shape=box];
    "Mais tarefas restantes?" [shape=diamond];
    "Despachar subagente revisor final de código para toda a implementação" [shape=box];
    "Usar superpoderes: finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];

    "Ler plano, extrair todas as tarefas com texto completo, anotar contexto, criar TodoWrite" -> "Despachar subagente implementador (./implementer-prompt.md)";
    "Despachar subagente implementador (./implementer-prompt.md)" -> "Subagente implementador faz perguntas?";
    "Subagente implementador faz perguntas?" -> "Responder perguntas, fornecer contexto" [label="sim"];
    "Responder perguntas, fornecer contexto" -> "Despachar subagente implementador (./implementer-prompt.md)";
    "Subagente implementador faz perguntas?" -> "Subagente implementador implementa, testa, commita, auto-revisa" [label="não"];
    "Subagente implementador implementa, testa, commita, auto-revisa" -> "Despachar subagente revisor de especificação (./spec-reviewer-prompt.md)";
    "Despachar subagente revisor de especificação (./spec-reviewer-prompt.md)" -> "Subagente revisor de especificação confirma que o código corresponde à especificação?";
    "Subagente revisor de especificação confirma que o código corresponde à especificação?" -> "Subagente implementador corrige lacunas na especificação" [label="não"];
    "Subagente implementador corrige lacunas na especificação" -> "Despachar subagente revisor de especificação (./spec-reviewer-prompt.md)" [label="re-revisar"];
    "Subagente revisor de especificação confirma que o código corresponde à especificação?" -> "Despachar subagente revisor de qualidade de código (./code-quality-reviewer-prompt.md)" [label="sim"];
    "Despachar subagente revisor de qualidade de código (./code-quality-reviewer-prompt.md)" -> "Subagente revisor de qualidade de código aprova?";
    "Subagente revisor de qualidade de código aprova?" -> "Subagente implementador corrige problemas de qualidade" [label="não"];
    "Subagente implementador corrige problemas de qualidade" -> "Despachar subagente revisor de qualidade de código (./code-quality-reviewer-prompt.md)" [label="re-revisar"];
    "Subagente revisor de qualidade de código aprova?" -> "Marcar tarefa como concluída em TodoWrite" [label="sim"];
    "Marcar tarefa como concluída em TodoWrite" -> "Mais tarefas restantes?";
    "Mais tarefas restantes?" -> "Despachar subagente implementador (./implementer-prompt.md)" [label="sim"];

…