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.
One-page map of Cursor spec commands (.cursor/commands/specs/). Full narrative: 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 deferredaudit-spec-completion — legacy alias removed; use spec-complete (see SPEC_COMPLETION_TRACKING.md)
Last Updated: 2026-05-09
