| 1 | # Knowledge roots index (template — copy to personal `work/local/knowledge-roots-index-v1.md`) |
| 2 | |
| 3 | **Not** a catalog of every file in group/public. TOML `[[knowledge.read_only]]` already mounts the full clone — use `read_knowledge_file(..., knowledge_root_id=group)` for any path. |
| 4 | |
| 5 | This file hints **`route_context`** which root to prefer when the query matches (ADR 017 / Core 2.1.2+). |
| 6 | |
| 7 | Format: one line per entry — `relative/path/under/knowledge/ => root_id` |
| 8 | |
| 9 | - **No trailing `/`** — single file only (e.g. `group/smoke-test-v1.md => group`) |
| 10 | - **Trailing `/`** — prefix: all files under that directory (e.g. `work/projects/<group-scope-dir>/ => group`) |
| 11 | - `group` — team KB (`{ORG_SLUG}/kb`) |
| 12 | - `public` — kb-public slice |
| 13 | - `user` — primary personal (or omit after import) |
| 14 | |
| 15 | Scope catalog names: **`work/org/scope-contour-map-v1.md`** — do not duplicate every card here. |
| 16 | |
| 17 | Lines starting with `#` are comments. No prose blocks in the committed real file. |
| 18 | |
| 19 | # --- minimal example --- |
| 20 | |
| 21 | group/smoke-test-v1.md => group |
| 22 | work/org/ => group |
| 23 | work/projects/<group-scope-dir>/ => group |
| 24 | |
| 25 | |
View only · write via MCP/CIDE