claude-plugin-prd-workflow

📋 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: