Future Enhancements
Roadmap
| ID | Title | Status | Target Date |
|---|---|---|---|
| vitepress-docs | VitePress docs integration | shipped | 2026-06-22 |
| review-quality-markdown | Review-quality feature markdown | shipped | 2026-06-22 |
| empty-section-suppression | Suppress empty sections in generated docs | shipped | 2026-06-22 |
| roles-schema | Roles field in system schema | shipped | 2026-06-22 |
| adr-schema-enrichment | ADR schema enrichment | shipped | 2026-06-22 |
| roadmap-improvements | Roadmap with feature links and delivery tracking | shipped | — |
| config-outputs | Configurable output paths | shipped | — |
| help-reference-expansion | Help docs reference expansion | shipped | — |
| agent-authoring-tools | MCP write tools | shipped | — |
| rules-file-generation | Tool-specific rules files | shipped | — |
| marketing-site | Marketing site | planned | — |
| user-docs-composition | User docs composed from personas and journeys | shipped | — |
| rules-files-generator | Tool-specific rules files generator | shipped | — |
| docs-split-generator | Help vs developer docs split | shipped | — |
| help-reference-generator | Help docs reference expansion | shipped | — |
| mcp-write-tools | MCP write tools (spec authoring) | shipped | — |
| consumer-blocker-fixes | Consumer integration fixes (config validation, CI gate, help docs, MCP merge) | shipped | — |
| package-universal-docs | Universal onboarding docs shipped in the npm package | shipped | — |
| docs-ia-restructure | Docs sidebar information architecture restructure | in-progress | — |
| help-docs-filter-deprecation | Deprecate subtraction-based help docs for feature pages | in-progress | — |
Upcoming Items
Marketing site [planned]
Next.js + shadcn landing page at usm.dev with spec-first workflow story
Docs sidebar information architecture restructure [in-progress]
Single-level sidebar nesting that VitePress renders correctly; unique human labels; dedicated Reference group; Architecture naming; help docs reduced to user-journey content; roadmap kept current
Deprecate subtraction-based help docs for feature pages [in-progress]
Feature pages in --audience help switch to composed content; subtraction filter retained for system-level pages during one transition cycle. Progressed by usm/docs-ia-restructure: help tree now excludes feature build specs entirely and surfaces composed persona guides instead.