Files
dev-skills/decisions/53-canon-and-docs-two-skills.md
T
av bf6a173115 журнал решений: разложен по теме на файл, метки решений стали номерами
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
2026-08-13 12:40:56 +03:00

2.2 KiB

53. canon и docs остаются двумя скиллами (2026-08-09)

Р201. Слияние отклонено, и довод у него не про объём. Оба скилла лежат в одном плагине, и слить их казалось естественным завершением раскола. Мешает description: это не аннотация, а триггер — по нему загрузчик решает, звать ли скилл вообще, и ровно ради его сохранности заведён frontmatter.py. Моменты вызова у этих двух разные. canon срабатывает на «проверь документацию», «переведи на канон», «пришёл в старый проект»; docs — на «задача сделана, обнови документацию», «заведи ADR», «запиши наблюдение». Одно описание покрывает оба хуже, чем два покрывают каждое своё, и потеря здесь не в читаемости, а в том, что скилл перестаёт находиться.

Второй довод — тот же разрез, что репозиторий подтверждал уже трижды: раскладка против содержимого, «где лежит» против «что внутри». Он по глубине, а такой разрез, в отличие от разреза по охвату (тема 50), даёт два разных текста и держится сам, без помеченных копий.

Что из этого следует

С178. Границу между скиллами держит не тема, а момент вызова. Два текста об одном предмете живут порознь законно, если зовут их в разные минуты; и наоборот — один предмет, разрезанный так, что оба куска нужны одновременно, разрезан неверно.