Skip to content

Commit 0bfe1d4

Browse files
authored
docs: rewrite customization guide to document schema commands (#582)
* docs: rewrite customization guide to document schema commands The old guide described a painful manual process for schema customization (mkdir, npm list, cp commands) and even listed "No scaffolding" as a limitation. But the `openspec schema` commands have existed for a while: - `schema fork` - copy existing schema to customize - `schema init` - create new schema from scratch - `schema validate` - check schema structure - `schema which` - debug resolution precedence Rewrote the guide to: - Lead with the actual CLI commands instead of manual steps - Remove the misleading "Current Limitations" section - Add practical examples (TDD workflow, adding review artifact) - Structure progressively: config → custom schemas → global overrides * docs: add language tags to code blocks in customization guide Address review feedback from CodeRabbit: - Add 'text' language tag to directory tree code blocks - Satisfies MD040 markdown lint rule
1 parent 0e6f42c commit 0bfe1d4

File tree

2 files changed

+235
-79
lines changed

2 files changed

+235
-79
lines changed

docs/cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -745,7 +745,7 @@ spec-driven resolves from: package
745745
**Schema precedence:**
746746

747747
1. Project: `openspec/schemas/<name>/`
748-
2. User: `~/.openspec/schemas/<name>/`
748+
2. User: `~/.local/share/openspec/schemas/<name>/`
749749
3. Package: Built-in schemas
750750

751751
---

0 commit comments

Comments
 (0)