| name | release-docs |
| description | Keep guide, site, skill, llms.txt, and CHANGELOG in sync after spec or CLI surface changes. |
Release docs sync
When specs/**, CLI flags, key placement, or user-facing error catalog change:
- Schema registry — if keys changed, update
src/ods-core/src/spec/schema.rs in the same change set
1b. Error catalog — if CLI/lifecycle messages changed: src/ods-core/src/error/messages.rs + docs/guide/07-troubleshooting-and-diagnostics.md + skill error directive
- Specs —
specs/{ods,okf,skills}/ consistent indexes
- Guide —
docs/guide/* links and summaries (no forked key rules)
- Other-specs — comparisons point at
specs, not old flat paths; archive plans under docs/plan/archive/
- Site —
app-web Layout nav, sitemap, spec.astro default entry, redirects
- Skill —
skills/ods/SKILL.md + skills/ods/references/*
- Agents — root
AGENTS.md, .agents/rules if product locks changed
- llms.txt —
app-web/public/llms.txt entrypoints (intro + keys first)
- Install scripts —
src/scripts/install.* is source of truth; sync app-web/public/ + skills/ods/scripts/
- CHANGELOG — Unreleased bullet
Grep dead paths + false CLI claims
grep -RInE 'SPEC\.md|resources-and-code|/spec/spec|non-goals\.md' \
--include='*.md' --include='*.astro' --include='*.ts' --include='*.txt' \
docs app-web/src app-web/public skills AGENTS.md README.md || true
grep -RInE 'export graph.*token|related.*chains.*context' skills/ods README.md docs/guide || true
After skill edits: confirm ods skill install bundle in skill_command.rs still lists current references/*.
Optional verify
ods lint
cd app-web && npm run build
