Forge
markdowne8ad0934
1# Knowledge Router Index v1
2
3## Purpose
4
5Single entrypoint for fast navigation across the knowledge base under tight context limits.
6
7**Структурный вход в дерево (корзины, таксономия):** `00-entry-kb-v1.md` → `META/kb-taxonomy-v1.md` — до маршрутизации по доменам ниже.
8
9Документ разделён на три слоя: **А — маршрутизация** (какой домен, какой порядок чтения), **Б — операционный базис** (L0 и правила агента до или параллельно домену; **полный текст:** `router-operational-baseline-v1.md`), **В — безопасность и сопровождение индекса** (Safety Checks — **`index-knowledge-router-safety-v1.md`**; правки структуры роутера, списки `section_id`, **How to add a domain** — **`index-knowledge-router-maintenance-v1.md`**). Детальные **триггеры по формулировкам запроса** — в `index-knowledge-router-supplement-v1.md` (секции `router-*`).
10
11
12
13
14
15## А. Маршрутизация (домены, порядок, бюджет)
16
17### Fast Start (60-Second Rehydrate)
18
191. Read `status-*` for the active domain.
202. Read matching `playbook-*` for operating contracts.
213. Read one `matrix-*` only if transfer/routing is needed.
224. Read `kb-*` only for detailed evidence/rule extraction.
235. Update outcome in canonical index and domain status if scope changed.
24
25### L1 pool (agent-notes, load on demand)
26
27- Тяжёлые секции заметок (HPMOR-батчи, it-source-mini-index, knowledge-index, world-human-system, psychology-gender-studies — полный текст в `worlds/psychology-models/psychology-gender-studies-subdomain-v1.md`, imc-ui-ux-vision) вынесены в L1: не входят в default hot context.
28- По запросу: `route_context(query)` или чтение `knowledge/agent-notes-l1-pool.md`; поиск по section ID в agent-notes.
29
30### Retrieval Order Contract
31
32- **Order:** `status -> playbook -> matrix -> kb`.
33- **Rule:** never start from large `kb-*` files unless a concrete question requires it.
34- **Rule:** if two files disagree, prefer `status-*` and domain `playbook-*` as the source of current operating contract.
35
36### Work / Sysadmin domains (Zabbix, Grafana, сети, 1С, nginx и др.)
37
38- **Роутер:** `knowledge/domain-index-v1.md` — тип задачи → домен → playbook и kb в **корне `knowledge/`**. Загружать по ключевым словам (Zabbix, Grafana, дашборд, OSI, топология, прокси, мониторинг, 413, nginx, 1С, SSH, …) сначала domain-index, затем указанные там playbook-* и при необходимости kb-*-reference-v1.md.
39
40### Domain Entry Map
41
42<!-- section:domain-entry-map-table -->
43| Domain | Entry status | Primary playbook | Router/matrix |
44| --- | --- | --- | --- |
45| Git | `worlds/collaboration-git-pr/status-git-v1.md` | `worlds/collaboration-git-pr/playbook-git-workflow-v1.md` | `worlds/collaboration-git-pr/kb-git-safety-and-recovery-rules-v1.md`; runbook multi-remote — `worlds/collaboration-git-pr/runbook-git-multi-remote-backup-v1.md`; hub — `worlds/collaboration-git-pr/README.md` |
46| PR Review | `worlds/collaboration-git-pr/status-pr-review-v1.md` | `worlds/collaboration-git-pr/playbook-pr-review-v1.md` | `worlds/collaboration-git-pr/kb-pr-review-risk-rules-v1.md`; hub — `worlds/collaboration-git-pr/README.md` |
47| HCI | `worlds/hci-ux-dx/status-hci-v1.md` | `worlds/hci-ux-dx/playbook-hci-core-v1.md` | `worlds/hci-ux-dx/kb-hci-usability-and-dialog-rules-v1.md`; классика UI/UX (Norman/Nielsen/Shneiderman/Krug) — `worlds/hci-ux-dx/kb-ui-ux-literature-evidence-v1.md`; карта чтения — `worlds/hci-ux-dx/map-hci-reading-v1.md`; hub — `worlds/hci-ux-dx/README.md` |
48| Human perception (psychophysiology) | `worlds/cognition-human-perception/status-human-perception-v1.md` | `worlds/cognition-human-perception/playbook-human-perception-operational-v1.md` | `worlds/cognition-human-perception/kb-human-perception-fundamentals-v1.md`; **научные якоря (DOI):** `worlds/cognition-human-perception/kb-human-perception-scientific-evidence-v1.md`; **evidence по первоисточникам:** `worlds/cognition-human-perception/kb-human-perception-miller-1956-evidence-v1.md`, `worlds/cognition-human-perception/kb-human-perception-treisman-gelade-1980-evidence-v1.md`; **world (KE)** **cognition.human-perception** — `worlds/cognition-human-perception/README.md`; с HCI и продуктовыми ADR — см. operational playbook |
49| Child language acquisition (L1) | `worlds/cognition-language-acquisition/status-language-acquisition-v1.md` | `worlds/cognition-language-acquisition/playbook-language-acquisition-operational-v1.md` | `worlds/cognition-language-acquisition/kb-language-acquisition-fundamentals-v1.md`; **научные якоря (DOI + read_depth):** `worlds/cognition-language-acquisition/kb-language-acquisition-scientific-evidence-v1.md`; **evidence по первоисточникам:** `worlds/cognition-language-acquisition/kb-language-acquisition-snow-1972-evidence-v1.md`, `worlds/cognition-language-acquisition/kb-language-acquisition-snow-1977-evidence-v1.md`, `worlds/cognition-language-acquisition/kb-language-acquisition-demetras-1986-evidence-v1.md`, `worlds/cognition-language-acquisition/kb-language-acquisition-saxton-1997-evidence-v1.md`, `worlds/cognition-language-acquisition/kb-language-acquisition-clark-lexicon-principles-evidence-v1.md`; **transfer:** `worlds/cognition-language-acquisition/matrix-language-acquisition-transfer-v1.md`; **world (KE)** **cognition.language-acquisition** — `worlds/cognition-language-acquisition/README.md`; **не** CASA teacher/sleep spec |
50| Neurolinguistics (brain language/reading) | `worlds/cognition-neurolinguistics/status-neurolinguistics-v1.md` | `worlds/cognition-neurolinguistics/playbook-neurolinguistics-operational-v1.md` | `worlds/cognition-neurolinguistics/kb-neurolinguistics-fundamentals-v1.md`; **scientific evidence:** `worlds/cognition-neurolinguistics/kb-neurolinguistics-scientific-evidence-v1.md`; **flagship (2020–26):** Feng 2022 reading circuits, Perdue 2022 intervention, Yeh 2026 bilingual brain, Grimaldi 2020; **foundational:** Dehaene, Price 2012, Perani; **boundary:** Hartshorne + van der Slik 2022; **bridge → pedagogy:** `worlds/cognition-neurolinguistics/matrix-neurolinguistics-pedagogy-bridge-v1.md`; hub — `worlds/cognition-neurolinguistics/README.md` |
51| Developer Experience (DE/DX) | `worlds/hci-ux-dx/status-de-dx-v1.md` | `worlds/hci-ux-dx/de-dx-playbook.md` | **troubleshooting:** `worlds/hci-ux-dx/troubleshooting/playbook-tooling-debug-troubleshooting-v1.md`; Git — `worlds/collaboration-git-pr/troubleshooting/`; UI — `playbook-hci-core-v1.md`, `ui-ux-playbook.md`; литература IDE — `kb-ide-dx-literature-evidence-v1.md`; desktop — **Avalonia** (product layout troubleshooting — полный канон, `work/`) |
52| IT | `worlds/systems-it/status-it-v1.md` | `worlds/systems-it/playbook-it-core-systems-v1.md` | `worlds/systems-it/playbook-it-cloud-platform-economics-diagnostics-v1.md`, `worlds/systems-it/kb-it-cloud-platform-economics-diagnostics-rules-v1.md`; инженерная эвиденция .NET/C# — `worlds/software-engineering-evidence/kb-engineering-evidence-v1.md`, карта чтения — `worlds/software-engineering-evidence/map-engineering-reading-v1.md`; hub engineering — `worlds/software-engineering-evidence/README.md`; hub IT — `worlds/systems-it/README.md` |
53| Automation (shell, scripting, containers) | — | `worlds/software-automation-scripting/automation-scripting-playbook.md` | `worlds/software-automation-scripting/powershell-playbook.md`, `worlds/software-automation-scripting/bash-playbook.md`, `worlds/software-automation-scripting/cmd-playbook.md`, `worlds/software-automation-scripting/python-playbook.md`, `worlds/software-automation-scripting/docker-playbook.md`; при парсинге/матчинге как ядре задачи — `worlds/pattern-regex/regex-playbook.md`; hub — `worlds/software-automation-scripting/README.md` |
54| Host OS environments | — | `worlds/ops-host-environments/linux-environments-playbook.md` | `worlds/ops-host-environments/windows-environments-playbook.md`; hub — `worlds/ops-host-environments/README.md` |
55| Ops network & admin tools | — | `worlds/ops-network-admin/playbook-ssh-operations-v1.md` | `worlds/ops-network-admin/playbook-nginx-admin-v1.md`, `worlds/ops-network-admin/playbook-wireshark-network-v1.md`, `worlds/ops-network-admin/playbook-1c-admin-v1.md`; hub — `worlds/ops-network-admin/README.md` |
56| Ops reliability (data + incidents) | — | `worlds/ops-reliability/playbook-backup-db-v1.md` | `worlds/ops-reliability/playbook-incidents-tickets-v1.md`; hub — `worlds/ops-reliability/README.md` |
57| Observability & network KB | — | `worlds/ops-observability-network/playbook-grafana-v1.md` | `worlds/ops-observability-network/kb-grafana-reference-v1.md`, `worlds/ops-observability-network/playbook-zabbix-monitoring-v1.md`, `worlds/ops-observability-network/kb-zabbix-reference-v1.md`, `worlds/ops-observability-network/playbook-network-fundamentals-v1.md`, `worlds/ops-observability-network/kb-network-reference-v1.md`; hub — `worlds/ops-observability-network/README.md` |
58| Knowledge Engineering | `worlds/knowledge-engineering/status-knowledge-engineering-v1.md` | `worlds/knowledge-engineering/playbook-knowledge-engineering-core-v1.md` | `worlds/knowledge-engineering/kb-knowledge-engineering-multiworld-rules-v1.md`, `worlds/knowledge-engineering/kb-knowledge-engineering-mixed-worlds-rules-v1.md`, `worlds/knowledge-engineering/kb-knowledge-engineering-culture-routing-rules-v1.md`, `worlds/knowledge-engineering/kb-knowledge-engineering-country-conflicts-rules-v1.md`, `worlds/knowledge-engineering/kb-knowledge-engineering-operations-rules-v1.md`, `worlds/knowledge-engineering/matrix-culture-routing-v1.md`, `worlds/knowledge-engineering/matrix-do-not-transfer-v1.md`, `worlds/knowledge-engineering/world-modeling-playbook.md`, `worlds/knowledge-engineering/runbook-revisions-backup-v1.md`, `worlds/knowledge-engineering/runbook-kb-mcp-access-v1.md`; личный снимок корпуса ↔ роутер — `personal/bookshelf-corpus-vs-router-gaps-v1.md` (personal); hub — `worlds/knowledge-engineering/README.md` |
59| Psychology | `worlds/psychology-models/status-psychology-v1.md` | `worlds/psychology-models/playbook-psychology-core-models-v1.md` | сквозные матрицы — `worlds/knowledge-engineering/matrix-culture-routing-v1.md`, `worlds/knowledge-engineering/matrix-do-not-transfer-v1.md`; kb — `worlds/psychology-models/kb-psychology-classical-schools-rules-v1.md`, `worlds/psychology-models/kb-psychology-empirical-evidence-rules-v1.md`, `worlds/psychology-models/kb-psychology-cultural-adaptation-rules-v1.md`, `worlds/psychology-models/kb-psychology-manipulation-and-influence-foundations-v1.md`; чтение — `worlds/psychology-models/map-psychology-reading-v1.md`; L1 Gender Studies — `worlds/psychology-models/psychology-gender-studies-subdomain-v1.md`; hub — `worlds/psychology-models/README.md` |
60| Agent orchestration | — | `worlds/agent-orchestration/playbook-agent-autonomy-and-routing-v1.md` | Hub `agent-memory-and-operating-principles-v1.md`; `domains/agent-operations/` (knowledge-responsibility, proactive, fuzzy, utility, principled-clarity, strict-execution, context-pressure, switch, integrity, multi-agent write), `playbook-agent-reconnaissance-before-action-v1.md`, `playbook-captain-parallel-agents-v1.md`, `playbook-session-summary-and-chat-export-v1.md`, `playbook-learn-basics-when-stuck-v1.md`, `playbook-clarification-general-query-v1.md`, `kb-agent-foundation-two-layers-orientation-v1.md`; hub — `worlds/agent-orchestration/README.md` |
61| Workspace & scope | — | `worlds/workspace-context/playbook-multi-project-context-v1.md` | `domains/agent-operations/playbook-project-switch-v1.md`, `playbook-mode-switch-v1.md`, `kb-protocols-and-entities-one-pager-v1.md`, `response-one-step-checklist-extended-v1.md`, `runbook-context-rehydrate-v1.md`, `active-scope-resolution-extended-v1.md`, `response-finalizer-extended-v1.md`; hub — `worlds/workspace-context/README.md` |
62| Information management | — | `worlds/information-management/im-playbook.md` | `worlds/information-management/kb-public-identity-and-trust-core-v1.md`, `worlds/information-management/kb-im-open-questions-v1.md`, `worlds/information-management/tool-purpose-and-books-v1.md`; hub — `worlds/information-management/README.md` |
63| Evidence & culture shelf | — | (см. kb в каталоге) | `worlds/evidence-humanities-shelf/kb-polyamory-reference-v1.md`, `worlds/evidence-humanities-shelf/kb-social-engineering-recognition-v1.md`, `worlds/evidence-humanities-shelf/kb-uncanny-valley-inverse-v1.md`, Covey/logic/utility/Russian/SA/history kb — в том же каталоге; hub — `worlds/evidence-humanities-shelf/README.md` |
64| Software integration (APIs) | — | (внутри kb) | `worlds/software-integration-kb/kb-webapitoolkit-v1.md`, `worlds/software-integration-kb/kb-telegram-api-wtelegram-ids-v1.md`; hub — `worlds/software-integration-kb/README.md` |
65| Culture (dialogue insights) | — | (внутри kb) | `worlds/culture-dialogue-insights/human-insights-from-dialogue-v1.md`; hub — `worlds/culture-dialogue-insights/README.md` |
66| Software authoring & language | `worlds/software-authoring/status-software-authoring-v1.md` | `worlds/software-authoring/playbook-ooad-agent-operational-v1.md` | `worlds/software-authoring/matrix-software-cross-domain-transfer-v1.md`, `kb-ooad-fundamentals-v1.md`, `playbook-domain-nouns-verbs-decomposition-v1.md`, `code-writing-principles-v1.md`, `index-knowledge-language-v1.md`; supplement `router-software-transfer-matrix`; hub — `worlds/software-authoring/README.md` |
67| Aviation Human Factors | `worlds/aviation-human-factors/status-aviation-human-factors-v1.md` | `worlds/aviation-human-factors/playbook-aviation-human-factors-v1.md` | `worlds/aviation-human-factors/matrix-aviation-to-human-interaction-transfer-v1.md`, `worlds/aviation-human-factors/kb-aviation-human-factors-rules-v1.md`; термины PFD/MFD/EFIS/EICAS и метафора IDE (Cascade ADR 0021) — `worlds/aviation-human-factors/kb-aviation-pfd-mfd-efis-eicas-fundamentals-v1.md`; корень мира — `worlds/aviation-human-factors/playbook-aviation-v1.md` |
68| Engineering (Evidence) | `worlds/software-engineering-evidence/status-engineering-reading-v1.md` | `worlds/software-engineering-evidence/kb-engineering-evidence-v1.md` | `worlds/software-engineering-evidence/map-engineering-reading-v1.md`, `worlds/software-engineering-evidence/kb-mcconnell-code-complete-2-chapter-map-v1.md` (McConnell *Code Complete* 2nd ed., карта глав + локальный source); hub — `worlds/software-engineering-evidence/README.md` |
69| Medicine (Evidence) | `worlds/medicine-evidence/status-medicine-evidence-v1.md` | `worlds/medicine-evidence/playbook-medicine-evidence-v1.md` | `worlds/medicine-evidence/kb-bci-evidence-based-medicine-v1.md`; границы терапии/поддержки агента — `worlds/medicine-evidence/kb-therapy-and-support-boundaries-v1.md`; hub — `worlds/medicine-evidence/README.md` |
70| Video (Videography + Surveillance) | — | (внутри kb) | `worlds/media-videography/kb-videography-cinematography-theory-v1.md` (теория + broadcast + кодеки; мир media.video-surveillance для CCTV); hub — `worlds/media-videography/README.md` |
71| ML (Applied) | — | (внутри kb) | `worlds/software-ml-applied/kb-ml-applied-theory-v1.md` (парадигмы ML, OCR, barcode/QR; мир software.ml-applied); hub — `worlds/software-ml-applied/README.md` |
72| Math / numerics (PDE, ODE, schemes, solver validation) | — | `worlds/math-numerics-pde/playbook-equation-ca-cuda-validation-v1.md` | `worlds/math-numerics-pde/kb-math-pde-fundamentals-v1.md`, `worlds/math-numerics-pde/kb-math-ode-ide-fundamentals-v1.md`, `worlds/math-numerics-pde/kb-math-numerical-schemes-fundamentals-v1.md`; валидация PDE / equation-to-ca-cuda — `worlds/math-numerics-pde/kb-pde-solver-validation-fundamentals-v1.md`, `worlds/math-numerics-pde/kb-equation-ca-cuda-validation-evidence-v1.md`; supplement — `router-math-numerics`, `router-equation-ca-cuda-validation`. Мир **math.numerics-pde**; hub — `worlds/math-numerics-pde/README.md` |
73| Music | — | `worlds/arts-music/playbook-music-v1.md` | `worlds/arts-music/kb-music-theory-fundamentals-v1.md`, `worlds/arts-music/kb-music-acoustics-v1.md`, `worlds/arts-music/kb-music-temperaments-math-v1.md`, `worlds/arts-music/kb-music-non-western-v1.md` (мир arts.music); hub — `worlds/arts-music/README.md` |
74| PHP / Laravel | `worlds/software-php-laravel/status-php-laravel-v1.md` | `worlds/software-php-laravel/playbook-php-v1.md` → `worlds/software-php-laravel/playbook-laravel-v1.md` | **Полный список kb — только в `worlds/software-php-laravel/status-php-laravel-v1.md` § Closure snapshot (+ README).** Карты кластеров: `worlds/software-php-laravel/index-knowledge-php-cluster-v1.md`, `worlds/software-php-laravel/index-knowledge-laravel-cluster-v1.md`, `worlds/software-php-laravel/index-knowledge-php-adjacent-ecosystem-v1.md`. Миры: `software.php`, `software.laravel`, `software.wordpress`, `software.drupal`, `software.symfony`, `software.web-backend`; hub — `worlds/software-php-laravel/README.md` |
75| JavaScript (ECMAScript) | `worlds/software-javascript/status-javascript-v1.md` | `worlds/software-javascript/playbook-javascript-operational-v1.md` | Карта `worlds/software-javascript/index-knowledge-javascript-cluster-v1.md` (**fundamentals → operational**); snapshot — `worlds/software-javascript/status-javascript-v1.md`. Мир **`software.javascript`**. TypeScript — отдельно. RegExp — `worlds/pattern-regex/kb-regex-flavors-practice-v1.md` § JavaScript; hub — `worlds/software-javascript/README.md` |
76| Regex | — | `worlds/pattern-regex/regex-playbook.md` | `worlds/pattern-regex/index-knowledge-regex-cluster-v1.md`, `worlds/pattern-regex/kb-regex-quickref-v1.md`, `worlds/pattern-regex/kb-regex-syntax-features-v1.md`, `worlds/pattern-regex/kb-regex-unicode-boundaries-v1.md`, `worlds/pattern-regex/kb-regex-engines-efficiency-v1.md`, `worlds/pattern-regex/kb-regex-flavors-practice-v1.md`, `worlds/pattern-regex/kb-regex-mre3-ru-chapter-map-v1.md` (кластер MRE3 / Friedl); hub — `worlds/pattern-regex/README.md` |
77| Warehouse (barcode video, marketplaces) | `worlds/logistics-warehouse/status-warehouse-v1.md` | `worlds/logistics-warehouse/playbook-warehouse-v1.md` | `worlds/logistics-warehouse/kb-warehouse-marketplace-labels-v1.md`, `worlds/logistics-warehouse/kb-warehouse-barcode-video-v1.md` (по запросу — тот или оба). Мир logistics.warehouse |
78| Pedagogy (school subjects) | `worlds/pedagogy-general/status-pedagogy-school-subjects-v1.md` | `worlds/pedagogy-general/playbook-pedagogy-school-subjects-v1.md` | `worlds/pedagogy-general/kb-pedagogy-scientific-evidence-v1.md`, `worlds/pedagogy-general/kb-pedagogy-evidence-global-v1.md`, `worlds/pedagogy-general/map-pedagogy-school-subjects-reading-v1.md`, `worlds/pedagogy-general/matrix-pedagogy-cross-subject-transfer-v1.md`, `worlds/pedagogy-general/playbook-pedagogy-fundamentals-to-operational-v1.md`; subject worlds — `pedagogy-russian-language`, `pedagogy-mathematics`, `pedagogy-physics`, `pedagogy-chemistry`, `pedagogy-biology`, `pedagogy-literature`, `pedagogy-history`, `pedagogy-geography`, `pedagogy-social-studies`, `pedagogy-second-native-language`, `pedagogy-informatics`, `pedagogy-visual-arts`; supplement `router-pedagogy-school-subjects`; hub — `worlds/pedagogy-general/README.md`; human L1 acquisition — `cognition-language-acquisition`; neurolinguistics — `cognition-neurolinguistics` (bridge via `matrix-neurolinguistics-pedagogy-bridge-v1.md`) |
79| Avalonia UI (desktop .NET) | `worlds/software-dotnet-avalonia/status-avalonia-cascade-ide-ui-v1.md` | `playbook-avalonia-dock-ui-v1.md`; **troubleshooting:** `worlds/software-dotnet-avalonia/troubleshooting/playbook-avalonia-ui-troubleshooting-v1.md`; software — `software-authoring/troubleshooting/` | `kb-avalonia-ui-dock-fundamentals-v1.md`; Roslyn — `software-dotnet-tooling-roslyn/troubleshooting/`; **product playbooks** — полный канон (`work/troubleshooting/`, не kb-public) |
80<!-- /section:domain-entry-map-table -->
81
82### Context Budget Modes
83
84- **Tiny budget:** one `status-*` + one `playbook-*` only.
85- **Normal budget:** add one `matrix-*` if cross-world transfer appears.
86- **Deep budget:** include one targeted `kb-*` file by explicit question.
87
88### Detailed domain routes (supplement)
89
90Триггеры «когда грузить какой playbook/kb» по темам (секции `router-logic`, … `router-captain-parallel-agents`, `learn-basics-when-stuck-router`) — в **`knowledge/index-knowledge-router-supplement-v1.md`**. Те же `section_id`, что до рефакторинга; правки через MCP `upsert_knowledge_section` с **`file_path: index-knowledge-router-supplement-v1.md`**.
91
92При узком контексте сначала **таблица доменов** выше и `status-*` / `playbook-*`; supplement — когда нужен **точечный** маршрут по запросу или по `route_context`.
93
94<!-- section:engineering-cad-domain-entry-v1 -->
95| CAD / engineering.cad | `worlds/engineering-cad/status-engineering-cad-v1.md` | `worlds/engineering-cad/playbook-engineering-cad-v1.md` | fundamentals: `kb-cad-platforms-fundamentals-v1.md`, `kb-cad-extension-models-fundamentals-v1.md`, `kb-cad-build-references-fundamentals-v1.md`; operational: `playbook-engineering-cad-operational-v1.md`; map: `map-engineering-cad-reading-v1.md`; hub: `worlds/engineering-cad/README.md` |
96<!-- /section:engineering-cad-domain-entry-v1 -->
97
98
View only · write via MCP/CIDE