📋 PRD Workflow Manager

The complete Claude Code plugin for Product-Driven Development

Transform PRDs from ideas to shipped features with AI-powered review, guided implementation, and automated quality gates. Never ship unclear requirements again.

🎯 Why PRD Workflow Manager?

The Problem 😫

Most development teams struggle with:

• Scope creep - Features grow 3x during implementation
• Context switching - Developers lose 2-3 hours/day switching between PRDs
• Quality issues - 40% of PRs need rework due to unclear requirements
• Wasted time - Manual PRD reviews take 2+ hours and miss critical gaps
• Lost progress - No clear tracking from idea → code → production

The Solution ✨

PRD Workflow Manager is the first and only Claude Code plugin that manages your entire product development lifecycle:

💡 Idea → 📝 PRD → ✅ Review → 💻 Code → 🔒 Quality → 🚀 Ship

With AI-powered agents, automated quality gates, and Git worktree orchestration, you ship features faster while maintaining production-grade quality.

✨ Key Features

🆕 What's New in v0.3.1

🚦 Review Gate - Stop Bad Ideas in 30 Seconds

3 killer questions before you waste time on full analysis:

1. KILL - Should this even exist?
2. SKIP - Can we wait 3 months?
3. SHRINK - What's the 20% MVP?

Impact: Catch scope bloat and unjustified features in 30s vs 10 min

🤖 Agent Orchestration - One Command, Full Analysis

/invoke "implement Stripe payments"
→ Runs: architecture + security + tests + plan (parallel)
→ 12 min → comprehensive outputs

⚙️ Worktree Health Checks - No More Cryptic Errors

Pre-flight validation catches Git issues before they break:

• ✓ Version check (need 2.25+)
• ✓ Permissions check
• ✓ Conflict detection

Impact: Clear remediation vs "git worktree add failed"

📊 3x Faster Reviews - 10-20 min → 3-5 min

• 4 core dimensions (not 7)
• Dynamic contextual (tag-based)
• Compact format (icons, bullets)

🔍 AI-Powered PRD Review

Multi-dimension analysis with automatic grading (A-F) and calibration questions that expose gaps you didn't know existed.

Before: Hours of manual review, still miss critical issues After: Minutes of AI analysis catches more with actionable questions

⚡ Daily Development Tools (v2.3)

7 new agents for everyday coding (not just PRDs):

• code-reviewer - 30-second automated code review (5 agents in parallel)
• test-automator - Auto-generate comprehensive test suites (10x faster)
• backend-architect - Expert API/database design guidance
• performance-analyst - Systematic app optimization (2-3x faster)
• incident-coordinator - Structured production incident response

Before: Manual code review (30-45 min), manual test writing (hours) After: Automated review (30s), auto-generated tests (seconds)

🎯 Intelligent Developer Experience (NEW in v2.4)

Smart features that prevent errors and save time:

• Auto-Recovery - Never lose progress on crashes (auto-checkpoint every 3 tasks)
• Contextual Questions - AI asks payment-specific questions for payment features (9 types)
• AI Conflict Resolution - Merge conflicts auto-resolved 80% of the time
• Helpful Errors - Every error suggests the right next command
• Parallel Orchestration - Analyze 20 PRDs in 10s instead of 200s (-95%)
• Quick Ship Enhanced - Ship bug fixes in <1 hour with zero overhead

Before: Lost work on crashes, generic questions, manual conflict resolution After: 100% recovery, smart questions, AI-assisted merges

🌳 Git Worktree Orchestration

Work on 5+ features in parallel without branch switching. Enforced by default with health checks - Git 2.25+ required.

Before: Context switching costs hours every day, optional worktree = inconsistent workflow After: Mandatory isolation, instant feature switching, clear error handling

👨‍💻 Guided Implementation

AI breaks your PRD into granular tasks with acceptance criteria, file paths, and code examples.

Before: Developers spend significant time figuring out "what's next" After: AI tells you exactly what to build, step by step

🔒 Automated Security & Quality

Zero-config security scans (OWASP Top 10, dependency vulnerabilities, secrets detection) and quality checks (coverage, complexity, linting).

Before: Manual security reviews miss many issues After: Automated scans find more issues in seconds

🎼 Multi-PRD Orchestration

Smart dependency resolution and resource allocation across multiple features. Know exactly what's blocked, what's ready, and where to focus.

Before: 3+ PRDs running = chaos After: Crystal clear dependency graph and bottleneck analysis

📊 Progress Tracking

Real-time progress on every PRD with automatic status updates, WORK_PLAN.md sync, and GitHub integration.

Before: "How's feature X going?" → checks 5 places After: /list-prds → instant status on everything

🏥 Self-Healing & Reliability (NEW in v2.8)

Never worry about installation issues again! The plugin now self-diagnoses and auto-repairs:

• Auto Health Check - Runs after every install/update to verify everything works
• One-Command Repair - /plugin-repair fixes 90%+ of issues automatically
• Smart Updates - /plugin-update updates safely with auto-backup
• Clear Diagnostics - Know exactly what's wrong and how to fix it

Before: "Why aren't my commands showing up?" → hours of debugging After: /plugin-health → instant diagnosis + /plugin-repair → fixed in seconds

Key Benefits:

• ✅ Zero missing commands (bin/ folder now copied correctly)
• ✅ Accurate installation verification (exact file counts)
• ✅ Self-healing when issues occur (auto-repair)
• ✅ Safe updates with rollback (never lose your config)

🎯 How It Works: Two Workflow Modes

Choose the right workflow for your feature size:

Mode 1️⃣: Full PRD Workflow (Substantial Features)

Use for: Features taking >1 day, multiple developers, customer-facing changes

# Step 1: Create PRD with interactive questions (Main branch)
/create-prd "Add OAuth2 authentication"
→ AI asks clarifying questions
→ Generates comprehensive PRD
→ Stays in DRAFT by default

# Step 2: Create feature branch (enables parallel work!)
/code-prd PRD-007
→ Creates feature/PRD-007-oauth2-integration
→ Your Main branch stays FREE

# Step 3: Review & refine (on feature branch, separate Cursor window)
/review-prd PRD-007
→ 7-dimension analysis
→ Refine until Grade A/B

# Step 4: Guided development with auto-recovery ✨ NEW
/code-prd PRD-007
→ AI breaks into tasks
→ Step-by-step guidance
→ Auto-saves progress every 3 tasks
→ Resume from checkpoint if interrupted

# Step 5: Complete with AI conflict resolution ✨ NEW
/complete-prd PRD-007
→ AI detects merge conflicts
→ Suggests intelligent resolutions
→ Auto-merge if tests pass
→ Auto-cleanup branches

🎯 Key Benefit: Main branch never blocked. Create PRD on Main, review/dev on feature branch in parallel.

Mode 2️⃣: Quick Ship Workflow (Small Changes) - Enhanced in v2.4 🚀

Use for: Bug fixes, small tweaks, <4 hour changes

/quick-ship "Fix dark mode toggle on iOS Safari"
→ No PRD created
→ Minimal tracking log
→ Auto-commit (AI message) ✨ NEW
→ Auto-PR with description ✨ NEW
→ Auto-merge on tests pass ✨ NEW
→ Complete in <1 hour

🎯 Key Benefit: Zero overhead for small changes. Ship fixes in minutes, not hours.

NEW in v2.4: Integrated workflow eliminates manual commit/PR creation - just describe the fix and ship!

📊 Which Mode to Choose?

| Criteria | Full PRD | Quick Ship | |----------|----------|------------| | Duration | >1 day | <4 hours | | Developers | Multiple | Single | | Scope clarity | Needs definition | Crystal clear | | Risk | Medium-High | Low | | Examples | New feature, Refactor, Integration | Bug fix, UI tweak, Dependency update |

🚀 Installation (2 minutes)

Prerequisites

• Claude Code v2.0 or higher
• Git v2.25+ (for worktree support)
• Node.js v18+ (for the installation script)

Step 1: Install the Plugin Globally (One Time)

💡 Key Concept: Install once globally → Available in ALL your projects automatically!

Option A: npm (Recommended - Fully Automatic)

npm install -g claude-prd-workflow
# ✅ Auto-installs to ~/.claude-code/
# ✅ Commands, agents, and skills copied to the right places
# ✅ Ready to use in ALL projects

# Restart Claude Code

Option B: Claude Code Marketplace (Native Plugin System)

# In Claude Code, add the marketplace:
/plugin marketplace add Yassinello/claude-prd-workflow

# Then install the plugin:
/plugin install claude-prd-workflow

# ✅ Direct integration with Claude Code
# ✅ Automatic updates via marketplace
# ✅ Discover all available plugins
# ✅ No npm required

# Restart Claude Code

Option C: Git Clone (Manual Installation)

# Clone to a temporary location
git clone https://github.com/Yassinello/claude-prd-workflow.git
cd claude-prd-workflow

# Run the installation script
node install.js
# ✅ Copies 18 slash commands to ~/.claude-code/commands/
# ✅ Copies 17 AI agents to ~/.claude-code/agents/
# ✅ Copies 13 skills to ~/.claude-code/skills/
# ✅ Copies plugin files to ~/.claude-code/plugins/claude-prd-workflow/
# ✅ Runs automatic health check to verify installation

🏥 Running automatic health check...
   ✅ Plugin directory found
   ✅ Plugin version: 2.8.0
   ✅ Installed 18 slash commands
   ✅ Installed 17 AI agents
   ✅ Installed 13 skills

✅ All systems operational!

# Restart Claude Code

Option D: From Claude Code (Interactive)

# In Claude Code, type:
/help plugins

# Then follow the prompts to:
# 1. Install from npm: claude-prd-workflow
# 2. Restart Claude Code
# Done!

🔓 Optional: Ultra-Permissive Permissions (Highly Recommended)

Problem: Claude Code asks for permissions constantly, interrupting your workflow.

Solution: This plugin includes suggested ultra-permissive permissions that eliminate 99% of authorization prompts while still blocking data deletion operations.

Automatic (Recommended)

During installation, Claude Code may offer to apply the suggested permissions. Accept to enable seamless workflow.

Manual Setup

If automatic setup didn't work or you want to configure later:

# Copy suggested permissions to your global config
cp ~/.claude-code/plugins/claude-prd-workflow/.claude/settings.local.json ~/.claude-code/settings.json

# OR merge with existing config
cat ~/.claude-code/plugins/claude-prd-workflow/.claude/settings.local.json

# Then restart Claude Code

What's Allowed: ✅ Git, NPM, file operations, web access, all plugin commands What's Blocked: ❌ Only data deletion (rm, del, git clean) and secrets

📖 Full permissions guide →

Step 2: Verify Installation

The installation script automatically runs a health check, but you can verify anytime:

Option A: Via Command (Recommended)

/plugin-health

Option B: Via Script

cd ~/.claude-code/plugins/claude-prd-workflow
node bin/check-health.js

✅ Success: All systems operational ❌ Error: Issues detected

If Issues Detected:

# Auto-repair (fixes 90%+ of issues)
/plugin-repair

# Or manually
cd ~/.claude-code/plugins/claude-prd-workflow
node bin/repair.js

# Restart Claude Code after repair

Quick Test:

/list-prds

✅ Success: No PRDs found. Create your first PRD with /create-prd ❌ Error: Command not found → Run /plugin-repair then restart Claude Code

Step 3: Using in an Existing Project

The plugin works immediately in any project! Just open your project in Claude Code:

# Open your existing project in Claude Code
cd ~/my-existing-project
code .  # or open with Claude Code

# In Claude Code, create the PRD structure:
/create-prd
# The plugin will:
# 1. Ask for PRD details
# 2. Create product/prds/ directory if needed
# 3. Generate your first PRD file

Optional: Customize config for this specific project:

# Copy a preset (choose one based on your project type)
mkdir -p .claude
cp ~/.claude-code/plugins/claude-prd-workflow/config/presets/startup.json .claude/config.json

# Or for enterprise:
cp ~/.claude-code/plugins/claude-prd-workflow/config/presets/enterprise.json .claude/config.json

# Or for open source:
cp ~/.claude-code/plugins/claude-prd-workflow/config/presets/open-source.json .claude/config.json

That's it! 🎉 You're ready to create your first PRD.

🔄 Keeping the Plugin Updated

New in v2.8: One-command updates with automatic backup and health check!

Update to Latest Version

Option A: One-Command Update (Recommended - NEW in v2.8)

/plugin-update

The update command automatically:

• ✅ Checks current version and fetches latest from GitHub
• ✅ Backs up your config (automatic - no data loss)
• ✅ Stashes uncommitted changes during update
• ✅ Updates via git pull (if installed via git)
• ✅ Reinstalls all commands/agents/skills globally
• ✅ Runs health check to verify update succeeded
• ✅ Shows version change and what's new
• ✅ Rollback-friendly (keeps old version if update fails)

Option B: Manual Update (Git-based installations)

cd ~/.claude-code/plugins/claude-prd-workflow
git pull origin main
node install.js
# Restart Claude Code

Option C: Reinstall (npm-based installations)

npm install -g claude-prd-workflow@latest
# Restart Claude Code

Check for Updates

# Check your installed version
npm list -g claude-prd-workflow

# Check latest available version
npm view claude-prd-workflow version

# See what changed in new versions
npm view claude-prd-workflow versions --json

Update to Latest Version

# Update to the latest version
npm install -g claude-prd-workflow@latest

# The postinstall script automatically:
# ✅ Updates commands in ~/.claude-code/commands/
# ✅ Updates agents in ~/.claude-code/agents/
# ✅ Updates skills in ~/.claude-code/skills/
# ✅ Updates plugin files in ~/.claude-code/plugins/

# Restart Claude Code to see changes

Update Notifications

Updates are NOT automatic - this is intentional to prevent breaking changes.

When to update:

• ✅ New features you want to use
• ✅ Bug fixes for issues you're experiencing
• ✅ Security patches (check GitHub releases)

Where to check for updates:

• GitHub Releases
• npm Package Page
• CHANGELOG.md

Version Compatibility

The plugin follows Semantic Versioning:

• Major (1.x.x → 2.x.x): Breaking changes, may require config updates
• Minor (1.0.x → 1.1.x): New features, backward compatible
• Patch (1.0.0 → 1.0.1): Bug fixes, always safe to update

Current stable version:

⚡ Quick Start - Real Example: Building MCP Server Prioritization

Let's walk through a real example from idea to shipped code in 30 minutes.

Scenario: You want to add a feature to prioritize MCP servers in Claude Code based on usage frequency.

1. Create Your First PRD

In Claude Code, type:

/create-prd

Claude will ask:

• Feature name: MCP Server Prioritization
• Priority: P1 (should-have)
• PRD ID: PRD-001

Output: product/prds/01-draft/251025-mcp-server-prioritization-v1.md

The PRD template is pre-filled with sections:

• Problem Statement
• Goals & Success Metrics
• User Stories
• Technical Approach
• Acceptance Criteria
• Dependencies
• Risks

Time: 2 minutes to fill in the details

2. Review Your PRD

/review-prd

What happens:

1. AI analyzes PRD across 7 dimensions (Clarity, Feasibility, UX, Dependencies, Criteria, Risks, Simplification)
2. Generates 5-10 calibration questions to expose gaps
3. You answer questions → PRD is updated
4. Grade assigned (A-F)
5. If grade ≥ minimum (B for enterprise, C for startup) → Approved!
6. PRD moves to product/prds/02-ready/
7. GitHub issue created (if enabled)

Time: 15 minutes (vs 2 hours manual review)

3. Start Development

/code-prd

What happens:

1. Creates branch feat/PRD-001-user-authentication
2. Creates Git worktree ../my-project-user-authentication/ (isolated workspace)
3. Installs dependencies (if configured)
4. Moves PRD to product/prds/03-in-progress/
5. Opens implementation context

You're now coding in a clean workspace!

4. Guided Implementation

/work-prd

What happens:

1. AI breaks PRD into 40+ tasks (example):

   • Task 1: Setup NextAuth.js (2h)
   • Task 2: Create login API route (1h)
   • Task 3: Build login UI component (3h)
   • Task 4: Add session management (2h)
   • ...Task 40: Deploy to production (1h)

2. For each task:

   • Shows what to build (clear description)
   • Shows where (exact files to modify)
   • Shows how (code examples & patterns)
   • Shows acceptance criteria (how to know you're done)

3. After you complete a task → validates → moves to next

Progress tracked automatically in .claude/prd-001-progress.json

5. Quality Gates

Before creating your PR:

/security-audit

→ Scans for vulnerabilities, secrets, OWASP violations → Must pass (0 high-severity issues)

/quality-check

→ Runs linting, tests, coverage, complexity analysis → Must pass (grade ≥ B for enterprise, C for startup)

Time: 30 seconds (vs 30 minutes manual review)

6. Ship It!

Create PR → Code review → Merge → Done! 🎉

PRD automatically moves to product/prds/04-complete/

🔧 How It Works

The Complete Workflow

flowchart LR
    A[💡 Idea] -->|/create-prd| B[📝 Draft PRD]
    B -->|/review-prd| C{🔍 AI Review<br/>7 Dimensions}
    C -->|Grade ≥ Min| D[✅ Approved]
    C -->|Grade < Min| B
    D -->|/code-prd| E[🌳 Worktree Created]
    E -->|/work-prd| F[👨‍💻 Task-by-Task<br/>Implementation]
    F -->|/security-audit<br/>/quality-check| G{🔒 Quality Gates}
    G -->|Pass| H[🚀 Ship]
    G -->|Fail| F
    H --> I[✔️ Complete]

    style A fill:#e1f5ff
    style C fill:#fff4e6
    style D fill:#f6ffed
    style G fill:#fff1f0
    style H fill:#f6ffed

AI Agents at Work (13 Total - 7 NEW in v2.3!)

PRD Management Agents (6): | Agent | When | What | |-------|------|------| | 🔍 prd-reviewer | /review-prd | 7-dimension analysis, calibration questions, grading | | 👨‍💻 prd-implementer | /code-prd | Task breakdown, code examples, validation | | 🎼 orchestrator | /orchestrate | Dependency analysis, resource allocation, bottleneck detection | | 🔒 security-expert | /security-audit | OWASP Top 10, secrets detection, vulnerability scanning | | ✅ quality-assurance | /quality-check | Coverage, complexity, linting, type safety | | 🚀 devops-engineer | (on-demand) | CI/CD setup, infrastructure as code |

Daily Development Agents (7 - NEW in v2.3): | Agent | Model | What | |-------|-------|------| | 🔎 code-reviewer | Haiku (fast) | Automated code review, best practices, complexity detection | | 🧪 test-automator | Haiku (fast) | Auto-generate unit/integration/E2E tests with fixtures | | 🏗️ backend-architect | Sonnet (complex) | API design, database schema, scalability guidance | | 🚨 incident-coordinator | Sonnet (complex) | Production incident response, runbooks, postmortems | | ⚡ performance-analyst | Sonnet (complex) | Bundle analysis, Core Web Vitals, systematic optimization | | 🎯 full-stack-orchestrator | Sonnet (complex) | End-to-end feature coordination (frontend → backend → tests) | | 🤖 code-review-orchestrator | Haiku (fast) | Runs 5 agents in parallel for 30-second comprehensive review |

⚙️ Configuration Presets

Choose the preset that matches your project type:

🚀 Startup - Ship fast, iterate faster

cp config/presets/startup.json .claude/config.json

Settings:

• ✅ Test coverage: 70% (pragmatic)
• ✅ Min PRD grade: C (good enough)
• ✅ Review dimensions: 5 (essentials only)
• ✅ Parallel features: 2 (small team)
• ✅ Auto-scan: On PR only (don't slow down development)

Best for: MVPs, prototypes, fast iteration

🏢 Enterprise - Production-grade quality

cp config/presets/enterprise.json .claude/config.json

Settings:

• ✅ Test coverage: 90% (strict)
• ✅ Min PRD grade: B (high quality)
• ✅ Review dimensions: 10 (comprehensive - includes Compliance, Security, Performance)
• ✅ Parallel features: 5 (larger team)
• ✅ Auto-scan: On every commit (catch early)
• ✅ Fine-grained tasks (40-50 tasks per PRD)
• ✅ SOX/PCI-DSS compliance tracking

Best for: Production systems, regulated industries, large teams

🌍 Open Source - Community-driven

cp config/presets/open-source.json .claude/config.json

Settings:

• ✅ PRD ID format: RFC-{number} (community standard)
• ✅ Work plan: ROADMAP.md (public transparency)
• ✅ Labels: help-wanted, good-first-issue (contributor-friendly)
• ✅ Auto-assign: Off (community picks tasks)
• ✅ No notifications (avoid spam)

Best for: Open source projects, community contributions

🎨 Custom - Build your own

Start with a preset, then customize:

cp config/presets/startup.json .claude/config.json
# Edit .claude/config.json to your needs

Full configuration reference →

🎓 Complete Command Reference

| Command | Purpose | Example Usage | |---------|---------|---------------| | Core Workflow ||| | /create-prd | Create new PRD from template | Start any new feature | | /review-prd | AI-powered 7D review + grading | Before approval | | /setup-prd | Create branch + worktree (dev setup) | Ready to implement | | /code-prd | Guided task-by-task implementation | During development | | /list-prds | Show all PRDs with status | Check progress | | /archive-prd | Archive completed/cancelled PRDs | Cleanup | | Quality & Security ||| | /security-audit | Scan dependencies, code, secrets, OWASP | Before PR | | /quality-check | Linting, tests, coverage, complexity | Before PR | | Orchestration ||| | /orchestrate | Multi-PRD coordination & dependencies | Managing 3+ PRDs |

Detailed command docs →

📚 Documentation

Getting Started

• 📖 Complete Guide - Everything in one place (Quick Start, Commands, Agents, Config, Troubleshooting)
• 🎯 Real-World Examples - Startup, Enterprise, Microservices, Open Source setups

🏗️ Advanced Features

Parallel Development with Git Worktrees

Work on 5+ features simultaneously without branch switching:

/setup-prd  # PRD-001 → ../project-auth/
/setup-prd  # PRD-002 → ../project-dashboard/
/setup-prd  # PRD-003 → ../project-billing/

# Each feature has its own:
# - Isolated workspace
# - Installed dependencies
# - No merge conflicts
# - Instant context switching

Time saved: 2-3 hours/day on context switching

Multi-PRD Orchestration

Managing 10+ PRDs? /orchestrate shows:

• 📊 Dependency graph - What blocks what
• 🎯 Critical path - Bottlenecks highlighted
• 👥 Resource allocation - Team capacity planning
• ⏰ Timeline prediction - When features ship

Example output:

🎯 Critical Path: PRD-001 → PRD-003 → PRD-005 (7 weeks)
🔴 Blocked: PRD-004, PRD-006 (waiting for PRD-003)
✅ Ready: PRD-002, PRD-007 (no blockers)
⚠️ Bottleneck: Backend team at 120% capacity

GitHub Integration

Automatic issue creation when PRD approved:

{
  "prd_workflow": {
    "github": {
      "enabled": true,
      "create_issue_on_approval": true,
      "issue_labels": ["feature", "P0", "PRD-001"],
      "auto_assign": true,
      "milestone_tracking": true
    }
  }
}

Result: Every approved PRD = GitHub issue with:

• Full PRD content
• Acceptance criteria checklist
• Dependencies linked
• Auto-assigned to team

Automated Quality Gates

Security Audit (/security-audit):

• ✅ npm/yarn audit (dependency vulnerabilities)
• ✅ ESLint security plugin
• ✅ git-secrets (no credentials committed)
• ✅ OWASP Top 10 checks
• ✅ Snyk/Trivy (container scanning)

Quality Check (/quality-check):

• ✅ Linting (ESLint/Prettier)
• ✅ Type checking (TypeScript)
• ✅ Test coverage (80-90% threshold)
• ✅ Code complexity (max 10)
• ✅ Bundle size analysis
• ✅ Performance budgets

Both run in <30 seconds and block PR merge if failing.

🤝 Contributing

We welcome contributions! Here's how:

Quick Start

1. Fork the repo
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Test thoroughly
5. Submit a PR

Guidelines

• Follow the existing code style
• Add tests for new features
• Update documentation
• Keep PRs focused (one feature per PR)

Full contributing guide →

Development Setup

git clone https://github.com/Yassinello/claude-prd-workflow.git
cd claude-prd-workflow
npm install  # if you're adding JS/TS features

🆘 Support & Community

Get Help

• 💬 GitHub Discussions - Ask questions
• 🐛 GitHub Issues - Report bugs

Report Issues

Use our issue templates:

• 🐛 Bug Report
• ✨ Feature Request
• ⚙️ Configuration Help
• 📚 Documentation Issue

🗺️ Roadmap

v1.1 (Next Month)

• [ ] Video tutorials
• [ ] VS Code snippets
• [ ] Interactive playground
• [ ] /clone-prd command (duplicate PRDs)
• [ ] /split-prd command (split large PRDs)

v1.2 (Q1 2026) - MCP Integration 🔌

Core MCP Support:

• [ ] MCP server integration framework
• [ ] Configuration schema for MCP servers

Optional MCP Integrations:

• [ ] Context7 - Fetch up-to-date library documentation
• [ ] GitHub MCP - Enhanced GitHub operations (PR reviews, issue sync)
• [ ] Memory MCP - Persistent knowledge graph for PRD relationships
• [ ] Puppeteer MCP - Automated testing & screenshots
• [ ] Brevo MCP - Email notifications & marketing automation

New Features:

• [ ] Jira/Linear/Notion integrations
• [ ] Analytics dashboard (/prd-metrics)
• [ ] AI-generated PRDs from notes
• [ ] Smart dependency detection

v2.0 (Q2 2026)

• [ ] Real-time collaboration
• [ ] Approval workflows
• [ ] Gantt chart visualization
• [ ] Team capacity planning
• [ ] Custom MCP server: @claude-prd/analytics-mcp
• [ ] Custom MCP server: @claude-prd/integrations-mcp

Full roadmap →

📜 License

MIT License - Free for commercial and open source use.

Copyright © 2025 Yassine Hamou-Tahra

See LICENSE for details.

🙏 Acknowledgments

Built with:

• Claude Code - AI-powered development
• Git - Version control & worktrees
• Inspired by Shape Up methodology

Special thanks to the Claude Code team for creating an amazing platform!

🏪 Plugin Distribution & Marketplaces

This plugin is available through multiple distribution channels:

Official Distribution Channels

1. npm Registry (Recommended for automation)

npm install -g claude-prd-workflow

• ✅ Automatic updates with npm update -g
• ✅ Version pinning support
• ✅ Works with CI/CD pipelines

2. Claude Code Marketplace (Native integration)

/plugin marketplace add Yassinello/claude-prd-workflow
/plugin install claude-prd-workflow

• ✅ Direct Claude Code integration
• ✅ Discover updates within Claude Code
• ✅ Marketplace-based distribution

3. Community Marketplaces

Submit this plugin to popular Claude Code marketplaces:

• claudecodemarketplace.com - Largest community marketplace
• claudemarketplaces.com - Marketplace directory

For Developers: Creating Your Own Marketplace

This repository includes a .claude-plugin/marketplace.json file that makes it a valid Claude Code marketplace. You can:

1. Fork this repo to customize for your organization
2. Add it as a marketplace: /plugin marketplace add your-org/your-fork
3. Share with your team via company documentation

See the Plugin Marketplaces documentation for more details.

⭐ Show Your Support

If PRD Workflow Manager helps you ship faster, please:

• ⭐ Star this repo
• 📝 Write a blog post
• 💬 Tell your team

Every star motivates us to keep improving! 🚀

📈 Stats

Built with ❤️ for the Claude Code community

Documentation • Examples • Contributing • License

Made by @Yassinello | Powered by Claude Code 🤖