docs(skills): объединены уточнения работы помощников

- Зачем:
  - сохранить в основной ветке согласованный способ экономить контекст и сопровождать ревью.
- Что:
  - добавлены правила изоляции и выбора Luna для механики Claude;
  - закреплены факты прогона, передача отчетов и границы наблюдения.
- Проверка:
  - git diff --check;
  - проверено слияние двух коммитов feature-ветки без конфликтов.

agents/.agents/skills/codex-subagent-playbook/SKILL.md

@@ -7,9 +7,9 @@ description: "Оптика координатора: делегирование,
 # Координатор задачи
 
 Ты ведешь задачу как координатор и несешь за нее ответственность: держишь
-замысел, выбираешь подход и принимаешь результат. Основную реализацию обычно
+замысел, выбираешь подход и принимаешь результат. Помощники защищают твой
-делегируй субагентам Sol или Terra, понятную механику - Luna. Глубину
+контекст: они удерживают механику и объемные доказательства, а возвращают
-рассуждения выбирай по сложности задачи.
+основания, нужные для следующего решения.
 
 Этот скилл добавляет оптику управления. Выбирай полезные приемы по текущему
 состоянию задачи; его подключение посреди работы не обнуляет сделанное.
@@ -35,17 +35,23 @@ description: "Оптика координатора: делегирование,
 
 Делегирование должно давать понятную пользу: разгрузить контекст, добавить
 свежий взгляд, нужную специализацию или независимую работу в параллель.
+Короткую команду выполни сам. Помощник нужен, когда работа оставит много
+механики или промежуточных доказательств, даже если сама задача проста.
 
 Перед созданием агента посмотри, у кого из существующих уже есть полезное
 понимание этой области. Соседнюю задачу можно передать ему, обновив цель,
 границы и ожидаемый результат. Свежий агент полезен, когда прежние
 предположения мешают, контекст перегружен или работе нужна независимость.
 
-Короткие поручения и ответы передавай сообщением. Объемные материалы направляй
+Короткие поручения и ответы передавай сообщением. Объемные материалы оставляй
-нужному агенту, оставляя себе сводку и путь к доказательствам.
+у помощника или в файле. Проси вернуть итог, существенные отклонения и вопросы,
-Файлы удобны для такого обмена и продолжения работы. Если доступный механизм
+а также пути к доказательствам. Подробности он раскрывает по запросу. Вопрос о
-передает материал без повторного включения в твой контекст, используй его.
+границах, риске или неожиданной стоимости помощник поднимает сразу, не дожидаясь
-Вывод инструментов сокращай до нужных фактов до его возврата в контекст.
+конца работы.
+
+Полный отчет ревьюер пишет туда, где его напрямую читает владелец триажа.
+Для находок реализации это исполнитель, для находок постановки - координатор.
+Остальным участникам достаточно вердикта, короткого индекса и путей.
 
 При назначении агента выбери модель, глубину рассуждения и нужную ему историю
 по [возможностям среды и ролям](references/roles.md). В поручение Sol или Terra
@@ -59,15 +65,18 @@ description: "Оптика координатора: делегирование,
 
 ## Какой взгляд добавить
 
-Подбирай проверку под неопределенность и цену ошибки. Самопроверки и известной
+Подбирай проверку под неопределенность, цену ошибки и известные слабые места
-детерминированной проверки часто достаточно для механики. Свежий ревьюер
+проекта. Самопроверки и известной детерминированной проверки часто достаточно
-полезен там, где могло остаться незамеченное решение или нарушение контракта.
+для механики. Свежий ревьюер полезен там, где могло остаться незамеченное
-Astra может проверить устройство и соразмерность нетривиального решения.
+решение или нарушение контракта. Размер diff сам по себе не определяет нужду
-Claude добавляет взгляд другого семейства; его отсутствие не останавливает
+в ревью.
-работу и само по себе не создает вопроса пользователю.
 
-Свежесть контекста и различие семейств решают разные задачи. Выбрав ревью,
+Для независимого взгляда другого семейства рассмотри Claude Opus. Это
-прочитай [договор ревью и триажа](references/review-and-triage.md): он задает
+рекомендация, а не обязательная линия. Свежесть контекста помогает поймать
+предположения автора; другое семейство добавляет иную родословную ошибок.
+
+Выбрав ревью, прочитай
+[договор ревью и триажа](references/review-and-triage.md). Он задает
 независимость, работу с находками и перепроверку. Если выбран Claude, перед
 запуском прочитай [его механику](references/claude.md). Запуск и достаточность
 доступа ревьюера остаются твоей ответственностью.
@@ -80,15 +89,18 @@ Claude добавляет взгляд другого семейства; его
 
 ## Достаточно ли сделанного
 
-Сопоставь результат с исходной целью и фактическими проверками. Отчет агента
+Сопоставь результат с исходной целью и фактическими проверками. Сам проверь
-о тестах или состоянии среды оценивай по доказательствам; ключевое для
+важные для приемки утверждения и доказательства доступным способом. Повторять
-приемки проверь доступным тебе способом. Новая проверка нужна, когда она
+каждую команду помощника не нужно. Для собственной проверки выбирай адресную
-разрешит оставшееся сомнение или проверит последующие изменения.
+команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана,
+когда она разрешает оставшееся сомнение или проверяет последующие изменения.
 
 После нескольких исправлений полезен проход на вычитание: какие добавления
-все еще оправданы задачей? Решение об удалении принимай по нужному поведению
+все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и
-и стоимости поддержки. Исполнитель вносит выбранные изменения, затронутая
+стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять
-часть снова получает подходящую проверку.
+результат и действовать по нему, а не числом удаленных строк. Исполнитель
+вносит выбранные изменения, затронутая часть снова получает подходящую
+проверку.
 
 Когда спор повторяется без новых фактов, исправления разрастаются или новый
 обзор мало что дает, пересмотри подход. Разбор несходимости находится в

agents/.agents/skills/codex-subagent-playbook/references/claude.md

@@ -5,22 +5,25 @@ Claude - необязательная линия; нативный процес
 
 ## Выбор и доступ
 
-Модель и глубину выбирай по пользовательскому предпочтению и результатам
+Для независимого ревью запускай Opus, если пользователь не выбрал другую
-реальных прогонов. Прежние рейтинги Opus, Sonnet или других моделей не являются
+модель. Записывай запрошенные настройки отдельно от фактически подтвержденных
-постоянной гарантией. Записывай запрошенные настройки отдельно от фактически
+метаданных запуска.
-подтвержденных метаданных запуска.
 
 Полноценному ревью нужны доступные тесты, документация, сеть и временные файлы.
 Если установленная версия поддерживает `--permission-mode auto`, запускай
 с этим режимом. Внешняя песочница только для чтения обедняет проверку; исходники
 и постоянное состояние защищает [мандат ревьюера](prompts/review-boilerplate.md).
 Запуск `claude` передает поручение и выбранные материалы внешнему сервису
-Anthropic. Сначала примени уже полученное разрешение. Если действующая политика
+Anthropic. Для своей личной конфигурации Дмитрий дал постоянное разрешение
-требует отдельного разрешения, получи его до передачи материалов и сохрани
+передавать через CLI Claude материалы текущей задачи для ревью: diff, фрагменты
-ценность выбранной линии при ожидании решения. При реальной блокировке назови
+кода, отчеты ревью и разбора находок. При переносе скилла другому владельцу это
-конкретную команду или ресурс и наблюдаемую ошибку, затем выбери доступного
+не становится его согласием. Фактически действующее разрешение передай точной
-ревьюера с честно указанным ограничением. Не засчитывай урезанный запуск как
+границей в поле `TRANSFER` из
-полноценную выбранную линию.
+[шаблона поручения](prompt-templates.md#независимое-ревью). Повторно спрашивать
+о том же канале и тех же материалах не нужно. Посторонние материалы и другие
+внешние действия отдельно сверяй с действующими разрешениями. При реальной
+блокировке назови конкретную команду или ресурс и наблюдаемую ошибку. Урезанный
+доступ не засчитывай как полноценную выбранную линию.
 
 ## Возможности установленного CLI
 
@@ -42,13 +45,25 @@ Anthropic. Сначала примени уже полученное разре
 отчета. Для короткого поручения подходит форма:
 
 ```text
-claude --permission-mode auto --model <model> --effort <level> --bg "<mandate>"
+claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
 ```
 
 Большой промпт оставь в общем временном каталоге и передай короткий мандат с
 путем. Шумный поток CLI сохрани во временном журнале; координатору верни
 ограниченный индекс и путь к отчету.
 
+Для долгой внешней линии предпочтительно выделить отдельную Luna. Она отвечает
+за запуск, наблюдение, получение отчета и продолжение сохраненной сессии до
+завершения линии. Храни у нее идентификатор сессии и пути к промпту, журналу и
+отчету. Другой помощник остается свободен для Git, механики и параллельной
+работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий
+обзор не требует отдельного агента.
+
+Основной канал наблюдения - события среды. В долгой тишине Luna может
+проверять состояние примерно раз в минуту и сообщать координатору о завершении,
+застое, ошибке или нужном решении. Для прямого опроса координатором без новых
+событий ориентир - один раз в пять минут.
+
 Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после
 финального результата его фоновый процесс все еще активен, останови этот
 простаивающий процесс; работающий обзор с прогрессом не останавливай. Продолжи

agents/.agents/skills/codex-subagent-playbook/references/lessons.md

@@ -24,6 +24,30 @@
 частью истории. Архив открывай для конкретного случая, нужного доказательства
 или проверки происхождения правила.
 
+## Наблюдение 2026-09-06
+
+В работе над лабораторной по сессиям Luna вела Git-механику и возвращала
+короткие итоги. Полные исследовательские материалы и отчеты при этом часто
+попадали координатору; он наблюдал перегрузку своего контекста. Измеренной
+экономии этот прогон не дал.
+
+Для следующего поручения владелец выбрал для Luna `high` ([комментарий
+#2845](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/236#issuecomment-2845)).
+Это было предпочтение и эксперимент без сравнения с `medium`. При обсуждении
+сопровождения Opus координатор признал свой выбор `high` избыточным для этой
+механики.
+
+Прямой обмен полным отчетом уже состоялся: исполнитель получил файл с девятью
+находками и разобрал их все, а в первоначальную сводку координатора вошли семь.
+Это зафиксировано в [комментарии #2840 к задаче
+#236](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/236#issuecomment-2840).
+Случай подтверждает канал передачи, но не измеряет экономию контекста.
+
+Первый обзор Opus шел в свежей сессии, а исправления проверялись в продолжении
+той же сессии. Устойчивые идентификаторы находок сохранили предмет разговора.
+Это подтверждает действующий [договор перепроверки](review-and-triage.md#перепроверка),
+но не доказывает пользу фиксированной частоты наблюдения за Claude.
+
 ## Проверить на обычных задачах
 
 - Удерживает ли координатор полезный объем контекста: какие подробности нужны
@@ -35,6 +59,9 @@
 - Помогает ли триаж исполнителю сохранять соразмерность исправлений после
   нескольких кругов ревью? Нужны случаи с основаниями принятых и отклоненных
   находок.
+- Снижает ли помощник для Claude расход контекста, если проверяет состояние
+  примерно раз в минуту и сообщает координатору только о существенных
+  событиях? Измеренного эффекта пока нет.
 
 Эти вопросы уточнены 2026-09-06 для новой редакции. Наблюдай их там, где
 обычная задача дает материал; отдельные сравнительные прогоны требуют

agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md

@@ -95,6 +95,12 @@ FINDING PREFIX: unique stable prefix
 REPORT: unique absolute path
 ```
 
+Для внешнего канала после уже полученного разрешения добавь точную границу:
+
+```text
+TRANSFER: <exact materials and channel already authorized by the user>
+```
+
 Передай пути к этим параметрам, [мандату ревьюера](prompts/review-boilerplate.md)
 и [правилу языка](prompts/runtime-language.md) либо механически собери из них
 полное поручение.

agents/.agents/skills/codex-subagent-playbook/references/roles.md

@@ -10,15 +10,20 @@
   спорные вопросы и принимает результат. Это роль ведущего текущей задачи.
 - **Sol или Terra** обычно реализует задачу, исследует техническую
   неопределенность, проверяет код и исправляет подтвержденные дефекты.
-- **Luna** удобна для ясной механики, пакетных операций и известных проверок
+- **Помощник** удерживает механику и объемный вывод вне контекста координатора.
-  с объемным выводом.
+- **Luna** - обычный выбор для такой помощи. Она может просмотреть задачи,
+  комментарии и историю Git, сверить фактическое состояние и подтвержденные
+  чекбоксы. Ей также подходят журналы, трассы, вывод тестов, планы запросов и
+  сопровождение внешнего ревьюера. Если это разрешено, ей можно поручить
+  коммиты, отправку ветки и уборку.
 
 Эти назначения служат отправной точкой. Состав собирай под задачу; один агент
 может совмещать совместимую работу. Выбор определяется вкладом в задачу и
 качеством доступных моделей. Название роли вторично.
 
-Свежая Astra полезна для отдельной проверки формы и соразмерности, когда
+Свежая Astra полезна для отдельной проверки формы и соразмерности. Claude Opus
-цена такого взгляда оправдана.
+добавляет независимый взгляд другого семейства. Основания выбора задает
+[основная оптика](../SKILL.md).
 
 Если партнер поручил группу связанных тикетов, выбирай готовые к работе по
 их существующим зависимостям. Перед выдачей зависимого тикета убедись, что
@@ -27,11 +32,14 @@
 ## Модель и глубина
 
 Модель и глубину рассуждения выбирай независимо, если среда открывает обе
-ручки. Для ограниченной работы разумная отправная точка - `medium`. Для
+ручки. Для Luna `medium` часто удобен как стартовый вариант. Можно сразу
-необратимого решения, высокой цены тихой ошибки или существенной
+выбрать `high` по сложности, цене ошибки или предпочтению пользователя.
-неопределенности - `high` либо более сильная доступная настройка. Это примеры:
+
-повышай глубину, когда не хватило поиска и рассуждения, а модель - когда не
+Для любой роли существенная неопределенность, необратимое решение или высокая
-хватило качества суждения.
+цена тихой ошибки могут обосновать `high` либо более сильную доступную
+настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель -
+когда не хватило качества суждения. Основание должно следовать из задачи, а не
+из названия роли.
 
 Не обещай, что запрошенная модель или глубина фактически применились, если
 инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,