brain/docs/superpowers/session-protocol-2026-06-13.md

# Протокол сессии — 2026-06-13 (роутер-наставник)

> Записи в раздел «Решения» делает Claude ТОЛЬКО по команде владельца «фиксируй …».
> Самовольные записи Claude запрещены (строгий запрет).

## Решения

### Р1 (2026-06-13) — способ сборки L1→L2

Выбран **способ B**: наставник — первый хук (выносит вердикт), судья — хук ПОСЛЕ наставника
(судит вслепую, печатает). Судья делается **fail-safe**: нет вердикта наставника для этого
плана → судья молчит, не дедлочит. Поведение: наставник → судья → печать судьи; счётчики 3+3;
карточка владельцу при тупике.

### Р2 (2026-06-13) — канал доставки замечаний контроллеру (обязательно, принцип №1)

На КАЖДЫЙ NO-GO (наставника или судьи) хук обязан отдать контроллеру ПОЛНЫЙ текст замечания
через канал обратной связи, который Claude реально получает (feedback хука / exit-2 stderr) —
НЕ `console.error` в пустоту и НЕ только в рантайм-файл. Проверяемо: после NO-GO контроллер
буквально видит текст замечания в своём контексте. Спека §2 П1 это требует, но в коде НЕ
реализовано — это и есть корень мучений. Не зависит от A/B.

### Р3 (2026-06-13) — канонический поток L1→L2 (эталон, словами владельца)

**Круг L1 — контроллер ↔ наставник (до 3 раз):**

1. Контроллер пишет план → его смотрит ТОЛЬКО наставник. Судья ещё не в курсе.
2. Наставник: «пункт 2 плохой, переделай». Счётчик L1 = 1.
3. Контроллер переписал → наставник смотрит снова: «теперь ок». Счётчик L1 → сброс.
   (если за 3 круга не сошлись → карточка владельцу: «я и наставник спорим, реши».)
4. Наставник доволен → САМ несёт план судье. Судья видит план ВПЕРВЫЕ.

**Круг L2 — наставник передал → судья (до 3 раз):**
5. Судья судит ВСЛЕПУЮ (не зная мнения наставника):

- Судья GO → судья ПОДПИСЫВАЕТ печать. План запечатан. Контроллеру приходит «GO, делай». ✅
- Судья NO-GO → его замечание возвращается контроллеру. Счётчик L2 = 1. Контроллер переписал
     → снова к наставнику (L1 заново) → наставник одобрил → снова судье (L2 = 2)…
- (3 NO-GO судьи подряд → карточка владельцу.)

1. Контроллер НИ РАЗУ не общается с судьёй напрямую. Печатает ТОЛЬКО судья.

### Р4 (2026-06-13) — чистое завершение плана (выход в разговорный)

По коду: после выполнения плана контроллер ЗАСТРЕВАЕТ в режиме реализации — следующее действие
блокируется «план исчерпан» (`enforce-supreme-gate.mjs:217`); выйти можно только ручным удалением
`frozen-plan` или новой сессией (стена сама печать не снимает — грепом подтверждено).
**Решение:** добавить ЧИСТОЕ завершение — когда последний шаг плана выполнен ИЛИ владелец сказал
«готово», стена САМА снимает печать (удаляет `frozen-plan`) и возвращается в разговорный. Ручное
удаление файла больше не нужно.

### Р5 (2026-06-13) — состояние сессии для передачи в новую

**Пивот:** O9 (исходная задача — лимит доли INFERRED) **ПАРКНУТА** — судья-ИИ через aitunnel
таймаутил (500/timeout), печать спеки/плана не вставала. Код `context-verity.mjs`/`.test.mjs`
**НЕ тронут** (изменений O9 на диске нет). Orphan-файлы `specs/2026-06-13-o9-*.md` +
`plans/2026-06-13-o9-*.md` (v1+r2) — мусор, удалить.
**Сделано:** через `brainstorming` → `writing-plans` собран redesign согласования L1→L2:

- спека `specs/2026-06-13-l1-l2-negotiation-redesign-design.md` (простым языком, с примерами);
- план `plans/2026-06-13-l1-l2-negotiation-redesign-plan.md` (6 фаз, TDD);
- решения Р1-Р4 (выше).
**СТЕНА СНЯТА** (maintenance: `.claude/settings.json` = `{"hooks":{}}`, бэкап
`.claude/settings.json.bak-before-maintenance-2026-06-13`). Edit/Write/Bash свободны, цикла печати нет.
**Остаток:** исполнить план, начать с **Фазы 0 (smoke канала замечаний — ГЕЙТ)**, inline TDD.
**Риски:** судья-транспорт aitunnel нестабилен; канал доставки замечаний контроллеру — критичная
неизвестность (Фаза 0 её снимает). Коммиты — владелец; settings.json — владелец.

### Р6 (2026-06-13) — наставник видит контекст, судья судит вслепую (уточнение Р3, Фаза 3 спека)

Наставник судит спеку (и план) и даёт замечания, и **ОБЯЗАН видеть контекст** (verified-context,
переговоры — наставник работает рядом с контроллером, как старший коллега). Судья судит
**ВСЛЕПУЮ** — контекст НЕ видит, на суд идёт только сам артефакт (спека/план), чтобы оценка была
честной и независимой. Действует одинаково для спеки (gate1) и плана (gate2).

### Р7 (2026-06-13) — наставник заворачивает на содержательном несогласии (фикс круга L1)

Сквозной смоук способа B (Фаза 6.3) вскрыл: наставник доносил замечание контроллеру ТОЛЬКО при
сломанном/degraded вердикте; содержательное «пункт 2 плохой, переделай» оформлялось как валидный
вердикт → проходило как **GO** → молча, до контроллера не доходило, счётчик L1 не рос. То есть
круг L1 из Р3 НЕ работал — несогласие наставника тонуло. **Решение — Подход А:** в вердикт
наставника добавить явное поле `decision: "GO" | "NO-GO"` (как у судьи). Логика: `blocked =
wired && (decision==='NO-GO' ИЛИ вердикт сломан)`; на NO-GO контроллеру приходит СУТЬ
(`recommendation` + `reasoning` + `plan_points_addressed`, не «есть замечание»); `mentor-GO`
пишется только при `wired && ok && decision==='GO'`; счётчик L1 растёт на NO-GO (3 → карточка).
**Видимость вердикта — ТОЛЬКО на NO-GO** (на GO тихо, минимум шума). Судья (уже имеет decision +
objections), печать, счётчик-механика, finish-грант, стена — БЕЗ изменений. Реализация — через
живой цикл способа B (спека→наставник→судья→печать→план→печать→правки) + TDD, план со скил-цепочкой.

### Р8 (2026-06-13) — мерж роутера в наставника (Подход 1): роутер СОХРАНЯЕТ мозг

**Решение владельца:** наставник — ЕДИНЫЙ рецензент: судит спеку + план + **выбор скилов в плане**,
заворачивает NO-GO на любом несогласии. Роутер сливается с наставником по **Подходу 1**: наставник
на ревью плана зовёт классификатор **как функцию**.
**ГАРАНТИЯ (страх владельца снят): «становится функцией» НЕ значит «теряет мозг».** Мозг роутера
сохраняется ЦЕЛИКОМ: `classify()` — 3 слоя (prefilter → LLM → regex-fallback) + **граф скилов/узлов**
(`docs/registry/nodes.yaml` через `registry-load.mjs`, с per-node атрибут-**карточками**) +
эмбеддинги/PAMYATKA. Меняется ТОЛЬКО проводка: `classify()` зовёт **наставник** (а не дохлый
`router-prehook`), результат идёт в **вердикт наставника** (а не в файл-в-стол). На пенсию — лишь
обёртки-хуки `router-prehook` / `chain-recommendation` / `graph-first` (пустые посредники), НЕ мозг.
**Предпосылка:** план ОБЪЯВЛЯЕТ выбранные скилы структурно (иначе судить нечего). Этот мерж
ПОГЛОЩАЕТ фикс наставник-NO-GO (Р7) — он фундамент (наставник обязан уметь NO-GO).

### Р9 (2026-06-13) — состояние сессии для передачи в новую (handoff)

**СДЕЛАНО этой сессией (на диске, НЕ закоммичено — коммиты за владельцем):**

1. **Redesign согласования L1→L2, Фазы 0–6** (план `2026-06-13-l1-l2-negotiation-redesign-plan.md`):
   Ф0 smoke-гейт канала (PostToolUse exit-2 ДОХОДИТ до контроллера, подтверждено фактом, хуки без
   рестарта); Ф1 канал замечаний (`objection-delivery.mjs` `buildObjectionFeedback`/`buildDegradedFeedback`;
   наставник+судья отдают дословный текст на NO-GO; degraded «не дозвонился» §9; root-cause:
   `formatJudgeObjection` читал `verdict.blocking`, не `.objections`); Ф2 способ B
   (`mentor-go-store.mjs` домен `MENTOR_GO`; наставник пишет mentor-GO/не печатает; судья fail-safe
   сам печатает; дедлок-фикс снят); Ф3 спека тем же сценарием (`runMentorSpecVerdict`+`onSpecWrite`,
   binding к хешу артефакта; судья gate1 под mentor-GO; `bindingHashForJudge`); Ф4 счётчики per
   task-id (mentor+judge); Ф5 чистое завершение (`removeFrozenPlan`, авто после последнего шага +
   finish-грант `PLAN_FINISH_ACTION='plan-done'`, Вариант А). **Полная регрессия 3877 passed + 2 skip,
   0 регрессий.**
2. **способ B settings.json** отдан владельцу (наставник→судья оба PostToolUse, судья снят из Pre).
   Владелец активировал → **сквозной смоук Ф6.3 вскрыл ДВА бага:** (A) наставник доносит замечание
   только при СЛОМАННОМ вердикте — содержательное «переделай» тонет (Р7); (B) **роутер работает в
   пустоту**: `classify()` зовёт только `router-prehook`, который пишет в файл и отдаёт контроллеру
   `{}`; хуки `chain-recommendation`/`graph-first` в способ-B вообще не зарегистрированы.
3. **Дизайн мержа** (Р7/Р8 + спека `2026-06-13-router-mentor-merge-design.md` + план
   `2026-06-13-router-mentor-merge-plan.md`, 9 задач TDD): наставник — единый рецензент
   (спека+план+скилы), зовёт `classify()` как функцию (мозг роутера цел: 3 слоя + граф `nodes.yaml`
   - карточки), заворачивает NO-GO. Поглощает Р7.
**СОСТОЯНИЕ СРЕДЫ:** **СТЕНА СНЯТА** (maintenance, `.claude/settings.json` = `{"hooks":{}}`; способ-B
бэкап у владельца + `settings - Copy.json`). Edit/Write/Bash свободны.
**ОСТАЛОСЬ:** исполнить план мержа (9 задач, inline TDD), затем владелец вернёт способ-B стену +
повторит смоук. Реализация НЕ начата.
**ПРОТОКОЛ:** записи только по команде владельца «фиксируй». Цепочка скилов исполнения: executing-plans
ИЛИ test-driven-development (inline RED→GREEN); systematic-debugging на баг; brainstorming перед
новым дизайном; /graphify или Grep/Read перед вопросом по коду. Регрессия — ТОЛЬКО
`npx vitest run --root app --config vitest.config.tools.mjs` (баре, без cd/&&/пайпа).