O que PRD para Plano faz?
Divida um PRD em um plano de implementação em fases usando fatias verticais (tracer bullets). A saída é um arquivo Markdown em docs/plans/.
Processo
1. Confirme que o PRD está no contexto
O PRD já deve estar na conversa. Se não estiver, peça ao usuário para colá-lo ou apontar para o arquivo.
2. Explore a base de código
Se você ainda não explorou a base de código, faça isso para entender a arquitetura atual, os padrões existentes e as camadas de integração.
3. Identifique decisões arquiteturais duradouras
Antes de fatiar, identifique decisões de alto nível que provavelmente não mudarão durante a implementação:
- Estruturas de rota / padrões de URL
- Forma do esquema do banco de dados
- Principais modelos de dados
- Abordagem de autenticação / autorização
- Limites de serviços de terceiros
Estas vão no cabeçalho do plano para que cada fase possa referenciá-las.
4. Elabore fatias verticais
Divida o PRD em fases de tracer bullet. Cada fase é uma fatia vertical fina que atravessa TODAS as camadas de integração de ponta a ponta, NÃO uma fatia horizontal de uma única camada.
5. Pergunte ao usuário
Apresente a divisão proposta como uma lista numerada. Para cada fase, mostre:
- Título: nome descritivo curto
- Histórias de usuário cobertas: quais histórias de usuário do PRD esta fase aborda
Pergunte ao usuário:
- A granularidade parece adequada? (muito grossa / muito fina)
- Alguma fase deve ser mesclada ou dividida ainda mais?
Itere até que o usuário aprove a divisão.
6. Escreva o arquivo de plano
Crie docs/plans/ se não existir. Escreva o plano como um arquivo Markdown nomeado conforme a funcionalidade (ex.: docs/plans/onboarding-de-usuario.md). Use o template abaixo.
PRD de origem:
Decisões arquiteturais
Decisões duradouras que se aplicam a todas as fases:
- Rotas: ...
- Esquema: ...
- Modelos principais: ...
- (adicione/remova seções conforme apropriado)
Fase 1: <Título>
Histórias de usuário:
O que construir
Uma descrição concisa desta fatia vertical. Descreva o comportamento de ponta a ponta, não a implementação camada por camada.
Critérios de aceitação
- Critério 1
- Critério 2
- Critério 3
Fase 2: <Título>
Histórias de usuário:
O que construir
...
Critérios de aceitação
- ...