xgaida-x-nixi-tech-scribe

# Tech Scribe — журнал решений и каркас тех-вики Скилл обслуживает **три живых артефакта** `docs/wiki/tech`: журнал решений, реестр техдолга и целостность каркаса (frontmatter, ссылки, гейт). Справочник о коде он больше не ведёт — с 2026-07-30 правда о коде живёт в коде. ## Что изменилось 30.07.2026 (читать первым) Роль скилла сузилась. Раньше он «держал доку в соответствии с кодом» — это и породило дрейф: справочник дублировал код и молча отставал (239 коммитов без сверки, точность страниц ~60%). Теперь у каждого факта один владелец, выбранный по тому, что ломается при расхождении. Таблица владельцев и порог записи — **`CLAUDE.md`, раздел «Где живёт правда»**; здесь не дублируются. Провенанс — [`journal/2026-07-30-code-owns-truth-journal-owns-why`](../../../docs/wiki/tech/00-meta/journal/2026-07-30-code-owns-truth-journal-owns-why.md). Скиллу из этой раскладки принадлежит один владелец из трёх: журнал. **Обычная фича этого скилла не касается.** Запись в журнал делается из шаблона в `CLAUDE.md` — без чтения скилла и без чтения других записей. Скилл нужен там, где работы больше одной записи. ## Живое и мёртвое в `docs/wiki/tech` ``` 00-meta/ journal/ ЖИВОЕ — запись = файл ГГГГ-ММ-ДД-slug.md, append-only, индекса нет tech-debt.md ЖИВОЕ — отложенный долг и главная будущая таска tech-changelog.md АРХИВ — записи 19.06-28.07.2026, не пополняется index.md ЖИВОЕ — MOC, навигация 10-reference/ ЖИВОЕ, но только предписывающее: code-standards, editor-tools, scene-sorting, ui-typography, vfx-color, asset-inventory + генерируемый audio-inventory. Описывавшие код доки удалены 30.07.2026 (20-explanation/) РАСФОРМИРОВАН 30.07.2026 — описание вернулось в код, «почему» в journal/ 30-how-to/ ЖИВОЕ — про среду и пайплайны, не про код 40-planning/ АРХИВ замысла по фазам ``` **Владелец статуса один — `status` во frontmatter самого дока.** Списков «что заморожено» не заводить нигде: список стал бы вторым владельцем и разошёлся. ## Правила, нарушение которых = переделка (HARD) 1. **Замороженный док не оживляют.** Понадобился актуальный факт о коде — он идёт в код (`<summary>`/`<remarks>`) или в тест, а не в обновление архивной страницы. Правка архива допустима ровно двух видов: битая ссылка и штамп статуса. *Почему:* оживший наполовину справочник опаснее мёртвого — он снова врёт с видом истины. 2. **Запись журнала не редактируется и не читается пачкой.** Новое решение = новый файл. Решение заместилось — новая запись со ссылкой на старую; старую не переписываем. *Почему:* append-only и есть причина, по которой журнал не может отстать. Плюс запись без чтения соседей стоит ~150 токенов вместо ~29k — ровно поэтому ритуал теперь исполняется. 3. **Строка «Владелец правды» в записи обязательна.** Файл и/или тест, где живёт реализация. *Почему:* без неё журнал через месяц снова начнёт пересказывать код. 4. **`40-planning` — архив замысла.** Правим только статус-шапки; имена классов внутри плана не переписываем — это след замысла на момент фазы. *Почему:* переписать план под текущий код = потерять эволюцию «почему пришли к этому». 5. **Перенёс файл → починил ВСЕ ссылки по всему vault** (`tech` + `gdd`), затем `scripts/check-wiki-links.ps1`; красный гейт = не сдано. *Почему:* урок из практики — grep по одному `tech/` пропустил 4 gdd-ссылки. См. `references/automation-and-ci.md`. 6. **Не уверена — не пишу.** Память и старые доки — гипотеза. Это правило пережило смену роли: оно теперь про журнал (что действительно решили) и про tech-debt (пункт ещё открыт?). ## Когда меня зовут — четыре захода **Крупный заход по журналу.** Закрыть дыру за период: пройти `git log` за диапазон, отобрать коммиты с развилками (не мелкие фиксы — они и так в git), написать по файлу на решение. Порог тот же, что в `CLAUDE.md`. **Правка `tech-debt`.** Добавить пункт с триггером «когда чинить» или закрыть закрытый. Готча: статусы в реестре — снимок на 2026-07-28 и после аудита кода 07-26 не сверялись; перед починкой пункта сверять с живым кодом. **Структура и переносы.** Новый док, смена порядка (`order`), перенос, разбор архива. Схема frontmatter, слаги, механика переноса — `references/structure-and-frontmatter.md`. **Гейт ссылок.** `check-wiki-links.ps1` локально и `docs-lint.yml` в CI — `references/automation-and-ci.md`. ## Формат записи журнала Полный шаблон — в `CLAUDE.md`, раздел «Где живёт правда»; здесь только то, что шаблон не говорит: - **Имя файла** — `ГГГГ-ММ-ДД-slug.md`, slug латиницей: он попадает в коммиты и комментарии кода как стабильный id. Дата первой — хронологическая сортировка бесплатно. - **Frontmatter — ровно `title`, `date`, `tags`.** Ни `status`, ни `updated`, ни `order`: запись историческая, она не устаревает и не правится, а порядок берётся из имени. - `title` — EN, по системе vault (`Journal - Name`). Тело — по-русски. - Индекс папки **не пишем**: Quartz строит листинг сам, `ls` и есть навигация. Рукописный индекс стал бы вторым владельцем. - Две записи в один день — разные слаги, суффиксы-номера не нужны. ## Чеклист сдачи - [ ] Запись — новый файл; существующие не тронуты; frontmatter ровно из трёх полей - [ ] В записи есть «Почему» с отвергнутой альтернативой и «Владелец правды» - [ ] Замороженные доки не оживлены (кроме битых ссылок и штампов статуса) - [ ] `40-planning` тронут только по статус-шапкам - [ ] Своё предложение помечено `proposed`, не выдано за принятое - [ ] Переносила файлы — `check-wiki-links.ps1` зелёный (и `gdd`-ссылки проверены) ## Справочные файлы (читать по надобности) - `references/structure-and-frontmatter.md` — кластеры, слаги, `title`/`order`/`status`, MOC, механика переноса без поломки ссылок. - `references/automation-and-ci.md` — `check-wiki-links.ps1`, `docs-lint.yml`, Dataview-дашборд, связь с Doxygen (API-справка генерируется из кода и этому скиллу не принадлежит).