doc-prd
doc-prd transforma uma conversa que você já teve num PRD publicado. Depois de um
interview ou de um grilling de doc-align, o entendimento compartilhado está no
contexto — esta skill o redige e o empurra pro issue tracker, sem perguntar tudo
de novo.
O que resolve
A lacuna entre “a gente concordou nisso na discussão” e “existe um ticket que
alguém pode pegar” é onde o bom raciocínio evapora. Re-entrevistar pra escrever o
PRD desperdiça o trabalho já feito e arrisca derivar do que foi decidido. E PRDs
que vazam caminhos de arquivo e código viram specs de implementação obsoletas no
instante em que o código se move. doc-prd fecha as duas lacunas: captura a
decisão enquanto está fresca, e mantém o documento no nível de intenção.
Como resolve
- Sem re-entrevista — o conhecimento é assumido como estando no contexto do brainstorm ou alinhamento anterior, então sintetiza em vez de re-elicitar.
- Intenção, não implementação — caminhos de arquivo e snippets de código são proibidos no corpo, com uma exceção: um snippet de protótipo que codifica uma decisão com mais precisão que a prosa. Um PRD descreve o quê e por quê, não qual arquivo.
- Direto pra ready-for-agent — publica no issue tracker já rotulado pra pickup, pulando o vai-e-volta da triagem.
Faz parte da família doc-*: interview e doc-align produzem o entendimento,
doc-prd o publica.
Quando usar
Logo após uma sessão de interview ou doc-align, quando a decisão está clara e
você quer um ticket sem re-percorrer a conversa. Se o entendimento ainda não
está fechado, rode a skill de intake antes.