docs(cross-review): проверка оснований находок и пересланных отзывов

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

AGENTS.md

@@ -27,7 +27,7 @@ This repository contains personal dotfiles and configurations for a highly produ
 *   **Shared Skills:** Located in `agents/.agents/skills/`. This is the single source of truth for AI instructions.
 *   **Gemini CLI:** Configured via `gemini/.gemini/`. 
     *   **Policies:** `readonly-commands.toml` allows critical commands like `git status`, `git diff`, and `git add` to run without confirmation.
-*   **Opencode:** MCP-based assistant configuration (`opencode.json`) with support for documentation, search, and web-reading.
+*   **Opencode:** MCP-based assistant configuration (`opencode.json`): Context7 для документации и встроенные `websearch`/`webfetch`. Локальный SearXNG в `docker/searxng` — резервный вариант, MCP-сервер отключён.
 *   **Skill Bridges:** Claude gets skills via the `~/.claude/skills` symlink; Opencode reads `~/.agents/skills` natively, no bridge needed.
 
 ## 🚀 Usage & Maintenance

agents/.agents/skills/cross-review/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: cross-review
+description: >-
+  Перекрёстное ревью своей работы моделью другого семейства (Claude ↔ Codex):
+  линзы для ревьюера, способы запуска и разбор находок самим автором.
+  Применяй, когда пользователь просит независимое или перекрёстное ревью,
+  ревью другой моделью, или когда готовое изменение либо план стоит показать
+  чужим глазам до сдачи.
+---
+
+# Перекрёстное ревью
+
+Ты автор изменения и остаёшься его владельцем. Ревьюер из другого семейства
+моделей добавляет то, чего у тебя нет: свежая сессия не знает твоих
+рассуждений, а другое семейство замечает иные классы ошибок. Его отчёт —
+набор утверждений для проверки. Решения по ним принимаешь ты.
+
+Скилл даёт линзы, способы запуска и опыт разбора находок. Сколько линий
+запускать, какие линзы брать и нужна ли перепроверка, решай по задаче и цене
+ошибки.
+
+## Что передать ревьюеру
+
+Создай обменный каталог вне репозитория (`mktemp -d`) и напиши в нём
+короткое поручение `brief.md`. Если переменные shell не сохраняются между
+вызовами, дальше подставляй путь каталога целиком. В поручении:
+
+- **что проверять**: точная версия и способ её получить — diff-команда от
+  точки отсчёта, коммиты или пути. Ревьюер должен отличить проверяемое от
+  посторонних правок в дереве;
+- **постановка**: путь к задаче, спеке или критериям приёмки. Без неё линза
+  «по задаче» работает вслепую — так и напиши;
+- **команды проверки** и ожидаемый результат (например, число тестов);
+- **границы**, если они есть: куда не ходить (приватные данные, рабочие
+  серверы, боевые скрипты), какие проверки слишком дороги, что в этой среде
+  заведомо не находка;
+- **места, где ты сам не уверен** — вопросами, без своих обоснований:
+  пересказ твоей логики лишает ревьюера независимости. То же с выводами
+  другого ревьюера, пока оба не закончили первый заход;
+- **префикс находок** и **путь отчёта** (`REPORT`) — свои у каждого ревьюера.
+
+Поручение собирается конкатенацией: `cat brief.md prompts/mandate.md
+prompts/lens-….md > prompt.md`. Файлы `prompts/` лежат в каталоге этого
+скилла — там, откуда прочитан этот файл. Подставляй их как есть.
+
+## Линзы
+
+Линза — фокус ревьюера. Выбирай те, где в этом изменении правда может
+прятаться ошибка. Два ревьюера параллельно, с разными линзами, видят
+больше: у каждого свой контекст, и фокус не размывается. Один ревьюер с
+несколькими линзами дешевле.
+
+- [`lens-spec.md`](prompts/lens-spec.md) — **по задаче**: сделано ли то, что
+  просили, что упущено, что добавлено сверх, можно ли пройти критерии, не
+  решив задачу.
+- [`lens-code.md`](prompts/lens-code.md) — **по коду**: корректность,
+  инварианты, регрессии, безопасность, честность тестов.
+- [`lens-shape.md`](prompts/lens-shape.md) — **форма и вкус**: эскиз решения
+  до чтения diff, глубина модулей, запахи кода по Фаулеру.
+- [`lens-subtract.md`](prompts/lens-subtract.md) — **вычитание**: что можно
+  удалить без потери нужного поведения. Особенно полезна после нескольких
+  кругов исправлений и для моделей, склонных раздувать код.
+- [`lens-plan.md`](prompts/lens-plan.md) — **план или спека до реализации**:
+  документ судится на своём уровне.
+
+Ревьюеру нужна сильная модель с высокой глубиной рассуждения. У слабой
+модели больше ложных находок, и их разбор съедает экономию. Конкретные
+модели указаны в адаптерах запуска.
+
+## Как запустить
+
+Способ запуска зависит от среды. Механика каждого — в отдельном файле:
+
+- [T3 Code](references/launch-t3.md) — если доступны инструменты
+  `orchestrator_capabilities` и `delegate_task`. Удобнее всего: приложение
+  само следит за задачей и будит тебя по завершении.
+- [Codex из командной строки](references/launch-codex.md) — когда автор
+  Claude или другая модель.
+- [Claude из командной строки](references/launch-claude.md) — когда автор
+  Codex или другая модель.
+
+Общее для всех способов:
+
+- ревьюер получает **свежую сессию**, а не копию твоей истории;
+- ревьюер может то же, что ты: запускать тесты, ходить в сеть, создавать
+  временные файлы. Исходники и состояние защищает мандат в поручении.
+  Песочница только для чтения оставила бы ревьюеру одно чтение кода;
+- перед запуском сними `git status --porcelain`, после — сверь: дерево
+  должно остаться прежним;
+- пока ревьюер работает, проверяемые файлы не меняй, иначе он проверит
+  смесь двух версий. Правки, которые уже ясны, готовь рядом, во временном
+  каталоге;
+- если ревьюеров или кругов несколько, веди в обменном каталоге короткий
+  реестр: кто проверял, какую версию, id сессии или задачи, пути отчётов,
+  открытые ID. Он переживёт сжатие контекста и пригодится для отчёта;
+- код уходит к другому поставщику моделей. Просьба пользователя о
+  перекрёстном ревью покрывает проверяемое изменение и нужный ему контекст;
+  секреты и посторонние материалы в поручение не клади.
+
+## Разбор находок
+
+Разбирает находки автор: у тебя контекст кода и задачи. Пользователю нужен
+итог в отчёте, а не участие в каждом споре. Так же разбирай и отзывы других
+моделей, которые переслал пользователь.
+
+По каждой находке проверь три вещи:
+
+1. **Верна ли она фактически.** Воспроизведи сценарий, прочти код, запусти
+   тест. Ревьюеры ошибаются уверенно: выдумывают API, путают версии,
+   приписывают коду то, чего в нём нет, требуют защиты от невозможных
+   состояний. Автору легко поверить хорошо изложенной находке, но уверенный
+   тон — не доказательство. Проверяй и то, на чём находка держится:
+   утверждения о прогонах, истории и прошлых решениях сверяй с источником
+   так же, как утверждения о коде. Дешёвая починка от проверки не
+   освобождает: ложная находка, закрытая одной строкой, всё равно добавляет
+   лишнее.
+2. **Применима ли к этому проекту** — его контрактам, масштабу, угрозам.
+3. **Соразмерна ли починка риску.** Предложенный способ — один из вариантов.
+   Подтверждённый дефект закрывай лучшим путём, какой видишь; отказ от
+   предложенной починки сам дефект не закрывает.
+
+Бывает и обратная ошибка: отмахнуться от неудобной находки. Отклонение с
+доводом от контракта или теста весит столько же, сколько исправление.
+Отклонение без довода ничем не лучше пропущенной находки.
+
+Следи за сложностью. Исправление, которое добавляет больше, чем убирает
+риска, — повод остановиться и поискать путь проще. Замечание о стиле без
+показанного вреда — не дефект.
+
+Исход каждой находки — один из четырёх:
+
+- `FIXED` — подтверждена и исправлена; названа проверка, которая это
+  показывает (по возможности — тест, воспроизводящий дефект);
+- `REJECTED` — не подтвердилась или неприменима; приведён довод;
+- `OUT_OF_SCOPE` — верна, но починка выходит за границы задачи;
+- `NEEDS_DECISION` — нужен выбор цели, устройства или допустимого риска.
+
+Последние два не решай молча правкой кода: вынеси пользователю с вариантами,
+их ценой и своей рекомендацией. Если без ответа дальше идти нельзя — спроси
+сразу, иначе — в итоговом отчёте.
+
+Резолюции пиши файлом в обменный каталог, по строке на находку:
+`ID | исход | довод или проверка`. Этот файл читает ревьюер в следующем
+круге, по нему же собирается отчёт пользователю.
+
+## Следующие круги
+
+Дороже всего в ревью — независимый контекст, который ревьюер набирает в
+первом заходе: устройство кода, постановка, свои опыты. Набирается он один
+раз. Все следующие круги отправляй в ту же сессию ревьюера:
+
+- **узкая перепроверка** — когда исправления нетривиальны или отклонение
+  могут оспорить. Отдай [`prompts/recheck.md`](prompts/recheck.md), путь к
+  своим резолюциям и что изменилось после ревью (diff-команду или список
+  файлов). Ревьюер проверяет только свои находки и оценивает, не вышла ли
+  починка шире нужного;
+- **полный проход по новой версии** — когда изменения вышли за пределы
+  починок. Опиши, что изменилось, и попроси пройти новую версию теми же
+  линзами; ID прежних находок сохраняются.
+
+Свежий ревьюер нужен, когда прежний контекст мешает: ревьюер держится за
+свои прошлые выводы, его сессия переполнена, его отчёт оказался слабым,
+версия переработана так, что прежний контекст устарел, или нужен взгляд
+другой модели. Если способ запуска не умеет продолжать сессию,
+свежему ревьюеру дай пути к исходному поручению, отчёту и резолюциям, а
+сохранённые прежним ревьюером скрипты и фикстуры он возьмёт по путям из
+отчёта.
+
+Если спор повторяется без новых фактов, ещё один круг ничего не даст: реши
+сам с доводом или вынеси пользователю.
+
+## Отчёт пользователю
+
+Коротко и обычными словами:
+
+- кто смотрел (модель, глубина, способ запуска), какую версию и какими
+  линзами;
+- находки — по строке: ID, суть, исход; счётчики;
+- что исправлено и чем это проверено, что отклонено и почему;
+- что вынесено на решение пользователя;
+- пути к полным отчётам; затраты времени и денег, если они известны.

agents/.agents/skills/cross-review/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Перекрёстное ревью"
+  short_description: "Перекрёстное ревью моделью другого семейства"
+  default_prompt: "Используй $cross-review: покажи готовое изменение ревьюеру другого семейства моделей, разбери его находки и дай мне короткий отчёт."

agents/.agents/skills/cross-review/prompts/lens-code.md

@@ -0,0 +1,17 @@
+## Линза: по коду
+
+Попробуй сломать изменение. Ищи:
+
+- неверный результат на входах и состояниях, о которых автор не подумал:
+  пусто, граница диапазона, параллельный доступ, частичный сбой, повтор;
+- нарушенные инварианты между модулями и поломки у вызывающего кода за
+  пределами diff;
+- обработку ошибок, которая теряет данные, прячет причину или оставляет
+  состояние записанным наполовину;
+- безопасность: недоверенный ввод, секреты, права доступа;
+- честность тестов: тест проходит при любом коде, подменяет заглушкой то,
+  что сам проверяет, сверяет результат с тем же вычислением, что в коде,
+  а не с независимым ожидаемым значением, или остаётся зелёным при той
+  ошибке, от которой должен защищать.
+
+Воспроизведённый сбой лучше подозреваемого. Указывай, какой из двух у тебя.

agents/.agents/skills/cross-review/prompts/lens-plan.md

@@ -0,0 +1,16 @@
+## Линза: план
+
+Ты проверяешь постановку, план или спеку, а не реализацию. Документ уйдёт
+исполнителю, который сделает то, что написано. Ищи:
+
+- факты, которые расходятся с кодом: имена, пути, поведение, версии;
+- решения, которые документ принимает молча или оставляет открытыми там,
+  где исполнителю придётся гадать;
+- критерии приёмки, которые нельзя проверить или можно пройти, не решив
+  задачу;
+- отсутствие наблюдаемости: как вообще станет видно, что всё работает.
+
+В детали реализации заходи только там, где документ молча её предрешает.
+Открытые детали реализации не делают план неполным: `APPROVED` значит, что
+в самом документе нет дефекта, который он должен исправить. Риски
+отложенных решений записывай строками `NOTE:`.

agents/.agents/skills/cross-review/prompts/lens-shape.md

@@ -0,0 +1,61 @@
+## Линза: форма и вкус
+
+Сильный исполнитель ошибается не в отделке кода, а в форме решения — в тех
+решениях, которые постановка оставила открытыми. Чистый код такие ошибки
+прячет, поэтому начни с формы, ещё до чтения изменённых файлов.
+
+1. По одной постановке набросай ожидаемую форму решения: какое вычисление
+   где живёт, что и примерно в каком объёме пересекает границы процессов и
+   хранилищ, какие артефакты должны появиться. Хватит нескольких строк.
+   Это гипотеза, а не образец, которому код обязан следовать.
+2. Прочитай изменения и выпиши решения, которых постановка не требовала:
+   где размещены вычисления, какие данные идут через границы, какие
+   появились новые сущности, что сделано сверх просьбы.
+3. Каждое расхождение с наброском и каждое такое решение оцени по
+   соглашениям репозитория, по риску и по размеру задачи. Формально верное,
+   но по сути неправильное — тоже находка: работа не по масштабу задачи,
+   артефакт, который не оправдывает своего существования, проверка, которая
+   проходит, ничего не доказывая.
+
+Набросок и список решений приведи в отчёте как выполненные проверки, даже
+если находок нет.
+
+### Глубина модулей
+
+Глубокий модуль прячет много поведения за маленьким интерфейсом. Мелкий
+заставляет вызывающего узнать почти столько же, сколько сам экономит.
+Отмечай новые мелкие модули, слои, которые только передают вызов дальше, и
+точки расширения с единственной реализацией, у которой не видно второй.
+
+### Запахи кода
+
+Оценивай находку о вкусе по цене жизни с этим кодом, а не по тому, ломает
+ли она тест. Сверяй изменение с этим списком (Фаулер, «Рефакторинг», гл. 3).
+Записанное соглашение репозитория важнее списка. Любой запах — повод для
+суждения («возможно, Feature Envy»), а не нарушение правила. Пропускай то,
+что уже проверяют линтеры и форматтеры.
+
+- **Mysterious Name** — имя скрывает, что делает или хранит сущность →
+  переименуй; если честное имя не находится, мутно само устройство.
+- **Duplicated Code** — одна и та же логика в нескольких местах → вынеси её
+  и вызывай из обоих.
+- **Feature Envy** — функция работает с чужими данными больше, чем со
+  своими → перенеси её к данным.
+- **Data Clumps** — одни и те же несколько полей или параметров всё время
+  ходят вместе → собери их в один тип.
+- **Primitive Obsession** — строка или число заменяют понятие предметной
+  области → дай понятию свой маленький тип.
+- **Repeated Switches** — один и тот же выбор по типу повторяется → полиморфизм
+  или одна таблица соответствий на оба места.
+- **Shotgun Surgery** — одно логическое изменение требует правок по многим
+  файлам → собери то, что меняется вместе, в один модуль.
+- **Divergent Change** — один модуль правят по несвязанным причинам →
+  раздели так, чтобы каждая часть менялась по одной причине.
+- **Speculative Generality** — абстракции, параметры или крючки для нужд,
+  которых у задачи нет → удали; встрой обратно, пока нужда не появится.
+- **Message Chains** — длинные цепочки `a.b().c().d()` → спрячь обход за
+  одним методом первого объекта.
+- **Middle Man** — модуль в основном передаёт вызовы дальше → вызывай
+  настоящую цель напрямую.
+- **Refused Bequest** — наследник почти не пользуется тем, что унаследовал →
+  откажись от наследования в пользу композиции.

agents/.agents/skills/cross-review/prompts/lens-spec.md

@@ -0,0 +1,12 @@
+## Линза: по задаче
+
+Сравни изменение с постановкой и найди:
+
+- требования, которые не выполнены или выполнены частично;
+- поведение, о котором не просили;
+- требования, которые выглядят выполненными, но сделаны неверно;
+- критерии приёмки, которые можно пройти, не решив задачу.
+
+К каждой находке приведи строку постановки, на которую она опирается.
+Если постановки нет, скажи об этом и суди по замыслу, который виден из
+коммитов и кода.

agents/.agents/skills/cross-review/prompts/lens-subtract.md

@@ -0,0 +1,20 @@
+## Линза: вычитание
+
+Спроси себя, что можно убрать из изменения, не потеряв нужного поведения.
+Сначала сравни размер изменения с размером задачи. Потом ищи:
+
+- ветки кода, опции, параметры и настройки, которых не требует ни одно
+  требование;
+- абстракции с единственной реализацией и обёртки, которые только передают
+  вызов;
+- защитные проверки от состояний, которые уже исключают типы или
+  вызывающий код;
+- повторяющиеся тесты, тесты самого фреймворка, тесты, которые пересказывают
+  код;
+- комментарии и документацию, которые повторяют код;
+- файлы, скрипты и зависимости, добавленные ради разовой нужды.
+
+Для каждого кандидата назови, чего стоит удаление: какое поведение или
+гарантия уйдут вместе с ним. Пиши только о тех удалениях, которые ничего не
+стоят или явно стоят своей цены. Такая находка — `MINOR`, если только
+лишнее не делает код заметно труднее для изменения или ревью; тогда — `MAJOR`.

agents/.agents/skills/cross-review/prompts/mandate.md

@@ -0,0 +1,56 @@
+## Мандат ревьюера
+
+Ты независимый ревьюер. Утверждения автора, комментарии в коде и выводы
+прежних ревью — гипотезы, пока их не подтвердят факты.
+
+- Ничего не меняй. Не правь исходники, не пиши в Git (`add`, `commit`,
+  `checkout`, `stash`, `reset`), не трогай службы, данные и настройки.
+  Единственный результат твоей работы — файл REPORT.
+- Проверяй руками: читай код, запускай тесты и команды, сверяйся с
+  документацией и первоисточниками. Черновые файлы держи во временном
+  каталоге вне репозитория. Находка, подтверждённая запуском, весит намного
+  больше находки, найденной чтением.
+- Скрипты воспроизведения и фикстуры, которые подтверждают находки, клади
+  в каталог рядом с REPORT и называй их пути в отчёте: по ним потом
+  проверят починку.
+- Если останавливал или перезапускал службу, убедись, что она вернулась в
+  прежнее состояние.
+- Оценивай документ по его задаче: план не считается неполным из-за того,
+  что не расписывает реализацию.
+- Требуя исправление, сравни его цену с риском, который оно убирает.
+  Находка — утверждение, которое автор проверит, а не приказ.
+
+## Отчёт
+
+Пиши REPORT по-русски и дописывай каждую находку сразу, как нашёл: если
+сессия оборвётся, часть отчёта сохранится. Одна строка на находку:
+
+`ПРЕФИКС-N | тяжесть | место | суть | сценарий отказа | как проверить`
+
+- `BLOCKER` — неверный результат, потеря данных, дыра в безопасности или
+  задача не сделана.
+- `MAJOR` — настоящий дефект с правдоподобным поводом сработать, или
+  стоимость сопровождения, которая задаче не нужна.
+- `MINOR` — дефект есть, но жить с ним дёшево.
+- `NIT` — дело вкуса. Замечание о стиле без показанного вреда — не выше
+  `NIT`.
+
+`место` — `файл:строка` или раздел постановки. ID не меняются: в следующих
+кругах на находки ссылаются только по ID.
+
+Заметный риск решения, которое можно спокойно отложить, пиши отдельной
+строкой `NOTE: ...` — без ID и тяжести, на вердикт она не влияет.
+
+Если находок нет, перечисли, что именно ты просмотрел и какие проверки
+запускал, с результатами. Голое «одобряю» — не ревью.
+
+Последняя строка REPORT:
+`VERDICT: APPROVED | APPROVED_WITH_MINORS | CHANGES_REQUESTED`.
+`CHANGES_REQUESTED` — есть хотя бы один BLOCKER или MAJOR;
+`APPROVED_WITH_MINORS` — есть MINOR; иначе `APPROVED`. NIT на вердикт не
+влияет.
+
+## Итоговое сообщение
+
+Верни только строку VERDICT, число находок по тяжести, по строке на каждую
+находку BLOCKER и MAJOR (ID и суть) и `REPORT: <абсолютный путь>`.

agents/.agents/skills/cross-review/prompts/recheck.md

@@ -0,0 +1,36 @@
+# Узкая перепроверка твоих находок
+
+Автор разобрал твои находки. Ниже — пути к исходному поручению, к твоему
+отчёту и к резолюциям автора. Если сессия у тебя новая, сначала прочитай
+все три файла: в поручении — постановка, границы проверяемой версии, мандат
+и формат находок. Мандат прежний: ничего не меняй; читать и запускать тесты
+можно.
+
+Проверяй только свои находки, а не всё изменение заново. Оценивай не только
+то, закрыта ли находка, но и саму починку: соразмерна ли она и не сломала ли
+что-то рядом. Чаще всего лишнее приходит из твоего же предписания, так что
+проверь и его. Прежде чем назвать находку
+незакрытой, убедись, что закрытое состояние вообще достижимо и что его цена
+соразмерна тому, что оно защищает. Это взвешивание не смягчает находок о
+доступе, данных и деньгах.
+
+Отклонение оценивай по доводу — контракт, тест, доказательство, — а не по
+вкусу. Если по ходу заметил новый дефект, запиши его с новым ID в исходном
+формате.
+
+Находки с исходом `OUT_OF_SCOPE` или `NEEDS_DECISION` ждут решения
+владельца задачи. Их не пересматривай: перенеси строкой `ID | DEFERRED` и
+не учитывай в итоговой строке.
+
+По строке на каждый остальной исходный ID:
+
+`ID | CLOSED | NOT_CLOSED (почему) | REJECTION_VALID | REJECTION_INVALID (почему)`
+
+Для исправленной находки (`FIXED`) допиши `| PROPORTIONATE` или
+`| OVERREACH (что вышло шире, чем требовала находка)`. `OVERREACH` — сигнал
+автору, а не блокер.
+
+Последняя строка: `RECHECK: ALL_CLOSED | ISSUES_REMAIN`
+
+Запиши результат по новому пути REPORT, указанному ниже, и верни только
+последнюю строку, ID незакрытых находок и `REPORT: <абсолютный путь>`.

agents/.agents/skills/cross-review/references/launch-claude.md

@@ -0,0 +1,84 @@
+# Запуск Claude из командной строки
+
+Для автора, у которого есть shell и установлен `claude` (Claude Code CLI).
+Проверено на Claude Code 2.1.302 (Linux, 2026-10-17): запуск с промптом из
+stdin, запись отчёта, продолжение по id сессии, фоновая сессия.
+
+## Первый запуск
+
+```bash
+# D — обменный каталог с готовым brief.md, S — каталог скилла
+cat "$D/brief.md" "$S/prompts/mandate.md" "$S/prompts/lens-shape.md" \
+  > "$D/prompt.md"
+
+cat "$D/prompt.md" | claude -p --permission-mode auto --model opus \
+  --effort high --add-dir "$D" --output-format json \
+  > "$D/out.json" 2> "$D/err.txt"
+
+jq -r '.session_id, .result, .is_error' "$D/out.json"
+```
+
+- **`--model opus`** — псевдоним последней модели Opus, он не устаревает с
+  выходом новых версий. Глубина ревью — `high`; выше — по просьбе
+  пользователя.
+- **`--permission-mode auto`** разрешает запускать тесты, ходить в сеть и
+  создавать временные файлы; опасные действия отсекает встроенный
+  классификатор. Исходники защищает мандат.
+- **`--add-dir "$D"`** разрешает запись отчёта в обменный каталог.
+- **`--output-format json`** возвращает `session_id` для перепроверки,
+  `result` — финальное сообщение, `modelUsage` — фактическую модель и
+  стоимость для отчёта пользователю.
+
+## Ожидание
+
+`claude -p` держит процесс до конца ревью, а это часто дольше 10 минут.
+Если твой инструмент shell столько не ждёт, есть два пути:
+
+- запусти ту же команду фоном средствами своей среды и жди завершения
+  процесса. Появление `out.json` ничего не значит: перенаправление создаёт
+  пустой файл сразу при запуске;
+- или запусти фоновую сессию самого Claude:
+
+  ```bash
+  claude --bg --permission-mode auto --model opus --effort high \
+    --add-dir "$D" "Прочитай $D/prompt.md и выполни." < /dev/null
+  ```
+
+  Команда сразу печатает короткий id. Состояние сессии —
+  `claude agents --json --all` (поля `id`, `sessionId`, `state`); жди
+  `state: done`. Сам `REPORT` ревьюер дописывает по ходу, поэтому его
+  появление тоже не признак конца. `claude logs` выдаёт сырой вывод
+  терминала, агенту он бесполезен. Завершённую сессию останавливай
+  `claude stop <id>`.
+
+В любом случае перед разбором проверь, что последняя строка `REPORT` —
+`VERDICT: …`: иначе отчёт неполный.
+
+## Затраты
+
+`out.json` содержит `total_cost_usd`, `usage` (токены) и `modelUsage`
+(разбивка по моделям, включая служебные вызовы).
+
+## Следующие круги
+
+Узкая перепроверка или полный проход по новой версии — продолжением той же
+сессии. Что положить в поручение — в разделе «Следующие круги» SKILL.md.
+
+```bash
+cat "$D/recheck-prompt.md" | claude -p --resume <session-id> \
+  --output-format json > "$D/recheck.json" 2> "$D/recheck-err.txt"
+```
+
+Модель сохраняется из первого запуска (проверено: продолжение шло на той же
+Opus). Режим доступа и глубину заново не задавай; сверь, что `session_id` в
+ответе совпал с исходным. Для фоновой сессии из `--bg` бери её `sessionId`
+из `claude agents --json --all`.
+
+## Особенности ревьюеров Claude
+
+- Однострочный формат находок держат хуже: бывают многострочные записи и
+  развёрнутые подтверждения. Проверь индекс перед разбором.
+- Видят картинки: графики, скриншоты, выводы ноутбуков. Если проверяемый
+  результат визуальный, это довод за Claude.
+- Сильнее в механике кода и форме решения: нереализуемые формулировки,
+  мёртвые заглушки, неудачные имена и границы.

agents/.agents/skills/cross-review/references/launch-codex.md

@@ -0,0 +1,103 @@
+# Запуск Codex из командной строки
+
+Для автора, у которого есть shell и установлен `codex`. Проверено на
+codex-cli 0.163.0 (Linux, 2026-10-17): первый запуск, продолжение по id,
+запись отчёта в обменный каталог.
+
+## Перед первым запуском
+
+На новой машине и после обновления Codex проверь, что команды внутри
+песочницы вообще выполняются:
+
+```bash
+codex sandbox -c 'sandbox_mode="workspace-write"' -- sh -c 'echo SANDBOX_OK'
+```
+
+На Linux отказ вида `bwrap: ... Failed RTM_NEWADDR` обычно значит, что
+AppArmor запрещает непривилегированные user namespaces. Это настройка машины,
+а не ревью: сообщи пользователю и сошлись на
+[требования песочницы](https://learn.chatgpt.com/docs/sandboxing#prerequisites).
+Работающий веб-поиск о песочнице ничего не говорит.
+
+## Первый запуск
+
+```bash
+# D — обменный каталог с готовым brief.md, S — каталог скилла
+cat "$D/brief.md" "$S/prompts/mandate.md" "$S/prompts/lens-code.md" \
+  > "$D/prompt.md"
+
+set -o pipefail
+cat "$D/prompt.md" | codex exec --json --strict-config --approve-for-me \
+  --add-dir "$D" -m <model> -c 'model_reasoning_effort="<effort>"' \
+  -o "$D/final.md" - > "$D/log.jsonl" 2> "$D/err.txt"
+```
+
+- **Промпт — каналом через stdin** (`cat … | codex exec … -`): так он
+  доходит в любой среде. Поток событий и ошибки — в файлы; в свой контекст
+  читай только `final.md` и отчёт `REPORT`.
+- **`--approve-for-me`** даёт песочницу `workspace-write` и сам одобряет
+  выход за неё: сеть, docker, команды вне каталога. Вместе с `-s` он не
+  принимается. Шире — `danger-full-access` — ревьюеру не нужно.
+- **`--add-dir "$D"`** разрешает запись отчёта в обменный каталог.
+- **Модель и глубину задавай явно.** Иначе они берутся из
+  `~/.codex/config.toml` и зависят от последней интерактивной сессии
+  пользователя. На 2026-10 для ревью кода обычно лучше всего подходит
+  `gpt-6.1-sol` с глубиной `high`. `gpt-6-astra` с `xhigh` сильнее и
+  заметно дороже: бери её по просьбе пользователя или когда ошибка особенно
+  дорога. Названия моделей быстро устаревают: при сомнении спроси
+  пользователя.
+- **`--strict-config`** останавливает запуск при неизвестном ключе `-c`.
+  Без него опечатка молча заменяется настройкой по умолчанию.
+
+## Ожидание
+
+Ревью идёт от нескольких минут до получаса. Запускай команду фоном средствами
+своей среды: в Claude Code — Bash с `run_in_background`, без `&` внутри
+команды; среда разбудит тебя по завершении.
+
+- **id сессии** — в первой строке лога:
+  `head -1 "$D/log.jsonl" | jq -r .thread_id`. Сохрани его сразу: по нему
+  идут перепроверка и спасение, если процесс умер.
+- **Признак жизни** — рост `log.jsonl`. Долгая сборка или тесты внутри
+  песочницы событий не пишут, поэтому застывший лог — повод посмотреть, а не
+  приговор.
+- **Вердикт без находок** проверь по логу: работа это или отписка.
+  `grep -c '"command_execution"' "$D/log.jsonl"` — число выполненных команд.
+  Голое APPROVED при нуле команд перезапускай.
+
+## Затраты
+
+Токены по каждому ходу пишутся в лог:
+`jq -c 'select(.type=="turn.completed") | .usage' "$D/log.jsonl"`.
+Стоимости в выводе нет.
+
+## Следующие круги
+
+Узкая перепроверка или полный проход по новой версии — продолжением той же
+сессии. Что положить в поручение — в разделе «Следующие круги» SKILL.md.
+
+```bash
+cat "$D/recheck-prompt.md" | codex exec resume --json --strict-config \
+  -m <model> -c 'model_reasoning_effort="<effort>"' \
+  -o "$D/recheck-final.md" <thread-id> - \
+  > "$D/recheck-log.jsonl" 2> "$D/recheck-err.txt"
+```
+
+- **Только по явному id.** `--last` подхватит последнюю сессию, а при
+  нескольких ревьюерах это может быть чужая.
+- Песочница и доступ к `$D` принадлежат сессии и сохраняются; ключей `-s`,
+  `--approve-for-me` и `--add-dir` у `resume` нет.
+- Модель и глубину повтори явно — те же, что при первом запуске: иначе
+  подставятся значения из конфига, а смена глубины внутри сессии сбрасывает
+  кэш.
+
+## Особенности ревьюеров Codex
+
+- Мандат и формат отчёта держат надёжно.
+- Бывает, требуют исправлений сверх цели задачи; в других прогонах все
+  починки выходили соразмерными. Проверяй соразмерность как обычно.
+- Хорошо ловят уровень требований: недостающие критерии, наблюдаемость,
+  «формально отчитаться можно».
+- Могут заглянуть в свою память (`~/.codex/memories/`) и подтянуть выводы
+  прошлых задач. Свежая сессия Codex поэтому не полностью свободна от
+  прошлого опыта.

agents/.agents/skills/cross-review/references/launch-t3.md

@@ -0,0 +1,102 @@
+# Запуск через T3 Code
+
+Для автора, который работает внутри T3 Code и видит инструменты
+`orchestrator_capabilities` и `delegate_task` (имена могут идти с префиксом
+вроде `mcp__t3-code__`). Приложение само следит за дочерней задачей, будит
+тебя по её завершении, а пользователь видит ход ревью в отдельном разговоре.
+Проверено 2026-10-17: Claude → Codex.
+
+## Выбор модели
+
+Модель и глубину выбирай по адаптеру семейства ревьюера:
+[Codex](launch-codex.md#первый-запуск) или
+[Claude](launch-claude.md#первый-запуск). Вызови `orchestrator_capabilities`,
+найди у нужного провайдера эту модель (`providerInstanceId`, `model`) и
+проверь, что она есть в списке. Ключ глубины у провайдеров разный —
+смотри `options` модели: у Codex это `reasoningEffort`, у Claude —
+`effort`.
+
+## Запуск
+
+Собери `prompt.md` так же, как для командной строки, и передай его путь:
+
+```json
+{
+  "task": "Прочитай /tmp/…/prompt.md и выполни.",
+  "target": {
+    "providerInstanceId": "codex",
+    "model": "<model>",
+    "options": { "reasoningEffort": "high" }
+  },
+  "role": "review",
+  "mode": "async",
+  "title": "cross-review: <что проверяем>",
+  "clientRequestId": "<уникальный id этого раунда>"
+}
+```
+
+- **`isolation` не задавай** (по умолчанию — общий checkout). Отдельный
+  worktree строится от последнего коммита, и незакоммиченные правки
+  ревьюер не увидит.
+- **`runtimeMode` не задавай.** Режимы с подтверждением остановят ревьюера
+  на первом же действии и будут ждать человека в его разговоре. Ограничения
+  задаёт мандат в поручении. Режим наследуется от твоего разговора, а шире
+  своего задать нельзя: если ты сам работаешь с подтверждением, скажи
+  пользователю до запуска.
+- После запуска заверши ход: уведомление о завершении придёт само.
+  `task_status` нужен, только если результат требуется посреди хода.
+- Итоговое сообщение ревьюера приходит в `summary`; полный отчёт — в файле
+  `REPORT`.
+- Вердикт без находок проверь по активности разговора: `t3_thread_read` с
+  `view: "activity"` показывает выполненные команды (`command_execution`).
+  Голое APPROVED без команд — отписка, перезапускай.
+
+## Следующие круги
+
+Следующие круги — узкую перепроверку и полный проход по новой версии —
+отправляй тому же ревьюеру, в его дочерний разговор, когда предыдущая
+задача уже завершилась. Это `t3_thread_send`:
+
+```json
+{
+  "threadId": "<childThreadId из ответа delegate_task>",
+  "message": "Прочитай /tmp/…/recheck-prompt.md и выполни.",
+  "mode": "auto",
+  "clientRequestId": "<уникальный id этого круга>"
+}
+```
+
+- В дочернем разговоре появляется новая задача со своим `taskId`; по
+  завершении она будит тебя так же, как исходная. Ребёнок помнит свои
+  прошлые ходы (проверено 2026-10-17 на Codex).
+- Модель, глубина и режим остаются от исходной задачи. Модель и глубину
+  можно сменить через `t3_thread_configure`, но это сбрасывает кэш и
+  отчасти обесценивает продолжение — оставляй как есть.
+- `childThreadId` запиши в реестр сразу после запуска ревью: разговор
+  хранит T3, но его id нужен тебе.
+- Что положить в поручение круга — в разделе «Следующие круги» SKILL.md.
+
+Свежий ревьюер — новый `delegate_task` с новым `clientRequestId`. Когда он
+нужен — там же, в SKILL.md. Тем же путём иди, если продолжить разговор не
+удалось или системные инструкции T3 для тебя обязательны (о них ниже). В
+поручение свежей задачи положи пути к исходному `prompt.md`, отчёту
+ревьюера и своим резолюциям.
+
+Системные инструкции T3 и описание `t3_thread_send` говорят об этом
+по-разному. Первые считают каждый круг ревью независимым: новый
+`delegate_task`, без продолжения через `t3_thread_send`. Второе оставляет
+`delegate_task` независимым кругам, а продолжение, которому нужен разговор
+того же ребёнка, отправляет в `childThreadId`. Этот скилл считает следующие
+круги продолжением: ревьюер работает по уже набранному контексту, это
+дешевле и глубже. В прогонах 2026-10-17 круги-продолжения шли в 2–4 раза
+быстрее первого захода.
+
+Это расходится с замыслом авторов T3 и сделано сознательно: владелец скилла
+ставит повторное использование контекста ревьюера выше независимости
+каждого круга. T3 и скилл развиваются; если инструкции T3 изменятся,
+этот выбор стоит пересмотреть.
+
+## Затраты
+
+T3 сообщает только время выполнения. Токены и стоимость видны в выводе
+командной строки — см. адаптеры Codex и Claude.

docker/searxng/README.md

@@ -0,0 +1,40 @@
+# SearXNG — резервный поиск
+
+Локальный SearXNG на `127.0.0.1:26745`. Постоянно не нужен: с 2026-10-17
+основной поиск идёт через встроенные `websearch`/`webfetch` OpenCode, а
+MCP-сервер `searxng` отключён в `opencode/.config/opencode/opencode.json`.
+Стек оставлен как запасной вариант, если встроенный поиск недоступен
+(например, кончилась подписка OpenCode Go) или нужен фильтр по времени.
+
+## Запуск и остановка
+
+```
+docker compose up -d      # поднять
+docker compose down       # погасить, кэш и настройки в томах сохранятся
+docker logs --since 10m searxng-core
+```
+
+Проверка: `curl -s -H 'Accept: application/json' http://127.0.0.1:26745/config | head -c 200`
+
+## Возврат MCP-сервера
+
+Добавить в `mcp.servers` файла `opencode/.config/opencode/opencode.json`:
+
+```json
+"searxng": {
+  "type": "local",
+  "command": ["npx", "-y", "mcp-searxng"],
+  "environment": { "SEARXNG_URL": "http://localhost:26745" }
+}
+```
+
+После правки — разложить конфиг установщиком (`./install.sh`) или скопировать
+файл в `~/.config/opencode/opencode.json`, затем перезапустить OpenCode.
+
+## Ограничения
+
+- Настройки по умолчанию (`use_default_settings: true`), форматы `html` и `json`.
+- С домашнего IP часть движков быстро упирается в лимиты: `brave` и `wikipedia`
+  отвечают `too many requests`, `duckduckgo` — CAPTCHA. Остаётся `google cse`,
+  то есть полноценной агрегации из многих движков ждать не стоит.
+- Контейнер не обновляется сам: `docker compose pull && docker compose up -d`.

opencode/.config/opencode/opencode.json

@@ -1,70 +1,34 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  // Плагин opencode-permission-reviewer снят (эксперимент 2026-10-11 признан
+  // Минимальный шаблон для OpenCode 2.x. Файл раскладывается копией
-  // неудачным — см. docs/research/). Блок сохранён для возврата:
+  // (install.sh → copy_managed_file), поэтому правки в репозитории
-  // "plugins": [
+  // попадают в ~/.config/opencode только после ./install.sh.
-  //   {
+  "share": "manual",
-  //     "package": "opencode-permission-reviewer@^2.4.0",
+  "permissions": [
-  //     "options": {}
+    // Порядок важен: побеждает последнее совпавшее правило.
-  //   }
+    { "action": "edit", "resource": "*", "effect": "ask" },
-  // ],
+    { "action": "webfetch", "resource": "*", "effect": "ask" },
-  "default_agent": "build",
+    { "action": "subagent", "resource": "*", "effect": "ask" },
-  "permission": {
+    { "action": "shell", "resource": "*", "effect": "ask" },
-    // edit покрывает и запись, и патчи (write/patch в V2 устарели)
+    { "action": "shell", "resource": "*/.ssh/*", "effect": "deny" },
-    "edit": "ask",
+    { "action": "shell", "resource": "*id_rsa*", "effect": "deny" },
-    "webfetch": "ask",
+    { "action": "shell", "resource": "*id_ed25519*", "effect": "deny" },
-    "task": "ask",
+    { "action": "shell", "resource": "*.pem", "effect": "deny" },
-    "bash": {
+    { "action": "shell", "resource": "*.env", "effect": "deny" },
-      "*": "ask",
+    { "action": "shell", "resource": "*.env.*", "effect": "deny" },
-      "*/.ssh/*": "deny",
+    { "action": "shell", "resource": "*.secrets*", "effect": "deny" },
-      "*id_rsa*": "deny",
+    { "action": "shell", "resource": "*.netrc*", "effect": "deny" },
-      "*id_ed25519*": "deny",
+    { "action": "shell", "resource": "*.env.example", "effect": "allow" }
-      "*.pem": "deny",
+  ],
-      "*.env": "deny",
-      "*.env.*": "deny",
-      "*.secrets*": "deny",
-      "*.netrc*": "deny",
-      "*.env.example": "allow"
-    }
-  },
   "mcp": {
-    "context7": {
+    "servers": {
-      "type": "remote",
+      "context7": {
-      "url": "https://mcp.context7.com/mcp",
+        "type": "remote",
-      "headers": {
+        "url": "https://mcp.context7.com/mcp",
-        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
+        "headers": {
-      },
+          "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
-      "enabled": true
+        }
-    },
+      }
-    "searxng": {
-      "type": "local",
-      "command": [
-        "npx",
-        "-y",
-        "mcp-searxng"
-      ],
-      "environment": {
-        "SEARXNG_URL": "http://localhost:26745"
-      },
-      "enabled": true
-    },
-    "playwright": {
-      "type": "local",
-      "command": [
-        "npx",
-        "-y",
-        "@playwright/mcp@latest"
-      ],
-      "enabled": false
-    },
-    "duckduckgo": {
-      "type": "local",
-      "command": [
-        "uvx",
-        "duckduckgo-mcp-server"
-      ],
-      "enabled": true
     }
-  },
+  }
-  "share": "manual"
 }

opencode/.config/opencode/skills

@@ -1 +0,0 @@
-../../../agents/.agents/skills