Перейти к содержанию

Адаптация правил: думать внутри границ

Для кого? Для того, кто пишет правила, по которым будет работать агент, и для агента, который по ним работает. Когда читать? Когда правило встаёт между агентом и поставленной целью — или до того, как писать правила, чтобы им можно было следовать с суждением. Какая модель что делает — «Маршрутизация работы».


Правила пишутся под ситуацию, которую видел их автор. Агент, исполняющий каждое правило буквально, встаёт при первой же смене ситуации; агент, гнущий правила, когда удобно, обесценивает их все. Harness должен учить третьему поведению: думать и адаптироваться, не выходя за разрешённое.

Два вида правил

Жёсткие границы не гнутся никогда. Если такая мешает — агент останавливается и спрашивает.

  • Закрытые поверхности — файлы, определяющие успех (harnessimo locked).
  • Безопасность: секреты, разрушительные команды, продовые данные.
  • Обход проверки: --no-verify, ослабленный assert, пропущенный тест.
  • Подделка доказательств: состояние очереди, исправленное руками, proof-маркер, не называющий ничего.
  • Всё, что владелец оставил за собой.

Правила процесса существуют ради цели: порядок задач, ритм ревью, правила скоупа, списки решённых вопросов, выбор инструментов. Обычно именно так команда быстро приходит к «готово». Когда правило перестаёт это делать, это правило, которое больше не подходит, а не закон.

Порядок решения

  1. Это жёсткая граница? Стоп. Спросить человека, с доказательствами.
  2. Следование ему срывает поставленную цель? Изменить его — в пределах своих полномочий:
  3. с областью — на эту ветку или полосу, не на весь репозиторий;
  4. с записью — в DECISIONS.md: правило, причина, цель, которой это служит;
  5. обратимо — исходное правило остаётся на месте, поправка говорит, когда она кончается;
  6. никогда через правку закрытой поверхности. Если поправке нужен закрытый файл — подготовить изменение и точную команду и передать их человеку.
  7. Иначе — следовать ему. Правило, которое просто неудобно, всё равно правило.

Поэтому в шаблонах агентов, которые пишет harnessimo init, у каждого правила есть зачем: агент, который знает, что правило защищает, видит день, когда оно перестаёт защищать.

Три реальных случая

Список решённого против смысла ветки. В основной линии записано как решённое: «без Saga, без gRPC». Ветка существует ровно для того, чтобы показать сагу между сервисами. Следование списку срывает цель ветки, а список — правило процесса, поэтому ветка его меняет: с областью на эту ветку и с записью в DECISIONS.md о причине. Список в основной линии не тронут.

Ревью после каждой задачи сериализует параллельную поставку. Процесс говорит: «ревью после каждой задачи». При четырёх параллельных потоках каждый ждёт ревьюера после каждого коммита, и параллелизма больше нет. Ревью не отменяется — оно собирается в пакет, раз на поток, и ничего не вливается без ревью. Изменился ритм; гейт — нет.

Закрытый файл, который агенту нельзя коммитить. Поправке нужна новая строка в CONSTRAINTS.md, а это закрытая поверхность. Агент не коммитит её и не ищет, как обойти harnessimo locked. Он пишет точный диф и команду в отчёт, и применяет их человек.

Смена целей

Цели меняются на ходу — на другую lane, на работу над harness'ом, на другую ветку, — и это обычный путь, а не исключение. Вся смена — одна команда и одна новая lane:

harnessimo track pause checkout-totals --reason "владелец переключился на billing"
harnessimo track new billing        # или: harnessimo track resume <slug>

pause пишет paused (причина) и сегодняшнюю дату в строку lane в TRACKS.md и датированную заметку в начало раздела State её handoff'а, чтобы холодная сессия возобновила её за минуты. Lane на паузе с причиной здорова: её задачи не гейтятся, её ## Owns больше не огораживает lane, которая заняла её пути, и она никогда не считается протухшей. track resume возвращает все три — и если новая lane теперь с ней пересекается, harnessimo tracks скажет об этом тогда.

Пауза без причины поблажки не получает: это и есть брошенная lane, ради которой эти правила существуют. Proof-маркеры в lane на паузе по-прежнему должны разрешаться, и ограничение очереди в одну активную задачу по-прежнему действует — поднимите queue.maxActive там, где цели меняются посреди задачи, вместо того чтобы помечать blocked работу, которая не заблокирована.

Чем адаптация не является

  • Не молчанием. Поправка, которую никто не найдёт, — это обход. Её место — DECISIONS.md.
  • Не умолчанием для всего репозитория. Поправку с областью, которая раз за разом оказывается правой, человек предлагает как изменение самого правила.
  • Не тихо покрасневшей проверкой. Красная проверка — это информация о работе, а не мешающее правило процесса. Именно проверки делают адаптацию процесса безопасной.