136 lines
3.9 KiB
Markdown
136 lines
3.9 KiB
Markdown
# Agents workspace — Randomayzer
|
||
|
||
Эта папка хранит задания, рабочие заметки и результаты всех агентов проекта.
|
||
|
||
Корневые обязательные правила: `../AGENTS.md`.
|
||
|
||
## Структура
|
||
|
||
Для каждого агента используется отдельная папка:
|
||
|
||
```text
|
||
agents/
|
||
<agent-id>/
|
||
inbox/
|
||
notes/
|
||
done/
|
||
```
|
||
|
||
Рекомендуемые `agent-id`:
|
||
|
||
```text
|
||
antigravity
|
||
opencode
|
||
grok
|
||
claude
|
||
coordinator
|
||
```
|
||
|
||
## Inbox
|
||
|
||
Перед началом работы агент фиксирует полученное задание в:
|
||
|
||
```text
|
||
agents/<agent-id>/inbox/TASK-YYYY-MM-DD-<slug>.md
|
||
```
|
||
|
||
Минимальные поля:
|
||
|
||
```text
|
||
# Task
|
||
Base SHA:
|
||
Scope:
|
||
Do not change:
|
||
Definition of Done:
|
||
Required verification:
|
||
```
|
||
|
||
Если задание пришло через чат, его смысл переносится в inbox без самовольного расширения scope.
|
||
|
||
## Notes
|
||
|
||
Черновые исследования, временные матрицы, локальные гипотезы и незавершённые выводы:
|
||
|
||
```text
|
||
agents/<agent-id>/notes/
|
||
```
|
||
|
||
Notes не считаются принятым результатом и не используются как доказательство закрытия фазы.
|
||
|
||
## Done
|
||
|
||
Итог задачи:
|
||
|
||
```text
|
||
agents/<agent-id>/done/TASK-YYYY-MM-DD-<slug>.md
|
||
```
|
||
|
||
Минимум:
|
||
|
||
```text
|
||
# Result
|
||
Base SHA:
|
||
Result SHA:
|
||
Files changed:
|
||
Commands actually run:
|
||
Test result:
|
||
Lint result:
|
||
Build result:
|
||
Findings:
|
||
UNVERIFIED:
|
||
Remaining blockers:
|
||
Non-blocking tech debt:
|
||
```
|
||
|
||
Review-agent дополнительно указывает:
|
||
|
||
```text
|
||
Reviewed SHA:
|
||
CRITICAL:
|
||
HIGH:
|
||
MEDIUM:
|
||
LOW:
|
||
Final verdict:
|
||
```
|
||
|
||
## Параллельная работа
|
||
|
||
Два implementation-agent не редактируют одну и ту же область одновременно без прямого указания координатора.
|
||
|
||
Если параллельная работа необходима:
|
||
- фиксируются разные scope;
|
||
- каждый агент сообщает base/result SHA;
|
||
- изменения остаются логически раздельными;
|
||
- merge выполняется контролируемо после review.
|
||
|
||
Review-agent не исправляет найденные production-проблемы в том же review-коммите, если задание явно не переведено в режим `fix`.
|
||
|
||
## Security findings
|
||
|
||
`CRITICAL` и `HIGH` не считаются закрытыми по заявлению автора исправления. В `done/` должен быть указан конкретный fix SHA и evidence; для security-sensitive областей применяется независимый re-review согласно `AGENTS.md`.
|
||
|
||
PoC считается более сильным evidence, чем общий PASS-отчёт. После исправления PoC превращается в regression test, если это технически возможно.
|
||
|
||
## Git
|
||
|
||
Force-push запрещён.
|
||
|
||
Reviewers не пушат production source. Кто имеет право пушить implementation в `main`, определяет владелец/главный координатор текущей задачи.
|
||
|
||
В каждом task/result всегда хранить полный commit SHA, а не только `main` или «последний коммит».
|
||
|
||
## Review export
|
||
|
||
Если внешний reviewer не видит GitHub:
|
||
|
||
```powershell
|
||
.\tools\export-review.ps1
|
||
```
|
||
|
||
или diff от известной базы:
|
||
|
||
```powershell
|
||
.\tools\export-review.ps1 -Diff -Base <SHA>
|
||
```
|
||
|
||
Reviewer использует архив как source of truth и обязательно указывает SHA snapshot.
|