| 1 | # Playbook: накопление troubleshooting-гайдов (v1) |
| 2 | |
| 3 | **Статус:** v1 · консолидация по мирам |
| 4 | **Индекс:** [`index-troubleshooting-v1.md`](index-troubleshooting-v1.md) |
| 5 | **Шаблон README мира:** [`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 | Product-only (пути репо, `settings.toml` продукта, ADR одного IDE, имена контролов продукта) — **только B** в `work/projects/…`. Реестр: [`work/troubleshooting/README.md`](../work/troubleshooting/README.md). |
| 17 | **В `worlds/…/troubleshooting/` запрещены** имена продуктов и product paths — только обобщённые симптомы стека + ссылка «карточка в work по `[PRIMARY]`». |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Структура мира (таксономия) |
| 22 | |
| 23 | В зрелом `worlds/<slug>/`: |
| 24 | |
| 25 | ``` |
| 26 | worlds/<slug>/ |
| 27 | status-*.md |
| 28 | playbook-*.md # операции |
| 29 | kb-*.md # факты |
| 30 | troubleshooting/ |
| 31 | README.md |
| 32 | playbook-<slug>-troubleshooting-v1.md |
| 33 | ``` |
| 34 | |
| 35 | - **Не** класть troubleshooting в корень мира (расползание имён). |
| 36 | - **Не** дублировать длинные § «Диагностика» в operational playbook — одна ссылка на `troubleshooting/`. |
| 37 | - Исключение: `matrix-*` в корне мира, если это роутер (software-authoring); troubleshooting дублирует fast router и ссылается на matrix. |
| 38 | |
| 39 | --- |
| 40 | |
| 41 | ## Когда создавать / расширять |
| 42 | |
| 43 | | Ситуация | Действие | |
| 44 | |----------|----------| |
| 45 | | Новый повторяющийся симптом в домене | Строка в `troubleshooting/playbook-…` | |
| 46 | | § Диагностика > ~8 пунктов в operational playbook | Перенос в troubleshooting, в operational — ссылка | |
| 47 | | Симптом только одного продукта | `work/projects/…`, не worlds | |
| 48 | | Два+ продукта, без product paths | Вынос B → A | |
| 49 | |
| 50 | --- |
| 51 | |
| 52 | ## Регистрация |
| 53 | |
| 54 | 1. Строка в [`index-troubleshooting-v1.md`](index-troubleshooting-v1.md) |
| 55 | 2. `troubleshooting/README.md` в hub мира (`worlds/<slug>/README.md`) |
| 56 | 3. Supplement router при частых формулировках |
| 57 | 4. Product: [`work/troubleshooting/README.md`](../work/troubleshooting/README.md) + `work/projects/<id>/README.md` |
| 58 | 5. Шаблон product playbook: [`templates/work/template-product-troubleshooting-v1.md`](../templates/work/template-product-troubleshooting-v1.md) |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## Provenance |
| 63 | |
| 64 | meta / process · 2026-05 world consolidation |
| 65 | |
| 66 | |