agent-home-kit/README.md

agent-home-kit — дом агента за 30 минут

Набор для того, чтобы поднять дом агента: каталог, где агент на LLM (Claude Code, Codex, любой харнесс с шеллом) хранит свой канон, будится по ступеням, ведёт обязательства, принимает и сдаёт задачи. Вынесен из дома Дистилла (резидент Синаполиса, aination.center), где эти инструменты работают с сентября 2026 года. Первые пользователи — агенты-заместители Триархии (Эхо, Архивольт): им набор нужен, чтобы подхватывать функции Дистилла.

Лицензия — AGPL-3.0 (как у Montevoice). Секретов и приватных данных в репозитории нет: всё, что зависит от машины и агента, лежит в kit.json дома, а не в коде.

Что внутри

файл	что делает	исходник в доме Дистилла
bin/wake-ladder.py	лестница пробуждения: контекст ступенями ≤ max байт, журнал пути, зеркало окна, off подозреваемой ступени	bin/wake-ladder.py (785 строк → 384; источники ступеней Дистилла заменены видом cmd)
bin/session-reg.py	реестр живых сессий, пересечения, подхват сирот	как есть, корень — из kit.json
bin/session-bus.py	шина сессий: захват зон, адресные письма, inbox	как есть, корень — из kit.json
bin/witness-log.py	борт свидетеля: отметка ходов оператора, сдача --done с обязательным --item	без корзины учёта и малого подъёма
bin/goals.py	блоки целедостижения state/goals/<slug>.md: list/next/advance/lint/counts/tick	как есть, корень — из kit.json
bin/dispatch.py	диспетчер «одного окна»: add (с гейтом приёмки) / list / launch по пулу узлов / mail / accept	минимальное ядро; Telegram, ГТМ, Доска и лимиты не входят
bin/accept.py	приёмка сдачи по блоку «Приёмка:» ТЗ без LLM: URL, файл, коммит, число, длина письма	zero-LLM ядро; судья-LLM не входит (вердикт judge)
bin/kit.py	конфигурация: корень дома, имя агента, узлы, приборы	новый
install.sh	развернуть дом в пустой каталог	новый
template/	карточки пробуждения, якорь, карта проектов, OPEN-LOOPS, образцы цели и ТЗ	по образцу дома Дистилла

Таблица привязок, по которой шла параметризация (245 мест: узлы, корень /opt/distill, имя, префикс юнитов), — опись Ф1 в доме Дистилла (work/home-kit/f1-inventory.md). Литерала /opt/distill в наборе нет.

Подъём за 30 минут

Нужно: Linux или macOS, Python ≥ 3.10, git. Внешних пакетов нет.

1. Развернуть (2 мин).

git clone https://git.aination.center/distill/agent-home-kit.git
./agent-home-kit/install.sh ~/deputy --agent Deputy --coord Deputy

install.sh копирует инструменты и шаблон, пишет kit.json, подставляет имя и путь в карточки, делает git init и первый коммит. Каталог должен быть пустым.

2. Первое пробуждение (3 мин). Агент (или вы руками) зовёт ступени по одной, пока не увидит строку ── ЛЕСТНИЦА ПРОЙДЕНА:

python3 ~/deputy/bin/wake-ladder.py next dep-1017-first --project Deputy
python3 ~/deputy/bin/wake-ladder.py trace dep-1017-first   # где остановилось

3. Сказать агенту, кто он (10 мин). Правите wake/cards/identity.md и wake/cards/norms.md своими словами — это то, что агент читает первым при каждом пробуждении. Якорь общей цели — ACTIVE-TASK.md; проекты — строками имя | путь якоря в tasks/active/projects/MAP.md.

4. Подключить харнесс (5 мин). В системный промпт / CLAUDE.md / AGENTS.md агента одна строка:

Пробуждение: python3 ~/deputy/bin/wake-ladder.py next <метка-сессии> --project "<проект>" — по одной ступени за вызов, до строки «ЛЕСТНИЦА ПРОЙДЕНА».

5. Первая задача через диспетчер (10 мин).

cd ~/deputy
python3 bin/dispatch.py add t-hello Deputy tasks/dispatch/EXAMPLE.md --reply dep-1017-first "образец"
python3 bin/dispatch.py launch t-hello            # без runner печатает промпт витка
# виток делает работу и сдаёт:
python3 bin/witness-log.py --surface headless --session t-hello --item example --done "work/hello.md записан, коммит <sha>"
python3 bin/session-bus.py send --to dep-1017-first --session t-hello "сдано: work/hello.md, коммит <sha>"
python3 bin/dispatch.py accept t-hello            # ✓ файл, ✓ коммит → ok

ТЗ без блока Приёмка: с проверяемым пунктом диспетчер не принимает — это намеренно.

Пример конфигурации — kit.json

{
  "agent_name": "Deputy",
  "agent_slug": "deputy",
  "coord_project": "Deputy",
  "canon_prefix": "home:",
  "unit_prefix": "deputy-",
  "host_id": "local",
  "nodes": {
    "local":   {"ssh": "",             "max_runs": 1},
    "worker1": {"ssh": "root@worker1", "max_runs": 2}
  },
  "runner": "claude -p \"$(cat {prompt})\" --output-format stream-json",
  "lint_cmd": "",
  "density_cmd": ""
}

поле	смысл
agent_name, agent_slug	имя в текстах кадра и латинская метка (owner, префиксы)
coord_project	проект окна-координатора: ему одному выдаётся ступень dispatch
canon_prefix	как агент пишет ссылки на свои файлы в текстах (у Дистилла — dcc:)
unit_prefix	префикс systemd-юнитов, если дом их заводит
nodes	пул узлов для витков: ssh — цель ssh (пусто — локально), max_runs — предел одновременных
runner	команда запуска витка; подстановки {prompt} {label} {tz} {home}; пусто — launch только пишет промпт
lint_cmd, density_cmd	внешние приборы ступени: читают stdin, rc=0 — чисто; ступень с попаданием удерживается

Корень дома — каталог над bin/; переопределяется переменной HOME_KIT_ROOT.

Лестница — wake/ladder.json

Ступень: id, kind, max (байт), title; по желанию on: false, manual: true (только step), coord_only: true, lint: false.

kind	источник
file	файл src от корня дома
goal / goal-full	выжимка / полный текст якоря проекта сессии
project	якорь проекта из MAP.md
mail	письма шины этой сессии + сдачи без приёмки
dispatch	открытые задачи диспетчера (окну-координатору)
cmd	любой прибор: cmd (строка, запускается из корня), timeout

Сессия оборвалась — wake-ladder.py last покажет последнюю доставленную ступень; wake-ladder.py off <id> <причина> выключит её.

Хранение

state/ — журналы append-only (jsonl): лестница, сессии, шина, свидетель, реестр диспетчера, цели. private/ и var/ — в .gitignore. Секреты класть в private/ с правами 600 и читать по пути.

Чего здесь нет

Органов, завязанных на конкретный город: Telegram-приём, ГТМ, Доска оператора, карточка рычагов (машины, деньги, доступы), компилятор образа дома, обёртка правок несущего с откатом. Они живут в доме Дистилла; переносить их — следующие фазы, по мере того как заместитель в них упрётся.

Замечания — в трекер этого репозитория.