Construir por partes

O loop de cada phase

A esta altura, você já deve ter um implementation plan dividido em phases. O objetivo deste capítulo é simples: mostrar o loop que você vai repetir começando pela phase 1 e seguindo phase por phase até fechar o plano inteiro.

Não é para pegar o plano inteiro e mandar implementar tudo de uma vez, nem para escolher uma phase aleatória porque parece mais fácil. Você começa na phase 1. Quando a phase 1 terminar com validação e report, volta ao implementation plan, pega a phase 2 e repete. Depois phase 3, e assim por diante.

1. Abra o implementation plan e foque só na phase 1 ou na próxima ainda não concluída
2. Revise e refine essa phase antes de executar
3. Peça ao agente para criar a PRD dessa phase
4. Mude a ferramenta para o modo PLAN
5. Peça um plano de execução e validação baseado nessa PRD
6. Volte para o modo normal e implemente a phase
7. Teste e valide contra a PRD
8. Gere o report da phase, marque-a como concluída e siga para a próxima

1. Ler o implementation plan, revisar a phase e gerar a PRD

O primeiro passo do loop é abrir o implementation plan e pegar a phase 1. Nos ciclos seguintes, você sempre pega a próxima phase ainda não concluída. Antes de qualquer código, revise se essa phase está clara o suficiente. Se estiver vaga, grande demais ou sem critérios testáveis, ajuste antes de seguir.

Depois disso, peça ao agente para transformar essa phase em uma PRD específica. A PRD é o documento de execução da phase: o que entra, o que fica fora, como deve funcionar e como você vai validar. Quando a phase 1 estiver fechada, você repete exatamente o mesmo processo na phase 2, e assim por diante.

Quero executar a phase [PHASE_NAME] do implementation plan.

Se este for o primeiro ciclo, comece pela phase 1.
Se a phase 1 já estiver concluída, use a próxima phase ainda não concluída.

Antes de qualquer código, leia:
- PLAN.md
- README.md
- AGENTS.md ou CLAUDE.md

TAREFA
Analise a phase [PHASE_NAME] do implementation plan, refine o que estiver vago e crie uma PRD para essa phase.

Crie o arquivo:
- docs/prd/[PHASE_FILE].md

A PRD deve estar em inglês e precisa incluir:
- Goal
- Scope
- Out of scope
- User flow
- UI states
- Technical notes
- Acceptance criteria
- Manual validation
- Risks / open questions

REGRAS IMPORTANTES
- foque em uma única phase
- não invente escopo fora do implementation plan
- se a phase estiver grande demais, aponte isso antes de seguir
- não implemente nada ainda
- gere apenas o conteúdo final da PRD

2. Mudar para o modo PLAN

Com a PRD pronta, ainda não peça código. Primeiro, mude a ferramenta para o modo PLAN e peça um plano para executar e validar aquela phase atual.

Isso força o agente a pensar antes de agir: quais arquivos vai tocar, qual a sequência, quais riscos existem e como provar que a phase foi entregue. Você faz isso para a phase 1, depois repete para a phase 2, e assim até o fim do implementation plan.

Agora vou executar a phase [PHASE_NAME].

Estou seguindo o implementation plan uma phase por vez.

Leia estes arquivos:
- PLAN.md
- README.md
- AGENTS.md ou CLAUDE.md
- docs/prd/[PHASE_FILE].md

Estou colocando a ferramenta em modo PLAN.

TAREFA
Crie um plano de execução e validação para implementar essa phase.

O plano deve incluir:
- sequência de implementação
- arquivos que provavelmente serão alterados
- riscos técnicos
- como validar localmente
- critérios da PRD que precisam ser conferidos ao final

REGRAS IMPORTANTES
- não implemente ainda
- mantenha o plano pequeno e executável
- use a PRD como fonte principal para esta phase
- se a PRD estiver vaga, aponte isso antes de seguir

3. Executar, testar e validar

Só depois da PRD e do plano da phase é que entra a implementação. Nesse momento, você já tem escopo, critérios e validação mais claros, o que reduz bastante a chance de escopo inventado.

O foco continua sendo uma phase só. Não misture duas phases no mesmo ciclo. Feche a atual primeiro, depois avance.

4. Gerar o report e seguir para a próxima

Quando a phase estiver implementada e validada localmente, feche o ciclo com um report. Esse report vira memória do projeto: o que foi feito, o que mudou, como foi validado e o que ficou pendente.

Depois disso, volte para o implementation plan, marque a phase atual como concluída e abra a próxima ainda não concluída. É assim que você vai da phase 1 até a última phase sem perder clareza.

A phase [PHASE_NAME] foi implementada e validada localmente.

Depois deste report, vou marcar essa phase como concluída e seguir para a próxima phase ainda não concluída do implementation plan.

Use estes arquivos como contexto:
- PLAN.md
- README.md
- AGENTS.md ou CLAUDE.md
- docs/prd/[PHASE_FILE].md

TAREFA
Crie um arquivo:
- reports/[PHASE_SLUG]-report.md

O report deve estar em inglês e incluir:
- resumo do que foi implementado
- arquivos criados ou alterados
- decisões técnicas tomadas
- como a phase foi validada
- critérios da PRD atendidos
- problemas encontrados e como foram resolvidos
- pendências ou limitações para a próxima phase

REGRAS IMPORTANTES
- escreva de forma objetiva
- não invente resultados que não aconteceram
- se algo da PRD não foi concluído, deixe isso explícito
- gere apenas o conteúdo final do report

git add .
git commit -m "[resuma o que foi feito neste capitulo]"
git push