Files
portal/docs/superpowers/specs/2026-06-16-record-wall-push-lessons.md
T

2.6 KiB
Raw Blame History

Зафиксировать уроки пуша кода через стену + завести баг-файл наставника

Сессия 16.06.2026 прошла полный путь «пуш кода через стену» и наткнулась на грабли, которые стоят дорого при повторе. Нужно (1) дописать урок в шпаргалку стены, чтобы следующая сессия не переоткрывала путь, и (2) завести отдельный файл-баг про дефект наставника (пустой recommendation) для передачи в проект claude-brain.

Цель

Документная задача без правки кода/схемы/прода: дописать секцию-урок в docs/superpowers/router-mentor-wall-GUIDE.md и создать новый файл с описанием бага машинерии вердикта. Только .md; рантайм и enforcement-код не трогаются.

D1. Урок в GUIDE стены

В конец docs/superpowers/router-mentor-wall-GUIDE.md добавить секцию «Пуш кода через стену»: порядок гейтов (verify-gate → criterion-gate → lefthook pre-push), продюсер расписки node tools/produce-verify-receipt.mjs, десинк criterion-gate на терминальном push и лечение не-терминальным МУТИРУЮЩИМ шагом, точечный LEFTHOOK_EXCLUDE вместо глухого LEFTHOOK=0, и квирк наставника с пустым recommendation. Edit существующего файла, дописывание в конец (после секции «Судьи-машины»).

D2. Файл-баг наставника

Создать новый .md с описанием дефекта: наставник возвращает decision:GO с пустым recommendation, проверка-содержательности помечает no_mentor_go, судья не вызывается, план не печатается. Файл содержит симптом, корень, воспроизведение, предлагаемый фикс (decision-aware проверка), место в коде и доказательство из лога AITUNNEL. Предназначен для передачи в claude-brain.

[
  {
    "id": "wall-guide-ref",
    "kind": "EXTRACTED",
    "ref": "docs/superpowers/router-mentor-wall-GUIDE.md",
    "anchor": "Судьи-машины"
  }
]