Create PRD

ANÁLISE EDITORIAL

Create PRD é uma Agent Skill para transformar uma ideia de produto, uma solicitação de funcionalidade ou um conjunto de notas em um Documento de Requisitos do Produto. O arquivo não entrega um PRD pronto por mágica. Ele obriga o agente a organizar o contexto, explicitar hipóteses e produzir uma estrutura que possa ser revisada por produto, design, engenharia e liderança.

A versão auditada faz parte do repositório phuryn/pm-skills no commit fixado. Em 12 de agosto de 2026, a API oficial do GitHub registrava 25.197 estrelas. A pasta da Skill contém somente um arquivo Markdown, o SKILL.md original. O pacote local oferecido pelo Bastidores preserva esse arquivo, a licença MIT e um registro de origem. Não há script, binário, dependência ou credencial dentro do ZIP.

Imagem editorial exclusiva do Bastidores da IA. Não é captura de tela, interface real nem prova de que um PRD foi aprovado.

O que a Create PRD faz de verdade

A instrução começa pedindo que o agente reúna as informações disponíveis. Se você anexar arquivos, ele deve lê-los. Se a tarefa mencionar pesquisa, URLs ou dados de clientes, o texto permite recorrer à busca na web para obter contexto adicional. Em seguida, o agente precisa pensar em quatro perguntas: qual problema será resolvido, para quem, como o sucesso será medido e quais restrições ou hipóteses existem.

Depois dessa preparação, a Skill define um modelo de oito partes: resumo, contatos, contexto, objetivo, segmentos de mercado, propostas de valor, solução e lançamento. Dentro de solução, ela pede fluxo ou protótipo, funcionalidades, tecnologia quando isso for relevante e hipóteses ainda não comprovadas. No lançamento, separa a primeira versão de evoluções futuras e recomenda estimativas relativas, sem datas exatas inventadas.

O resultado esperado é um arquivo Markdown chamado no formato PRD-nome-do-produto.md. Essa entrega deve ser tratada como uma primeira especificação revisável. Ela não substitui pesquisa com usuários, decisão de negócio, desenho de experiência, análise de segurança, estimativa de engenharia nem aprovação dos responsáveis.

Para quem serve e quando não usar

A Create PRD faz sentido para product managers, fundadores, analistas de negócio, designers e engenheiros que já têm um problema razoavelmente definido e precisam registrar decisões. Também pode ajudar uma equipe pequena a transformar notas dispersas em um documento comum antes de abrir histórias, desenhar telas ou estimar trabalho.

Ela não é a melhor primeira etapa quando a equipe ainda não sabe qual problema vale resolver. Nesse cenário, descoberta, entrevistas e análise de evidências vêm antes do PRD. Também não é uma substituta do Briefing de projeto já existente no catálogo do Bastidores, que organiza pedidos vagos e define escopo inicial. E não repete a finalidade de Superpowers Writing Plans, voltada a converter uma decisão técnica já tomada em um plano de implementação. A Create PRD ocupa o espaço intermediário: documenta requisitos de produto depois de haver direção suficiente, mas antes do plano técnico detalhado.

Compatibilidade e pré-requisitos

O mantenedor descreve os arquivos SKILL.md como compatíveis com ferramentas que entendem o formato de Agent Skills. O README oficial do repositório documenta uso com Claude Code, Codex, Gemini CLI, OpenCode, Cursor e Kiro, com diferenças entre plugins, comandos e Skills. No Codex, o repositório orienta instalar o plugin pm-execution pelo marketplace. Em clientes que não executam os comandos do plugin, a Skill ainda pode ser carregada como arquivo, desde que o cliente reconheça o formato e a pasta escolhida.

Antes de instalar, você precisa de um agente compatível, uma pasta de projeto na qual a instalação possa ser testada e um problema de produto descrito com algum nível de evidência. Separe também os materiais que podem ser lidos com segurança: entrevistas anonimizadas, métricas aprovadas, restrições legais conhecidas e decisões de estratégia. Não envie dados pessoais, segredos comerciais ou credenciais apenas para preencher uma seção do documento.

O formato de Skill usa frontmatter com nome e descrição, seguido pelas instruções. Para GitHub Copilot, a própria documentação do GitHub explica os diretórios aceitos para Agent Skills. Em outros clientes, confira a documentação da versão instalada antes de copiar arquivos.

Instalação recomendada no Codex

O caminho documentado pelo mantenedor instala o plugin inteiro de execução, não apenas esta Skill. Em um projeto de teste, registre o marketplace:

codex plugin marketplace add phuryn/pm-skills

Depois, instale o plugin que contém a Create PRD:

codex plugin add pm-execution@pm-skills

Abra a pasta instalada, confirme que a origem continua sendo phuryn/pm-skills e compare o arquivo com o commit auditado. O manifesto do marketplace identifica os plugins publicados pelo projeto, enquanto o manifesto do pm-execution registra o pacote específico. Esses arquivos podem mudar em versões futuras, por isso o commit fixado é a referência desta curadoria.

Se você não quiser instalar o conjunto inteiro, use o ZIP local como material auditável: extraia o pacote, leia ORIGEM.md, LICENSE e create-prd/SKILL.md, e só então copie a pasta da Skill para o diretório aceito pelo seu cliente. Instalação manual varia por produto e não concede suporte oficial do mantenedor.

Configuração antes do primeiro uso

A Skill não possui arquivo de configuração próprio. A qualidade depende do contexto fornecido. Prepare um bloco curto com nome da iniciativa, problema observado, pessoas afetadas, evidências disponíveis, objetivo de negócio, restrições, responsáveis e decisões que ainda estão abertas. Marque claramente o que é fato, o que é estimativa e o que ainda é hipótese.

Defina também as permissões do agente. Leitura local deve ficar limitada às pastas necessárias. Pesquisa na web deve usar fontes oficiais e não deve transformar uma afirmação encontrada em requisito confirmado sem revisão. Escrita deve apontar para um arquivo novo, dentro do projeto de teste. A Skill não precisa de token, chave de API, acesso a produção nem permissão para enviar o documento a outras pessoas.

Primeiro uso seguro

Comece com uma iniciativa fictícia ou não sensível. Um pedido útil seria:

Use a Create PRD para estruturar um PRD de uma central interna de solicitações.
Público: equipe de operações.
Problema confirmado: pedidos chegam por três canais e perdem responsável.
Meta inicial: reduzir solicitações sem responsável.
Restrições: sem integração externa na primeira versão.
Salve como PRD-central-solicitacoes.md.
Marque como hipótese qualquer dado que não esteja neste briefing.

O documento esperado deve trazer as oito seções pedidas e manter a linguagem simples. Verifique se os contatos são pessoas reais ou campos pendentes, se os resultados-chave podem ser medidos, se os segmentos são definidos pelo problema e se a proposta de valor não promete algo que a primeira versão não entrega. Na solução, confirme que funcionalidades, tecnologia e hipóteses estão separadas. No lançamento, procure uma divisão clara entre primeira versão e etapas posteriores.

Permissões, privacidade e riscos

O arquivo auditado é Markdown e não executa comandos. Mesmo assim, as instruções autorizam o agente a ler arquivos fornecidos e a pesquisar a web quando o pedido mencionar URLs ou pesquisa. Isso cria dois riscos práticos. O primeiro é exposição de dados: entrevistas, tickets e planilhas podem conter nomes, e-mails, dados contratuais ou informações de clientes. O segundo é influência de conteúdo externo: uma página pode estar errada, desatualizada ou conter instruções inadequadas para um agente.

Reduza esses riscos anonimizando materiais, removendo credenciais, limitando as pastas disponíveis e aprovando as fontes. Nunca aceite números de mercado, benchmarks, prazos, custos ou metas apenas porque o agente os preencheu. Se não houver evidência, o campo deve ficar marcado como hipótese ou pendência.

A licença MIT do repositório permite usar, copiar, modificar e distribuir, desde que o aviso de copyright e a permissão sejam preservados. Ela também informa que o material é fornecido sem garantia. Isso permite o download local auditado, mas não transforma o Bastidores em mantenedor da Skill.

Erros comuns e como corrigir

A Skill não aparece no agente

Confirme o caminho da pasta, o nome create-prd e o frontmatter do SKILL.md. Reinicie ou recarregue o cliente se ele só descobre Skills na inicialização. Se você instalou o plugin inteiro, verifique se o pm-execution está habilitado.

O PRD ficou genérico

O problema costuma ser contexto insuficiente. Acrescente evidências, restrições, pessoas responsáveis e decisões abertas. Não peça ao agente para inventar métricas. Diga explicitamente que lacunas devem aparecer como perguntas ou hipóteses.

O arquivo mistura requisitos e plano técnico

Peça uma segunda passagem que separe necessidades do usuário, critérios de sucesso, funcionalidades, decisões técnicas e hipóteses. Tecnologia é opcional no modelo e só deve entrar quando for relevante para a decisão de produto.

A pesquisa trouxe fatos sem fonte

Interrompa a aprovação. Exija links primários, data da consulta e distinção entre fonte e interpretação. O próprio mantenedor liga a Skill ao artigo How to Write a Product Requirements Document e a um modelo de PRD com IA, mas esses textos são referências de estrutura, não evidência do seu produto.

Versão auditada, licença e download local

• Repositório: phuryn/pm-skills.
• Caminho: pm-execution/skills/create-prd/SKILL.md.
• Commit: 18468a95b427e70e258b51389796367c6f684e7d.
• Estrelas: 25.197 em 12/08/2026, consultadas na API oficial do GitHub.
• Licença: MIT.
• Conteúdo do ZIP: create-prd/SKILL.md, LICENSE e ORIGEM.md.
• SHA-256 do ZIP: c684dae093e1ce7cb817eaddd29cb678156ad14126c7046a10a0d29d2f7a1e20.

O download hospedado pelo Bastidores é uma cópia pequena e auditável do material permitido. Use o botão de download para obter o pacote fixado e o botão separado de repositório oficial para conferir atualizações. Não substitua uma origem pela outra: o ZIP preserva a versão revisada, enquanto o repositório mostra a evolução do projeto.

Resultado esperado e limite final

Uma boa execução termina com um PRD conciso, completo e claramente revisável. Fatos têm origem, hipóteses estão marcadas, métricas podem ser verificadas, requisitos respondem ao problema e o lançamento separa primeira versão de possibilidades futuras. O documento ainda precisa de leitura humana por quem responde por produto, tecnologia, segurança, jurídico e operação, conforme o contexto.

O limite mais importante é simples: uma estrutura de oito seções melhora a conversa, mas não valida uma ideia. A Create PRD ajuda a registrar decisões e revelar lacunas. Ela não prova demanda, não estima esforço sozinha e não autoriza construir ou lançar nada.

Referências primárias

• Pasta oficial da Create PRD no commit auditado.
• SKILL.md oficial.
• README oficial com instalação e compatibilidade.
• Licença MIT preservada no pacote.