словарь, манифесты, 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:
@@ -180,6 +180,14 @@ color: yellow
|
||||
|
||||
## Доклад
|
||||
|
||||
**Форма параллельна дому `вычитка-доклад` (`shared/language.md`), но копией не
|
||||
является, и маркера здесь нет намеренно.** Копию того дома везут проходы вычитки
|
||||
— `doc-wording` и `task-wording`; у судьи утверждений расходится каждое поле:
|
||||
находка стоит на **паре** документов, а не на одном, несёт **дом по канону** и не
|
||||
несёт «почему», а границы покрытия считают документы и спрашивают про спеки и
|
||||
архив изменений, а не про термины. Одинаков только порядок разделов, и сверять
|
||||
машиной в нём нечего.
|
||||
|
||||
Находки по одной, в порядке важности: прямые противоречия → факт в двух домах →
|
||||
поведение в обзоре → ADR и провенанс → пустые слоты. Первые ломают решения,
|
||||
которые по документам принимают; последние — только цену чтения.
|
||||
|
||||
@@ -219,7 +219,8 @@ capability), `openspec/config.yaml`.
|
||||
каталога показывает только `tasks.py check`. Позвал на шаге 5 скилл задач —
|
||||
его отчёт идёт в доклад отдельной строкой, и пункт «задачи без цели» в нём
|
||||
зелёным не станет: цели не сочиняются адаптацией (запрет записан у того, кто
|
||||
ведёт задачи), их проставляет человек порциями переоценки на первой сессии.
|
||||
ведёт задачи), их проставляет человек порциями переоценки на первом груминге —
|
||||
скилл `av-dev-tasks:groom`.
|
||||
|
||||
### 5. Объяви переходное состояние
|
||||
|
||||
|
||||
@@ -410,7 +410,7 @@ severity стоит здесь, а не выводится каждым прох
|
||||
- **Что считается сломанным** — какая красная проверка обгоняет развитие,
|
||||
то есть останавливает текущую работу:
|
||||
- **Ориентир по размеру порции:** своё число, если замерялось
|
||||
- **Что такое «сделана»:** пайплайн проекта пройден + критерии приёмки проверены
|
||||
- **Что такое «сделана»:** конвейер проекта пройден + критерии приёмки проверены
|
||||
поимённо
|
||||
|
||||
## Язык
|
||||
|
||||
@@ -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: Вести содержимое документов канона
|
||||
Твоя часть на синке: **дефект пишется сразу**, а не «потом, когда починим».
|
||||
Со временем теряется не факт, а то, почему дефект не поймали, — единственное,
|
||||
ради чего журнал есть. И решение сузить проверки (перестали звать проход, понизили
|
||||
метка) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
|
||||
метку) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
|
||||
|
||||
## Промоут в конвенции
|
||||
|
||||
|
||||
@@ -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`.
|
||||
|
||||
@@ -141,7 +141,7 @@ description: "Завести новый проект — сессия вопро
|
||||
|
||||
- Содержимое канона по ходу разработки ведёт скилл `docs`.
|
||||
- Раскладку проверяет `canon check`.
|
||||
- Первую задачу берёт пайплайн проекта; `architecture.md` и `conventions/`
|
||||
- Первую задачу берёт конвейер проекта; `architecture.md` и `conventions/`
|
||||
наполняются его шагом синка, а не заранее.
|
||||
|
||||
## Чего этот скилл не делает
|
||||
|
||||
Reference in New Issue
Block a user