хвост задачи: отражение молча, новое — по слову человека

Синк документации делил правки по документам, а делить их надо по роду.
Отражение сделанного (вливание дельт, миграция, компонент в обзоре) пишется
молча: без правки документ станет ложным. Новая запись и новая норма — ADR,
конвенция, записка разведки, инвариант, периметр, дефект в журнале — только
предлагаются, а пишет их третий такт шага 6 после слова человека.

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

Сверка документов получила счётчик: doc-healthcheck оставляет след ключом
[healthcheck] last в .av-dev.toml, синк считает по нему задачи с прошлого
прогона и говорит строкой. Прежде признак «десяток задач» держался в памяти,
то есть не срабатывал.

Журнал — тема 78.
This commit is contained in:
av
2026-08-23 19:06:06 +03:00
parent 3c89d7111d
commit a4bc9191e7
12 changed files with 462 additions and 62 deletions
+15
View File
@@ -295,6 +295,11 @@ kebab-case.** Причина не эстетическая: имя файла с
«заменено на».
<!-- /дом: adr-когда-заводить -->
**Сработавший триггер даёт предложение, а не запись.** Заводит ADR человек своим
словом — правило и его причина в скилле `av-dev:doc-sync`, раздел «Два рода
правок». Канон здесь отвечает за другое: за то, при каких условиях предлагать
вообще есть что.
Не заводится для рутины и для того, что видно из кода и `git log`.
Записи неизменяемы: передумали — заводится новая, старая получает статус.
@@ -553,6 +558,9 @@ migrations = "internal/store/migrations" # если БД есть
[tasks]
dir = "tasks" # каталог задач от корня репозитория
[healthcheck]
last = "a1b2c3d" # сверка документов: коммит прошлого прогона
```
`version` — версия раскладки, под которую проект приведён, целым числом:
@@ -563,6 +571,13 @@ dir = "tasks" # каталог задач от корн
делает сверку с `database.md`. `[tasks]` — где лежит каталог задач и как названы
его части; состав ключей описывает скилл `task-track`.
`[healthcheck] last` — коммит, на котором в последний раз проходила сверка
документов; ставит его сам `av-dev:doc-healthcheck` последним шагом прогона, а
читает `av-dev:doc-sync`, чтобы сосчитать задачи, сделанные с тех пор. **Ключ
необязательный и в скелете его нет намеренно**: у нового проекта сверок не было,
и пустое значение врало бы про это меньше, чем отсутствие ключа, только на вид.
Отсутствие читается однозначно — «не сверялись ни разу».
**Формат TOML взят ради комментариев.** Файл лежит в репозитории проекта, и
человек, открывший его через полгода, обязан прочитать в нём, что означает
число. JSON комментариев не знает, и объяснение приходилось держать в другом