canon-revisionlisted

Full structural REVISION of an always-loaded rules file (CLAUDE.md / MEMORY.md): build a TOP block of the most important rules + numbered categories, move rule bodies verbatim (a script moves bytes and proves 0 losses; the LLM decides only the mapping), fold heavy mechanics into trigger+gist+pointer form, then guards → canary window → fleet rollout. Trigger on "/canon- revision", "revise the canon". For scheduled maintenance, not ad-hoc trimming.
tonydzi/second-brain-starter-kit · ★ 1 · AI & Automation · score 70

Install: claude install-skill tonydzi/second-brain-starter-kit

# canon-revision — revising an always-loaded rules file The pain: the rules file grows through intake, the structure drifts, and the important parts drown in the middle. The owner's decision (2026-07-22): live in cycles — free growth up to the yellow zone, then a FULL structural revision. This procedure is that revision, battle-tested on CLAUDE.md v2. Roles: the LLM decides ONLY (a) the mapping of sections into categories, (b) the contents of the TOP block, (c) which sections to fold, plus pinpoint edits from the owner's explicit decisions. The bytes are moved by the SCRIPT, which proves by itself that nothing was lost. Never retype the file by hand. ## Step 0 — RECALL + the frame - Memory: [[claude-md-compression-contract]] (the contract: trigger · directive · clauses · pointer; the two-ends pitfall), [[write-service-files-tight-no-recompress]], [[memory-index-hygiene]] (for MEMORY.md), [[declined-decisions]] (word-level re-compression = declined). - Thresholds = the defaults in `~/.claude/scripts/claude_md_guard.py` (owner, 07-22: yellow 100KB · red 120KB). The truth is the guard's code, not the notes. - A revision = a canon edit → the owner's machine only, in a live session. ## Step 1 — Measure BEFORE `python ~/.claude/scripts/claude_md_guard.py` + byte size + section counter (`^## ` / `^### `). Record: bytes, sections, md5. ## Step 2 — Coordination and safety net 1. `onair.py check --zone canon-skills` (for MEMORY.md: memory-index) → clear → `onair.py declare --mode