Files

T

Дмитрий 10eed4e7e4 docs(brain): spec v2.0 LLM-first router overhaul

Brainstorming сессия 2026-05-24..25:
- LLM-first классификатор (Sonnet 4.6) заменяет regex Layer 1.
- §17 «universal skill-coverage» заменяет §12 (default-deny кроме
  conversation/micro/manual_override/escape-hatch).
- Opus 4.7 ревьюер в /brain-retro заполняет review.* (auto, не пользователь).
- Self-retrospect skill (opt-in) для самоанализа агента.
- 7 гранулярных flag-переключателей + dry-run rollback.
- 3 implementation фазы (~3.5-4.5 недели) + 5-6 месяцев passive
  evidence collection + фаза 4 distillation regex из эмпирики.

v1.0 содержал 8 фактических ошибок (несуществующие skill-discipline
файлы, отсутствующие nodes.yaml поля, L1-L16 в неверных файлах) +
11 пропусков охвата + 10 underspecified + 6 противоречий. v2.0 —
полная перезапись с реальным state inventory (§18) и explicit
accepted trade-offs (§19).

Реализация — после закрытия Биллинга v2 Спек C (per user decision).

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

2026-05-25 03:27:02 +03:00

4.9 KiB

Raw Blame History

Brain Status (auto-generated)

Last updated: 2026-05-25T00:09:15.184Z

Контролёр	Состояние	Детали
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	⚠️	290 episode(s) this month · Stop-hook + post-commit OK · 21 missed activation(s) — see /brain-retro
C6 Chain map sync	✅	[chain-map-checker] OK — 16 chains in sync

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

Observer evidence: 290 episodes this month, 0 observer_error markers, 21 PII matches before filter
Legacy v1 episodes (not in factor analysis): 151
Last /brain-retro: 0 day(s) ago
Использование узлов: см. /brain-retro (раз в спринт). missed_activations: 21. Неиспользованные узлы — не алерт, если профильной задачи не было (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.

Тип задачи	Эпизодов	% с триггер-матчем	% через скил
analysis	14	50.0%	28.6%
bugfix	9	44.4%	44.4%
feature	9	22.2%	0.0%
planning	6	0.0%	0.0%
monitoring	4	0.0%	0.0%
refactor	1	0.0%	0.0%
cleanup	1	0.0%	0.0%

Router step distribution: 1: 117, 2: 94, 3: 36, 5: 38

Boundaries applied (ADR / границы): 45 of 285 эпизодов (15.8%).

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

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