convez.ai
PluginProdutividadeIntermediário
feba-capital

PRD Generator

feba-capital/prd-generator

Transforma ideias em PRDs validadas e sem contradições entre docs

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que converte briefs freeform em pacotes PRD validados e consistentes entre documentos. Inclui 16 quality gates, labels explícitos de incerteza (TBD/Proposed/Assumed) e suporte a múltiplos stacks e idiomas. Entrega PRD pronto para agentes de codificação sem decisões escondidas.

Instalação

$npx convez-ai feba-capital/prd-generator

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
1
Saúde
50%
Último commit
há 6 meses
Versão
v1.3.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Estruturar especificações de produtos antes de delegar para agentes de IA
  • Validar consistência entre PRD, endpoints, modelos e documentação
  • Gerar pacotes PRD multi-idioma (EN, PT, ES, CN) com workflows explícitos

Veredito

Ferramenta sólida para times que precisam de PRDs estruturadas e sem contradições. O foco em uncertainty labels e 16 quality gates reduz drasticamente retrabalho e alucinações em agentes de codificação. Recomendado para projetos multi-stack que exigem rigor na especificação.

README

A tradução para o português deste README ainda está na fila.

PRD Generator

Plugin for Claude Code and Codex. Turns a freeform product idea into a validated, cross-doc-consistent PRD package, ready to hand to a coding agent.

In 30 seconds

> /prd-generator
[skill] Language? > English
[skill] Brainstormed already? > Yes
[skill] Briefly describe what you want to build:
> Multi-tenant blog platform for portfolio companies. Each tenant
> gets isolated content, AI writers, publishing webhooks. Stack:
> Next.js 16 + Supabase. MVP needs auth, brief approval, content
> generation, scheduling.

[skill asks 6 high-leverage questions in 2 batches]
[skill confirms summary, you approve]

[skill] Generated 11 files in projects/blog-saas/.
        16 quality gates passed.
        8 items safe to implement.
        2 need decision before coding.
        3 deferred to v1.1.

Now any coding agent can read your PRD without making things up.

What it generates

                    ┌─────────────────┐
                    │   Main PRD      │
                    │ {slug}-prd.md   │
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        ↓                    ↓                    ↓
  ┌──────────┐         ┌──────────┐        ┌──────────┐
  │AGENTS.md │         │CLAUDE.md │        │  api-*   │
  │  rules   │         │ guardrail│        │ contracts│
  └──────────┘         └──────────┘        └──────────┘
        ↓                    ↓                    ↓
  ┌────────────────────────────────────────────────┐
  │  stack docs + DEVELOPMENT-WORKFLOW + README    │
  │       + CHANGELOG + service-boundaries         │
  └────────────────────────────────────────────────┘

Default output: projects/{project-slug}/.

Why it exists

Most AI-generated PRDs fail in one of two ways:

Failure 1: sounds complete, hides decisions
Failure 2: five docs that contradict each other

This plugin pushes against both:

DefenseHow
Hidden uncertaintyForces explicit TBD { blocks_coding: yes/no }, Assumed { question, default, flip_cost }, Proposed { promote_when } labels
Doc drift16 quality gates validate that PRD, endpoints, models, and RLS summaries agree
Workflow handwavingEvery workflow step must reference an exact endpoint or UI only
Stale runtimeVersion Policy blocks EOL Node, Next.js, or framework defaults
Accidental activationThe skill only runs from /prd-generator, never from natural-language brainstorm

Install

In Claude Code, add the marketplace from feba-capital/prd-generator and install prd-generator. In Codex, the manifest is in .codex-plugin/plugin.json and the skill payload is the same skills/prd-generator/ directory.

See docs/skill-installation.md for the full path.

Use

/prd-generator

The workflow:

  1. Picks language (English, Portuguese, Spanish, Chinese, or Other)
  2. Confirms idea is brainstormed (or hands off to a brainstorm skill)
  3. Offers an optional 7-question MVP scope check
  4. Reads your briefing, asks 2 to 4 high-leverage questions in batches
  5. Confirms summary before generating
  6. Writes the package into projects/{slug}/
  7. Runs 16 quality gates and reports pass/fail per gate
  8. Returns an Implementation Readiness summary

Works with any stack. Two presets bundled (nextjs-supabase, yii2-mysql); other stacks get ad-hoc generation that you can promote into a permanent preset later.

What's in the box

PathPurpose
commands/prd-generator.mdThe slash command entry
skills/prd-generator/SKILL.mdThe workflow source of truth
skills/prd-generator/interview/Step 0 to Step 6 prompts
skills/prd-generator/templates/Base templates copied into every package
skills/prd-generator/stack-presets/Reusable per-stack docs
skills/prd-generator/scripts/validate-generated-docs.shThe 16-gate validator
examples/wisercontent/Frozen reference snapshot
tests/Pass/fail fixtures and three regression scripts

Quality gates (the 16)

GroupGate
Cross-docWorkflow steps must point at endpoints that exist
Cross-docReused endpoint anchors must carry distinct role/state qualifiers
Cross-docEndpoint access summaries must match RLS policy text
Cross-docRole claims must agree across PRD, endpoints, and RLS
FormatTBD / Assumed / Proposed must use classifier syntax
FormatNo legacy TBD (reason: ...) in new output
FormatNo em dash in prose
FormatNo Lorem, example.com, foo bar, or TODO placeholders
StructureAll required sections present per file type
StructureImplementation Readiness non-empty, with source citations
StructureFuture Versions and Launch Dependencies mutually exclusive
StructureValidation Plan carries all four required fields
StructureScope Decisions items carry a non-empty reason
HygieneRuntime and framework versions current stable or pinned with reason
HygieneNon-admin UPDATE policies declare explicit transitions
HygieneNon-admin UPDATE policies enforce explicit columns

Develop on it

git clone https://github.com/feba-capital/prd-generator
cd prd-generator
bash tests/test-validate-generated-docs.sh
bash tests/test-sprint-1-regressions.sh
bash tests/test-sprint-2-regressions.sh

See CONTRIBUTING.md for the full flow, including how to add a new stack preset or a new language.

Authors

Created by Bill Madeira and Fabio Espindula at FEBACAPITAL.

Bill wrote the original PRD that became the seed of this plugin. Fabio reverse-engineered its structure into a reusable generator and built the validator, quality gates, stack presets, and multi-language workflow.

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados