diff --git a/agents/.agents/skills/codex-subagent-playbook/handoffs/20260713-1411-review-optics-and-sync.md b/agents/.agents/skills/codex-subagent-playbook/handoffs/20260713-1411-review-optics-and-sync.md new file mode 100644 index 0000000..13d1732 --- /dev/null +++ b/agents/.agents/skills/codex-subagent-playbook/handoffs/20260713-1411-review-optics-and-sync.md @@ -0,0 +1,55 @@ +# Handoff: оптика ревью и синхронизация + +## Назначение + +Продолжить полевую проверку `codex-subagent-playbook` после согласования +тонкого координатора, файлового канала и ревью высокоуровневых документов. +Действующий договор находится в [SKILL.md](../SKILL.md), механика ревью — в +[review-and-triage.md](../references/review-and-triage.md), текущая +маршрутизация — в [roles.md](../references/roles.md). + +## Зафиксированное состояние + +- `6cc1b26` пересобрал скилл вокруг оптики тонкого мастера. +- `70b18b9` убрал shell-зависимые и конвейерные допущения из шаблонов. +- `02a98df` закрепил ревью на уровне самого документа: открытые детали + реализации не мешают `APPROVED`, существенный отложенный риск можно вернуть + как неблокирующее соображение. +- `quick_validate.py`, `git diff --check` и локальные Markdown-ссылки + проходили после изменений. + +## Оптика триажа ревью + +Находки ревьюера — сигналы о возможных слабых местах, а не руководство к +действию. Перед правкой проверять, реальна ли проблема в рамках замысла и не +превращает ли предложенное решение оптику в обязательный конвейер. + +Типичный уклон ревьюера: лечить неоднозначность новыми манифестами, состояниями, +фиксированными именами и преждевременными деталями. Сохранять жёсткими только +границы ответственности, независимость, файловый канал, владельца триажа и +предохранители несходимости. Выбор приёма и модели оставлять оптикой. + +## Незавершённая синхронизация + +Первый `git pull --no-rebase origin master` вернул `Already up to date`. +Следующий `git push origin master` был отклонён: удалённый `master` успел +перейти с `a4985b3` на `9c047f9`. + +Следующему агенту: + +1. Закоммитить этот handoff отдельным Conventional Commit. +2. Выполнить `git fetch origin` и изучить новые удалённые коммиты. +3. Слить `origin/master` обычным merge, сохранив локальный замысел и удалённые + изменения. Не выбирать сторону конфликта целиком без чтения. +4. Повторить проверки скилла и отправить `master` в origin. + +В рабочем дереве есть посторонние неотслеживаемые каталоги скиллов и +`.skill-lock.json`. Они не относятся к этой работе; не добавлять и не удалять +их. + +## Suggested skills + +- `$codex-subagent-playbook` — применять и оценивать текущую оптику. +- `$writing-great-skills` — проверять ясность и отсутствие скрытого процесса. +- `$conventional-commits` — формировать сообщения следующих коммитов. +- `$code-review` — только для нового независимого обзора по явной потребности.