prd-pipeline

Overview

Orchestrates a PRD-to-production pipeline by composing existing pixl-crew skills across multiple sessions. Each phase persists state to a pipeline state file so the next session can resume without replanning. The session-start.sh hook auto-injects prior session summaries and decisions on restart.

A scope guard hook (prd-pipeline-scope-guard) activates automatically when pipeline-state.json is present — it blocks accidental writes to critical infrastructure files (CI workflows, .env, Makefile, docker-compose, package manifests, CLAUDE.md) during autonomous execution. Set PIXL_PIPELINE_BYPASS=1 to override.

Mode Detection

Input	pipeline-state.json exists?	Mode
File path or URL	No	Init — start new pipeline
File path or URL	Yes	Reset — restart pipeline with new PRD
resume or no argument	Yes	Resume — continue from last phase
No argument	No	Error — ask for PRD path

Pipeline State

Track progress in a pipeline-state.json file committed alongside the project:

{
  "version": "1.0",
  "started_at": "ISO timestamp",
  "updated_at": "ISO timestamp",
  "prd_source": "<path to canonical PRD>",
  "current_phase": "planning",
  "phases": {
    "setup": { "status": "completed", "started_at": "...", "completed_at": "..." },
    "planning": { "status": "in_progress", "started_at": "..." },
    "foundation": { "status": "pending" },
    "implementation": { "status": "pending" },
    "quality": { "status": "pending" },
    "delivery": { "status": "pending" },
    "finalization": { "status": "pending" }
  },
  "sprints_completed": 0,
  "total_sprints": 4,
  "coverage_percentage": 0.0,
  "branch": "feat/prd-implementation"
}

Phases

Phase 0: Setup

Goal: Bootstrap the pipeline workspace and verify the project is buildable and testable. Inputs: PRD file path or URL. Outputs: Canonical PRD stored in the project context directory, pipeline-state.json initialized, test command verified. Constraints: PRD must be readable before proceeding. The project must have a discoverable test command. Suggest scoped permission wildcards via AskUserQuestion if none are configured.