chore: убраны рабочие заметки перед слиянием в master

- Зачем: - Рабочая зона .scratch не переносится в master по правилам репозитория. - Что: - Удалены спецификация и отчет проверки из текущего дерева ветки. - Ссылки на их версии в истории сохранены в актуальном handoff скилла. - Проверка: - Сверены состав .scratch и доступность обеих версий документов в Git.
2026-09-06 11:06:29 -04:00
1 parent f49b5847f9
commit f36111660d
@@ -1,160 +0,0 @@
 # Переработка codex-subagent-playbook
 ## Задача
 Пересобрать скилл как дополнительную оптику для Astra-координатора:
 сохранять смысл задачи, выбирать полезное делегирование, беречь дорогой
 контекст и принимать результат. Скилл можно добавить посреди работы;
 координатор применяет подходящие приёмы к текущему состоянию задачи.
 Текущий скилл вырос из Claude-плейбука, развивался отдельно и позднее получил
 ссылку на него как на базовый. В нём смешались прежние ограничения среды,
 повторяющиеся правила и разные шкалы ревью. По опыту пользователя, Sol
 склонен выполнять формальные требования, принимать замечания ревью за истину
 и усложнять решение после нескольких кругов исправлений. Проход на вычитание
 появился как защита от этого поведения.
 ## Принятый подход
 Основной текст даёт координатору способы оценивать ситуацию: где нужно его
 суждение, кому поручить работу, какой контекст сохранить, что проверить и
 когда свидетельств достаточно. Постановка, исследование, реализация, ревью,
 триаж, перепроверка и проход на вычитание остаются доступными приёмами.
 Координатор выбирает их состав и порядок по пользе для задачи. Подключение
 скилла само по себе не создаёт обязательных этапов или повторных проверок.
 У выбранного приёма есть ясный договор. Например, независимое ревью требует
 свежего контекста, а триаж — явного исхода каждой находки. Эти свойства
 сохраняют смысл приёма. Правила владения изменениями защищают совместную
 работу агентов. Остальные рекомендации оставляют место суждению координатора.
 ### Роли и внимание координатора
 | Участник | Назначение |
 |---|---|
 | Astra | Замысел, подход, границы, технический вкус, разрешение спорных вопросов и приёмка |
 | Sol | Основная реализация, техническое исследование, проверка и исправление подтверждённых дефектов |
 | Luna | Понятная механика, пакетные операции и известные проверки с объёмным выводом |
 | Claude | Преимущественно независимое ревью другим семейством моделей для поиска слепых зон GPT |
 Это распределение ответственности, а не обязательный список участников.
 Sol свободен в локальных технических решениях. Вопрос, который существенно
 меняет устройство решения, границы или добавляет обязательства, возвращается
 координатору с вариантами, последствиями и рекомендацией.
 Astra сохраняет контекст пользовательского замысла и читает достаточно
 ключевых фрагментов, чтобы самостоятельно судить о результате. Объёмное
 исследование, журналы и механика остаются у субагентов. Экономия контекста
 не должна лишать координатора оснований для решения; подробности раскрываются
 по мере необходимости.
 Короткое поручение, вопрос или вердикт передаются сообщением. Большой материал,
 который нужен другому агенту, передаётся напрямую через файл; координатору
 достаточно выжимки и пути. Вывод инструментов сокращается до нужных фактов
 до попадания в его контекст. Файл оправдан защитой контекста и дальнейшим
 использованием материала, а не самим фактом обмена между агентами.
 ### Ревью и отдельный триаж
 Claude полезен различием обучения и самостоятельным взглядом на код. Его
 доступность не гарантирована: основной процесс работает средствами Codex,
 а отсутствие Claude само по себе не требует согласования. Выбор конкретной
 модели опирается на результаты прогонов; прежняя оценка Opus не становится
 постоянной гарантией качества.
 Свежая Astra допустима для ревью нетривиальных решений: устройства,
 соразмерности и оправданности новых сущностей и зависимостей. Координатор
 оценивает пользу такого обзора с учётом стоимости. Свежесть контекста и
 различие семейств — самостоятельные основания выбора ревьюера. Приёмка
 координатором с контекстом разговора сохраняет отдельную роль.
 Триаж остаётся самостоятельной работой с находками. Находки о постановке
 разбирает координатор. При ревью реализации исполнитель проверяет
 технические утверждения и обосновывает исправление либо отклонение.
 Координатор разбирает противоречия, уместность сложности и решения в пределах
 согласованной задачи. Изменения цели, границ и существенный остаточный риск
 выносятся пользователю.
 У каждой находки есть явный исход: исправлена, отклонена, вынесена за границы
 или требует решения. Исправления перепроверяются, отклонения подкрепляются
 доводами. Вынесенный вопрос остаётся открытым до решения его владельца.
 Сохраняется связь между исходной находкой, её разбором и перепроверкой.
 Повтор спора без новых доказательств, разрастание исправлений и падение пользы
 очередного обзора — признаки несходимости. Координатор пересматривает подход
 и при необходимости выносит развилку пользователю. Третий и пятый круги
 остаются практическими ориентирами в справочнике; основание вмешательства —
 состояние задачи, а не обязательное прохождение заданного числа кругов.
 Ревью — набор проверяемых утверждений. При разборе важны фактическая верность,
 применимость сценария к проекту и соразмерность исправления. Предложенный
 ревьюером способ починки тоже оценивается; исполнитель может выбрать более
 подходящий. Аргументированное отклонение нормально, квота отклонений не нужна.
 Например, требование усилить безопасность должно опираться на применимый
 сценарий и конкретную границу доверия. Само упоминание безопасности не делает
 предложение обязательным.
 Проход на вычитание сохраняется как приём против накопления лишнего после
 реализации и ревью. Координатор оценивает, какие добавления по-прежнему
 оправданы задачей. Выбранные удаления сохраняют нужное поведение, изменившаяся
 часть получает подходящую проверку. Универсальное правило «при сомнении режь»
 уступает оценке конкретного решения.
 ### Среда и устройство скилла
 Запуск ревьюеров и достаточность их доступа контролирует Astra. Согласованный
 полноценный запуск Claude нельзя молча подменять ограниченным запуском и
 засчитывать его как выполненное ревью. Полноценный доступ включает нужные для
 обзора тесты, исследование, сеть и временные файлы. Сохранность исходников
 и постоянного окружения задаётся мандатом ревьюера; ограничение доступа
 только чтением не заменяет этот мандат. При реальном ограничении координатор
 сообщает конкретную причину и решает, как продолжить в доступных условиях.
 Новый скилл опирается на доступные средства выбора модели, глубины рассуждения
 и передачи истории. Июльские утверждения об ограничениях требуют проверки.
 Описание параметра инструментом и его фактическое применение различаются;
 проверенные возможности и оставшиеся предположения должны быть различимы.
 Структуру определяет [writing-for-agents](../../agents/.agents/skills/writing-for-agents/SKILL.md):
 общая оптика находится в основном тексте, механика отдельных приёмов — по
 ссылкам с ясными условиями чтения. Один смысл имеет одно авторитетное место.
 Конкретные настройки среды отделены от устойчивых принципов. Границы
 обязательной работы сформулированы проверяемо, без лишних ритуалов.
 ## Границы и альтернативы
 Полная переработка самостоятельного Codex-скилла предпочтительнее точечной
 починки надстройки: надстройка сохраняет чтение двух расходящихся инструкций.
 Claude-плейбук служит источником проверенных приёмов; его полное чтение
 перестаёт быть предпосылкой применения нового скилла.
 Общий слой для двух плейбуков сейчас не является целью: он расширяет работу
 за пределы настройки координации Astra. Обязательный конвейер также отклонён:
 пользователь применяет скиллы как оптику для сильного агента и ожидает выбора
 действий по пользе для задачи. Оставить всё как есть означало бы сохранить
 наблюдавшиеся сбои. Переработка Claude-плейбука в эту задачу не входит.
 ## Как оценить результат переработки
 Поведение нового скилла нужно проверить на характерных ситуациях:
 - При подключении посреди работы координатор выбирает нужные приёмы,
  сохраняя силу уже выполненной работы и проверок.
 - Механическая задача не порождает лишних участников и этапов; нетривиальное
  решение получает достаточное внимание Astra и обоснованное ревью.
 - Большой отчёт попадает нужному агенту, а координатор получает основания
  для решения без повторного чтения полного материала.
 - Ошибочная или неуместная находка получает обоснованный исход; настоящая
  проблема исправляется и проверяется. Все находки учтены отдельно.
 - Повторяющийся спор без новых доказательств вызывает пересмотр подхода,
  а не автоматический запуск ещё одного общего ревью.
 - Исправление, которое добавляет существенную сложность, получает оценку
  уместности до внесения; проход на вычитание сохраняет нужное поведение.
 - При недоступности Claude работа продолжается доступными средствами;
  ограничения проведённой проверки названы точно.
 - Выбор моделей, глубины рассуждения и передачи истории опирается на
  проверенные возможности среды, а не на старые заметки.
 Конкретные настройки моделей и способы запуска уточняются при переработке.
 Эта спецификация сохраняет согласованное направление; изменение самого
 скилла начинается по отдельному запросу на реализацию.
@@ -1,67 +0,0 @@
 # Проверка переработанного плейбука
 Дата: 2026-09-06. Спецификация зафиксирована коммитом `65c802f`.
 ## Что проверено
 Основной текст и справочники сверены с принятой спецификацией. Astra сохраняет
 замысел и приемку, Sol ведет реализацию и технический триаж, Luna выполняет
 ограниченную механику. Выбор ревью и канала обмена остается ситуативным.
 Механики Claude больше не требуют чтения его отдельного плейбука.
 Детерминированные проверки прошли:
 - `git diff --check`;
 - 46 относительных Markdown-ссылок, включая 8 ссылок с якорями;
 - разбор YAML, длина `short_description`, наличие имени скилла в подсказке;
 - сохранение явного включения: `disable-model-invocation: true` и
  `allow_implicit_invocation: false`.
 Штатный `quick_validate.py` не знает существующее поле
 `disable-model-invocation` и отклоняет исходник. На временной копии с удалением
 только этого поля он возвращает `Skill is valid!`. Исходное поле сохранено для
 мостов между инструментами; успешная проверка копии не выдается за успешную
 прямую проверку исходника.
 ## Поведение и независимое ревью
 Свежая Astra получила изолированную задачу с настоящим дефектом и спорными
 находками ревью. Она исправила обработку нулевого приоритета, добавила
 регрессионную проверку, отклонила ненужное усиление безопасности и вынесла
 расширение архитектуры за границы задачи. Координатор подтвердил сохранение
 границ. Проверка нового случая сначала падала, после исправления все три теста
 прошли; координатор повторил их. Это один ограниченный сценарий, а не оценка
 общей эффективности скилла. Независимой перепроверки кода этого примера не было.
 Реализацию скилла проверил Claude CLI с `--permission-mode auto`. Метаданные
 подтвердили `claude-opus-5` и `high`. Пользователь явно разрешил передачу diff и
 фрагментов кода этому каналу ревью; после этого автоматическая проверка
 разрешила ранее отклоненный запуск.
 Из девяти находок Claude восемь исправлены. Требование удалить исторические
 заметки отклонено: они не входят в обязательное чтение и не задают текущую
 механику. Дополнительно исправлена находка координатора: отклонение чрезмерного
 способа починки не закрывает подтвержденный дефект.
 Узкая перепроверка в продолжении контекста исходного ревью дала `APPROVED`:
 8 `CLOSED`, 1 `REJECTION_VALID`, без новых дефектов и `OVERREACH`.
 Хеши всех 15 файлов до и после обоих обзоров совпали.
 ## Проверка запуска
 Схема нативных инструментов подтверждает выбор модели, глубины и истории.
 Полная история наследует модель и глубину; явные переопределения требуют
 свежего или ограниченного контекста. Принятый параметр сам по себе не доказывает
 фактически примененную глубину рассуждения.
 Claude CLI 2.1.263 показал дополнительную особенность: повторное задание
 параметров при `--resume` создает копию даже завершенной сессии. Поэтому первая
 перепроверка продолжила историю в копии. Пример в справочнике исправлен на
 `claude --bg --resume <session-id> "<поручение>"` без переопределений.
 Следующий запуск подтвердил тот же идентификатор и сохраненные настройки
 доступа, модели и глубины. Ревьюер отдельно одобрил эту последнюю поправку;
 хеши исходников после проверки не изменились.
 Исторические handoffs, `lessons.md`, принятая спецификация и посторонние
 неотслеживаемые каталоги не изменены. Временные отчеты и пробный код оставлены
 в `/tmp/codex-playbook-refactor.dW8ZC3`; они не являются частью скилла.