Escrever um PRD que os desenvolvedores realmente leiam, com Claude como editor
Os desenvolvedores ignoram PRDs que parecem ensaios. Uma estrutura rígida e Claude como editor severo abriram a minha.
Meus primeiros PRDs voltaram com 'você pode simplesmente dizer o que construir?' Então parei de escrever documentos e comecei a escrever especificações que um engenheiro cansado toleraria. A função de Claude nisso é cortar, não inventar.
Estrutura primeiro: uma linha sobre o problema, uma linha sobre o usuário, uma pequena lista do que significa 'pronto' e os casos extremos que os desenvolvedores realmente atingiram. Nenhum romance de fundo. Se precisar de um parágrafo de contexto, ele pertence a um tópico vinculado.
Faça um rascunho simples e cole-o em Claude com uma instrução: 'remova todas as frases que um desenvolvedor possa inferir e sinalize qualquer requisito sem teste de aceitação'. Esse único prompt elimina o problema que torna os PRDs ignoráveis.
Depois adiciono os testes de aceitação que Claude sinalizou como ausentes. Um requisito sem teste é uma opinião. Os desenvolvedores leem as especificações que podem verificar; eles vasculham o resto.
O hábito que mudou tudo: escrevo o PRD presumindo que o leitor tenha contexto e não tenha paciência. Claude me ajuda a manter essa linha excluindo a prosa de cortesia.
Claude (claude.ai)
Melhor para: redação longa, edição e raciocínio por meio de estrutura.
Principais recursos: modo documento, contexto longo, artefatos para rascunhos, edição cuidadosa.
Plano gratuito: um nível gratuito com limites diários.
Preço: Pro cerca de US$ 20 por mês para maior uso.
Prós: forte no corte e na reestruturação, permanece breve.
Contras: suavizará uma ponta romba, a menos que você diga para não fazê-lo.
Meu veredicto: escrevo os ossos, Claude remove a gordura, adiciono novamente os casos extremos. O documento resultante é curto o suficiente para ser lido e específico o suficiente para ser construído.
Perguntas frequentes:
P: Claude deveria escrever o PRD do zero?
R: Eu escrevo a estrutura; Cláudio edita. A geração completa difere do que a equipe realmente precisa.
P: Quão curto é muito curto?
R: Se um desenvolvedor puder construí-lo e testá-lo a partir do documento, ele será longo o suficiente. Mais longo geralmente é o preenchimento.
P: Preciso de testes de aceitação para cada linha?
R: Para qualquer coisa que uma pessoa de controle de qualidade verifique, sim. Requisitos vagos tornam-se culpados mais tarde.