{
  "//": "-> .claude/settings.json   Hooks run in the HARNESS, not the model.",
  "//2": "A rule in CLAUDE.md is something the model SHOULD do. A hook is",
  "//3": "something that happens whether or not it decides to. Knowing which",
  "//4": "of your rules needs which is what stops the drift.",

  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\" 2>/dev/null || true"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo \"session ended\" >> .claude/session.log"
          }
        ]
      }
    ]
  },

  "//5": "PreToolUse can BLOCK a call. PostToolUse reacts after it happened.",
  "//6": "Stop fires when the assistant finishes a response.",
  "//7": "Start with ONE hook. A wall of them is harder to debug than none."
}