prd2impl

prd2impl

PRD-to-Implementation pipeline for Claude Code. A 14-skill plugin that takes you from a Product Requirements Document (or existing hand-written docs) through gap analysis, task generation, execution planning, parallel batch dispatch, full-autopilot execution, and all the way to milestone verification.

🇨🇳 中文用户: 完整的中文使用手册（含新项目接入 / 多人协同分工 / 典型工作流 / FAQ）见 docs/guide-zh.md。

Installation

Via marketplace (recommended)

# 1. Add the ezagent42 marketplace (one-time)
/plugin marketplace add ezagent42/ezagent42

# 2. Install prd2impl
/plugin install prd2impl@ezagent42

Via Claude Code settings (manual)

If you've cloned this repo locally, add to your project's .claude/settings.json:

{
  "plugins": [
    "/path/to/prd2impl"
  ]
}

Companion plugins

prd2impl delegates testing and methodology to two optional companions (both available on the same marketplace). Install them for the full pipeline; without them, prd2impl degrades gracefully to simpler paths.

/plugin install dev-loop-skills@ezagent42   # test pipeline (eval / plan / code / run / registry)
/plugin install superpowers                 # brainstorming, TDD, debugging, code review

References

• references/mock-policy.md — Mock policy consumed by task-gen, start-task, continue-task, and batch-dispatch. Defines what may / must-not be mocked and the contract-test pattern that catches the cdcfdb2 bug class. Project-specific overrides can live at {plans_dir}/mock-policy.local.md.

Verify installation

After installing, the following skills should appear in /help:

prd2impl:ingest-docs        — Ingest human-authored MDs (Entry B)
prd2impl:prd-analyze       — Structured PRD extraction (Entry A)
prd2impl:gap-scan           — Codebase vs PRD gap analysis
prd2impl:task-gen           — Task generation with dependencies
prd2impl:plan-schedule      — Execution plan & batch scheduling
prd2impl:start-task         — Launch a task into dev-loop
prd2impl:continue-task      — Resume task at next checkpoint
prd2impl:next-task          — Recommend next executable task
prd2impl:batch-dispatch     — Parallel agent dispatch for a batch
prd2impl:task-status        — Progress dashboard
prd2impl:smoke-test         — Milestone gate verification
prd2impl:retro              — Milestone retrospective
prd2impl:contract-check     — Contract drift detection
prd2impl:autorun            — Full-autopilot orchestrator

Quick Start

Entry A — New project from a PRD document

/prd-analyze docs/prd/my-prd.md    # Step 1: Parse PRD → structured YAML
/gap-scan                           # Step 2: Scan code vs requirements
/task-gen                           # Step 3: Generate task breakdown
/plan-schedule                      # Step 4: Create execution plan

Entry B — Project already has hand-written docs

Use this when you already have gap analyses, design specs, or plans in Markdown. Entry A and Entry B are mutually exclusive — pick one per project.

/ingest-docs gap.md design-spec.md plan.md
                                    # Step 1: Classify + extract → 3 YAMLs
                                    #   prd-structure.yaml
                                    #   gap-analysis.yaml
                                    #   task-hints.yaml  (preserves file-change granularity)
/task-gen                           # Step 2: Generate tasks (reads task-hints.yaml automatically)
/plan-schedule                      # Step 3: Create execution plan

Force a role when auto-detection is uncertain:

/ingest-docs a.md b.md --tag design-spec=a.md --tag gap=b.md

Each step has a human review checkpoint — the pipeline pauses and waits for your approval before advancing.

Daily development

/next-task                          # What should I work on?
/start-task T1A.1                   # Start a specific task
/continue-task T1A.1                # Resume after review
/task-status                        # Overall progress dashboard

Batch operations

/batch-dispatch batch-3             # Launch batch in parallel
/batch-dispatch T1A.3,T1A.6,T1A.7  # Launch specific tasks

Milestone gates

/smoke-test M1                      # Verify milestone
/retro M1                           # Retrospective analysis
/contract-check                     # Check interface drift

Pipeline Overview