| 1 | # Knowledge Router — Supplement (detailed domain routes) v1 |
| 2 | |
| 3 | **Роль:** триггеры «когда грузить какой playbook/kb» по темам — все секции `<!-- section:router-* -->` и `learn-basics-when-stuck-router`. Раньше жили в `index-knowledge-router-v1.md` сразу после Context Budget. |
| 4 | |
| 5 | **Точка входа:** `index-knowledge-router-v1.md` — Baseline, Domain Entry Map; **Safety Checks** — `index-knowledge-router-safety-v1.md`; правила сопровождения индекса — `index-knowledge-router-maintenance-v1.md`. Этот файл подключают, когда нужен **доменный** маршрут по запросу (или по `route_context`). |
| 6 | |
| 7 | **Редактирование:** `upsert_knowledge_section` с `file_path: index-knowledge-router-supplement-v1.md` и прежними `section_id` (`router-logic`, …). |
| 8 | |
| 9 | **Обратная совместимость:** в старых документах встречается «секция `router-…` в `index-knowledge-router-v1.md`» — смысл тот же; физически секции перенесены **сюда** (рефакторинг v2 split). |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | <!-- section:router-kb-structure-adr009 --> |
| 14 | |
| 15 | ## KB structure / taxonomy (ADR 009) |
| 16 | |
| 17 | - **При вопросах о физической раскладке канона** (куда класть новый файл, чем `worlds/` отличается от `work/projects/`, что такое `domains/` и `templates/`, нужна ли папка `routers/`, связка с kb-public): загружать **`knowledge/META/kb-taxonomy-v1.md`** и тонкий вход **`knowledge/00-entry-kb-v1.md`**; решение по направлению — **`knowledge/adr/009-kb-entry-structure-and-pre-open-onboarding.md`**. Это **не** замена Domain Entry Map для выбора *предметного* домена (Git, HCI, …) — только слой «дерево и корзины». |
| 18 | <!-- /section:router-kb-structure-adr009 --> |
| 19 | |
| 20 | <!-- section:router-logic --> |
| 21 | |
| 22 | |
| 23 | |
| 24 | |
| 25 | ## Logic: everyday and formal (evidence base) |
| 26 | |
| 27 | - **При запросах о логике, аргументации, кванторах («все/везде» vs «хотя бы один»), необходимости и достаточности, типичных ошибках в рассуждениях:** загружать `knowledge/worlds/evidence-humanities-shelf/kb-logic-everyday-and-formal-evidence-v1.md` — обычная логика (кванторы в речи, условие, необходимость/достаточность), связка с формальной (∀, ∃, импликация), evidence-кейсы из практики, связь с scope-disambiguation и эпистемией. Операционная секция scope-disambiguation-all-everywhere-v1 в agent-notes опирается на этот документ как на логический фундамент. |
| 28 | <!-- /section:router-logic --> |
| 29 | |
| 30 | <!-- section:router-value-utility --> |
| 31 | |
| 32 | |
| 33 | |
| 34 | |
| 35 | ## Value / Utility / Underdetermination (evidence base) |
| 36 | |
| 37 | - **При запросах о критериях полезности, ценности, сравнении вариантов или обосновании оценочных суждений:** загружать `knowledge/worlds/evidence-humanities-shelf/kb-utility-value-underdetermination-evidence-v1.md` — обзор по теории полезности (EU, критика), теории ценности (axiology, good for / attributive, плюрализм), несоизмеримости (incommensurability, parity), теореме Эрроу. Операционный принцип — `knowledge/domains/agent-operations/playbook-utility-judgment-underdetermination-v1.md` (hub: `agent-memory-and-operating-principles-v1.md`). |
| 38 | <!-- /section:router-value-utility --> |
| 39 | |
| 40 | <!-- section:router-agent-memory-hub --> |
| 41 | |
| 42 | |
| 43 | |
| 44 | |
| 45 | ## Agent memory / operating principles (hub) |
| 46 | |
| 47 | - **При онбординге «как агент работает с памятью и пользователем», неясном маршруте по операционным привычкам, или когда нужен один вход вместо перебора playbooks:** загружать `knowledge/agent-memory-and-operating-principles-v1.md` — маршрутизатор (таблица SSOT). **Не** грузить весь hub телом — один целевой playbook по строке таблицы. |
| 48 | <!-- /section:router-agent-memory-hub --> |
| 49 | |
| 50 | <!-- section:router-proactive-micro-improvements --> |
| 51 | |
| 52 | |
| 53 | |
| 54 | |
| 55 | ## Proactive micro-improvements |
| 56 | |
| 57 | - **При микро-улучшениях по ходу работы, «почему не поправил сразу», интуиции по KB/коду без явного запроса:** `knowledge/domains/agent-operations/playbook-proactive-micro-improvements-v1.md`; hot stub `proactive-micro-improvements-and-intuition-v1`; hub — `agent-memory-and-operating-principles-v1.md`. |
| 58 | <!-- /section:router-proactive-micro-improvements --> |
| 59 | |
| 60 | <!-- section:router-fuzzy-search-implicit-language --> |
| 61 | |
| 62 | |
| 63 | |
| 64 | |
| 65 | ## Fuzzy search / implicit language |
| 66 | |
| 67 | - **При образном запросе, «найди как finplan», неявном языке, одном пустом поиске как «доказательстве отсутствия»:** `knowledge/domains/agent-operations/playbook-fuzzy-search-implicit-language-v1.md`; hot stub `fuzzy-search-and-implicit-language-v1`; hub — `agent-memory-and-operating-principles-v1.md`. |
| 68 | <!-- /section:router-fuzzy-search-implicit-language --> |
| 69 | |
| 70 | <!-- section:router-principled-clarity --> |
| 71 | |
| 72 | |
| 73 | |
| 74 | |
| 75 | ## Principled clarity |
| 76 | |
| 77 | - **При оценке сторон, вины, правоты, ответственности; «кто прав»; когда принцип уже режет, но тянут «всё сложно»:** `knowledge/domains/agent-operations/playbook-principled-clarity-v1.md`; L0 `principled-clarity-v1`; stub `principled-clarity-extended-v1`; hub — `agent-memory-and-operating-principles-v1.md`. |
| 78 | <!-- /section:router-principled-clarity --> |
| 79 | |
| 80 | <!-- section:router-strict-execution-analogy --> |
| 81 | |
| 82 | |
| 83 | |
| 84 | |
| 85 | ## Strict execution by analogy |
| 86 | |
| 87 | - **При «по аналогии с X», «как в X», «как finplan» — строго 1:1 по образцу, без импровизации:** `knowledge/domains/agent-operations/playbook-strict-execution-when-analogy-v1.md`; hot stub `strict-execution-when-analogy-v1`; hub — `agent-memory-and-operating-principles-v1.md`. |
| 88 | <!-- /section:router-strict-execution-analogy --> |
| 89 | |
| 90 | <!-- section:router-reconnaissance-before-action --> |
| 91 | |
| 92 | |
| 93 | |
| 94 | |
| 95 | ## Reconnaissance before action (anti-hurry) |
| 96 | |
| 97 | - **При ложном давлении «ответить немедленно», патче без контекста, «сейчас быстренько напишу»:** `knowledge/worlds/agent-orchestration/playbook-agent-reconnaissance-before-action-v1.md`; hot stub `autonomy-right-to-pause-reconnaissance-v1`; связь с `execution-gate-v1` (L1) и `playbook-agent-autonomy-and-routing-v1.md`; hub — `agent-memory-and-operating-principles-v1.md`. |
| 98 | <!-- /section:router-reconnaissance-before-action --> |
| 99 | |
| 100 | <!-- section:router-agent-kb-responsibility --> |
| 101 | |
| 102 | |
| 103 | |
| 104 | |
| 105 | ## Agent knowledge responsibility |
| 106 | |
| 107 | - **При ответственности за слои KB, куда класть знание, свежесть канона, operational vs fundamentals:** `knowledge/domains/agent-operations/playbook-agent-knowledge-responsibility-v1.md`. **Партнёрство по ADR / культура Cascade** — отдельно `playbook-agent-partnership-kb-v1.md` (не смешивать). Hub — `agent-memory-and-operating-principles-v1.md`. |
| 108 | <!-- /section:router-agent-kb-responsibility --> |
| 109 | |
| 110 | <!-- section:router-bci-medicine --> |
| 111 | |
| 112 | |
| 113 | |
| 114 | |
| 115 | ## BCI / Medicine (evidence base) |
| 116 | |
| 117 | - **При запросах о BCI (интерфейсы мозг–компьютер), нейрореабилитации (инсульт, SCI, locked-in, речь при параличе, ДЦП, нейрофидбек) или evidence-based по этим направлениям медицины:** загружать `knowledge/worlds/medicine-evidence/kb-bci-evidence-based-medicine-v1.md` — уровни доказательности, мета-анализы/RCT, ссылки на Cochrane/PubMed/PMC/NEJM/Nature; сводная таблица по направлениям. Домен: Medicine (Evidence); status → playbook → kb. Клинические решения — по руководствам и протоколам; документ только навигация. |
| 118 | <!-- /section:router-bci-medicine --> |
| 119 | |
| 120 | <!-- section:router-secret-mode --> |
| 121 | |
| 122 | |
| 123 | |
| 124 | |
| 125 | ## Secret Mode (активатор дисциплинированного режима) |
| 126 | |
| 127 | - **При запросах про дисциплинированный режим, «что делаю + зачем», совместную ясность без победы в споре или про активатор для текстового агента:** загружать `secret-mode-prefix-ru.md` (корень репо agent-notes). Расширенный префикс — 6 посылок после «Secret Mode activated»; применим к любому текстовому агенту. Связь с multiworld: тег `secret-mode` в kb-knowledge-engineering-multiworld-rules-v1.md. |
| 128 | <!-- /section:router-secret-mode --> |
| 129 | |
| 130 | <!-- section:router-clarification --> |
| 131 | |
| 132 | |
| 133 | |
| 134 | |
| 135 | ## Clarification: general / vague query |
| 136 | |
| 137 | - **При общем или размытом запросе** (нет явного scope, outcome или домена): загружать `knowledge/worlds/agent-orchestration/playbook-clarification-general-query-v1.md` — лестница снятия неопределённости (переформулировка → варианты A/B/C → минимальный безопасный шаг), использование route_context до вопроса, правило одного вопроса. Не загружать несколько доменных веток «на угад»; не сыпать уточняющими вопросами — один вопрос, снимающий максимум измерений. |
| 138 | <!-- /section:router-clarification --> |
| 139 | |
| 140 | <!-- section:router-polyamory --> |
| 141 | |
| 142 | |
| 143 | |
| 144 | |
| 145 | ## Polyamory (reference, culture.global) |
| 146 | |
| 147 | - **При запросах о полиамории, полиаморах, согласованной немоногамии (CNM), структурах отношений (иерархия, solo poly, relationship anarchy), этике и терминологии:** загружать `knowledge/worlds/evidence-humanities-shelf/kb-polyamory-reference-v1.md` — определения, этический фундамент, типовые структуры, термины (мета, комперсия, NRE, границы, veto), неэтичное поведение, мифы, связь с психологией, книги для углубления. **Мир:** `culture.global`. При переносе в страновой контекст или в психологический/терапевтический контур — через `worlds/knowledge-engineering/matrix-culture-routing-v1.md`. |
| 148 | <!-- /section:router-polyamory --> |
| 149 | |
| 150 | <!-- section:router-therapy --> |
| 151 | |
| 152 | |
| 153 | |
| 154 | |
| 155 | ## Therapy / Support boundaries |
| 156 | |
| 157 | - **При запросах о терапии, поддерживающем контакте, границах «агент vs терапевт», когда направлять к специалисту, травме, флешбэках, кризисе, психологической первой помощи:** загружать `knowledge/worlds/medicine-evidence/kb-therapy-and-support-boundaries-v1.md` и секцию **agent-supportive-listening-gap-v1** в agent-notes. В документе: терапия vs поддерживающее слушание, признаки кризиса и серьёзных индикаторов, травма-информированный отклик и grounding (вне клиники), PFA-контекст, операционная таблица для агента. Агент не терапевт; может «заполнять пробел» (отражение, признание, без советов); при риске — предложить специалиста или экстренную службу. |
| 158 | <!-- /section:router-therapy --> |
| 159 | |
| 160 | <!-- section:router-uncanny-valley --> |
| 161 | |
| 162 | |
| 163 | |
| 164 | |
| 165 | ## Uncanny valley (прямая и инверсная, reference) |
| 166 | |
| 167 | - **При запросах о зловещей долине (прямой или инверсной), переключении человек/агент, стене трения при переходе к людям после среды с агентами, обходах (XB-70, compression lift), калибровке ожиданий:** загружать `knowledge/worlds/evidence-humanities-shelf/kb-uncanny-valley-inverse-v1.md` — прямая долина (страх неизвестного, пример Арво), инверсная (стена трения, высокое «число Маха»), таблица различий, обход через смену конфигурации и протокол WORK/HUMAN. Связь с HCI и дизайном сред человек–агент. |
| 168 | <!-- /section:router-uncanny-valley --> |
| 169 | |
| 170 | <!-- section:router-human-perception --> |
| 171 | |
| 172 | |
| 173 | |
| 174 | |
| 175 | ## Human perception (psychophysiology): fundamentals → operational |
| 176 | |
| 177 | - **При запросах о психофизиологии восприятия, когнитивной нагрузке, усталости и внимании в контексте UX/IDE/агента**, о том, «почему интерфейс бесит без бага», о конкуренции зон экрана за внимание, о прерываниях потока и предсказуемости фидбека: загружать **`knowledge/worlds/cognition-human-perception/playbook-human-perception-operational-v1.md`** — чеклисты и мост к HCI/продукту. Фундамент понятий (внимание, рабочая память, нагрузка, стресс, заметность): **`knowledge/worlds/cognition-human-perception/kb-human-perception-fundamentals-v1.md`**. **Первоисточники, DOI, таблица «идея → статья»:** **`knowledge/worlds/cognition-human-perception/kb-human-perception-scientific-evidence-v1.md`** — при обосновании ревью, споре о цитировании или углублении в научный слой. **Evidence-карточки по первоисточникам (`kb-human-perception-*-evidence-v1`):** `knowledge/worlds/cognition-human-perception/kb-human-perception-miller-1956-evidence-v1.md`, `knowledge/worlds/cognition-human-perception/kb-human-perception-treisman-gelade-1980-evidence-v1.md` (или по запросу конкретной работы). Hub **world (KE)** и границы переноса: **`knowledge/worlds/cognition-human-perception/README.md`** (`cognition.human-perception`). |
| 178 | - **Порядок:** `worlds/cognition-human-perception/status-human-perception-v1.md` → operational playbook → fundamentals kb → при необходимости **scientific-evidence** kb; затем при узком UI‑вопросе — **HCI** (`worlds/hci-ux-dx/playbook-hci-core-v1.md`, при необходимости `worlds/hci-ux-dx/kb-hci-usability-and-dialog-rules-v1.md`, `worlds/hci-ux-dx/kb-ui-ux-literature-evidence-v1.md`). Не подменять **Psychology** при клинических запросах. |
| 179 | - **Пересечение с CascadeIDE:** метафора кокпита и иерархия внимания — в ADR репозитория (напр. 0021, 0076); KB даёт слой «почему», не дублирует нормативы продукта. |
| 180 | <!-- /section:router-human-perception --> |
| 181 | |
| 182 | <!-- section:router-language-acquisition --> |
| 183 | |
| 184 | |
| 185 | |
| 186 | |
| 187 | ## Child language acquisition (L1): fundamentals → operational |
| 188 | |
| 189 | - **При запросах о human child L1** (CDS, maternal input, corrective feedback, word learning, lexical mapping, «как ребёнок учит язык»): загружать **`knowledge/worlds/cognition-language-acquisition/playbook-language-acquisition-operational-v1.md`**. Фундамент: **`knowledge/worlds/cognition-language-acquisition/kb-language-acquisition-fundamentals-v1.md`**. **DOI + read_depth + evidence-карты:** **`knowledge/worlds/cognition-language-acquisition/kb-language-acquisition-scientific-evidence-v1.md`** → per-paper `kb-language-acquisition-*-evidence-v1.md`. Hub: **`knowledge/worlds/cognition-language-acquisition/README.md`** (`cognition.language-acquisition`). |
| 190 | - **Порядок:** status → playbook → fundamentals → scientific-evidence index → **одна** evidence-карта на источник. **Не** импортировать в CASA teacher/sleep — **`matrix-language-acquisition-transfer-v1.md`** + `matrix-do-not-transfer-v1.md`. |
| 191 | - **CASA lab / ca-substrate-agent:** engineering spec — `teacher-correction-protocol-v0`, `kb-casa-teacher-sleep-lab-norm-v1`; педагогика — только inspiration в `research-training-developmental-pedagogy-v1` (hypothesis). |
| 192 | <!-- /section:router-language-acquisition --> |
| 193 | |
| 194 | <!-- section:router-troubleshooting-index --> |
| 195 | |
| 196 | |
| 197 | |
| 198 | |
| 199 | ## Troubleshooting (общий индекс) |
| 200 | |
| 201 | - **При любом «симптом / не работает / узко / тормозит / куда смотреть»:** **`knowledge/META/index-troubleshooting-v1.md`** → **`worlds/<world>/troubleshooting/playbook-*-troubleshooting-v1.md`** (контур A, kb-public). Product — **`work/projects/…`** (контур B). |
| 202 | - **Процесс и таксономия папки `troubleshooting/`:** `knowledge/META/playbook-troubleshooting-collection-v1.md`. |
| 203 | - **Software (неявный симптом):** `worlds/software-authoring/troubleshooting/playbook-software-authoring-troubleshooting-v1.md` (+ matrix). |
| 204 | - **Build/test/debug:** `worlds/hci-ux-dx/troubleshooting/playbook-tooling-debug-troubleshooting-v1.md`. |
| 205 | - **Sysadmin:** `domain-index-v1.md` → `worlds/ops-network-admin|ops-observability-network|ops-reliability/troubleshooting/`. |
| 206 | <!-- /section:router-troubleshooting-index --> |
| 207 | |
| 208 | <!-- section:router-videography --> |
| 209 | |
| 210 | |
| 211 | |
| 212 | |
| 213 | ## Videography / Cinematography (theory reference) |
| 214 | |
| 215 | - **При запросах о теории видеосъёмки, кинематографии, композиции, типах планов (EWS/CU/MCU и др.), правиле 180°/30°, свете (трёхточечный, high/low key), движении камеры (pan, tilt, dolly, tracking), глубине резкости, непрерывном монтаже, broadcast (LUFS/EBU R128, broadcast-safe), кодеках доставки (H.264, ProRes и др.), прикладном видеонаблюдении (CCTV, охранные камеры, размещение, слепые зоны, покрытие, retention, персональные данные):** загружать `knowledge/worlds/media-videography/kb-videography-cinematography-theory-v1.md` — теория + операционный слой (R1–R8 + R9–R12 для surveillance), broadcast, кодеки; прикладное видеонаблюдение — мир **media.video-surveillance** (§13); для планирования съёмки, разбора кадра, проверки доставки/эфира и проектирования систем видеонаблюдения. |
| 216 | <!-- /section:router-videography --> |
| 217 | |
| 218 | <!-- section:router-ml --> |
| 219 | |
| 220 | |
| 221 | |
| 222 | |
| 223 | ## ML (applied, OCR, barcode, QR) |
| 224 | |
| 225 | - **При запросах о машинном обучении (парадигмы, supervised/unsupervised, классификация, регрессия), OCR (распознавание текста, Tesseract, препроцессинг, облако vs on-device), распознавании штрихкодов и 2D-кодов (barcode, QR, Data Matrix, UPC, EAN, Code 128, требования к изображению, ML Kit, ZXing):** загружать `knowledge/worlds/software-ml-applied/kb-ml-applied-theory-v1.md` — фундамент ML и прикладные задачи; OCR (пайплайн, препроцессинг, OEM/PSM); 1D/2D коды, типы и выбор решения; операционные правила R1–R7; мир **software.ml-applied**. |
| 226 | <!-- /section:router-ml --> |
| 227 | |
| 228 | <!-- section:router-dotnet --> |
| 229 | |
| 230 | |
| 231 | |
| 232 | |
| 233 | ## Developer Experience (DE/DX) |
| 234 | |
| 235 | - **При запросах о developer experience, DX, DE/DX, эргономике доставки, трение в тулинге, онбординге разработчика, «лёгком пути», lead time / cycle time / change failure rate / MTTR (DORA-ориентир), time-to-first-edit / time-to-first-contribution, малых батчах и обратной связи до merge:** загружать `knowledge/worlds/hci-ux-dx/de-dx-playbook.md` — принципы, метрики, формат evidence-based работы. |
| 236 | - **Литература IDE и опыта разработчика** (принципы Osmani, интегрированная среда Smalltalk-80, Boxer/diSessa — не путать с метриками команды из playbook): `knowledge/worlds/hci-ux-dx/kb-ide-dx-literature-evidence-v1.md`. Загружать при проектировании **IDE**, инструмента, обосновании «трения», TTC, единого окна, режимов редактора/отладки. |
| 237 | - **Классика UI/UX** (Norman, Nielsen, Shneiderman, Krug): `knowledge/worlds/hci-ux-dx/kb-ui-ux-literature-evidence-v1.md` — эвристики и язык ревью интерфейса; пересечение с HCI. |
| 238 | - **Порядок:** при узком вопросе достаточно `worlds/hci-ux-dx/de-dx-playbook.md`; при пересечении с циклом кода — добавить **Git** (`playbook-git-workflow-v1.md`), **PR Review** (`playbook-pr-review-v1.md`); при боли в сборке/тестах/отладке — `tooling-debug-playbook.md`; при фокусе на UI/диалоге — **HCI** (`worlds/hci-ux-dx/playbook-hci-core-v1.md`, при необходимости `worlds/hci-ux-dx/kb-hci-usability-and-dialog-rules-v1.md`, `worlds/hci-ux-dx/kb-ui-ux-literature-evidence-v1.md`) и/или `worlds/hci-ux-dx/ui-ux-playbook.md`. |
| 239 | - **Продуктовые числовые бюджеты** (latency редактора, acceptance перед релизом конкретного приложения) — не дублировать в KB: держать в ADR/доках репозитория продукта; KB даёт общий слой DX. Для desktop IDE на Avalonia — см. домен **Avalonia UI (CascadeIDE)** в Domain Entry Map. |
| 240 | <!-- /section:router-de-dx --> |
| 241 | |
| 242 | <!-- section:router-php-laravel --> |
| 243 | |
| 244 | |
| 245 | |
| 246 | |
| 247 | ## PHP runtime (8.4+) and Laravel framework |
| 248 | |
| 249 | - **Порядок загрузки:** `status -> playbook -> kb` (см. Domain Entry Map — домен **PHP / Laravel**). |
| 250 | - **Полный фундаментальный проход** в **world (KE)** `software.php` **(без фреймворка):** начать с `knowledge/worlds/software-php-laravel/index-knowledge-php-cluster-v1.md` (таблица «вопрос → файл» и порядок из 5 kb); затем по шагам `knowledge/worlds/software-php-laravel/playbook-php-v1.md` § Full fundamental pass — **не грузить все kb одновременно** без явного запроса. |
| 251 | - **Точечные запросы по PHP:** |
| 252 | - платформа, версии, OPcache, JIT, preloading, FPM, ini, расширения, Composer, bcrypt/PCRE/8.4 → `knowledge/worlds/software-php-laravel/kb-php-fundamentals-v1.md`; |
| 253 | - хронология языка с **PHP 5.x/7.x**, миграции мажоров, «с какой версии появилась фича» → `knowledge/worlds/software-php-laravel/kb-php-versions-and-evolution-v1.md`; |
| 254 | - семантика языка, типы, ООП, enum, ошибки, namespace, `==` vs `===`, опасные API → `knowledge/worlds/software-php-laravel/kb-php-language-semantics-v1.md`; |
| 255 | - сессии, cookies, суперглобалы, upload, заголовки, потоки → `knowledge/worlds/software-php-laravel/kb-php-web-sessions-io-v1.md`; |
| 256 | - PDO, SQL, транзакции, миграции без ORM → `knowledge/worlds/software-php-laravel/kb-php-data-persistence-v1.md`; |
| 257 | - PHPUnit/Pest, PHPStan/Psalm, Rector, Xdebug, CI-матрица → `knowledge/worlds/software-php-laravel/kb-php-tooling-quality-v1.md`. |
| 258 | - **Всегда перед углублением:** `knowledge/worlds/software-php-laravel/status-php-laravel-v1.md` + `knowledge/worlds/software-php-laravel/playbook-php-v1.md`. |
| 259 | - **Laravel — база:** `knowledge/worlds/software-php-laravel/playbook-laravel-v1.md`, затем `knowledge/worlds/software-php-laravel/kb-laravel-fundamentals-v1.md` — **поверх** слоя PHP, не вместо него. |
| 260 | - **Laravel — полный контур (версии 8→12+, first-party пакеты, Sanctum/Passport, Symfony под капотом, Octane/FrankenPHP/RoadRunner/Reverb, Livewire/Filament/Inertia):** `knowledge/worlds/software-php-laravel/index-knowledge-laravel-cluster-v1.md` (таблица «вопрос → kb» и порядок full pass) → **один** целевой `knowledge/worlds/software-php-laravel/kb-laravel-*` за раз; апгрейды — `knowledge/worlds/software-php-laravel/kb-laravel-versions-upgrades-v1.md` + официальный Upgrade Guide ветки. |
| 261 | - **Связь:** `knowledge/worlds/software-engineering-evidence/kb-engineering-evidence-v1.md` при необходимости общих инженерных фактов; OWASP/внутренние стандарты — для угрозной модели вне этих kb. |
| 262 | - **Смежная экосистема PHP (WordPress, Drupal, Symfony full stack, Composer/Packagist/сторонние пакеты):** `knowledge/worlds/software-php-laravel/index-knowledge-php-adjacent-ecosystem-v1.md` → **один** из `knowledge/worlds/software-php-laravel/kb-wordpress-architecture-ops-v1.md`, `knowledge/worlds/software-php-laravel/kb-drupal-architecture-ops-v1.md`, `knowledge/worlds/software-php-laravel/kb-symfony-framework-fundamentals-v1.md`, `knowledge/worlds/software-php-laravel/kb-composer-packagist-thirdparty-v1.md`; не смешивать паттерны CMS и фреймворков. |
| 263 | - **Цепочки миров:** `software.php` ↔ `software.laravel` / `software.web-backend`; отдельно `software.wordpress`, `software.drupal`, `software.symfony` — подменять друг друга нельзя. |
| 264 | <!-- /section:router-php-laravel --> |
| 265 | |
| 266 | <!-- section:router-javascript --> |
| 267 | |
| 268 | |
| 269 | |
| 270 | |
| 271 | ## JavaScript / ECMAScript language core |
| 272 | |
| 273 | - **Порядок загрузки:** `status -> playbook -> kb` (см. Domain Entry Map — домен **JavaScript (ECMAScript)**). Playbook операционного слоя: **`knowledge/worlds/software-javascript/playbook-javascript-operational-v1.md`** (мост **fundamentals → operational** и контракты CI/репо). |
| 274 | - **Структура:** **fundamentals** — четыре карточки языка по `knowledge/worlds/software-javascript/index-knowledge-javascript-cluster-v1.md` § fundamentals; **operational** — `knowledge/worlds/software-javascript/kb-javascript-operational-ecosystem-v1.md` § operational (или сразу при чисто npm/CSP/tooling вопросе). |
| 275 | - **Полный проход** в **world (KE)** `software.javascript`: index § фаза A → фаза B + `knowledge/worlds/software-javascript/playbook-javascript-operational-v1.md` § Full pass — **не грузить все kb одновременно**. |
| 276 | - **Точечные запросы (fundamentals):** |
| 277 | - редакции ECMA-262, ESM/CommonJS/`import.meta`, транспилятор vs полифилл; **движки и хосты** → `knowledge/worlds/software-javascript/kb-javascript-ecmascript-and-modules-v1.md`; |
| 278 | - принуждения типов, `===`, UTF-16, TDZ, замыкания, функции/стрелки/`this` → `knowledge/worlds/software-javascript/kb-javascript-types-coercion-and-scope-v1.md`; |
| 279 | - прототипы, `class`/private `#`, итерируемость → `knowledge/worlds/software-javascript/kb-javascript-objects-prototypes-and-classes-v1.md`; |
| 280 | - Promises, async/await, микро/макрозадачи, AbortSignal → `knowledge/worlds/software-javascript/kb-javascript-async-and-event-loop-v1.md`. |
| 281 | - **Operational:** lockfile/npm/semver, ESLint/бандлеры, тест‑раннеры, CSP/XSS/`eval`, audit → **`knowledge/worlds/software-javascript/kb-javascript-operational-ecosystem-v1.md`**. Старый путь `kb-javascript-runtime-tooling-and-security-baseline-v1.md` — только stub с перенаправлением (`knowledge/worlds/software-javascript/…`). |
| 282 | - **Перед углублением:** `knowledge/worlds/software-javascript/status-javascript-v1.md` + `knowledge/worlds/software-javascript/playbook-javascript-operational-v1.md`. |
| 283 | - **TypeScript** — отдельная линия; **не смешивать** с этим кластером без явного указания. |
| 284 | - **RegExp (flavor JS):** `knowledge/worlds/pattern-regex/regex-playbook.md` → `knowledge/worlds/pattern-regex/kb-regex-flavors-practice-v1.md` § JavaScript. |
| 285 | - **Связь:** `knowledge/worlds/software-engineering-evidence/kb-engineering-evidence-v1.md`; DOM/Web API — MDN/платформа, не этот кластер. |
| 286 | <!-- /section:router-javascript --> |
| 287 | |
| 288 | <!-- section:router-avalonia-ui --> |
| 289 | |
| 290 | |
| 291 | |
| 292 | |
| 293 | ## Math / Numerics (PDE/ODE/IDE, schemes) |
| 294 | |
| 295 | - **При запросах о математической постановке задач для симуляции (PDE/ODE/IDE, начальные/граничные условия, выбор тестовых задач):** загружать: |
| 296 | - `knowledge/worlds/math-numerics-pde/kb-math-pde-fundamentals-v1.md` — классы PDE (эллиптические/параболические/гиперболические), heat/wave/Poisson, IC/BC, типы граничных условий, well-posedness; |
| 297 | - `knowledge/worlds/math-numerics-pde/kb-math-ode-ide-fundamentals-v1.md` — ODE, Volterra/Fredholm IE/IDE, когда и зачем использовать интегральные/интегро-дифференциальные формы, высокоуровневая классификация. |
| 298 | - **При запросах о численных схемах и устойчивости (конечные разности, CFL, сходимость, измерение ошибок):** загружать `knowledge/worlds/math-numerics-pde/kb-math-numerical-schemes-fundamentals-v1.md` — консистентность/устойчивость/сходимость, CFL-ограничения, стандартные стенсилы и сеточные эксперименты. |
| 299 | - Документы лежат в **world (KE)** **`math.numerics-pde`** (`knowledge/worlds/math-numerics-pde/README.md`); используйте их как слой математики/численного анализа вместе с предметными доменами (**engineering**, **physics**, и т.д.). |
| 300 | <!-- /section:router-math-numerics --> |
| 301 | |
| 302 | <!-- section:router-equation-ca-cuda-validation --> |
| 303 | |
| 304 | |
| 305 | |
| 306 | |
| 307 | ## Equation→CA→CUDA / PDE solver validation |
| 308 | |
| 309 | - **При запросах о валидации решателей 2D heat, проверке корректности численного решения equation-to-ca-cuda, критериях «прошёл/не прошёл» (нормы ошибки, сходимость, референс):** загружать: |
| 310 | - `knowledge/worlds/math-numerics-pde/kb-pde-solver-validation-fundamentals-v1.md` — что такое валидация PDE-решателя, почему одного скаляра недостаточно, референс и нормы; |
| 311 | - `knowledge/worlds/math-numerics-pde/kb-equation-ca-cuda-validation-evidence-v1.md` — факты и эвристики по референсным задачам, нормам, CFL, воспроизводимости; |
| 312 | - `knowledge/worlds/math-numerics-pde/playbook-equation-ca-cuda-validation-v1.md` — пошаговый контракт базовой валидации (референс, нормы, сходимость, метаданные, критерии прохождения). |
| 313 | - Дополнительно при необходимости: `knowledge/worlds/math-numerics-pde/kb-math-numerical-schemes-fundamentals-v1.md` (см. router-math-numerics). Слой валидации для проекта equation-to-ca-cuda; решения о корректности — по критериям из KB, не по одному числу на выходе. |
| 314 | <!-- /section:router-equation-ca-cuda-validation --> |
| 315 | |
| 316 | <!-- section:router-warehouse --> |
| 317 | |
| 318 | |
| 319 | |
| 320 | |
| 321 | ## Warehouse (barcode video, marketplace labels) |
| 322 | |
| 323 | - Порядок загрузки: status → playbook → kb. **При запросах о требованиях маркетплейсов (Ozon, Wildberries, Яндекс Маркет) к этикеткам, размерам, штрихкодам и маркировке:** загружать `knowledge/worlds/logistics-warehouse/kb-warehouse-marketplace-labels-v1.md` — размеры, dpi, форматы (GS1-128, EAN, Data Matrix), Честный знак. **При запросах о видеозахвате штрихкодов/QR на складе, настройке камер и NVR под читаемость кода на записи:** загружать `knowledge/worlds/logistics-warehouse/kb-warehouse-barcode-video-v1.md` — пиксели на модуль (QR 3–3,5, штрихкод ≥2), разрешение, FOV, освещение, кодек, глубина резкости, две зоны съёмки. Для запросов о конкретных моделях камер (Hikvision DS-2CD2083G2-IU и др.), даташитах и evidence-расчёте px/модуль — дополнительно **L1 on demand:** `knowledge/worlds/logistics-warehouse/kb-warehouse-barcode-video-models-l1-v1.md`. По запросу, затрагивающему и этикетки, и видео — оба основных файла. Мир **logistics.warehouse**. |
| 324 | <!-- /section:router-warehouse --> |
| 325 | |
| 326 | <!-- section:router-music --> |
| 327 | |
| 328 | |
| 329 | |
| 330 | |
| 331 | ## Music |
| 332 | |
| 333 | - **При запросах о музыке (теория, нотация, гармония, физика звука, психоакустика, строи, незападная):** загружать **`knowledge/worlds/arts-music/playbook-music-v1.md`** для маршрутизации; затем по теме запроса — соответствующий kb: **fundamentals** (нотация, pitch, ритм, лады, гармония, транспонирование) → **`knowledge/worlds/arts-music/kb-music-theory-fundamentals-v1.md`**; **физика/психоакустика** (волны, спектр, Фурье, громкость, тембр, маскировка) → **`knowledge/worlds/arts-music/kb-music-acoustics-v1.md`**; **строи, темперации, коммы, JI** → **`knowledge/worlds/arts-music/kb-music-temperaments-math-v1.md`**; **макам, рага, микротоновость** → **`knowledge/worlds/arts-music/kb-music-non-western-v1.md`**. Мир **arts.music**; hub — **`knowledge/worlds/arts-music/README.md`**. |
| 334 | <!-- /section:router-music --> |
| 335 | |
| 336 | <!-- section:router-regex --> |
| 337 | |
| 338 | |
| 339 | |
| 340 | |
| 341 | ## Regex (кластер MRE3 / Friedl + операционный контракт) |
| 342 | |
| 343 | - **При запросах о регулярных выражениях (паттерны, диалекты, производительность, .NET/JS/Java/PCRE):** сначала операционный контракт — `knowledge/worlds/pattern-regex/regex-playbook.md` (дизайн, диалекты, тестирование, безопасность). |
| 344 | - **Точка входа кластера:** `knowledge/worlds/pattern-regex/index-knowledge-regex-cluster-v1.md` — порядок чтения и таблица «задача → файл». |
| 345 | - **По типу вопроса (не грузить все kb сразу):** шпаргалка `knowledge/worlds/pattern-regex/kb-regex-quickref-v1.md`; синтаксис и утверждения `knowledge/worlds/pattern-regex/kb-regex-syntax-features-v1.md`; Unicode и границы `knowledge/worlds/pattern-regex/kb-regex-unicode-boundaries-v1.md`; движки и катастрофический backtracking `knowledge/worlds/pattern-regex/kb-regex-engines-efficiency-v1.md`; API языков и практика `knowledge/worlds/pattern-regex/kb-regex-flavors-practice-v1.md`; соответствие глав русскоязычного PDF издания книги Friedl — `knowledge/worlds/pattern-regex/kb-regex-mre3-ru-chapter-map-v1.md`. |
| 346 | - **Порядок загрузки:** `knowledge/worlds/pattern-regex/regex-playbook.md` → `knowledge/worlds/pattern-regex/index-knowledge-regex-cluster-v1.md` → один целевой `knowledge/worlds/pattern-regex/kb-regex-*` по вопросу. |
| 347 | <!-- /section:router-regex --> |
| 348 | |
| 349 | <!-- section:router-sysadmin-ops --> |
| 350 | |
| 351 | |
| 352 | |
| 353 | |
| 354 | ## Sysadmin: Zabbix, Grafana, networks |
| 355 | |
| 356 | - **При запросах по Zabbix, Grafana, мониторингу и алертингу, дашбордам и источникам данных, основам сетей (OSI, VLAN, диагностика), выбору инструмента («мониторинг vs визуализация», аналоги Zabbix/Grafana), а также по 1С, nginx, бекапам, инцидентам, SSH, Wireshark:** загружать `knowledge/domain-index-v1.md` (роутер доменов и ключевые слова), при сравнении задач и инструментов — `knowledge/worlds/information-management/tool-purpose-and-books-v1.md`, затем соответствующий `playbook-*` и `kb-*-reference-v1.md` из таблицы домена. **`domain-index`** остаётся в **корне `knowledge/`**; целевые playbooks/kb — под **`knowledge/worlds/...`** (см. таблицу в `domain-index-v1.md`; в kb-public — если файл не исключён иначе). |
| 357 | <!-- /section:router-sysadmin-ops --> |
| 358 | |
| 359 | <!-- section:learn-basics-when-stuck-router --> |
| 360 | |
| 361 | |
| 362 | |
| 363 | |
| 364 | ## Learn basics when stuck (agent discipline) |
| 365 | |
| 366 | - **При повторяющихся ошибках по одной задаче (CHAT_ID_INVALID, 404, неверный формат и т.п.), неясной семантике API/домена или фактическом угадывании параметров:** загружать `knowledge/worlds/agent-orchestration/playbook-learn-basics-when-stuck-v1.md` — правило: остановиться, изучить матчасть (официальная документация, KB, Context7/MCP), при необходимости зафиксировать факты в KB, затем продолжать. Не метаться trial-and-error. |
| 367 | <!-- /section:learn-basics-when-stuck-router --> |
| 368 | |
| 369 | <!-- section:router-agent-autonomy --> |
| 370 | |
| 371 | |
| 372 | |
| 373 | |
| 374 | ## Agent autonomy without mentor (external world) |
| 375 | |
| 376 | - **При подготовке к самостоятельной работе без постоянного «учителя в контуре», при расширении scope за привычную среду (внешние API, чужие репо, неоднозначные источники), при вопросах о доверии к процессу без человека или о границах самостоятельных решений:** загружать `knowledge/worlds/agent-orchestration/playbook-agent-autonomy-and-routing-v1.md` — инварианты (Integrity POST, baseline), четыре режима (действовать / уточнить / отказаться / остановиться), transfer boundaries, эпистемика, связь с `knowledge/worlds/agent-orchestration/playbook-learn-basics-when-stuck-v1.md`, `knowledge/worlds/workspace-context/playbook-multi-project-context-v1.md`, `knowledge/worlds/agent-orchestration/playbook-clarification-general-query-v1.md`. Не путать автономию с угадыванием в незнакомом домене. |
| 377 | <!-- /section:router-agent-autonomy --> |
| 378 | |
| 379 | <!-- section:router-multi-project-context --> |
| 380 | |
| 381 | |
| 382 | |
| 383 | |
| 384 | ## Multi-project workspace / rational context |
| 385 | |
| 386 | - **При запросах о множестве репозиториев, выборе проекта, смешении контекстов между MCP и IDE, рациональном использовании памяти между проектами, «куда смотреть» в домашнем workspace, заведении нового workspace `scope`:** загружать `knowledge/worlds/workspace-context/playbook-multi-project-context-v1.md` — первичный `project-id`, порядок навигации (хаб → карточка `door-to-singularity` → README репо), §6c (жизненный цикл `scope`), что не подмешивать без зависимости, кластеры связанных репо, граница hot-context и длинного KB. Не перечислять все проекты «на всякий случай». Явное переключение primary/scope в чате — маркеры `[PRIMARY:…]`, `[SCOPE:…]`; полный текст протокола у автора канона может быть только в hot `agent-notes.md` ниже `<!-- public-cut -->` — тогда опираться на **`kb-protocols-and-entities-one-pager-v1.md`**, этот плейбук и `kb-one-pager-structure-and-protocols-v1.md`. |
| 387 | <!-- /section:router-multi-project-context --> |
| 388 | |
| 389 | <!-- section:router-session-summary --> |
| 390 | |
| 391 | |
| 392 | |
| 393 | |
| 394 | ## Длинная сессия / итоги / читаемый экспорт чата |
| 395 | |
| 396 | - **При разросшемся треде; по запросу пользователя подвести итоги / зафиксировать договорённости; по инициативе агента предложить подвести итоги** (длинный тред, риск потери нити, выгодно зафиксировать); **или** когда нужен читаемый экспорт вместо непрозрачного сжатия контекста: загружать `knowledge/worlds/agent-orchestration/playbook-session-summary-and-chat-export-v1.md`; **pressure / когда агент сам должен предложить checkpoint** — `knowledge/domains/agent-operations/playbook-context-pressure-checkpoint-v1.md`; операционный hub — `knowledge/agent-memory-and-operating-principles-v1.md` → `playbook-session-summary-and-chat-export-v1.md`. При работе с сырым `*.jsonl` Cursor — `tools/Export-CursorJsonlTranscript.ps1` (см. `tools/README.md`). |
| 397 | <!-- /section:router-session-summary --> |
| 398 | |
| 399 | <!-- section:router-kb-world-public-authoring --> |
| 400 | |
| 401 | |
| 402 | |
| 403 | |
| 404 | ## KB: любой мир, fundamentals, карточка домена (kb-public) |
| 405 | |
| 406 | - **При создании или существенной правке любого `knowledge/worlds/<slug>/` (любой домен), Domain Entry Map, fundamentals/playbook в мирах, hub `worlds/README.md`:** загружать `knowledge/worlds/knowledge-engineering/playbook-kb-world-public-authoring-v1.md` **до коммита**. Вычистить: scope/project-id, ссылки на `work/`, машинные пути, внутренние бренды; в `worlds/` — только vendor-neutral предметка и общеизвестные вендоры. Clone/диск/scope — в `work/projects/`, не в публичном слое. **Не** ограничивать проверку миром knowledge.engineering. |
| 407 | <!-- /section:router-kb-world-public-authoring --> |
| 408 | |
| 409 | <!-- section:router-kb-mcp-access --> |
| 410 | |
| 411 | |
| 412 | |
| 413 | |
| 414 | ## KB: доступ через MCP (agent-notes) |
| 415 | |
| 416 | - **При сбоях чтения `knowledge/` через agent-notes MCP, вопросах про `AGENT_NOTES_CANON_PATH`, после Reload Window, рассинхроне «MCP подключён» vs «агент не видит тулы», или когда нужно явно зафиксировать поведение «контур чтения канона недоступен»:** загружать `knowledge/worlds/knowledge-engineering/runbook-kb-mcp-access-v1.md`. Не дублирует L0 baseline. Связь: `SHOWCASE.md`, hub `agent-memory-and-operating-principles-v1.md`, `playbook-multi-project-context-v1.md` §6–§6c. |
| 417 | <!-- /section:router-kb-mcp-access --> |
| 418 | |
| 419 | <!-- section:router-captain-parallel-agents --> |
| 420 | |
| 421 | |
| 422 | |
| 423 | |
| 424 | ## Cursor: капитан и параллельные субагенты (Task) |
| 425 | |
| 426 | - **При координации нескольких субагентов (Task), параллельной разведке по репозиторию, декомпозиции крупной задачи на воркеров в Cursor:** загружать `knowledge/worlds/agent-orchestration/playbook-captain-parallel-agents-v1.md` — роли капитан/воркер, бриф, антипаттерны; область — любой проект/workspace, не один продукт (в плейбуке есть пример Cascade IDE). Связь: `knowledge/worlds/workspace-context/playbook-multi-project-context-v1.md` (primary/scope), `agent-memory-and-operating-principles-v1.md`. |
| 427 | <!-- /section:router-captain-parallel-agents --> |
| 428 | |
| 429 | <!-- section:router-clean-setup --> |
| 430 | |
| 431 | |
| 432 | |
| 433 | |
| 434 | ## Чистая установка KB (kb-public → personal) |
| 435 | |
| 436 | - **При первой настройке agent-notes-mcp, скачивании kb-public, заведении personal, «clean setup», онбординге участника:** загружать `knowledge/domains/agent-operations/playbook-knowledge-stack-clean-setup-v1.md` и `knowledge/templates/newcomer/README.md`. Не подставлять чужой org slug — пути и `{ORG_SLUG}` у пользователя. |
| 437 | <!-- /section:router-clean-setup --> |
| 438 | |
| 439 | <!-- section:router-org-kb-white-label --> |
| 440 | |
| 441 | |
| 442 | |
| 443 | |
| 444 | ## Организационный KB (white-label, свой org) |
| 445 | |
| 446 | - **При запросе поднять KB для своей GitHub-организации, `{ORG_SLUG}/kb`, group KB, seed org, canon-maintainer, без привязки к конкретному бренду:** загружать `knowledge/domains/agent-operations/playbook-org-kb-white-label-v1.md`, затем `map-kb-three-contours-v1.md`. Участник существующей org — фаза E в white-label + `playbook-knowledge-stack-clean-setup-v1.md` фаза 4. |
| 447 | <!-- /section:router-org-kb-white-label --> |
| 448 | |
| 449 | <!-- section:router-pedagogy-school-subjects --> |
| 450 | |
| 451 | |
| 452 | |
| 453 | |
| 454 | |
| 455 | |
| 456 | ## Pedagogy: школьные предметы (instruction science + subject worlds) |
| 457 | |
| 458 | - **При запросах о школьной педагогике, curriculum authoring, Rosenshine/CLT, reading/math/science pedagogy, ЗУН/gate constructs, или выборе предметного мира:** загружать **`knowledge/worlds/pedagogy-general/playbook-pedagogy-school-subjects-v1.md`** → **`status-pedagogy-school-subjects-v1.md`**. Порядок: **`playbook-pedagogy-fundamentals-to-operational-v1.md`** → **`kb-pedagogy-scientific-evidence-v1.md`** (cross-cutting) → subject **`kb-*-scientific-evidence-v1.md`** → one per-paper card → subject fundamentals. Карта: **`map-pedagogy-school-subjects-reading-v1.md`**. Перенос: **`matrix-pedagogy-cross-subject-transfer-v1.md`**; L1 acquisition — **`cognition-language-acquisition`** (deny без bridge). |
| 459 | - **RU written v1:** **`pedagogy-russian-language`** — Castles 2018, SVR, orthographic mapping cards. |
| 460 | - **Не путать:** **`cognition.language-acquisition`** (Snow/Clark/Saxton child L1); **`math.numerics-pde`** (инженерная math). |
| 461 | - **Публикация:** **`playbook-kb-world-public-authoring-v1.md`** до коммита любого `worlds/pedagogy-*`. |
| 462 | <!-- /section:router-pedagogy-school-subjects --> |
| 463 | |
| 464 | |