create-prd

A CLI tool that generates a complete product requirements documentation workspace for your project.

Install

npx create-prd

Or install globally:

npm install -g create-prd
create-prd

Usage

# Generate docs in the current directory
npx create-prd

# Generate docs in a specific directory
npx create-prd --dir my-project

# Overwrite existing docs
npx create-prd --dir my-project --force

# Generate docs with AI
OPENAI_API_KEY=sk-... npx create-prd --ai

# Use a different AI provider
ANTHROPIC_API_KEY=sk-... npx create-prd --ai --provider anthropic

# Show help
npx create-prd --help

Options

| Option | Description | |--------|-------------| | --dir <name> | Output directory (default: current directory) | | --force | Overwrite existing files | | --ai | Use AI to generate documentation (requires API key) | | --provider <name> | AI provider: openai, anthropic, groq, openrouter (default: openai) | | --api-key <key> | API key for AI provider (or use env var) | | --help, -h | Show help message | | --version, -v | Show version number |

Output Structure

docs/
├── 01-product/
│   ├── PRD.md                — Product Requirements Document
│   ├── FEATURES.md           — Feature list and descriptions
│   ├── USER_STORIES.md       — User stories with acceptance criteria
│   ├── ACCEPTANCE_CRITERIA.md — Detailed acceptance criteria
│   └── ROADMAP.md            — Product roadmap
├── 02-technical/
│   ├── TECH_STACK.md         — Technology stack decisions
│   ├── ARCHITECTURE.md       — System architecture overview
│   ├── DATABASE_SCHEMA.md    — Database schema design
│   ├── API_SPEC.md           — API endpoint specifications
│   ├── AUTH.md               — Authentication & authorization
│   └── DEPLOYMENT.md         — Deployment guide
├── 03-development/
│   ├── TASKS.md              — Development task breakdown
│   ├── SPRINT_01.md          — Sprint 1 backlog
│   ├── SPRINT_02.md          — Sprint 2 backlog
│   ├── BACKLOG.md            — Full product backlog
│   └── CHANGELOG.md          — Release changelog
├── 04-design/
│   ├── DESIGN_SYSTEM.md      — Design tokens and components
│   ├── BRAND.md              — Brand guidelines
│   ├── USER_FLOWS.md         — User flow diagrams
│   └── WIREFRAMES.md         — ASCII wireframes
├── 05-ai/
│   ├── CLAUDE.md             — Claude AI configuration
│   ├── GPT.md                — GPT configuration
│   ├── CURSOR_RULES.md       — Cursor AI rules
│   └── AGENTS.md             — AI agent configuration
└── prompts/
    ├── planner.md             — Technical planning prompt
    ├── frontend.md            — Frontend development prompt
    ├── backend.md             — Backend development prompt
    ├── mobile.md              — Mobile development prompt
    ├── database.md            — Database design prompt
    ├── designer.md            — UI/UX design prompt
    └── reviewer.md            — Code review prompt

AI-Powered Generation

Pass --ai to generate documentation using an LLM instead of the built-in templates. The AI produces richer, more tailored content with realistic brand colors, specific metrics, and project-specific backlog items.

Providers

| Provider | --provider value | Env variable | Default model | |----------|-----------------|--------------|---------------| | OpenAI | openai | OPENAI_API_KEY | gpt-4o-mini | | Anthropic | anthropic | ANTHROPIC_API_KEY | claude-sonnet-4-20250514 | | Groq | groq | GROQ_API_KEY | llama-3.3-70b-versatile | | OpenRouter | openrouter | OPENROUTER_API_KEY | openai/gpt-4o-mini |

# OpenAI (default)
export OPENAI_API_KEY=sk-...
npx create-prd --ai

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-...
npx create-prd --ai --provider anthropic

# Groq
export GROQ_API_KEY=gsk-...
npx create-prd --ai --provider groq

The wizard still runs to collect your project details, then 5 batched LLM calls generate all 31+ files. No manual editing of placeholders needed.

License

MIT