diff --git a/AGENTS.md b/AGENTS.md index 6d5c131..9d87b08 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,9 @@ Python, SQLite и OpenSearch. Production пока не развернут. [деплой](docs/operations/DEPLOYMENT.md), [backup](docs/operations/BACKUP.md), [rollback](docs/operations/ROLLBACK.md), [восстановление](docs/operations/RECOVERY.md). - Работай в feature/fix/refactor-ветке. `main` защищена; изменения вноси через - PR, не сливай его автоматически. Сохраняй незакоммиченные изменения. + PR. DEV не одобряет и не сливает собственный PR. Условный merge выполняет + только REVIEWER по правилам раздела «Автономный workflow PR» ниже. Сохраняй + незакоммиченные изменения. - SSH alias — `akyldash_vps`; используй только read-only диагностику. Не давай `codex` общий sudo или доступ к Docker socket. Root-действия требует владелец. Для Gitea используй `gitea-api`, не читай файлы с учётными данными. @@ -34,3 +36,36 @@ Python, SQLite и OpenSearch. Production пока не развернут. для нового хоста. - После каждого изменения инфраструктуры обновляй `docs/operations/CURRENT_STATE.md` по фактическим проверкам. + +## Автономный workflow PR + +- Центральный оркестратор: thread `01a144a5-8b95-77c3-b311-9a9afd062ca8`, + host local. DEV (этот агент) выполняет только явно назначенную пользователем + задачу в `admin/akyldash`; REVIEWER: thread + `01a144f9-5b51-7923-8398-61d4a6a98306`, host + `remote-ssh-codex-managed:b61555d7-8d1a-4cfa-988b-c8da4791d426`. +- Обмен между чатами идёт через центральный relay: участники завершают каждый + этап структурированным отчётом с полями `task`, `repo`, `branch`, `pr`, + `head_sha`, `stage`, `checks`, `findings`, `next_action`. Не настраивай + отдельные webhook, daemon или транспорт. +- Веди только одну пользовательскую задачу и один PR одновременно. Не + подхватывай старые PR самостоятельно; дождись конкретного назначения. +- DEV исследует, изменяет, проверяет, коммитит и отправляет изменения, создаёт + или обновляет PR к `main`. После каждого push REVIEWER независимо проверяет + весь актуальный diff и повторно учитывает предыдущие findings. Не запускай + замену этому REVIEWER и не одобряй свой PR. +- После успешного первоначального review DEV вносит значимые изменения в + существующий changelog, коммитит и отправляет их в тот же PR. Затем REVIEWER + повторно проверяет полный итоговый diff. Для документационной задачи не + придумывай изменения кода; соблюдай правила версии, только если они явно + применимы. +- Слияние зарегистрированной задачи разрешено только REVIEWER и только после + формального `APPROVED` review текущего `head_sha`, успешных required checks и + прохождения всех действующих gates/branch protection. Approval в комментарии + не является разрешением на merge. При изменении head или base требуется + актуализировать review и проверки. Запрещено обходить защиту ветки, обязательные + проверки или требуемое review. +- Все Gitea API-вызовы выполняй только через `gitea-api` с личным окружением; + Git используй с обычным credential helper. Не читай credentials из файлов + репозитория. Запускай Git- и API-команды отдельно, без объединения с другими + командами.