Общая для всех проектов схема: задание — в agents/<id>/inbox/, черновики — в notes/, результат — в done/, принятое главным агентом — в _accepted/. Папки заведены для claude, codex, antigravity, hermes, grok, opencode. Причина: результаты работы расползались по личным папкам агентов и по переписке, и найти, кто что сделал, было нельзя. Место результата теперь определено заранее и одинаково во всех репозиториях. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
62 lines
4 KiB
Markdown
62 lines
4 KiB
Markdown
# Задания агентов — 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/`. Это архив приёмки.
|