Esta skill pega o contexto da conversa atual e o entendimento da base de código e produz um PRD. NÃO entreviste o usuário — apenas sintetize o que você já sabe.
O rastreador de issues e o vocabulário de etiquetas de triagem devem ter sido fornecidos a você — execute /setup-matt-pocock-skills caso contrário.
Processo
-
Explore o repositório para entender o estado atual da base de código, se ainda não o fez. Use o vocabulário do glossário de domínio do projeto em todo o PRD e respeite quaisquer ADRs na área que você está tocando.
-
Esboce os pontos de teste (seams) nos quais você vai testar a funcionalidade. Pontos de teste existentes devem ser preferidos a novos. Use o ponto de teste mais alto possível. Se novos pontos forem necessários, proponha-os no ponto mais alto que puder. Quanto menos pontos de teste houver na base de código, melhor — o número ideal é um.
Verifique com o usuário se esses pontos de teste correspondem às expectativas dele.
- Escreva o PRD usando o template abaixo e publique-o no rastreador de issues do projeto. Aplique a etiqueta de triagem
ready-for-agent— não é necessária triagem adicional.
Declaração do Problema
O problema que o usuário está enfrentando, da perspectiva do usuário.
Solução
A solução para o problema, da perspectiva do usuário.
Histórias de Usuário
Uma lista LONGA e numerada de histórias de usuário. Cada história de usuário deve estar no formato:
- Como um , quero um , para que <benefício>
<exemplo-de-história-de-usuário>
- Como um cliente de banco móvel, quero ver o saldo das minhas contas, para que possa tomar decisões melhor informadas sobre meus gastos </exemplo-de-história-de-usuário>
Esta lista de histórias de usuário deve ser extremamente extensa e cobrir todos os aspectos da funcionalidade.
Decisões de Implementação
Uma lista de decisões de implementação que foram tomadas. Isso pode incluir:
- Os módulos que serão construídos/modificados
- As interfaces desses módulos que serão modificadas
- Esclarecimentos técnicos do desenvolvedor
- Decisões arquiteturais
- Mudanças no esquema
- Contratos de API
- Interações específicas
NÃO inclua caminhos de arquivo específicos ou trechos de código. Eles podem se desatualizar muito rapidamente.
Exceção: se um protótipo produziu um trecho que codifica uma decisão mais precisamente do que a prosa pode (máquina de estados, redutor, esquema, formato de tipo), coloque-o em linha dentro da decisão relevante e observe brevemente que veio de um protótipo. Corte para as partes ricas em decisão — não uma demonstração funcional, apenas as partes importantes.
Decisões de Teste
Uma lista de decisões de teste que foram tomadas. Inclua:
- Uma descrição do que constitui um bom teste (testar apenas comportamento externo, não detalhes de implementação)
- Quais módulos serão testados
- Trabalho anterior para os testes (ou seja, tipos semelhantes de testes na base de código)
Fora do Escopo
Uma descrição das coisas que estão fora do escopo deste PRD.
Notas Adicionais
Quaisquer notas adicionais sobre a funcionalidade.