Дмитрий
f6b52df613
Establishes a proven rollback mechanism for the LLM-first router overhaul before
any destructive step. Without this, Phase 1-3 work would be irreversible.
What this commit adds:
- Git tag 'brain-pre-llm-bootstrap' on origin/main 9d4a30c3 (pre-overhaul state).
- docs/archive/llm-bootstrap-2026-05/ archive structure with:
- settings-snapshot/ — pre-overhaul ~/.claude/settings.json + project settings
- user-hooks/ — all 14 ~/.claude/hooks/*.py pre-overhaul (incl. §12 ones)
- runtime-flags-snapshot/ — pre-overhaul ~/.claude/runtime/*-mode.json
- nodes-yaml-archive/ — pre-overhaul docs/registry/nodes.yaml
- tools/test-rollback.mjs — rollback planner + executor (--dry-run / --execute)
- tools/test-rollback.test.mjs — TDD: 3 tests for planRollback() contract
- ROLLBACK.md — operator runbook with from->to manifest
E2E smoke proof was run BEFORE this commit (Task 1 step 9):
1. Created TEMP marker commit on top of tag with a dummy file + runtime flag.
2. Ran 'test-rollback.mjs --dry-run' (OK) then '--execute' (user state restored).
3. Reverted git-tracked state and verified marker + flag gone.
4. Verified Task 1 untracked files survived the rollback.
Smoke discovered a bug in the plan's procedure ('git checkout tag -- .' +
'git reset --soft tag' does NOT delete files committed-after-tag — they stay
staged). ROLLBACK.md uses 'git reset --hard <tag>' instead, which correctly
removes overhaul-added tracked files while preserving untracked artefacts
(episodes-*.jsonl, observer notes).
TDD: 3/3 green on test-rollback.test.mjs. Full vitest tools/: 546 passed (was
543 baseline, +3 from this commit), 4 pre-existing 'No test suite' failures
on tools/ruflo-* and tools/subagent-prompt-prefix.test.mjs (out of scope).
Plan: docs/superpowers/plans/2026-05-25-llm-first-router-overhaul.md Task 1.
Spec: docs/superpowers/specs/2026-05-24-llm-first-router-overhaul-design.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
60 lines
2.5 KiB
Python
60 lines
2.5 KiB
Python
"""PreToolUse hook on matcher 'Edit|Write|MultiEdit': if no Skill was
|
|
invoked yet in this session, inject an additionalContext reminder.
|
|
Silent on failure. Never blocks (no permissionDecision). Reminder text
|
|
has two variants - one for CLAUDE.md edits, one for other files."""
|
|
import json
|
|
import os
|
|
import sys
|
|
import tempfile
|
|
|
|
|
|
REMINDER_CLAUDE_MD = (
|
|
"REMINDER (skill-discipline hook): Edit/Write по CLAUDE.md без вызова Skill в этой сессии. "
|
|
"Правки CLAUDE.md обязаны идти через `claude-md-management` skill (CLAUDE.md §5 п.10): "
|
|
"/claude-md-management:claude-md-improver для structural/audit правок или "
|
|
"/claude-md-management:revise-claude-md для capture session learnings. "
|
|
"Прямой Edit по CLAUDE.md — нарушение даже на тривиальных правках. "
|
|
"Если правишь не CLAUDE.md, а .md файл с похожим именем — игнорируй reminder."
|
|
)
|
|
|
|
REMINDER_GENERAL = (
|
|
"REMINDER (skill-discipline hook): Edit/Write вызван без предшествующего Skill в этой сессии. "
|
|
"Если задача попадает под Pravila §12.2 — TDD/debug/brainstorm/plan/verify-before-completion/code-review/parallel-agents/worktree/finishing-branch/subagent/writing-skills "
|
|
"— инвокируй соответствующий superpowers skill через Skill tool ПЕРЕД продолжением. "
|
|
"Если задача — Q&A/чтение/навигация/мета-вопрос/тривиальная правка вне §12.2 — игнорируй reminder и продолжай."
|
|
)
|
|
|
|
|
|
def main() -> None:
|
|
try:
|
|
data = json.load(sys.stdin)
|
|
except Exception:
|
|
return
|
|
|
|
sid = data.get("session_id") or "unknown"
|
|
flag = os.path.join(tempfile.gettempdir(), f"claude-skill-{sid}.flag")
|
|
|
|
if os.path.exists(flag):
|
|
return
|
|
|
|
tool_input = data.get("tool_input") or {}
|
|
file_path = (tool_input.get("file_path") or "").replace("\\", "/")
|
|
is_claude_md = file_path.endswith("/CLAUDE.md") or file_path == "CLAUDE.md"
|
|
|
|
msg = REMINDER_CLAUDE_MD if is_claude_md else REMINDER_GENERAL
|
|
|
|
out = {
|
|
"hookSpecificOutput": {
|
|
"hookEventName": "PreToolUse",
|
|
"additionalContext": msg,
|
|
}
|
|
}
|
|
try:
|
|
sys.stdout.write(json.dumps(out, ensure_ascii=True))
|
|
except Exception:
|
|
return
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|