Два круга кросс-ревью правок (находки по убыванию: конфликт уровней,
затем стенд/человек), раздел «Контракт автономного прогона» и открытый
пункт: контракт не проверен вживую до следующей цепочки.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
По ревью Codex: «живой стенд» ошибочно попал в класс «может проверить
только человек». Теперь как в статус-контракте: недоступную worker-у
проверку прогоняет координатор (часть коммит-гейта), открытым риском в
handoff уходит лишь то, что недоступно и ему — ручная приёмка, внешняя
среда.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
По предложению Codex из ретро: скилл проектировался под сценарий «передал
очередь issue и ушёл», но входной контракт и мандат были неявными. Новый
раздел фиксирует вход (issue, порядок, «зачем»), мандат (весь цикл без
уточняющих вопросов; за пределы локального репозитория — только по
поручению) и сводку стоп-условий со ссылками на их разделы — без
пересказа правил, чтобы не разъезжались. Предупреждение о третьем круге
уточнено: это не вопрос, ответа не ждать.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
По ревью Codex: фраза «дефолт — рабочий уровень» противоречила таблице
effort-levels.md (worker обычного issue — экономный) и толкала запускать
всех worker-ов на high; заменена на выбор уровня по роли и классу issue.
Заодно «форма распределений» расширена до доменных инвариантов данных —
скилл общий, а не только для генератора.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Итоги эксперимента medium-worker (критерий выхода не сработал), ссылка на
правки b8f1fe0, закрытые и оставшиеся пункты из «не сделано».
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Три уточнения по отзыву Codex, сверенному с журналом координатора:
- предусловие входа: качественно подготовленные issue (выход /to-issues),
мутные — сначала прояснение замысла;
- точная граница чтения координатора: запрет только на код ради
верификации, процессные артефакты — его зона;
- классификатор риска расширен маркерами из прогона (версионирование
state, разрушающие пути, fail-open проверки); в effort-levels.md —
итог калибровки: уровни не менять, точность даёт классификация issue.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- на прогоне 2026-07-05 make generator-test с зашитым pytest -v высыпал
в контекст координатора полный список из 181 теста: правило «только
сводка» было, а механики не было.
- Что:
- шаг 7: гейт координатор гоняет сам (не через субагента), шумные
команды — в файл-лог, в контекст только код возврата и итоговые
строки; интерпретация объёмного вывода — разборщику логов
экономного уровня.
- ведущее правило и чек-лист дополнены той же механикой.
- effort-levels: «разбор логов» добавлен в экономный ярус Claude Code.
- Проверка:
- вычитка SKILL.md; grep по pytest/сводка/файл-лог — противоречий нет.
- Зачем:
- session-handoff писался до живого прогона; вторая волна правок и
результат кросс-прохода не были зафиксированы.
- Что:
- дополнение к handoff сессии: шесть находок прогона, вторая волна правок,
урок «живой прогон под наблюдением — самый дешёвый источник находок».
- rationale: поправка 2026-07-05 — третий случай подтверждения находки
о родословной (1 critical, 5 high после APPROVED той же линии).
- Проверка:
- перекрёстные ссылки на отчёт кросс-ревью и коммиты правок сходятся.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- триаж находок финального ревью не был назначен никому (worker-ы уже
закрыты); ретроспектива координатора после цепочки 12-08 дала
проверенные боевые предложения.
- Что:
- триаж находок финала — у fixer-а тем же механизмом, что у worker-а.
- словарь статусов отчётов и правило «APPROVED != завершение цепочки».
- предупреждение пользователю на третьем круге ревью, до потолка.
- шаг 3: уровень worker-а явно по effort-levels.md и в журнал.
- Проверка:
- перечитывание разделов «Цикл» и «Финал цепочки» после правок.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- правило «всё чинит fixer» было слишком грубым: процессные файлы
(PRD фичи, чекбоксы issue, журнал) — прямая зона координатора по
построению скилла, отдавать их fixer-у бессмысленно.
- Что:
- граница по классу файла: процессные — координатор сам (симптом
пропущенного п.1), файлы проекта — fixer-субагент, кодовая находка —
мини-issue с rerun ревью.
- Проверка:
- сверка с живым прогоном: находки Bernoulli (PRD, чекбоксы) — класс 1,
World Map в пользовательских доках — класс 2.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- живой прогон: координатор сам правил доки по находкам финального ревью
(полные тексты в контексте, второй писатель) и дал промежуточный статус,
прочитанный пользователем как завершение.
- Что:
- находки финального ревью чинит fixer-субагент с worker-контрактом,
не координатор.
- до выполнения финала каждый отчёт пользователю явно называет статус
цепочки и остаток.
- Проверка:
- перечитывание раздела «Финал цепочки».
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- координатор прочитал «свежие сессии» как запрет продолжать субагента:
пять полных xhigh-обходов финального ревью вместо узких rerun-ов.
- Что:
- правило уточнено: свежая сессия — про запуск без форка истории;
узкий rerun — продолжение того же ревьюера через send_input.
- свежий ревьюер обязателен по триггерам: спор, эскалация, широкая
переработка, слабый индекс; правило продублировано в шаге 5 и финале.
- reviewer-prompt.md: PREVIOUS_FINDINGS_BLOCK — только для свежего
субагента.
- Проверка:
- сверка с механикой rerun в claude-team-review (продолжение — штатный
путь, блок прошлых находок — для свежего).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- эксперимент «worker на medium» должен быть измерим: круги ревью против
уровня worker-а видны только если уровень записан.
- Что:
- точка записи «старт issue» дополнена уровнем мышления worker-а.
- Проверка:
- перечитывание раздела «Журнал прогона».
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- у worker-а есть страховочная сетка ниже по течению, у ревьюера нет:
глубина мышления важнее на ревью, а worker — самая дорогая петля.
- Что:
- таблицы уровней: worker на обычном issue — экономный (medium), любое
code review и worker на гейтовом issue — рабочий (high).
- в SKILL.md ярусы получили обоснование членства ролей.
- Проверка:
- согласованность ярусов SKILL.md с обеими таблицами effort-levels.md.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- живой прогон issue 12 показал: субагенты не наследуют уровень сессии,
дефолт spawn_agent — medium, worker и ревьюер молча ушли ступень ниже.
- Что:
- effort-levels.md: явные значения уровней (medium/high/xhigh) и
предупреждение про дефолт spawn_agent.
- журнал: фиксировать фактический уровень хоста, не название яруса.
- Проверка:
- сверка с конфигом сессии (model_reasoning_effort = high) и экраном
прогона (spawn gpt-5.5 medium).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- живой прогон issue 12 показал: координатор тратит циклы на попытки
передать worker-у полный контекст форком своей истории.
- Что:
- явное правило в раздел ролей: worker, ревьюеры и диагносты запускаются
свежими сессиями; форк тащит контекст координатора и убивает
независимость ревьюера.
- Проверка:
- перечитывание раздела «Роли» после правки.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- зафиксировать итог сессии для продолжения: как проверялся пакет,
повороты после ревью, что осталось незамеренным.
- Что:
- добавлен handoff 2026-07-04-rework-session-claude-line.md.
- в пакете правок обновлена строка статуса (внесено и закоммичено).
- Проверка:
- перекрёстные ссылки между двумя handoff'ами сходятся.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- боевой прогон цепочки 07-11 показал: worker в Codex не может запускать
субагентов, ревью шло пятью кругами без ограничителя, финальный handoff
и закрытие issue выпадали из цикла.
- Что:
- ревьюеров запускает координатор (наблюдатели, ограничение промптом),
триаж находок и флаг «спор» — в worker-е; политика кругов с потолком.
- две ручки стоимости: модель по роли и уровень мышления, таблица
references/effort-levels.md; шаблон references/reviewer-prompt.md —
скилл самодостаточен, без файлов claude-team-review.
- журнал с метками времени; финал: PRD до ревью, Status: done
docs-коммитом, handoff — условие выхода; handoff пакета правок.
- Проверка:
- адверсарное ревью пакета свежим субагентом (2 блокера и 7 important
закрыты) плюс саморевью; следующий боевой прогон цепочки — замер.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- инцидент 2026-07-03: координатор молча подменил ревью и записал
недоказанную причину, а кросс-линейный проход нашёл серьёзные дефекты
после APPROVED ревьюера той же линии — процессу нужны след и честность.
- Что:
- контракт worker-а: строка происхождения ревью в индексе (режим,
механизм, ревьюер, вердикт), сверка на коммит-гейте.
- append-only журнал прогона coordinator-journal.md: запись в момент
события, handoff собирается по журналу, отклонения фиксируются фактами,
причины-предположения запрещены; честная граница защиты названа явно.
- кросс-линейный проход поднят до рекомендованного по умолчанию для
нетривиальной цепочки; дубли свёрнуты (саморевью, раздел «Родословная»);
датированная поправка с эмпирикой в references/rationale.md.
- Проверка:
- /claude-team-review code (adversarial-reviewer, Opus, read-only):
APPROVED после 2 раундов, неблокирующие заметки применены.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Переписан SKILL.md (194→159): user-invoked, ведущее правило «работай по
индексу», per-finding триаж делегирован claude-team-review, режимы ревью
по риску (два лена разными субагентами на риске), коммит-гейт берёт только
сводку тестов, финал = ревью на соответствие замыслу + handoff под ручную
кросс-линию. README, rationale и июньский context-economy handoff подровнены;
добавлен handoff по сессии. Прошёл /claude-team-review — 2 раунда, APPROVED.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Зачем:
- сохранить выводы сессии проектирования у самого навыка, чтобы будущая сессия по доработке нашла их рядом с handoff про наблюдаемость.
- Что:
- добавлена расширенная версия handoff: диагностика двух «пожаров» по логам Codex, prior art (obra:superpowers), два принятых правила с адресами правок в SKILL.md, кандидаты-фиксы и открытые вопросы.
- Проверка:
- открыть handoffs/2026-06-14-coordinator-loop-context-economy.md
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Зачем:
- нужно передать на другую машину договорённости по наблюдаемости coordinator-loop.
- Что:
- добавлен handoff с форматом live-логов, summary и правилами gitignore.
- зафиксированы отказ от state.md и run-id, а также best-effort heartbeat.
- Проверка:
- просмотрен staged diff нового handoff-файла.
- Зачем:
- README должен описывать границы скилла без ложных ожиданий от runtime-поведения.
- Что:
- уточнена приёмка через агент другой модельной линии, если он доступен.
- разделены проектная документация и документационные правки внутри issue.
- проверяемость описана как свойство конечного результата цепочки.
- Проверка:
- просмотрен staged diff README coordinator-loop.
- Зачем:
- дать человеку и будущей сессии быстрый вход: зачем навык, где в конвейере, что на выходе.
- Что:
- описаны место в потоке (brainstorm/grill -> to-issues -> coordinator-loop -> приёмка) и границы навыка.
- зафиксировано, что проверяемость результата закладывается при проектировании, а не в этом скилле.
- якоря контекста самодостаточны: ссылки только на SKILL.md и references/rationale.md.
- Проверка:
- открыть agents/.agents/skills/coordinator-loop/README.md.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Зачем:
- закрепить эксперимент с координатором субагентов как переиспользуемый навык для Codex.
- Что:
- добавлен SKILL.md с циклом worker -> саморевью -> классификация -> ревью -> коммит.
- эмпирика эксперимента вынесена в references/rationale.md.
- добавлен мост codex/.codex/skills/coordinator-loop для подхвата навыка в Codex.
- навык только по явному вызову (/coordinator-loop), без автосрабатывания.
- Проверка:
- ls ~/.agents/skills/coordinator-loop/SKILL.md; вызов /coordinator-loop в Codex.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>