LOOPER — проектирование цикла до запуска

Плохо спроектированный цикл жжёт токены и копит мусор. Дешевле потратить пять минут на harness, чем полмиллиона токенов на разъехавшийся прогон. Это слой проектирования перед /loop, фоновым агентом или автономным /goal.

Принцип: цикл без критерия «готово» — это while(true) с биллингом.

Когда применять

• Перед /loop с самопейсингом (модель сама решает, когда остановиться).
• Перед фоновым агентом / Workflow, который крутит итерации.
• Перед автономным /goal (в т.ч. автономные task-раннеры, self-improve cron).
• Когда задача — «делай X, пока не станет Y».

Если это разовое действие без повтора — LOOPER не нужен, просто сделай.

Процесс (по шагам)

1. Уловить замысел. Одна фраза: что зацикливаем и как выглядит результат. Если размыто — уточнить, иначе цикл не сойдётся.
2. Критика по антипаттернам (ниже). Назвать конкретные дыры в черновом цикле.
3. Собрать harness-спеку — заполнить template.md (рядом в этой папке). Все поля обязательны; «н/д» — осознанный выбор, а не пропуск.
4. Нарисовать ASCII-диаграмму цикла (шаблон ниже).
5. Выдать команду запуска + путь к сохранённому артефакту.

Антипаттерны — что критиковать в черновике

• Нет критерия готовности → крутится вечно или встаёт рано. Чинится done_rubric.
• Нет стоп-условий → разъезд. Нужны и max_iters, и no_progress_rounds (loop-until-dry: K раундов без нового прогресса).
• Нет бюджета токенов → сжигает счёт. Hard cap или soft с порогом; цикл должен видеть остаток.
• Самооценка исполнителя → исполнитель всегда ставит себе «зачёт». Нужен независимый судья.
• Нет состояния между итерациями → повтор по кругу. Где пишется «сделано / осталось».
• Слишком широкий шаг → одна итерация делает слишком много, нечего проверять. Сузить iteration_unit.
• Нет реальной верификации → «должно работать». Связка с verify-done: гонять настоящую команду, читать вывод.

Harness-спека — поля артефакта

Поля кладутся в YAML-блок артефакта (см. template.md) — машиночитаемо и переносимо.

ASCII-диаграмма (шаблон)

          ┌───────────────────────────────────────────┐
          │  STATE (state.where): сделано / осталось   │
          └───────────────┬───────────────────────────┘
                          │ читать
                          ▼
   ┌──────────────┐   iteration_unit   ┌──────────────────┐
   │  ИСПОЛНИТЕЛЬ  │ ─────────────────► │  результат шага  │
   └──────────────┘                    └────────┬─────────┘
          ▲                                      │ verify_cmd
          │ не готово / правки                   ▼
   ┌──────┴───────────┐  judge.how      ┌──────────────────┐
   │  СУДЬЯ (who)     │ ◄────────────── │  оценка по rubric │
   └──────┬───────────┘                 └──────────────────┘
          │ pass_threshold достигнут?
          │  да → СТОП (готово)
          │  нет → следующая итерация
          ▼
   стоп-условия: max_iters | no_progress_rounds (K) | token_budget исчерпан

Запуск (после проектирования)

• /loop — /loop <interval> для опроса/интервала, или /loop без интервала для самопейсинга; в промпт вшить путь к артефакту.
• Workflow — для детерминированной фан-аут/пайплайн-оркестрации с реальным бюджетом (budget.remaining()), судьёй-агентом и loop-until-dry.
• Фоновый агент / autonomous /goal — передать артефакт как контракт цикла.
• Судья отдельным вызовом — Codex/не-Claude как независимая проверка (через доступный CLI/MCP), либо subagent с rubric. Никогда не давать исполнителю самому ставить финальный «зачёт».

Связь с принципами

• Бюджет токенов — жёсткое ограничение, не совет (мировоззрение: не жечь впустую).
• verify-done — никакого «готово» без свежего доказательства; verify_cmd это формализует.
• YAGNI — harness ровно под задачу, не золотить. Спека короткая.
• Артефакт переносим и правится — «написанное живёт».