pi-blueprint

A Pi extension that turns high-level objectives into phased, multi-session construction plans with dependency tracking and verification gates.

Installation

pi install npm:pi-blueprint

Commands

Command	Description
/blueprint <objective>	Generate a phased plan from an objective
/blueprint abandon	Abandon the active blueprint
/plan-status	Show detailed progress with completion percentage
/plan-verify	Run verification gates for the current phase
/plan-next	Get and start the next actionable task

LLM Tools

Tool	Description
blueprint_create	Create a new blueprint from structured phases
blueprint_status	Get current plan progress
blueprint_update	Mark tasks as completed, in_progress, or skipped
blueprint_next	Get the next actionable task

How It Works

1. Run /blueprint "Add OAuth2 authentication" to start
2. The LLM generates a phased plan with tasks, dependencies, and verification gates
3. On each session start, the active blueprint context is injected into the system prompt
4. Use /plan-next to work through tasks sequentially
5. Use /plan-verify to run phase verification gates (tests, typecheck) before advancing
6. Progress persists across sessions in ~/.pi/blueprints/

Storage

~/.pi/blueprints/
  index.json              # Active blueprint pointer
  <blueprint-id>/
    plan.md               # Human-readable plan (auto-generated)
    state.json            # Machine-readable state (source of truth)
    history.jsonl          # Audit log of state transitions
    sessions.json          # Session-to-task mapping

Features

• Phased execution: Work is decomposed into ordered phases with verification gates
• Dependency tracking: Tasks declare dependencies; blocked tasks are surfaced automatically
• Verification gates: Tests, type-check, user approval, or custom commands gate phase advancement
• Multi-session persistence: Plan state survives session restarts with context injection
• Cycle detection: Dependency cycles are rejected at blueprint creation time