| 1 | # Индекс troubleshooting в KB (v1) |
| 2 | |
| 3 | **Статус:** living index · 2026-05-20 (консолидация по мирам) |
| 4 | **Процесс:** [`playbook-troubleshooting-collection-v1.md`](playbook-troubleshooting-collection-v1.md) |
| 5 | **Шаблон папки:** [`templates/worlds/template-world-troubleshooting-readme-v1.md`](../templates/worlds/template-world-troubleshooting-readme-v1.md) |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## Два контура |
| 10 | |
| 11 | | Слой | Путь | kb-public | |
| 12 | |------|------|-----------| |
| 13 | | **A** | `worlds/<world>/troubleshooting/` | Да | |
| 14 | | **B** | `work/projects/<scope>/` | Нет | |
| 15 | |
| 16 | **Правило:** в каждом зрелом мире — каталог **`troubleshooting/`** с `README.md` + `playbook-<world>-troubleshooting-v1.md`. Операционные `playbook-*` в корне мира — процесс; § «Диагностика» → ссылка в `troubleshooting/`. |
| 17 | |
| 18 | --- |
| 19 | |
| 20 | ## Реестр миров (слой A) |
| 21 | |
| 22 | | Мир / каталог | Troubleshooting playbook | |
| 23 | |---------------|-------------------------| |
| 24 | | `software-authoring` | [`playbook-software-authoring-troubleshooting-v1.md`](../worlds/software-authoring/troubleshooting/playbook-software-authoring-troubleshooting-v1.md) | |
| 25 | | `software-dotnet-avalonia` | [`playbook-avalonia-ui-troubleshooting-v1.md`](../worlds/software-dotnet-avalonia/troubleshooting/playbook-avalonia-ui-troubleshooting-v1.md) | |
| 26 | | `software-dotnet-tooling-roslyn` | [`playbook-dotnet-roslyn-troubleshooting-v1.md`](../worlds/software-dotnet-tooling-roslyn/troubleshooting/playbook-dotnet-roslyn-troubleshooting-v1.md) | |
| 27 | | `software-dotnet-csharp` | [`playbook-dotnet-csharp-troubleshooting-v1.md`](../worlds/software-dotnet-csharp/troubleshooting/playbook-dotnet-csharp-troubleshooting-v1.md) | |
| 28 | | `hci-ux-dx` | [`playbook-tooling-debug-troubleshooting-v1.md`](../worlds/hci-ux-dx/troubleshooting/playbook-tooling-debug-troubleshooting-v1.md) | |
| 29 | | `collaboration-git-pr` | [`playbook-git-pr-troubleshooting-v1.md`](../worlds/collaboration-git-pr/troubleshooting/playbook-git-pr-troubleshooting-v1.md) | |
| 30 | | `ops-network-admin` | [`playbook-ops-network-admin-troubleshooting-v1.md`](../worlds/ops-network-admin/troubleshooting/playbook-ops-network-admin-troubleshooting-v1.md) | |
| 31 | | `ops-observability-network` | [`playbook-ops-observability-network-troubleshooting-v1.md`](../worlds/ops-observability-network/troubleshooting/playbook-ops-observability-network-troubleshooting-v1.md) | |
| 32 | | `ops-reliability` | [`playbook-ops-reliability-troubleshooting-v1.md`](../worlds/ops-reliability/troubleshooting/playbook-ops-reliability-troubleshooting-v1.md) | |
| 33 | | `knowledge-engineering` | [`playbook-knowledge-engineering-mcp-troubleshooting-v1.md`](../worlds/knowledge-engineering/troubleshooting/playbook-knowledge-engineering-mcp-troubleshooting-v1.md) | |
| 34 | | `world-life` | [`playbook-world-life-troubleshooting-v1.md`](../worlds/world-life/troubleshooting/playbook-world-life-troubleshooting-v1.md) | |
| 35 | | `software-php-laravel` | [`playbook-php-laravel-troubleshooting-v1.md`](../worlds/software-php-laravel/troubleshooting/playbook-php-laravel-troubleshooting-v1.md) | |
| 36 | | `cognition-human-perception` | [`playbook-cognition-perception-troubleshooting-v1.md`](../worlds/cognition-human-perception/troubleshooting/playbook-cognition-perception-troubleshooting-v1.md) | |
| 37 | | `systems-it` | [`playbook-systems-it-troubleshooting-v1.md`](../worlds/systems-it/troubleshooting/playbook-systems-it-troubleshooting-v1.md) (роутер) | |
| 38 | |
| 39 | **Легаси:** корень [`tooling-debug-playbook.md`](../tooling-debug-playbook.md) → hci `troubleshooting/`. |
| 40 | **Матрица (не отдельная папка):** [`matrix-software-cross-domain-transfer-v1.md`](../worlds/software-authoring/matrix-software-cross-domain-transfer-v1.md) — дублирует fast router в `software-authoring/troubleshooting/`. |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## Слой B (product) — только полный канон |
| 45 | |
| 46 | **Не kb-public** (префикс `work/` в `public-kb.ignore`). В публичном срезе — только слой A; product playbooks живут в репозитории **agent-notes** целиком: `work/troubleshooting/README.md` → `work/projects/<scope>/<project-id>/playbook-*-troubleshooting-v1.md`. |
| 47 | |
| 48 | В `worlds/` **нет** product troubleshooting — при `[PRIMARY:…]` в полном каноне: сначала A, затем реестр work. |
| 49 | |
| 50 | --- |
| 51 | |
| 52 | ## Маршрутизация агента |
| 53 | |
| 54 | 1. Есть `[PRIMARY]` / `project-id` и симптом **специфичен продукту** → контур B в **полном каноне** (`work/troubleshooting/README.md` → playbook в `work/projects/…`) |
| 55 | 2. Иначе → `worlds/…/troubleshooting/playbook-…` (этот индекс § A; kb-public) |
| 56 | 3. Software неявный → `software-authoring/troubleshooting/` |
| 57 | 4. Sysadmin → `domain-index-v1.md` → ops `troubleshooting/` |
| 58 | 5. Роутер: `router-troubleshooting-index` (supplement, kb-public). Product layout — `section_id` `router-cascade-ide-layout-troubleshooting` в `work/projects/door-to-singularity/cascade-ide/router-cascade-ide-layout-troubleshooting-v1.md` |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## Backlog |
| 63 | |
| 64 | - [ ] `pattern-regex/troubleshooting/` при росте симптомов engines |
| 65 | - [ ] `aviation-human-factors/troubleshooting/` (метафора vs product layout) |
| 66 | - [ ] systems-it: facet playbooks по digest IT Knowledge Expansion |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ## Provenance |
| 71 | |
| 72 | layer: meta / index · consolidation 2026-05 |
| 73 | |
| 74 | |