Skip to content

/ux-review

Role: UX reviewer Pipeline position: fortress

Developer-experience review of CLI ergonomics, docs, and onboarding.

Canonical invocation

/ux-review

With arguments:

/ux-review [path/to/plan-suite/] [phase-id] [--dry-run]

Inputs

Host repository at any lifecycle state

Outputs

UX findings + REPORT.md

Downstream

Phase 20 of the review fortress

Workflow phases

The command follows the standard /plan-* pipeline workflow:

  1. Load context — Read plan suite, rules, and Resumption Contract.
  2. Verify prerequisites — Confirm dependency phases complete.
  3. Execute tasks — Perform the command mission.
  4. Verify outputs — Confirm all declared outputs exist and pass quality gates.
  5. Update PROGRESS.md — Record verified outputs in the Phase Output Registry.
  6. Emit REPORT.md — Pre-emission gate attestation recorded.

Failure modes

Symptom Cause Recovery
Prerequisite incomplete Dependent phase not finished Complete upstream phase first
Quality gate FAIL Output does not meet standards Fix the output and re-run
Missing input file Plan suite file absent Run /plan-generate to create it

Examples

# Dry-run to preview what would happen
/ux-review --dry-run

# Execute against a named plan suite
/ux-review path/to/plan-suite/

Cross-references