| 1 | # KB taxonomy v1 (канонический описатель) |
| 2 | |
| 3 | **Статус:** Accepted · 2026-05-11 (v1 таксономии под [ADR 009](../adr/009-kb-entry-structure-and-pre-open-onboarding.md)). Примеры миров: **cognition.human-perception**, **aviation.human-factors**, **psychology.models**, **medicine.evidence**, **hci.ux-dx**, **software.engineering-evidence**, **software.automation-scripting**, **collaboration.git-pr**, **systems.it**, **knowledge.engineering**, **ops** (host / network / observability / reliability), **agent.orchestration**, **workspace.context**, **information.management**, **evidence.humanities-shelf** — каталоги под `worlds/<…>/`; **полный список** — [`worlds/README.md`](../worlds/README.md). Роутеры — в корне `knowledge/`. |
| 4 | **Не путать с роутером:** машинный контракт загрузки остаётся в `index-knowledge-router-v1.md` и supplement; этот файл — **человеческая карта корней** и соглашений «куда класть новое». |
| 5 | |
| 6 | --- |
| 7 | |
| 8 | ## Зачем один файл |
| 9 | |
| 10 | Имена папок `worlds/`, `domains/`, `templates/` сами по себе не объясняют смысл. Здесь зафиксированы определения, отличия от `work/`, `META/`, корневых `playbook-*` / `kb-*`, и куда смотреть первым делом: **`../00-entry-kb-v1.md`**. |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## Определения |
| 15 | |
| 16 | | Корень | Назначение | |
| 17 | |--------|------------| |
| 18 | | **`worlds/`** | Крупные контексты («вселенные»): продуктовые стеки, исследовательские миры, длинные дуги. Внутри мира: `status-*`, `playbook-*`, `kb-*`; **`troubleshooting/`** — симптомы и чеклисты (контур A, kb-public). Индекс: [`META/index-troubleshooting-v1.md`](index-troubleshooting-v1.md). Не смешивать со **scope** в `work/projects/<scope>/` (контур B). | |
| 19 | | **`domains/`** | Сквозные темы (безопасность, инструменты, процессы, …). **v1:** [`domains/agent-operations/`](../domains/agent-operations/) — операционные контракты агента (`playbook-project-switch`, `playbook-mode-switch`, multi-agent write, integrity под давлением). **Имя корзины не финально** для других slug — см. **`domains/README.md`**. | |
| 20 | | **`templates/`** | Реюзабельные **шаблоны** (каркасы). Подкаталоги: `cards/`, `worlds/`, `work/`, `matrices/`, `meta/`, `newcomer/` — [`templates/README.md`](../templates/README.md). Экземпляры живут в `work/projects/…`, `worlds/…`, `adr/…` и т.д., не в `templates/`. | |
| 21 | | **`work/`** | Оперативный слой: карточки проектов, локальные runbook’и; **весь product troubleshooting** — `work/projects/<id>/playbook-*-troubleshooting-v1.md`, реестр [`work/troubleshooting/README.md`](work/troubleshooting/README.md) (контур B, не kb-public). Сквозная диагностика стека — `worlds/<world>/troubleshooting/` (контур A). Сводка: [`META/index-troubleshooting-v1.md`](index-troubleshooting-v1.md). | |
| 22 | | **`temp/`** | Scratch **external WM** агента (workaround harness): не канон, не kb-public. [`temp/README.md`](../temp/README.md). | |
| 23 | | **`META/`** | Well-known спеки, integrity, provenance; корень доверия. | |
| 24 | | **`adr/`** | ADR оглавление и записи решений. | |
| 25 | | **Корень `knowledge/*.md`** | Легаси и намеренно плоские артефакты (роутер, playbooks, kb-*): **не обязаны** немигрировать в корзины; миграция — инкрементально с обновлением ссылок и роутера ([009](../adr/009-kb-entry-structure-and-pre-open-onboarding.md) §9–10). | |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Роутеры vs «indexes» |
| 30 | |
| 31 | Файлы `index-knowledge-router-*.md` пока остаются в **корне** `knowledge/` (легаси-путь). Отдельная папка **`routers/`** — только если явно перенесём роутер и обновим все вызовы MCP/примеры ([009](../adr/009-kb-entry-structure-and-pre-open-onboarding.md) §11–13). Папку **`indexes/`** не вводим как синоним роутера; при необходимости позже — только под человеческие каталоги (ToC). |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ## Полнотекст (опционально) |
| 36 | |
| 37 | Локальный FTS по Markdown **не** часть канона в Git: опциональный MCP **Hybrid Codebase Index**, артефакты под `.hybrid-codebase-index/` вне коммитов. Политика: [ADR 010](../adr/010-kb-markdown-fts-index-boundary.md); пошагово: `work/projects/door-to-singularity/agent-notes-kb/templates/kb-hci-optional-fts-runbook-v1.md`. |
| 38 | |
| 39 | --- |
| 40 | |
| 41 | ## Таблица «корень → роль» (снимок v1) |
| 42 | |
| 43 | | Путь | Роль | |
| 44 | |------|------| |
| 45 | | `SHOWCASE.md` | Быстрый обзор без full load | |
| 46 | | `00-entry-kb-v1.md` | Тонкий вход: ссылки по осям | |
| 47 | | `index-knowledge-router-v1.md` | Машинный маршрутизатор | |
| 48 | | `META/integrity-core.md` | Корень доверия | |
| 49 | | `work/` | Оперативка, не kb-public | |
| 50 | | `temp/` | Scratch агента (external WM), не kb-public | |
| 51 | | `personal/` | Личный контур, не kb-public | |
| 52 | | `worlds/`, `domains/`, `templates/` | Корзины по этому файлу | |
| 53 | |
| 54 | --- |
| 55 | |
| 56 | ## Правило для нового материала |
| 57 | |
| 58 | 1. Если это **карточка проекта / трек** — `work/projects/<scope>/…` ([003](../adr/003-multi-project-scope-and-project-cards.md)). |
| 59 | 2. Если это **мир / длинный контур** — по мере зрелости `worlds/<slug>/…`. |
| 60 | 3. Если это **сквозная тема** — `domains/<slug>/…` когда появится согласованный slug. |
| 61 | 4. Если это **шаблон** — подкаталог `templates/<kind>/` (не корень `templates/`). Полный индекс — § `taxonomy-templates-v13` ниже и [`templates/README.md`](../templates/README.md). |
| 62 | |
| 63 | |