大きな CLAUDE.md を丸ごと書き換えられたとき、消えた見出しを探して戻し、次から止める

claude --version

# 何を解決するか: どの指示ファイルが「先頭しか読まれない」大きさか、先に把握する
find . -type f \( -name CLAUDE.md -o -path '*/.claude/rules/*.md' \) \
  -not -path '*/node_modules/*' | while read -r f; do
  printf '%7s 文字  %s\n' "$(LC_ALL=C.UTF-8 wc -m < "$f")" "$f"
done | sort -rn | head

   8552 文字  ./sub/CLAUDE.md
   8552 文字  ./sub/.claude/rules/a.md
   8552 文字  ./CLAUDE.md

git diff --numstat
# 1	138	CLAUDE.md   ← 追加 1 行、削除 138 行

#!/usr/bin/env bash
# lost_headings.sh — 基準の版にあって、いまのファイルから消えた見出しを出す
# 使い方: lost_headings.sh CLAUDE.md [基準のリビジョン(既定 HEAD)]
set -euo pipefail
f="${1:?file}"; rev="${2:-HEAD}"
old="$(mktemp)"; trap 'rm -f "$old"' EXIT
git show "${rev}:${f}" > "$old"
echo "行数:   $(wc -l < "$old") -> $(wc -l < "$f")"
echo "文字数: $(LC_ALL=C.UTF-8 wc -m < "$old") -> $(LC_ALL=C.UTF-8 wc -m < "$f")"
echo "--- 消えた見出し ---"
diff <(grep -E '^#{1,4} ' "$old") <(grep -E '^#{1,4} ' "$f") | grep '^<' | sed 's/^< //' || true

行数:   206 -> 68
文字数: 8552 -> 2850
--- 消えた見出し ---
## 第5章 ルール5
## 第6章 ルール6
（中略）
## 第12章 ルール12

git restore CLAUDE.md

git show HEAD:CLAUDE.md > /tmp/CLAUDE.old.md
# 消えた章だけを /tmp/CLAUDE.old.md から開いて、いまのファイルに貼り直す

#!/usr/bin/env python3
# .claude/hooks/guard_instruction_rewrite.py
# 何を解決するか: 指示ファイルが Write で全文置換され、後半が消えるのを書き込み前に止める
import json, os, re, sys
 
WATCHED = re.compile(r"(^|/)(CLAUDE(\.local)?\.md|\.claude/rules/.+\.md)$")
MIN_CHARS = 6000      # これより小さいファイルは素通し
SHRINK_LIMIT = 0.7    # 新しい内容が既存の 70% 未満なら止める
 
def headings(text):
    return [l.strip() for l in text.splitlines() if re.match(r"#{1,4} ", l)]
 
def main():
    # stdin はバイトで受けて UTF-8 に固定する（Windows の cp932 対策）
    data = json.loads(sys.stdin.buffer.read().decode("utf-8"))
    if data.get("tool_name") != "Write":
        return 0
    inp = data.get("tool_input", {})
    path = inp.get("file_path", "")
    if not WATCHED.search(path.replace("\\", "/")) or not os.path.isfile(path):
        return 0
    old = open(path, encoding="utf-8", errors="replace").read()
    new = inp.get("content", "")
    if len(old) < MIN_CHARS:
        return 0
    lost = [h for h in headings(old) if h not in set(headings(new))]
    ratio = len(new) / len(old)
    if lost or ratio < SHRINK_LIMIT:
        print(f"[guard] {path}: 既存 {len(old)} 文字 → 新規 {len(new)} 文字"
              f"（{ratio:.0%}）、消える見出し {len(lost)} 件。"
              "全文を Read で読み直すか、Edit で該当箇所だけ直してください。",
              file=sys.stderr)
        return 2   # 終了コード 2 で書き込みを止め、stderr を Claude に返す
    return 0
 
if __name__ == "__main__":
    sys.exit(main())

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/guard_instruction_rewrite.py\""
          }
        ]
      }
    ]
  }
}