словарь, манифесты, 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
+2 -1
View File
@@ -219,7 +219,8 @@ capability), `openspec/config.yaml`.
каталога показывает только `tasks.py check`. Позвал на шаге 5 скилл задач —
его отчёт идёт в доклад отдельной строкой, и пункт «задачи без цели» в нём
зелёным не станет: цели не сочиняются адаптацией (запрет записан у того, кто
ведёт задачи), их проставляет человек порциями переоценки на первой сессии.
ведёт задачи), их проставляет человек порциями переоценки на первом груминге —
скилл `av-dev-tasks:groom`.
### 5. Объяви переходное состояние
@@ -410,7 +410,7 @@ severity стоит здесь, а не выводится каждым прох
- **Что считается сломанным** — какая красная проверка обгоняет развитие,
то есть останавливает текущую работу:
- **Ориентир по размеру порции:** своё число, если замерялось
- **Что такое «сделана»:** пайплайн проекта пройден + критерии приёмки проверены
- **Что такое «сделана»:** конвейер проекта пройден + критерии приёмки проверены
поимённо
## Язык
+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: Вести содержимое документов канона
Твоя часть на синке: **дефект пишется сразу**, а не «потом, когда починим».
Со временем теряется не факт, а то, почему дефект не поймали, — единственное,
ради чего журнал есть. И решение сузить проверки (перестали звать проход, понизили
метка) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
метку) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
## Промоут в конвенции
+6 -3
View File
@@ -130,9 +130,12 @@ check` и его скрипт; здесь начинается там, где к
- **Не проверяет раскладку, версию и ссылки** — это `canon check`, там машина.
- **Не судит язык** документов: залог, англицизмы, жаргон, термин без дома — это
агент `doc-wording`, и зовут его отдельно, по пачке правленных документов. У
него другой ритм: он нужен там, где текст только что писали, а не там, где он
год лежал. Оркестровать его нечем — он один и работает по названному списку.
агент `doc-wording`, и зовут его отдельно, по пачке правленных документов.
Звонящие у него названные — последний шаг синка в `av-dev-docs:docs`, шаг 9
`av-dev-docs:init` и шаг вычитки в обоих режимах `canon`, — просто ни один из
них не здесь. У него другой ритм: он нужен там, где текст только что писали, а
не там, где он год лежал. Оркестровать его нечем — он один и работает по
названному списку.
- **Не правит документы за агентов** — они возвращают формулировки, решение
подставить принимает человек или ты по его правилу.
- **Не заводит задачи** — этим владеет `av-dev-tasks:tasks`.
+1 -1
View File
@@ -141,7 +141,7 @@ description: "Завести новый проект — сессия вопро
- Содержимое канона по ходу разработки ведёт скилл `docs`.
- Раскладку проверяет `canon check`.
- Первую задачу берёт пайплайн проекта; `architecture.md` и `conventions/`
- Первую задачу берёт конвейер проекта; `architecture.md` и `conventions/`
наполняются его шагом синка, а не заранее.
## Чего этот скилл не делает