prd-generator

prd-generator-plugin

An AI-powered Claude Code plugin that transforms a product idea into a complete, research-backed PRD with modern architecture design, enforcement skills, CI/CD pipeline, documentation cache infrastructure, and self-evolving project documentation — ready for AI-assisted development.

---

What It Does

Given a product idea, this plugin:

1. Interrogates — conducts a structured, one-question-at-a-time interview covering business model, features, compliance, integrations, infrastructure, and VCS choice
2. Researches — automatically searches official documentation sources (never forums or blogs) for every technology and regulatory domain identified
3. Validates — audits research in a fresh, unbiased context to eliminate hallucinations and stale information
4. Designs — proposes a modern, compatible technology stack tailored to the product (not just what you know), structured as a monorepo
5. Documents — generates a complete PRD, architecture document, and ER diagram
6. Enforces — creates six project-specific Claude skills that prevent AI coding agents from violating your product decisions during development
7. Guides — produces CLAUDE.md files for each stack layer with best practices from Clean Code, Clean Architecture, DDD, and The Pragmatic Programmer; includes local documentation cache policy
8. Pipelines — generates a lean CI/CD pipeline for your VCS (GitHub/GitLab/Bitbucket) with path-filtering per monorepo service
9. Evolves — updates all documents, skills, and CI/CD pipeline atomically when the product scope changes

---

Installation

Install via Claude Code plugin system:

claude plugin install prd-generator-plugin

Or clone and install locally:

git clone https://github.com/rodrigo/prd-generator-plugin
claude plugin install ./prd-generator-plugin

---

Usage

Create a new PRD

/prd-new
# or with an initial description:
/prd-new "A B2B SaaS platform for managing construction project budgets"

Evolve the PRD when scope changes

/prd-evolve "Added Pix payment integration and BACEN compliance requirements"
/prd-evolve "Removed mobile app from scope, focusing on web-only MVP"
/prd-evolve "Changed database from MySQL to PostgreSQL for JSONB support"

---

Complete Workflow — /prd-new

flowchart TD
    A(["/prd-new initial description"]) --> B

    subgraph PHASE1["Phase 1 — Interactive Interrogation"]
        B["Block 1: Identity\nname, vision, users, problem"]
        B --> C["Block 2: Business\nmonetization, KPIs, scale"]
        C --> D["Block 3: Core Features\nMVP list, real-time, mobile"]
        D --> E["Block 4: Regulatory\nGDPR/LGPD, payments, sector"]
        E --> F["Block 5: Integrations\nexternal APIs, auth providers"]
        F --> G["Block 6: Infrastructure\ncloud, SLA, budget, geo, VCS, branch strategy"]
        G --> H["Block 7: Stack Preference\nAI-suggested or user-defined"]
    end

    subgraph PHASE2["Phase 2 — Official Research (parallel)"]
        I["official-researcher × N\nparallel instances\nblocked: forums, blogs, wikis"]
        J["research-validator\nFRESH CONTEXT\nverifies accuracy + officiality"]
        K{Approved?}
        I --> J --> K
        K -->|"no (max 3x)"| I
    end

    subgraph PHASE3["Phase 3 — Analysis"]
        L["requirements-analyst\nRF / RNF / domain rules\ncompliance / acceptance criteria"]
    end

    subgraph PHASE4["Phase 4 — Architecture"]
        M["architecture-designer\nmodern stack selection\nMermaid diagrams + ADRs"]
        N{User approves\narchitecture?}
        M --> N
        N -->|"adjust"| M
    end

    subgraph PHASE5["Phase 5 — Generation (parallel)"]
        O["prd-writer\nPRD.md\nARCHITECTURE.md\nER.md"]
        P["stack-guide-generator\nbackend/CLAUDE.md\nfrontend/CLAUDE.md\ninfrastructure/CLAUDE.md\ndocs/stack/ + .claude/settings.json"]
        Q["skills-generator\nproject-guardian\nproject-architecture\nproject-domain-rules\nproject-compliance\nproject-docs-stack\nproject-cicd"]
        R2["cicd-generator\n.github/workflows/ci.yml\n(or .gitlab-ci.yml\nor bitbucket-pipelines.yml)"]
    end

    R[("git commit\nall artifacts")]

    B -->|"tech/domain identified"| I
    K -->|yes| L
    H --> L
    L --> M
    N -->|approved| O & P & Q & R2
    O & P & Q & R2 --> R

---

Research Validation Loop

flowchart LR
    A["official-researcher\nWebSearch + WebFetch\nbanned: forums/blogs/social"] -->|research_refs| B
    B["research-validator\n🔴 FRESH CONTEXT\nno prior session memory"] --> C{Approved?}
    C -->|"✅ yes"| D[("research_refs\nvalidated")]
    C -->|"❌ issues found\nmax 3 iterations"| E["re-research\nwith correction\nguidance"]
    E --> A
    C -->|"3rd attempt fails"| F["mark as\npartially_validated\nlog issues for user"]