Files

T

скиллы: doc-canon стал canon, версия раскладки поднята до 2

- каталог скилла и все вызовы переименованы: префикс `doc-` называл материал,
  а скилл занят формой — раскладкой всех частей проекта и общим повышением
  версии, включая каталог задач;
- README перестроен: `canon` вынесен из семейства документов отдельным блоком
  и отдельным узлом графа, правило префиксов переформулировано, у документов
  уточнено владение — содержимым, а не раскладкой;
- заведена запись 2 журнала версий: в проекте ничего не переехало, но путь к
  `docs.py` и имя вызова живут в гейте и в `CLAUDE.md` проекта и сломаются
  молча;
- прежние адреса в записи 1 и в журнале решений оставлены как есть: журнал
  описывает состояния, которые были, и задним числом не переписывается.

2026-08-13 12:53:12 +03:00

8.3 KiB

Raw Blame History

Оси процесса

Это дом перечня, а не значений. Что означает каждое значение и как оно работает, знает владелец оси — здесь только сама ось, её дом и чего она не решает. Второй пересказ механики разошёлся бы с первым; перечень же нужен целиком и в одном месте, потому что вопрос «а не задаёт ли это метку» задают из скилла, который метку не ведёт.

Ось — это закрытый перечень значений, по которому что-то ветвится. Признак проверяемый, и он отсекает похожее: темы ревью и документы проекта — списки открытые, их пополняет проект, и перечень в плагине протух бы на первом же своём документе. Модель прохода — не ось, а цена прогона; её дом — «Модель по проходу» в code-review, механизация — frontmatter.py.

Перечень

Ось	Значения	Дом
тип записи	`goal` `feature` `fix` `chore` `research`	`task-track/SKILL.md`, «Тип записи»
сценарий	решение · обслуживание · разведка	`code-resolve/SKILL.md`, «Развилка»
метка	`small` `medium` `large`	`code-review/SKILL.md`, «Метки»
режим прогона	с меткой · без метки	здесь, ниже
стадия ревью	дизайн · код	`code-review/SKILL.md`, «Ревью дизайна»
категория документа	тема · источник темы · процессный	`canon/references/canon.md`
severity находки	`critical` `major` `minor` `nit`	`code-review/references/finding-contract.md`
коды выхода	0 1 2 3 4	здесь, ниже

Две оси стоят домом здесь, и обе по одной причине: владельца у них нет. Коды выхода делят восемь скриптов и три скилла, режим прогона — конвейер, сценарий обслуживания и два устава.

Что на что влияет

Клетка называет место, где связка описана; сама связка живёт там.

Влияет	На что	Где описано
тип записи	сценарий — предлагает, подтверждает предмет работы	`task-track/SKILL.md`, «Тип записи»
тип записи	метку и глубину — не влияет, и это записано явно	там же
сценарий	режим прогона: обслуживание идёт без метки	`code-resolve/references/maintain.md`
метка	состав проходов обеих стадий	`code-review/SKILL.md`, «Метки»
метка	глубину темы: против чего смотрят и как	там же
режим прогона	состав проходов и саму возможность запуска прохода	`code-review/SKILL.md`, «Прогон без change»
категория документа	заводит ли документ направление проверки	`canon.md`, «Три категории»
severity	что с находкой делают дальше	`code-review/SKILL.md`, «Что происходит с находками»

Две клетки пусты, и это сказано намеренно, а не забыто.

Категория документа × режим прогона. На прогоне с меткой своя тема проекта закрыта при любом значении: review-basics — приёмник проектных тем и при small, и при large, и при medium. На прогоне без метки план фиксирован сценарием — autotests, operations, conventions, — и своих тем проекта в нём нет. Значит, документ, заведённый проектом как тема, на обслуживании не смотрит никто, и строкой это нигде не называется.

Режим прогона × severity. Триаж обязателен всегда, в том числе без метки. Но часть оснований critical — построенный путь к отказу, замер — добывается проходами, которые без метки не запускаются. Значит ли это, что critical на прогоне обслуживания не бывает, или что его основания там другие, не сказано.

Режим прогона

Прогон ревью идёт в одном из двух режимов, и режим — не глубина.

С меткой — обычный прогон по change: разметку сделал review-scope, состав обеих стадий выведен из метки.
Без метки — прогон сценария обслуживания: change нет, размечать нечего, план фиксирован и назван сценарием. Разметчик не запускается вовсе.

Без метки — не то же самое, что small. small — это суждение о размере и сложности, снятое с изменения; отсутствие метки — утверждение, что снимать её не с чего. Проход, подставивший себе small там, где метки нет, вывел бы глубину из ничего.

Режим правит не только состав, но и саму возможность запуска. Проход, у которого запуск задан меткой, без метки не имеет ответа на вопрос «запускаться ли» — и ответ ему даёт план сценария, а не умолчание.

Коды выхода

Коды выхода — общий словарь всех скриптов av-dev. Ветвись на коде, а не на тексте вывода.

Код	Что случилось
0	сошлось
1	дрейф: рабочая ситуация, чинится
2	ошибка употребления: аргументы или нарушенное правило
3	окружение: не тот каталог, битый конфиг, нет инструмента
4	внутренний сбой — дефект скрипта, доложить

Различать 1 и 3 обязательно. «Дрейф» — рабочая ситуация, и чинится она правкой предмета; «окружение» — нерабочая, и повтор той же командой не поможет. Одинаковая реакция на них неверна в обоих случаях.

Словарь был объявлен «общим» в одиннадцати местах, и каждое объявление перечисляло свой набор соседей: «тот же, что у tasks.py», «тот же, что у tasks.py, docs.py и copies.py», «общий словарь скриптов av-dev». Ни одно из них не было домом, все — списки по памяти. Отсюда дом здесь: у словаря восемь скриптов-потребителей и ни одного владельца.

8.3 KiB Raw Blame History Unescape Escape