Compare commits
No commits in common. "chore/agents-workspace" and "main" have entirely different histories.
chore/agen
...
main
23 changed files with 0 additions and 150 deletions
34
AGENTS.md
34
AGENTS.md
|
|
@ -1,34 +0,0 @@
|
||||||
# Правила работы агентов — lightweight-server
|
|
||||||
|
|
||||||
Документ адресован любому исполнителю: человеку или агенту. Он описывает не
|
|
||||||
устройство проекта, а порядок работы над ним.
|
|
||||||
|
|
||||||
## 1. Границы задачи
|
|
||||||
|
|
||||||
Задание определяет область. Выход за неё запрещён, даже когда исправление
|
|
||||||
очевидно и занимает минуту: перемешанные изменения нельзя ни отревьюить, ни
|
|
||||||
откатить по отдельности. Замеченное рядом — списком в отчёт, отдельными
|
|
||||||
предложениями задач.
|
|
||||||
|
|
||||||
## 2. Факты и догадки
|
|
||||||
|
|
||||||
Выдумывать нельзя. Если решение не принято, версия неизвестна, а поведение не
|
|
||||||
проверено — так и пишем. Правдоподобная выдумка дороже честного «не определено»:
|
|
||||||
по ней начнут работать.
|
|
||||||
|
|
||||||
## 3. Проверка
|
|
||||||
|
|
||||||
«Работает» — не результат проверки. В отчёт идёт команда и её фактический
|
|
||||||
вывод. Если проверка не запускалась, это пишется прямо.
|
|
||||||
|
|
||||||
## 4. Задания и результаты
|
|
||||||
|
|
||||||
Задания и отчёты живут в `agents/`. Схема одинакова во всех репозиториях
|
|
||||||
рабочего пространства `Agent_projects`, полные правила — в `agents/README.md`.
|
|
||||||
|
|
||||||
Коротко: задание — в `agents/<твой-id>/inbox/`, результат — в
|
|
||||||
`agents/<твой-id>/done/`, черновики — в `agents/<твой-id>/notes/`. Задание,
|
|
||||||
пришедшее в чате, агент сначала записывает в свой `inbox/`, и только потом
|
|
||||||
работает. Своих папок за пределами `agents/<твой-id>/` не заводить.
|
|
||||||
|
|
||||||
Принимает работу и пушит в `main` только главный агент.
|
|
||||||
|
|
@ -1,62 +0,0 @@
|
||||||
# Задания агентов — 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/` — рабочие черновики агента.
|
|
||||||
|
|
||||||
## Маршрут задания
|
|
||||||
|
|
||||||
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/`. Это архив приёмки.
|
|
||||||
|
|
@ -1,27 +0,0 @@
|
||||||
# Отчёт: заголовок задания
|
|
||||||
|
|
||||||
- **Задание:** `../inbox/` — файл с тем же именем
|
|
||||||
- **Агент:** id агента
|
|
||||||
- **Дата:** ГГГГ-ММ-ДД
|
|
||||||
- **Ветка / коммиты:** ветка и хеши
|
|
||||||
|
|
||||||
## Что сделано
|
|
||||||
|
|
||||||
Списком, с указанием файлов.
|
|
||||||
|
|
||||||
## Как проверено
|
|
||||||
|
|
||||||
Команда и её фактический вывод. Если проверка не запускалась — так и написать.
|
|
||||||
|
|
||||||
## Что не сделано
|
|
||||||
|
|
||||||
Незакрытая часть задания и причина. Пусто — тоже ответ, но осознанный.
|
|
||||||
|
|
||||||
## Замечено рядом
|
|
||||||
|
|
||||||
Дефекты и улучшения за границами задачи — предложениями отдельных задач,
|
|
||||||
без самовольного исправления.
|
|
||||||
|
|
||||||
## Вопросы к приёмке
|
|
||||||
|
|
||||||
Места, где решение спорное и нужен взгляд главного агента.
|
|
||||||
|
|
@ -1,27 +0,0 @@
|
||||||
# Заголовок задания
|
|
||||||
|
|
||||||
- **Кому:** id агента из таблицы в README
|
|
||||||
- **Дата:** ГГГГ-ММ-ДД
|
|
||||||
- **От кого:** владелец проекта / главный агент
|
|
||||||
- **Ветка:** `<префикс-агента>/краткое-имя`
|
|
||||||
- **Файл отчёта:** `../done/` с тем же именем, что у этого файла
|
|
||||||
|
|
||||||
## Что нужно сделать
|
|
||||||
|
|
||||||
Одна задача — один файл. Если задач две, это два файла: иначе половину примут,
|
|
||||||
а половину нет, и состояние станет непонятным.
|
|
||||||
|
|
||||||
## Границы
|
|
||||||
|
|
||||||
Чего в этой задаче делать не нужно, даже если исправление очевидно и занимает
|
|
||||||
минуту. Замеченное рядом — в отчёт списком.
|
|
||||||
|
|
||||||
## Как проверить результат
|
|
||||||
|
|
||||||
Команды, которые должны пройти, и что считается доказательством. «Работает» —
|
|
||||||
не критерий приёмки.
|
|
||||||
|
|
||||||
## Контекст и ограничения
|
|
||||||
|
|
||||||
Файлы, документы, решения, которые нельзя нарушать. Если чего-то не знаешь —
|
|
||||||
пиши «не определено», а не правдоподобную выдумку.
|
|
||||||
Loading…
Reference in a new issue