settings.example.json

{
  "$comment": [
    "Example Claude Code settings.json wiring for the harness hooks. Copy the `hooks` block into your",
    "project's .claude/settings.json (or merge it with an existing one), and copy hooks/ into the path",
    "you reference below.",
    "",
    "ORDER MATTERS on the Edit|Write|MultiEdit matcher: pre-write-discipline runs first (it only ever",
    "adds context and never blocks), then autonomous-blast-radius (which can DENY). Putting the deny-",
    "capable hook second means the guidance is attached even on the turn the cap fires.",
    "",
    "ENV VARS the hooks read:",
    "  HARNESS_AUTONOMOUS        set truthy in unattended runs ONLY. Both autonomous-* hooks exit 0",
    "                            immediately when it is unset, and destructive-bash-guard downgrades",
    "                            from deny to ask. Attended sessions are deliberately untouched.",
    "  HARNESS_BLAST_LIMIT       default 300. Uncommitted changed lines before Edit/Write is denied.",
    "  HARNESS_IMAGE_BUDGET      default 30. Image reads before a hard deny.",
    "  HARNESS_FRAMES_BUDGET     default 6. Extractor invocations before a standing warning.",
    "  HARNESS_EXTRACTOR_PATTERN regex matching your frame/asset extraction command.",
    "  HARNESS_VALUE_SURFACE     regex for paths holding values that feed the model under test.",
    "  HARNESS_ID_LINT           shell command implementing your canonical-identifier lint. It reads the",
    "                            changed text on stdin and prints ONLY when it finds an ambiguous id.",
    "                            Unset (the default) skips the lint and the guard never fires.",
    "  HARNESS_PIPELINE_AGENTS   comma-separated subagent_type names that always trip the premise gate.",
    "",
    "All four hooks FAIL OPEN on any parse error. A broken guard must never block legitimate work."
  ],

  "env": {
    "HARNESS_VALUE_SURFACE": "src/model/|src/engine/|fixtures/|(^|/)data/",
    "HARNESS_PIPELINE_AGENTS": "premise-verifier,preop-judge,postop-judge,implementation-reviewer"
  },

  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit|Agent|Task",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/hooks/pre-write-discipline.py\""
          }
        ]
      },
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/hooks/autonomous-blast-radius.py\""
          }
        ]
      },
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/hooks/destructive-bash-guard.py\""
          }
        ]
      },
      {
        "matcher": "Read|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/hooks/autonomous-image-budget.py\""
          }
        ]
      }
    ]
  }
}