O que Orquestrador de Ciclo de Desenvolvimento faz?
Orquestre o ciclo de vida completo de desenvolvimento: brainstorm → planejar → revisar → issues → implementar → revisão de código → PR.
Desambiguação: Se o usuário quiser apenas um PRD, direcione para /write-a-prd. Se quiser apenas um plano, direcione para /prd-to-plan. Esta skill é para o ciclo de vida completo.
O Pipeline de 7 Fases
Toda fase é obrigatória. Nenhuma fase pode ser pulada.
| # | Fase | Delega Para | Condição de Aprovação |
|---|---|---|---|
| 1 | Brainstorm | write-a-prd | URL da issue registrada |
| 2 | Planejar | prd-to-plan | Arquivo de plano existe em docs/plans/ |
| 3 | Revisão CEO | plan-ceo-review (recomendar MANTER ESCOPO) | Revisão concluída, usuário aprova |
| 4 | Issues | Orquestrador (fatias do plano → issues do GitHub) | Todas as URLs das issues registradas |
| 5 | Implementar | Orquestrador (tdd por issue, subagent-development) | Todas as issues resolvidas, testes passam |
| 6 | Revisão Código | daa-code-review | Revisão limpa |
| 7 | PR | commit + github-cli | URL do PR registrada |
Lógica de Reentrada
Em cada invocação:
Sem argumentos (/dev-cycle)
- Escaneie
docs/dev-cycle/por arquivos*.state.mdcomstatus: in_progress - Se um → pergunte: "Continuar {feature} (
{branch})? Atualmente em {fase}." - Se múltiplos → liste com nomes de branch, pergunte qual continuar
- Se nenhum → pergunte: "Em qual feature você está trabalhando?" → inicie Fase 1
Com argumento (/dev-cycle {slug})
- Procure por
docs/dev-cycle/{slug}.state.md - Encontrado → retome em
current_phase - Não encontrado → crie arquivo de estado, inicie Fase 1
Colisão de Slug
Ao criar um novo arquivo de estado, verifique docs/dev-cycle/ por slugs existentes. Se o slug já existir (abandonado ou concluído), adicione sufixo -2, -3, etc.
Carregamento de Contexto na Retomada
Antes de continuar, carregue TODOS os artefatos referenciados:
- Brainstorm:
gh issue viewa issue do PRD - Plano: Leia o arquivo de plano do disco
- Revisão CEO: Leia o arquivo de plano (inclui revisões)
- Issues:
gh issue viewcada issue de implementação - Implementar: Verifique status do git no branch da feature, revise issues fechadas
Apresente resumo: "Continuando {feature} na {fase}. Aqui onde paramos: ..."
Execução das Fases
Fase 1: Brainstorm
Invoque write-a-prd. Confie no fluxo interno da skill (entrevista → PRD → issue do GitHub). Registre a URL da issue no arquivo de estado.
Fase 2: Planejar
Passe a URL da issue do PRD para prd-to-plan. Registre o caminho do arquivo de plano (em docs/plans/{feature}.md).
Fase 3: Revisão CEO
Passe o caminho do arquivo de plano para plan-ceo-review. Recomende modo MANTER ESCOPO, mas deixe a seleção de modo da própria skill (Passo 0F) rodar. Registre quando a revisão estiver concluída e o usuário aprovar.
Fase 4: Issues
De propriedade do orquestrador. Leia as fatias verticais do plano. Para cada fatia, crie uma issue no GitHub usando gh issue create que:
- Referencie a issue do PRD
- Inclua critérios de aceitação do plano
- Seja criada em ordem de dependência
Registre cada URL da issue na tabela de issues imediatamente após a criação. Veja references/phase-transitions.md para recuperação de conclusão parcial.
Fase 5: Implementar
De propriedade do orquestrador. Crie branch de feature feat/{feature-slug} (veja manuseio de branch em references/phase-transitions.md).
Despache um subagente por issue do GitHub seguindo a metodologia subagent-development:
- Cada subagente invoca a skill
tdd - Revisão de código é executada entre cada despacho de subagente
- O arquivo de estado é atualizado após cada subagente concluir (não em lote)
Registre eventos por subagente:
"Subagente iniciado para issue #N: {título}""Subagente concluído para issue #N: {aprovado/reprovado}""Revisão de código após issue #N: {limpa/problemas bloqueadores encontrados}"
Fase 6: Revisão de Código
Invoque daa-code-review contra todos os arquivos alterados no branch da feature. Se problemas bloqueadores forem encontrados → corrija, execute novamente. Loop até ficar limpo.
Se problemas arquiteturais exigirem retrabalho no plano → dispare transição reversa para a Fase 2.
Fase 7: PR
Verifique conflitos com o branch padrão primeiro. Invoque commit para commit convencional, depois github-cli para abrir PR. Registre a URL do PR, defina status: completed. Então execute a etapa de arquivamento (veja Arquivamento abaixo).
Arquivo de Estado
Cada feature rastreada em docs/dev-cycle/{feature-slug}.state.md. Veja references/state-file-schema.md para formato completo, definições de campos e regras de transição.
Falha e Recuperação
Veja references/phase-transitions.md para:
- Lógica de repetição de fase (bloqueado → repita na próxima invocação)
- Transições reversas (implementar/revisão_código → planejar)
- Abandono de feature. Arquivos arquivados são movidos para
docs/archive/.
Gerenciamento de Branch
- Fases 1–4: Execute no branch atual (apenas documentação)
- Fase 5: Cria branch
feat/{feature-slug} - Fase 7: PRs para o branch padrão (detectado via
gh repo view --json defaultBranchRef) - Retomar na Fase 5+: Mude para o branch da feature se já não estiver nele
Arquivamento
Quando uma feature atinge um estado terminal (completed ou abandoned), arquive seus artefatos:
- Crie diretórios de arquivo:
mkdir -p docs/archive/dev-cycle docs/archive/plans - Mova o arquivo de estado:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - Mova o arquivo de plano: leia o caminho do plano da tabela de artefatos, então
git mv {plan_path} docs/archive/plans/ - Faça commit dos movimentos com mensagem:
chore(dev-cycle): arquivar {slug}
O arquivamento é executado automaticamente:
- No final da Fase 7 (após a URL do PR ser registrada e o status definido como
completed) - No abandono da feature (após o status ser definido como
abandoned)