PRD para Issues
Transforme um PRD em issues do GitHub independentes usando fatias verticais (tracer bullets).
Processo
1. Localize o PRD
Peça ao usuário o número da issue do PRD no GitHub (ou a URL).
Se o PRD ainda não estiver no seu contexto, busque-o com gh issue view <numero> (incluindo comentários).
2. Explore o código (opcional)
Se você ainda não explorou o código, faça isso para entender o estado atual do código.
3. Elabore as fatias verticais
Divida o PRD em issues tracer bullet. Cada issue é 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.
As fatias podem ser 'HITL' ou 'AFK'. Fatias HITL exigem interação humana, como uma decisão arquitetural ou uma revisão de design. Fatias AFK podem ser implementadas e mescladas sem interação humana. Prefira AFK a HITL sempre que possível.
4. Questione o usuário
Apresente a divisão proposta como uma lista numerada. Para cada fatia, mostre:
- Título: nome descritivo curto
- Tipo: HITL / AFK
- Bloqueado por: quais outras fatias (se houver) devem ser concluídas primeiro
- Histórias de usuário cobertas: quais histórias de usuário do PRD esta fatia aborda
Pergunte ao usuário:
- A granularidade parece adequada? (muito grossa / muito fina)
- As relações de dependência estão corretas?
- Alguma fatia deve ser mesclada ou dividida ainda mais?
- As fatias estão marcadas corretamente como HITL e AFK?
Itere até que o usuário aprove a divisão.
5. Crie as issues no GitHub
Para cada fatia aprovada, crie uma issue no GitHub usando gh issue create.
Use o template de corpo da issue abaixo.
Crie as issues na ordem de dependência (primeiro os bloqueadores) para que você possa referenciar números reais de issues no campo "Bloqueado por".
#
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. Referencie seções específicas do PRD pai em vez de duplicar conteúdo.
Critérios de aceitação
- Critério 1
- Critério 2
- Critério 3
Bloqueado por
- Bloqueado por # (se houver)
Ou "Nenhum - pode começar imediatamente" se não houver bloqueadores.
Histórias de usuário abordadas
Referencie pelo número do PRD pai:
- História de usuário 3
- História de usuário 7
NÃO feche ou modifique a issue do PRD pai.