docs(skill): уточнено назначение README coordinator-loop

- Зачем:
  - README должен описывать границы скилла без ложных ожиданий от runtime-поведения.
- Что:
  - уточнена приёмка через агент другой модельной линии, если он доступен.
  - разделены проектная документация и документационные правки внутри issue.
  - проверяемость описана как свойство конечного результата цепочки.
- Проверка:
  - просмотрен staged diff README coordinator-loop.
This commit is contained in:
ddadmin committed 2026-06-14 18:57:48 +03:00
1 parent 2c70c97db3
commit 8f6d9de9d5
1 file changed
+11 -10
@@ -32,8 +32,8 @@ coordinator-loop каждый issue: worker по /tdd → саморе
закладывается проверяемость результата (см. «Что получается»). закладывается проверяемость результата (см. «Что получается»).
- **Скилл — исполнение.** Берёт **готовые** issues по одной и проводит каждую через - **Скилл — исполнение.** Берёт **готовые** issues по одной и проводит каждую через
цикл worker → саморевью → классификация → ревью на риске → коммит. цикл worker → саморевью → классификация → ревью на риске → коммит.
- **После скилла — приёмка.** Результат уходит на ревью другим агентом (обычно - **После скилла — приёмка.** Результат уходит на ревью агентом другой модельной
Claude — это и есть взгляд другой родословной) и на ручную проверку. линии, если он доступен, и на ручную проверку.
## Что делает и чего не делает ## Что делает и чего не делает
@@ -42,7 +42,8 @@ coordinator-loop каждый issue: worker по /tdd → саморе
Не делает: Не делает:
- не проектирует и не пишет документацию — это upstream; - не создаёт проектную документацию и не принимает архитектурные решения — это
предыдущий этап;
- не нарезает issues — это `/to-issues`; - не нарезает issues — это `/to-issues`;
- не отвечает за проверяемость результата — она закладывается при проектировании; - не отвечает за проверяемость результата — она закладывается при проектировании;
- не делает финальную приёмку — это ревью другим агентом плюс человек; - не делает финальную приёмку — это ревью другим агентом плюс человек;
@@ -60,13 +61,13 @@ coordinator-loop каждый issue: worker по /tdd → саморе
Один issue = один проверяемый коммит плюс отчёт — так пост-цикловое ревью и ручная Один issue = один проверяемый коммит плюс отчёт — так пост-цикловое ревью и ручная
проверка остаются посильными. проверка остаются посильными.
**Про проверяемость.** Прошлый прогон показал: если «готово» у issue — это «прочитай **Про проверяемость.** Прошлый прогон показал: если итог цепочки можно принять
diff», проверить всю цепочку руками не выходит. Лекарство — на уровне только чтением diff, ручная проверка становится слишком дорогой. Лекарство — на
проектирования: формулировать issue так, чтобы «готово» было **наблюдаемым** (запись уровне проектирования: у всего набора issues должен быть **наблюдаемый конечный
в Kafka-топик, строки в конкретной таблице, панель дашборда, вывод команды). Это результат** для приёмки (запись в Kafka-топик, строки в конкретной таблице, панель
ответственность `/to-issues` и брейншторма, **не** этого скилла. Если issue пришла дашборда, вывод команды). Это ответственность `/to-issues` и брейншторма, **не**
без наблюдаемого критерия, координатор отметит это как **риск** («проверять придётся этого скилла. Координатор может отметить слабую проверяемость как **риск** и вернуть
чтением кода») и вернёт сигнал на уровень выше, но сам проверку не выдумывает. сигнал на уровень выше, но сам критерий приёмки не выдумывает.
## Как вызвать ## Как вызвать