словарь, манифесты, README: одно слово — одна вещь, одно описание — один дом

- «готовность» значила и «запись можно брать», и «что считается сделанным»;
  второй смысл стал «определением сделанного» — своё же правило про занятое
  слово запрещало это прямо
- «пайплайн» жил в 24 местах вне журналов при том, что DECISIONS фиксирует
  его уход «целиком»; рабочее имя — конвейер
- «чекпоинт» в review значил стадию и проход, в resolve — остановку человеку;
  слово оставлено за остановкой
- у описания плагина было два дома, и три из четырёх уже разошлись. Сведены,
  и класс закрыт машиной: frontmatter.py сверяет plugin.json с marketplace,
  гейт разбужен на *.json
- README врал про односторонние зависимости и терял healthcheck на диаграмме
- перечень агентов в REMAINING отстал на два поколения

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
av
2026-08-09 18:45:39 +03:00
co-authored by Claude Opus 5
parent 63ba36d71d
commit 12882911a9
22 changed files with 180 additions and 90 deletions
+6 -6
View File
@@ -9,8 +9,8 @@ description: Вести содержимое документов канона
Определение канона и роли документов — [канон](../canon/references/canon.md),
здесь не пересказывается.
Главный вызывающий — **шаг синка документации в пайплайне задачи**. Пайплайн
живёт в другом плагине и зовёт этот скилл по имени; проект без пайплайна ведёт
Главный вызывающий — **шаг синка документации в конвейере задачи**. Конвейер
живёт в другом плагине и зовёт этот скилл по имени; проект без конвейера ведёт
документацию тем же скиллом вручную.
## Правило, из которого всё следует
@@ -55,7 +55,7 @@ description: Вести содержимое документов канона
- passport, security, conventions, review — не требуется: изменение внутреннее
```
## Сверка — не здесь, а на сессии
## Сверка — не здесь, а в `av-dev-docs:healthcheck`
Синк правит документы поодиночке, а расходятся они **между собой**: факт,
дописанный в `architecture.md`, уже живёт в `CLAUDE.md`; периметр в
@@ -80,8 +80,8 @@ description: Вести содержимое документов канона
**Язык правленого вычитывается на синке, и зовёшь агента `doc-wording` ты.**
Довод обратный доводу про судей: он читает **только названную пачку**, стоит
дёшево и ищет ровно то, что портится в момент письма, — залог, оценку без факта,
жаргон, термин без ввода. Ждать сессии здесь нечего: через месяц никто уже не
помнит, какую фразу имел в виду автор.
жаргон, термин без ввода. Ждать `healthcheck` здесь нечего: через месяц никто уже
не помнит, какую фразу имел в виду автор.
Позови его **последним шагом синка**, отдав список файлов, которых чек-лист
коснулся, — и назови этот список в промпте: по нему же он судит, известен ли
@@ -181,7 +181,7 @@ description: Вести содержимое документов канона
Твоя часть на синке: **дефект пишется сразу**, а не «потом, когда починим».
Со временем теряется не факт, а то, почему дефект не поймали, — единственное,
ради чего журнал есть. И решение сузить проверки (перестали звать проход, понизили
метка) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
метку) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
## Промоут в конвенции