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

KILL - Should this even exist?
SKIP - Can we wait 3 months?
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:

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:

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

Time: 15 minutes (vs 2 hours manual review)

3. Start Development

/code-prd

What happens:

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

You're now coding in a clean workspace!

4. Guided Implementation

/work-prd

What happens:

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)
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)
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

Fork the repo
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes
Test thoroughly
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:

🗺️ Roadmap

v1.1 (Next Month)

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.

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:

Fork this repo to customize for your organization
Add it as a marketplace: /plugin marketplace add your-org/your-fork
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 🤖

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
.claude		.claude
.github		.github
.husky		.husky
.prds/thoughts		.prds/thoughts
bin		bin
dev		dev
docs		docs
mcp		mcp
product/templates		product/templates
.editorconfig		.editorconfig
.gitignore		.gitignore
.markdownlint.json		.markdownlint.json
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
SESSION_CONTENT.md		SESSION_CONTENT.md
SPRINT-SUMMARY.md		SPRINT-SUMMARY.md
TROUBLESHOOTING.md		TROUBLESHOOTING.md
install.js		install.js
package.json		package.json

License

yadri-lab/claude-plugin-prd-workflow

Folders and files

Latest commit

History

Repository files navigation

📋 PRD Workflow Manager

🎯 Why PRD Workflow Manager?

The Problem 😫

The Solution ✨

✨ Key Features

🆕 What's New in v0.3.1

🚦 Review Gate - Stop Bad Ideas in 30 Seconds

🤖 Agent Orchestration - One Command, Full Analysis

⚙️ Worktree Health Checks - No More Cryptic Errors

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

🔍 AI-Powered PRD Review

⚡ Daily Development Tools (v2.3)

🎯 Intelligent Developer Experience (NEW in v2.4)

🌳 Git Worktree Orchestration

👨‍💻 Guided Implementation

🔒 Automated Security & Quality

🎼 Multi-PRD Orchestration

📊 Progress Tracking

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

🎯 How It Works: Two Workflow Modes

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

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

📊 Which Mode to Choose?

🚀 Installation (2 minutes)

Prerequisites

Step 1: Install the Plugin Globally (One Time)

🔓 Optional: Ultra-Permissive Permissions (Highly Recommended)

Automatic (Recommended)

Manual Setup

Step 2: Verify Installation

Step 3: Using in an Existing Project

🔄 Keeping the Plugin Updated

Update to Latest Version

Check for Updates

Update to Latest Version

Update Notifications

Version Compatibility

⚡ Quick Start - Real Example: Building MCP Server Prioritization

1. Create Your First PRD

2. Review Your PRD

3. Start Development

4. Guided Implementation

5. Quality Gates

6. Ship It!

🔧 How It Works

The Complete Workflow

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

⚙️ Configuration Presets

🚀 Startup - Ship fast, iterate faster

🏢 Enterprise - Production-grade quality

🌍 Open Source - Community-driven

🎨 Custom - Build your own

🎓 Complete Command Reference

📚 Documentation

Getting Started

🏗️ Advanced Features

Parallel Development with Git Worktrees

Multi-PRD Orchestration

GitHub Integration

Automated Quality Gates

🤝 Contributing

Quick Start

Guidelines

Development Setup

🆘 Support & Community

Get Help

Report Issues

🗺️ Roadmap

v1.1 (Next Month)

v1.2 (Q1 2026) - MCP Integration 🔌

v2.0 (Q2 2026)

📜 License

🙏 Acknowledgments

🏪 Plugin Distribution & Marketplaces

Packages