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

Конфигурация

Кому это? Тому, у кого инструмент уже стоит и кто пишет или правит harnessimo.config.json. Когда читать? Когда нужен ключ, которым вы ещё не пользовались. Чтобы выбрать, какую проверку включить, есть таблица в гайде: симптом → секция.


Каждая секция необязательна, а отсутствие секции — это проверка, которая не работает. harnessimo doctor печатает этот список, и он и есть честный ответ на вопрос, что репозиторий гарантирует.

Страница генерируется из schema/harnessimo.config.schema.json. Править её руками бессмысленно: npm run docs:sync перезапишет, а тест упадёт на расхождении.

docs

Включает: proof

Proof-маркеры: каждое утверждение в тексте называет доказательство, которое делает его правдой.

Ключ Тип Что делает
roots array of string Каталоги, где искать Markdown. "." — корень репозитория, без рекурсии.
skip array of string Имена каталогов, внутрь которых не заходить.
maxDepth integer Насколько глубоко спускаться от каждого корня. Не даёт обходу уйти в вендоренное дерево.
mustCarryProof array of string Документы, которые в строгом режиме обязаны нести хотя бы один маркер. Сюда — те, что дают обещания.
commands object Префикс маркера → файл, объявляющий эти команды: { "make": "Makefile", "task": "Taskfile.yml", "pnpm run": "package.json" }.
migrations string or null Каталог, на который опираются маркеры migration:<prefix>.

tracks

Включает: tracks

Handoff-driven development: индекс живых треков работы и хендоффы, на которые он ссылается.

Ключ Тип Что делает
file string Индекс живых треков — по строке на трек, со статусом и следующим шагом.
log string Куда складывается итог закрытого трека.
specsDir string Где лежат спека, задачи и хендофф лана — по каталогу на лан.
taskFile string Файл со списком задач внутри лана; его отмеченные галочки читает task-гейт.
gateTasks boolean Требовать, чтобы отмеченная задача в живом лане несла proof-маркер.
staleAfterDays integer Через сколько дней живая строка трека, которую никто не обновлял, считается находкой. Полоса, брошенная на середине, сохраняет статус, следующий шаг и заявленные пути — само по себе это не протухает. 0 (по умолчанию) выключает правило.

queue

Включает: queue

Очередь работы. Состояние меняется только через прошедшую верификацию, а CI перепроверяет каждое утверждение.

Ключ Тип Что делает
file string Сама очередь: каждый пункт, его состояние и команда, которая его проверяет.
timeoutMinutes number Верификация, идущая дольше этого, — падение с названной причиной, а не зависание.
terminalByKind object Куда попадает пункт, когда его верификация прошла, — по видам.
maxActive integer Сколько задач очереди может быть активно одновременно (по умолчанию 1). wip_limit из файла очереди тоже действует, если он больше. Поднимайте его там, где цели меняются посреди задачи, вместо того чтобы помечать blocked работу, которая не заблокирована.

locked

Включает: locked

Файлы, которые определяют или обеспечивают сигнал приёмки; коммит агента не имеет права их трогать.

Ключ Тип Что делает
paths array of string Префиксы путей. Пусто — проверка выключена.
baseline string Файл, называющий коммит, с которого действует правило.
agentTrailer string Трейлер в сообщении коммита, помечающий авторство агента.

coldStart

Включает: cold-start

Может ли свежий клон установиться и проверить себя, имея только репозиторий?

Ключ Тип Что делает
requiredFiles array of string Файлы, которые обязаны быть в свежем клоне до запуска чего-либо, — те, на которые рассчитывает первая команда.
entryDocs array of string Документы, проверяемые на пути, которые разрешаются только на одной машине.
commands array of string Задокументированные команды, запускаемые внутри свежего клона.

cleanExit

Включает: clean-exit

Чистое состояние на выходе из сессии (лекция 12): мусора не осталось, прогресс записан.

Ключ Тип Что делает
scan array of string Префиксы путей, чьи изменённые файлы читаются. Пусто — проверка выключена.
markers array or null Строки, которые проходят сборку и означают незаконченную работу. Null — значения по умолчанию.
allow array of string Фрагменты путей-исключений — обычно те файлы, где эти маркеры и перечислены.
progressFile string Файл, который сессия обязана обновить, если меняла код.
codePrefixes array of string Что считается кодом для правила о прогрессе. Пусто — всё, что не Markdown.
progressThreshold number Число изменённых строк, ниже которого правило о прогрессе молчит, чтобы правку в одну строку не заставляли описывать. По умолчанию 50.
requireCleanTree boolean Падать также, когда в рабочем дереве есть незакоммиченные изменения.

instructions

Включает: instructions

Файл инструкций остаётся маршрутизатором, а не мануалом (лекция 04).

Ключ Тип Что делает
limits object Путь → максимальное число строк.

boundaries

Линии, которые коду пересекать нельзя: шаблон, который не должен появляться в определённой части дерева, и причина, по которой не должен. Оба репозитория, из которых выросла эта библиотека, написали это правило руками и по-разному — потому что объявить его было негде.

Ключ Тип Что делает
scan array of string Каталоги, которые читать. Всё под ними проверяется правилами, чьи пути его покрывают.
rules array of object Сами границы. Пустой список — проверка, которая ничего не найдёт.

thresholds

У измеренной метрики есть объявленный пол, и прогон ниже него не закончен. Проверка не считает метрики: команда самого проекта пишет файл результатов, а она читает и сравнивает. Только полы — метрика, где меньше значит лучше, это то же правило зеркально, а придумывать направление на нуле реальных случаев было бы гаданием.

Ключ Тип Что делает
results string Файл, который пишет команда подсчёта: JSON вида { метрика: число }.
floors string Файл с минимально допустимым значением каждой метрики. Положите его в locked.paths: агент, который может опустить себе проходной балл, оценивает сам себя.
command string Команда, которая создаёт файл результатов. Называется в сообщении, когда файла нет, и отсюда никогда не запускается — команды принадлежат проекту.

release

Включает: release

Версия — утверждение, сделанное на нескольких поверхностях: они обязаны совпадать.

Ключ Тип Что делает
manifest string Где объявлена отгружаемая версия. Обычно package.json.
changelog string Файл, описывающий каждую выпущенную версию.
tagPrefix string Как выглядит тег для x.y.z: "v" даёт v1.2.3.

tokens

Guard на чтение: повторное чтение файла, который не менялся, отклоняется, а стоимость сессии печатается. Принуждение в момент работы, а не проверка того, закончена ли она.

Ключ Тип Что делает
windowMinutes integer Сколько помнить прочитанное. После этого тот же файл можно читать снова — сессия, шедшая дольше, это уже не один кусок работы. По умолчанию 20.
statePath string Где лежит состояние сессии. Оно описывает один прогон, поэтому ему место вне git.

autonomy

Насколько работа в этом репозитории идёт под присмотром. Это нижняя граница, а не настройка: harnessimo check работает на этом уровне или выше, а --autonomy может её только поднять. Каждый уровень добавляет проверки, которые надзор на уровне ниже уже не ловит.

Ключ Тип Что делает
level "watched" | "reviewed" | "unattended" watched — человек читает каждый шаг; быстрые проверки. reviewed — за шагами никто не смотрел, но диф прочитают; добавляет переперепроверку и проверку закрытых поверхностей. unattended — не смотрел никто; добавляет чистый выход и холодный старт.

worktree

harnessimo worktree: по git worktree на каждый независимый поток работы, рядом с основным checkout и с установленными зависимостями. Не проверка — команда, которая открывает, вливает и убирает параллельные потоки.

Ключ Тип Что делает
prefix string Префикс ветки. wt- (по умолчанию) кладёт worktree add search на ветку wt-search.
dir string Куда класть worktree, относительно основного checkout. .. (по умолчанию) кладёт <repo>-<name> рядом с ним.
install array or null Команды, которые запускаются в свежем worktree, чтобы первый коммит прошёл pre-commit hook. Null (по умолчанию) берёт шаг установки из coldStart.commands, например npm ci; [] не запускает ничего.

herd

harnessimo herd: по панели herdr, worktree и агенту на каждую lane, которую можно запустить сейчас; агенты стартуют по несколько, чтобы не упереться в лимиты API. Не проверка — команда, которая планирует и запускает параллельные lane.

Ключ Тип Что делает
maxWorking integer Сколько агентов lane работают одновременно (по умолчанию 3). herd plan и herd up не запускают больше, считая уже работающих.
staggerSeconds number Пауза между стартами двух агентов в секундах (по умолчанию 20), чтобы их первые запросы не упёрлись в лимит вместе.
agentKind string Тип агента herdr, которым запускается каждый агент lane, через herdr agent start --kind (по умолчанию claude).
agentArgs array of string Аргументы для каждого агента lane после собственных флагов роли, например ["--model", "sonnet"]. --model или --effort отсюда перебивают роль — для этого флага. По умолчанию нет.
defaultRole string Роль, которую играет агент lane, если laneRoles не назвал другую (по умолчанию implementer). Модель и effort берутся из .claude/agents/<role>.md и передаются как --model и --effort при старте агента.
laneRoles object Slug lane → имя роли для lane, которая не implementer, например { "billing-review": "architect" }.
roles object Имя роли → { model, effort }; берётся там, где файла роли нет или он не называет ни то, ни другое. Файл главнее. Sonnet получает effort high, если ничего не сказано.
panesPerTab integer Панелей в одной вкладке herdr, считая панель координатора (по умолчанию 4). herd up добивает текущую вкладку до этого числа, остальных открывает в новой вкладке с именем её первой lane.
backoffSeconds array of number Паузы перед каждой повторной попыткой после ошибки лимита (429), в секундах (по умолчанию [60, 120, 240]). Вписываются в каждый стартовый промпт.