# 📋 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.

[![npm version](https://img.shields.io/npm/v/claude-prd-workflow.svg)](https://www.npmjs.com/package/claude-prd-workflow)
[![npm downloads](https://img.shields.io/npm/dm/claude-prd-workflow.svg)](https://www.npmjs.com/package/claude-prd-workflow)
[![GitHub release](https://img.shields.io/github/v/release/Yassinello/claude-prd-workflow.svg)](https://github.com/Yassinello/claude-prd-workflow/releases)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-2.0%2B-purple.svg)](https://claude.com/claude-code)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

---

## 🎯 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**
```bash
/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

```bash
# 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

```bash
/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](https://claude.com/claude-code) v2.0 or higher
- [Git](https://git-scm.com/) 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)
```bash
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)
```bash
# 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)
```bash
# 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)
```bash
# 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:

```bash
# 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 →](.claude/PERMISSIONS.md)

### 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**
```bash
cd ~/.claude-code/plugins/claude-prd-workflow
node bin/check-health.js
```

✅ **Success**: All systems operational
❌ **Error**: Issues detected

**If Issues Detected**:
```bash
# 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:

```bash
# 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:
```bash
# 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)
```bash
/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)
```bash
cd ~/.claude-code/plugins/claude-prd-workflow
git pull origin main
node install.js
# Restart Claude Code
```

**Option C: Reinstall** (npm-based installations)
```bash
npm install -g claude-prd-workflow@latest
# Restart Claude Code
```

### Check for Updates

```bash
# 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

```bash
# 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](https://github.com/Yassinello/claude-prd-workflow/releases)
- [npm Package Page](https://www.npmjs.com/package/claude-prd-workflow)
- [CHANGELOG.md](CHANGELOG.md)

### Version Compatibility

The plugin follows [Semantic Versioning](https://semver.org/):
- **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**: ![npm version](https://img.shields.io/npm/v/claude-prd-workflow.svg)

---

## ⚡ 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

```mermaid
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
```bash
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
```bash
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
```bash
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:

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

[Full configuration reference →](docs/configuration.md)

---

## 🎓 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 →](docs/commands-reference.md)

---

## 📚 Documentation

### Getting Started
- 📖 **[Complete Guide](docs/guide.md)** - Everything in one place (Quick Start, Commands, Agents, Config, Troubleshooting)
- 🎯 **[Real-World Examples](docs/examples.md)** - Startup, Enterprise, Microservices, Open Source setups

---

## 🏗️ Advanced Features

### Parallel Development with Git Worktrees

Work on **5+ features simultaneously** without branch switching:

```bash
/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:

```json
{
  "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 →](CONTRIBUTING.md)

### Development Setup
```bash
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](https://github.com/Yassinello/claude-prd-workflow/discussions) - Ask questions
- 🐛 [GitHub Issues](https://github.com/Yassinello/claude-prd-workflow/issues) - Report bugs

### Report Issues
Use our issue templates:
- [🐛 Bug Report](.github/ISSUE_TEMPLATE/bug_report.yml)
- [✨ Feature Request](.github/ISSUE_TEMPLATE/feature_request.yml)
- [⚙️ Configuration Help](.github/ISSUE_TEMPLATE/configuration_help.yml)
- [📚 Documentation Issue](.github/ISSUE_TEMPLATE/documentation.yml)

---

## 🗺️ 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 →](https://github.com/Yassinello/claude-prd-workflow/projects/1)

---

## 📜 License

**MIT License** - Free for commercial and open source use.

Copyright © 2025 [Yassine Hamou-Tahra](https://github.com/Yassinello)

See [LICENSE](LICENSE) for details.

---

## 🙏 Acknowledgments

Built with:
- [Claude Code](https://claude.com/claude-code) - AI-powered development
- [Git](https://git-scm.com/) - Version control & worktrees
- Inspired by [Shape Up](https://basecamp.com/shapeup) 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)
```bash
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)
```bash
/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](https://claudecodemarketplace.com/) - Largest community marketplace
- [claudemarketplaces.com](https://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](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces) 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

![GitHub stars](https://img.shields.io/github/stars/Yassinello/claude-prd-workflow?style=social)
![GitHub forks](https://img.shields.io/github/forks/Yassinello/claude-prd-workflow?style=social)
![GitHub watchers](https://img.shields.io/github/watchers/Yassinello/claude-prd-workflow?style=social)

---

<div align="center">

**Built with ❤️ for the Claude Code community**

[Documentation](docs/) • [Examples](docs/examples/) • [Contributing](CONTRIBUTING.md) • [License](LICENSE)

Made by [@Yassinello](https://github.com/Yassinello) | Powered by Claude Code 🤖

</div>