/spec-plan

Plan Cascade - Spec Plan (Interview)

Start (or resume) a Specification Interview and generate:

• spec.json (structured spec)
• spec.md (human-readable spec)
• .state/spec-interview.json (resume state)

Optionally compile spec.json → prd.json.

Step 1: Parse Arguments

Parse:

• <desc>: required description
• --output-dir <dir>: optional (default: current directory)
• --flow <quick|standard|full>: optional (default: standard)
• --first-principles: optional
• --max-questions N: optional (default: 18)
• --feature-slug <slug>: optional (useful for Mega features)
• --compile: optional (also run compile after interview)
• --tdd <off|on|auto>: optional (only used with --compile)
• --confirm / --no-confirm: optional (only used with --compile, --no-confirm wins)

Step 2: Run Interview (CLI)

Run:

uv run --project "${CLAUDE_PLUGIN_ROOT}" plan-cascade spec plan "<desc>" \
  --output-dir "<output-dir>" \
  --flow <flow> \
  --mode on \
  --max-questions <N> \
  --feature-slug "<slug>" \
  $( [ "<first-principles>" = true ] && echo "--first-principles" )

Step 3 (Optional): Compile to PRD

If --compile:

uv run --project "${CLAUDE_PLUGIN_ROOT}" plan-cascade spec compile \
  --output-dir "<output-dir>" \
  --flow <flow> \
  --tdd <tdd> \
  $( [ "<no-confirm>" = true ] && echo "--no-confirm" || true ) \
  $( [ "<confirm>" = true ] && echo "--confirm" || true )

Output Files

• spec.json
• spec.md
• .state/spec-interview.json
• prd.json (if --compile)