yassinello

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. [](https://www.npmjs.com/package/claude-prd-workflow) [](https://www.npmjs.com/package/claude-prd-workflow) [](https://github.com/Yassinello/claude-prd-workflow/releases) [](LICENSE) [](https://claude.com/claude-code) [](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**:  --- ## ⚡ 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    --- <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>