Retrofit `DOCS/` in place with a consistent, lightweight OKF-style knowledge layer (YAML frontmatter + Markdown/wikilinks, no graph DB/vector store/embeddings), and shrink `CLAUDE.md` back into a router rather than a knowledge dump.
Why: `CLAUDE.md`'s "Core data model" section currently restates ~700 words of ADR-030/031/032/038/039/040/041/042/045/048 content inline instead of citing it — a second, driftable copy of facts the ADRs already own. Meanwhile `DOCS/audit/` already independently reinvented the OKF pattern (frontmatter + `[[wikilink]]`s + a MOC index at `00-Audit-Overview.md`), but `DOCS/adr/` (the most load-bearing directory) has no frontmatter and only unlinked plain-text cross-references, and `CLAUDE.md`'s own "Documentation map" omits 4 of the 6 `DOCS/` subdirectories entirely.
Scope (first pass, conservative):
- Fix two malformed ADR filenames (`ADR-034-repo-ingestion-input.m` → `.md`, `ADR-044-graph-models-in-shared` → `.md`) and the one stale reference to the latter.
- Add YAML frontmatter to all 19 `DOCS/adr/` files, reusing `DOCS/audit/`'s proven schema (`title`, `date`, `type`, `status`, `tags`, `related`) — copying `date`/`status` only where the ADR body already states them explicitly, never inferring or defaulting a value.
- Create `DOCS/index.md` as the repo-wide discovery entry point, routing to `DOCS/audit/00-Audit-Overview.md` and the other `DOCS/` subdirectories rather than duplicating their content.
- Trim `CLAUDE.md`'s "Core data model" section to ADR citations instead of restated rules, and expand "Documentation map" to cover all `DOCS/` subdirectories.
Explicitly out of scope this pass: `DOCS/architecture/` (13 files), `DOCS/test_results/`, `DOCS/notes/`, `docs-archive/`, `status/`, and `AGENTS.md` (no second AI tool actively in use yet) — all deferred, not touched.
No production code, service, or schema is touched — this is documentation-metadata only.
Retrofit `DOCS/` in place with a consistent, lightweight OKF-style knowledge layer (YAML frontmatter + Markdown/wikilinks, no graph DB/vector store/embeddings), and shrink `CLAUDE.md` back into a router rather than a knowledge dump.
Why: `CLAUDE.md`'s "Core data model" section currently restates ~700 words of ADR-030/031/032/038/039/040/041/042/045/048 content inline instead of citing it — a second, driftable copy of facts the ADRs already own. Meanwhile `DOCS/audit/` already independently reinvented the OKF pattern (frontmatter + `[[wikilink]]`s + a MOC index at `00-Audit-Overview.md`), but `DOCS/adr/` (the most load-bearing directory) has no frontmatter and only unlinked plain-text cross-references, and `CLAUDE.md`'s own "Documentation map" omits 4 of the 6 `DOCS/` subdirectories entirely.
Scope (first pass, conservative):
Explicitly out of scope this pass: `DOCS/architecture/` (13 files), `DOCS/test_results/`, `DOCS/notes/`, `docs-archive/`, `status/`, and `AGENTS.md` (no second AI tool actively in use yet) — all deferred, not touched.
No production code, service, or schema is touched — this is documentation-metadata only.