blueprint

Blueprint — Frontend Spec Pipeline

Extract a complete specs/ directory from any frontend codebase. Covers all 12 axes needed to rebuild or migrate a frontend app. Produces ~80% quality on first pass, refined to ~95% through guided iteration.

Input: $ARGUMENTS = <command> [options]

Commands:

• discover — Scan codebase, create specs/_pipeline.md
• scope — Interactive: select views and axes to spec
• extract [--view <name>] [--axis <name>] — Extract specs (all, or resume one)
• incorporate [--dir <path>] — Analyze screenshots against visual specs
• refine [--fix <RF-NN>] — Quality audit, generate checklist
• finalize — Cross-references, known-gaps, rebuild-readiness
• run — Auto-advance state machine through all phases

Examples:

• /blueprint run — full pipeline from scratch (pauses at scope)
• /blueprint discover — scan only, create _pipeline.md
• /blueprint scope — select views interactively
• /blueprint extract — extract all pending axes
• /blueprint extract --view home — re-extract one view's functional spec
• /blueprint extract --axis types — re-extract just the types axis
• /blueprint incorporate — analyze screenshots in specs/baseline/
• /blueprint refine — run quality audit
• /blueprint refine --fix RF-03 — address one checklist item
• /blueprint finalize — generate cross-refs + meta docs

---

Phase 0: Parse $ARGUMENTS

Read $ARGUMENTS. The first token is the command. Parse as follows:

If $ARGUMENTS is empty or missing:
  → Print usage help (command list + examples above) and stop.

Commands:
  discover    → Jump to Phase 1
  scope       → Jump to Phase 2
  extract     → Jump to Phase 3
    Flags: --view <name>  (extract only the named view's functional + visual specs)
           --axis <name>  (extract only the named axis)
  incorporate → Jump to Phase 4
    Flags: --dir <path>  (custom screenshot directory; default: specs/baseline/)
  refine      → Jump to Phase 5
    Flags: --fix <RF-NN>  (address a specific checklist item only)
  finalize    → Jump to Phase 6
  run         → Jump to Orchestrator

Unknown command:
  → Print "Unknown command: {token}. Valid commands: run, discover, scope, extract, incorporate, refine, finalize." and stop.