Адаптация правил: думать внутри границ
Для кого? Для того, кто пишет правила, по которым будет работать агент, и для агента, который по ним работает. Когда читать? Когда правило встаёт между агентом и поставленной целью — или до того, как писать правила, чтобы им можно было следовать с суждением. Какая модель что делает — «Маршрутизация работы».
Правила пишутся под ситуацию, которую видел их автор. Агент, исполняющий каждое правило буквально, встаёт при первой же смене ситуации; агент, гнущий правила, когда удобно, обесценивает их все. Harness должен учить третьему поведению: думать и адаптироваться, не выходя за разрешённое.
Два вида правил
Жёсткие границы не гнутся никогда. Если такая мешает — агент останавливается и спрашивает.
- Закрытые поверхности — файлы, определяющие успех (
harnessimo locked). - Безопасность: секреты, разрушительные команды, продовые данные.
- Обход проверки:
--no-verify, ослабленный assert, пропущенный тест. - Подделка доказательств: состояние очереди, исправленное руками, proof-маркер, не называющий ничего.
- Всё, что владелец оставил за собой.
Правила процесса существуют ради цели: порядок задач, ритм ревью, правила скоупа, списки решённых вопросов, выбор инструментов. Обычно именно так команда быстро приходит к «готово». Когда правило перестаёт это делать, это правило, которое больше не подходит, а не закон.
Порядок решения
- Это жёсткая граница? Стоп. Спросить человека, с доказательствами.
- Следование ему срывает поставленную цель? Изменить его — в пределах своих полномочий:
- с областью — на эту ветку или полосу, не на весь репозиторий;
- с записью — в
DECISIONS.md: правило, причина, цель, которой это служит; - обратимо — исходное правило остаётся на месте, поправка говорит, когда она кончается;
- никогда через правку закрытой поверхности. Если поправке нужен закрытый файл — подготовить изменение и точную команду и передать их человеку.
- Иначе — следовать ему. Правило, которое просто неудобно, всё равно правило.
Поэтому в шаблонах агентов, которые пишет 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. - Не умолчанием для всего репозитория. Поправку с областью, которая раз за разом оказывается правой, человек предлагает как изменение самого правила.
- Не тихо покрасневшей проверкой. Красная проверка — это информация о работе, а не мешающее правило процесса. Именно проверки делают адаптацию процесса безопасной.