Files

T

Дмитрий c6f9dc2d76 feat(brain): Pravila §17 (universal skill-coverage) + ADR-016 (phase 1 task 5)

Phase 1 Task 5 of LLM-first router overhaul. §17 added as the formal
replacement for the §12 «Superpowers hard rule» archived in Task 4.

Pravila changes:
- Header v1.40 -> v1.41 (25.05.2026) + changelog entry.
- §17 «Universal skill-coverage rule» added (6 subsections):
  - §17.1 default-deny on non-conversation tasks.
  - §17.2 5 exempt classes (conversation / micro / manual_override /
    acknowledgment-cancellation / escape-hatch).
  - §17.3 Continuation НЕ exempt (D1).
  - §17.4 Enforcement via router-tool-gate.mjs + runtime mode-flag
    (off / warn-only / enforce; default Phase 2 = warn-only).
  - §17.5 Status (not hard-rule under §9, mechanical hook).
  - §17.6 Link to §16.4 missed-activation.

ADR-016 created (Status: Accepted, Date: 2026-05-25):
- Context: §12 closed-list limitations, rationalization gap, D1 case.
- Decision: §12 archived, §17 introduced.
- Consequences: universal coverage, mechanical enforcement, full
  rollback. Cost ~$320-1370/mo bootstrap (accepted).
- Boundaries: 10 scenarios mapped.
- Enforcement: hook chain + adr-judge + brain-retro + STATUS.md C5.

No code changes — normative-text + new ADR file only. Test impact zero.

Plan: docs/superpowers/plans/2026-05-25-llm-first-router-overhaul.md Task 5.
Spec: docs/superpowers/specs/2026-05-24-llm-first-router-overhaul-design.md §6.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-25 14:28:24 +03:00

4.9 KiB

Raw Blame History

Brain Status (auto-generated)

Last updated: 2026-05-25T07:16:31.351Z

Контролёр	Состояние	Детали
C1 L1-watcher	✅	[l1-watcher] OK — 0 drift
C2 Cross-ref consistency	🔴	Update cross-refs in offending files.
C3 Observer-of-observer	✅	[observer-of-observer] OK — last read 0 week(s) ago
C4 Сигнальный статус	✅	This file (self-reference)
C5 Observer-coverage	⚠️	135 episode(s) this month · .git/hooks/post-commit not installed (run: npx lefthook install --force) · 17 missed activation(s) — see /brain-retro
C6 Chain map sync	✅	[chain-map-checker] OK — 16 chains in sync

Метрики (информационные, не алерты)

Observer evidence: 135 episodes this month, 0 observer_error markers, 6 PII matches before filter
Legacy v1 episodes (not in factor analysis): 11
Last /brain-retro: 1 day(s) ago
Использование узлов: см. /brain-retro (раз в спринт). missed_activations: 17. Неиспользованные узлы — не алерт, если профильной задачи не было (Pravila §16.4 v1.36; capability-readiness; см. memory feedback_brain_unused_tools_not_problem — outside-repo memory store).

Метрики дисциплины

Baseline дисциплины роутера (этап 2 router discipline overhaul, spec 2026-05-23). Цель — увидеть «точку До» перед enforcement-хуком этапа 3.

Тип задачи	Эпизодов	% с триггер-матчем	% через скил
bugfix	7	28.6%	42.9%
feature	5	0.0%	0.0%
analysis	4	0.0%	25.0%
planning	2	0.0%	0.0%
refactor	1	0.0%	0.0%
cleanup	1	0.0%	0.0%
monitoring	1	0.0%	0.0%

Router step distribution: 1: 55, 2: 45, 3: 12, 5: 18

Boundaries applied (ADR / границы): 13 of 130 эпизодов (10.0%).

Активные многоэтапные проекты

Router discipline overhaul (spec)
- Этап 1 (машиночитаемый реестр) ✅ закрыт 2026-05-23 — docs/registry/nodes.yaml (83 узла + 16 chains L1-L16), tools/registry-load.mjs + tools/registry-render.mjs (16 тестов), auto-render Tooling §4.0 + routing-off-phase, lefthook job 17 (warn-only).
- Этап 2 (измерения + классификатор-парсер) ✅ закрыт 2026-05-24 + влит в main 2026-05-24 — discipline-metrics (3 среза), brain-retro-analyzer переключён на реестр, STATUS.md блок «Метрики дисциплины», baseline snapshot docs/observer/baselines/2026-05-24-pre-enforcement.md. Plan: docs/superpowers/plans/2026-05-24-router-overhaul-stage-2-measurements.md.
- Этап 3 (принуждение — хук на routing) — Phase A+B (классификатор + 3 хука: router-prehook/tool-gate/stop-gate в .claude/settings.json) ✅ + влит в main 2026-05-24. Гейт работает в режиме warn-only (только stderr-предупреждения, никакой блокировки). Bug-fix bec69aa5: deriveRouterStep в tools/discipline-metrics.mjs — шаг роутера теперь выводится из наблюдаемых признаков (был захардкоженной константой 1). Follow-up 3 fixes 2026-05-24 (после ANTHROPIC_API_KEY + рестарта CC выявлены при инспекции state): (a) UTF-8 stdin helper tools/router-stdin-helper.mjs через StringDecoder + подключение к 3 хукам (русский в state-файл и Anthropic API без mojibake); (b) tools/observer-state-enricher.mjs — pure helper для чтения router-state-<session>.json; (c) parseTranscript обогащение primary_rationale 4 полями (recommended_node override + recommended_chain + chain_progress + chain_completed). 538 tools-тестов GREEN. Plan: docs/superpowers/plans/2026-05-24-router-stage3-three-fixes.md. CHECKPOINT B: дать warn-only накопить реальные наблюдения с починенным сторожем (план говорит «минимум 24 часа»), затем Task 9 — переключение в enforce + 2 новых метрики (domain-hit-rate / chain-completion). Plan: docs/superpowers/plans/2026-05-24-router-overhaul-stage-3-enforcement.md.
- Этап 4 (уборка устаревших правил, deprecation observer-classification-map.json → удаление) — не начат.

Алерт-индикаторы

✅ — норма ・ ⚠️ — внимание ・ 🔴 — действие требуется ・ ⚪ — не запускалось

4.9 KiB Raw Blame History Unescape Escape