agent-control-center/agents/README.md
Ochenstarik 085110bf59 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:43 +07:00

62 lines
4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Задания агентов — agent-control-center
Единая схема для всех репозиториев в `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/` — рабочие черновики агента.
## Маршрут задания
1. **Задание попадает в `<agent>/inbox/`** файлом `ГГГГ-ММ-ДД-краткое-имя.md`
по шаблону [TASK-TEMPLATE.md](TASK-TEMPLATE.md). Если задание пришло голосом
или в чате — агент сам записывает его в свой inbox **до** начала работы.
Незаписанного задания не существует: его нельзя ни проверить, ни повторить.
2. **Агент работает.** Черновики — в `<agent>/notes/`. Ветка — с префиксом
из таблицы выше.
3. **Результат — в `<agent>/done/`** файлом с тем же именем, что и задание,
по шаблону [REPORT-TEMPLATE.md](REPORT-TEMPLATE.md). Задание остаётся
в inbox до приёмки: пара «задание — отчёт» должна читаться рядом.
4. **Главный агент принимает работу:** сверяет отчёт с тем, что реально
изменилось, объединяет результаты разных агентов, переносит пару файлов
в `agents/_accepted/ГГГГ-ММ-ДД-краткое-имя/` и только после этого пушит.
Пункт 4 выполняет только главный агент. Остальные в `main` не пушат — иначе
приёмка превращается в разбор того, что уже влито.
## Что обязано быть в отчёте
- что сделано и какими файлами;
- как это проверено — команда и её вывод, а не «протестировано»;
- что не сделано и почему; незакрытая часть в отчёте лучше, чем найденная
при приёмке;
- замеченные рядом дефекты — списком, отдельными предложениями задач, без
самовольного исправления.
## Чего делать нельзя
- Класть результат в `inbox/`, а задание в `done/`.
- Править чужой отчёт в `done/`. Возражения — отдельным файлом в своём
`done/` со ссылкой на разбираемый отчёт.
- Удалять принятое из `_accepted/`. Это архив приёмки.