Ochenstarik 038a9cb5bf chore(agents): единая структура заданий и приёмки

Общая для всех проектов схема: задание — в agents/<id>/inbox/, черновики —
в notes/, результат — в done/, принятое главным агентом — в _accepted/.
Папки заведены для claude, codex, antigravity, hermes, grok, opencode.

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-18 13:33:47 +07:00

4 KiB

Raw Permalink Blame History

Задания агентов — lightweight-server

Единая схема для всех репозиториев в Agent_projects. Смысл один: задание, результат и приёмка лежат в репозитории, а не в переписке и не в личных папках агента на диске. Через месяц найти работу можно только так.

Правило, из-за которого всё это заведено

Агент не создаёт папок за пределами agents/<свой-id>/. Черновики, логи прогонов, промежуточные заметки — в notes/. Если своей папки не хватило, это повод изменить схему в этом файле, а не завести my_review/ в корне.

Кто есть кто

id	Агент	Папка	Префикс ветки
`claude`	Claude	`agents/claude/`	`claude/`
`codex`	Codex	`agents/codex/`	`codex/`
`antigravity`	Antigravity	`agents/antigravity/`	`antigravity/`
`hermes`	Hermes	`agents/hermes/`	`hermes/`
`grok`	Grok	`agents/grok/`	`grok/`
`opencode`	OpenCode	`agents/opencode/`	`opencode/`

Внутри каждой папки:

inbox/ — задания агенту;
done/ — готовые результаты и отчёты;
notes/ — рабочие черновики агента.

Маршрут задания

Задание попадает в <agent>/inbox/ файлом ГГГГ-ММ-ДД-краткое-имя.md по шаблону TASK-TEMPLATE.md. Если задание пришло голосом или в чате — агент сам записывает его в свой inbox до начала работы. Незаписанного задания не существует: его нельзя ни проверить, ни повторить.
Агент работает. Черновики — в <agent>/notes/. Ветка — с префиксом из таблицы выше.
Результат — в <agent>/done/ файлом с тем же именем, что и задание, по шаблону REPORT-TEMPLATE.md. Задание остаётся в inbox до приёмки: пара «задание — отчёт» должна читаться рядом.
Главный агент принимает работу: сверяет отчёт с тем, что реально изменилось, объединяет результаты разных агентов, переносит пару файлов в agents/_accepted/ГГГГ-ММ-ДД-краткое-имя/ и только после этого пушит.

Пункт 4 выполняет только главный агент. Остальные в main не пушат — иначе приёмка превращается в разбор того, что уже влито.

Что обязано быть в отчёте

что сделано и какими файлами;
как это проверено — команда и её вывод, а не «протестировано»;
что не сделано и почему; незакрытая часть в отчёте лучше, чем найденная при приёмке;
замеченные рядом дефекты — списком, отдельными предложениями задач, без самовольного исправления.

Чего делать нельзя

Класть результат в inbox/, а задание в done/.
Править чужой отчёт в done/. Возражения — отдельным файлом в своём done/ со ссылкой на разбираемый отчёт.
Удалять принятое из _accepted/. Это архив приёмки.

4 KiB Raw Permalink Blame History Unescape Escape