docs: define autonomous review workflow
Runner smoke test / runner-smoke (pull_request) Successful in 1s
CI / tests-and-images (pull_request) Has been cancelled

This commit is contained in:
agent committed 2026-10-17 23:07:12 +03:00
1 parent ac611cc878
commit 36892aef77
1 file changed
+36 -1
+36 -1
View File
@@ -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-команды отдельно, без объединения с другими
командами.