> ## Documentation Index > Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt > Use this file to discover all available pages before exploring further. # Spec Command Cheat Sheet > One-page map of Cursor spec commands (.cursor/commands/specs/). Full narrative: SPEC_WORKFLOW.md. Navigate without memorizing: whats-next --spec {CORE-##}. One-page map of **Cursor spec commands** (`.cursor/commands/specs/`). Full narrative: [SPEC\_WORKFLOW.md](SPEC_WORKFLOW.md). **Navigate without memorizing:** `whats-next --spec {CORE-##}`. *** ## Tier 1 — Core workflow (use every feature) | I want to… | Run | Notes | | ---------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------- | | Check prior art before creating specs | `npm run spec -- precedent --core {core} --topic "{feature}"` | Searches active + archived specs, registry, deferred dashboard | | Start a new spec | `create-spec --core {core} --name {slug}` | Output: `specs/{core}/specs/{CORE}-##-{slug}.md` | | Fix placeholders / ambiguities | `clarify-spec --spec {CORE-##}` | Before planning if TODOs remain | | Structure + constitution + optional plan | `validate-spec --file specs/{core}/specs/{CORE}-##-….md --auto-fix --auto-plan` | Run before spec-reviewer | | Know the single next step | `whats-next --spec {CORE-##}` | Uses artifacts + session state | | Break work into tasks | `generate-tasks --spec {CORE-##}` | After review; reads `*-CONTEXT.md` if present | | Finish the feature | `spec-complete --spec {CORE-##}` | Registry, logs, deferred checks — see command doc | *** ## Tier 2 — Quality gates (use when workflow or risk demands) | I want to… | Run | Notes | | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | Deep implementability + overlap | **spec-reviewer** agent or `spec-review` | **Required** before tasks for regulated cores (CL, PM, HR, RH, GR, FA, IT, CE) | | UX/spec UI checklist only | `review-ux --spec {CORE-##}` or spec-reviewer **UX focus** | Optional; see `review-ux` command | | Heuristic overlap scan (tables/paths) | `spec-landscape --spec {CORE-##}` | Read-only; before or with review | | Lock UI/API choices before tasks | `discuss-implementation --spec {CORE-##}` | Writes `specs/{core}/specs/{CORE}-##-CONTEXT.md` | | Validate / create plan | `validate-plan --spec {CORE-##}` / `create-plan --spec {CORE-##}` | When plan exists or score ≥ 4 | | Full canonical one-shot pipeline (resolve/create → validate → clarify → review → tasks) | `spec-pipeline {CORE-##}` or `spec-pipeline --spec {CORE-##}` (or `--create --core {core} --name {slug}`) | Bare IDs normalize, e.g. `/spec-pipeline hr-42` → `--spec HR-42`; includes optional UX and implementation discussion steps | | One-shot validate + plan (+ optional tasks) | `prepare-spec --spec {CORE-##}` | Does not replace clarify-spec or spec-reviewer | | Verify a task | `verify-task --spec {CORE-##} T{N}` | After implementation | *** ## Tier 3 — Specialized (domain or artifact type) | I want to… | Run | Notes | | ------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | | Wizard UX spec | `create-wizard-spec` / `create-spec --type wizard` | Under `specs/{core}/ux/` | | **Full wizard pipeline** (create → validate → review → tasks) | `wizard-spec-pipeline --spec {CORE-UX-##}` | End-to-end autonomous; see command doc | | Validate wizard spec | `validate-spec --file … --type wizard` | **Not** `validate-wizard-spec` | | Score specs for wizard candidacy | `recommend-wizards` | Prioritization | | Audit wizard specs vs template | `audit-wizard-specs` | Quality band | | Deferred enhancements | `spec deferred --list` / `--sync` / `--promote` | `specs/DEFERRED_DASHBOARD.md` | | Promote deferred phase | `create-expansion` | Expansion markdown | | CL/PM research bundle | `research-ehr-pm-requirements`, `plan-ehr-pm-module` | EHR/PM planning | | Module strategy | `deep-module-review --core {core}` | Quarterly / pre-kickoff | | Cross-module spec recommendations | `recommend-module-specs --core {core} --cross-module all [--research]` | Full module review + peer-core comparative scan + external research → new + enhanced spec recommendations | | Integration gap report | `research-module-integration-gaps --core {core}` | Events/APIs vs code | | Tests from spec | `generate-test-suite` | Scaffolds per command doc | | UAT cases | `generate-uat-test-cases` | User-story based | | Archive completed spec files | `eos-spec archive` | Moves spec/plan/tasks to `specs/{core}/archive/`; `--status complete` also matches `Implemented` | *** ## Tier 4 — Operational / inventory | I want to… | Run | Notes | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | | List specs | `list-specs --core {core}` | Optional `--json` | | Include archived specs in CLI list/status | `npm run spec -- list --core {core} --include-archived` / `npm run spec -- status --core {core} --include-archived` | Adds `🗄️` rows from `specs/{core}/archive/` | | Read-only status | `spec-status --spec {CORE-##}` | No writes | | Backfill canonical issue line | `backfill-core-canonical-issues --core {core}` | Spec file metadata | | Issue / project sync | `review-module-issue-sync` | See command + `SPEC_TRACKING_TRIAGE.md` | *** ## Deprecated / do not use * `promote-deferred`, `sync-deferred-summary` — legacy aliases removed; use **`spec deferred`** * `audit-spec-completion` — legacy alias removed; use **`spec-complete`** (see [SPEC\_COMPLETION\_TRACKING.md](SPEC_COMPLETION_TRACKING.md)) *** **Last Updated:** 2026-05-09