feat: add RuleCatch Stop hook — runs automatically every turn

rulecatch-check.sh runs when Claude finishes a turn, reporting any rule
violations. Guaranteed to run (like verify-no-secrets.sh). Skips silently
if RuleCatch isn't installed — zero overhead for new users.

Added to project settings.json, global settings.json, GitHub Pages hooks
section, project structure, and install-global references.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: timclausendev-web

.claude/hooks/rulecatch-check.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# RuleCatch Check Hook — Stop
+# Runs when Claude finishes a turn — reports any rule violations detected.
+# Guaranteed to run (stronger than CLAUDE.md command instructions).
+#
+# Based on Claude Code Mastery Guides V3-V5 by TheDecipherist
+
+# Check if RuleCatch CLI is available
+if ! command -v npx &>/dev/null; then
+    exit 0
+fi
+
+# Check if @rulecatch/ai-pooler is available (quick check)
+# If not installed, skip silently — don't block the user
+if ! npx @rulecatch/ai-pooler@latest check --help &>/dev/null 2>&1; then
+    exit 0
+fi
+
+# Run RuleCatch violation check for the current session
+# --quiet: only output if violations found
+# --format: short summary suitable for hook output
+RESULT=$(npx @rulecatch/ai-pooler@latest check --quiet --format summary 2>/dev/null)
+
+if [ -n "$RESULT" ] && [ "$RESULT" != "0 violations" ]; then
+    echo "" >&2
+    echo "📋 RuleCatch: $RESULT" >&2
+    echo "   Run 'pnpm ai:monitor' for details or check your dashboard." >&2
+    # Exit 0 = inform but don't block (violations are warnings, not blockers)
+    exit 0
+fi
+
+exit 0

.claude/settings.json

@@ -28,6 +28,10 @@
           {
             "type": "command",
             "command": "bash .claude/hooks/verify-no-secrets.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/rulecatch-check.sh"
           }
         ]
       }

CLAUDE.md

@@ -461,7 +461,7 @@ project/
 │   ├── commands/          # Slash commands (/review, /refactor, /worktree, /new-project, etc.)
 │   ├── skills/            # Triggered expertise & scaffolding templates
 │   ├── agents/            # Custom subagents
-│   └── hooks/             # Deterministic enforcement scripts
+│   └── hooks/             # Enforcement scripts (block-secrets, verify-no-secrets, rulecatch-check)
 ├── project-docs/
 │   ├── ARCHITECTURE.md    # System overview & data flow
 │   ├── INFRASTRUCTURE.md  # Deployment & environment details

docs/index.html

@@ -281,7 +281,8 @@ <h3>Set Up Global Config (One Time)</h3>
 # Copy hooks for global enforcement
 mkdir -p ~/.claude/hooks
 cp .claude/hooks/block-secrets.py ~/.claude/hooks/
-cp .claude/hooks/verify-no-secrets.sh ~/.claude/hooks/</code></pre>
+cp .claude/hooks/verify-no-secrets.sh ~/.claude/hooks/
+cp .claude/hooks/rulecatch-check.sh ~/.claude/hooks/</code></pre>
           </div>
         </div>
 
@@ -342,7 +343,8 @@ <h2>Project Structure</h2>
 │   └── hooks/
 │       ├── block-secrets.py     # PreToolUse: block sensitive files
 │       ├── lint-on-save.sh      # PostToolUse: lint after writes
-│       └── verify-no-secrets.sh # Stop: check for secrets
+│       ├── verify-no-secrets.sh # Stop: check for secrets
+│       └── rulecatch-check.sh   # Stop: report RuleCatch violations
 ├── project-docs/
 │   ├── ARCHITECTURE.md          # System overview (authoritative)
 │   ├── INFRASTRUCTURE.md        # Deployment details
@@ -659,6 +661,21 @@ <h3>verify-no-secrets.sh</h3>
 # Check for AWS keys
 if grep -qE 'AKIA[0-9A-Z]{16}' "$file"; then
     VIOLATIONS="${VIOLATIONS}\n  - AWS ACCESS KEY in $file"
+fi</code></pre>
+          </div>
+
+          <div class="hook-stage">
+            <div class="hook-stage-header">
+              <span class="hook-stage-tag hook-stop">Stop</span>
+              <h3>rulecatch-check.sh</h3>
+            </div>
+            <p>Runs when Claude <strong>finishes a turn</strong>. Checks RuleCatch for any rule violations detected during the session. Skips silently if RuleCatch isn't installed &mdash; zero overhead for users who haven't set it up yet.</p>
+            <pre class="language-bash"><code class="language-bash"># Run RuleCatch violation check
+RESULT=$(npx @rulecatch/ai-pooler@latest check --quiet --format summary 2>/dev/null)
+
+if [ -n "$RESULT" ] && [ "$RESULT" != "0 violations" ]; then
+    echo "📋 RuleCatch: $RESULT" >&2
+    echo "   Run 'pnpm ai:monitor' for details." >&2
 fi</code></pre>
           </div>
         </div>
@@ -676,7 +693,10 @@ <h3>Hook Configuration</h3>
       "hooks": [{ "type": "command", "command": "bash .claude/hooks/lint-on-save.sh" }]
     }],
     "Stop": [{
-      "hooks": [{ "type": "command", "command": "bash .claude/hooks/verify-no-secrets.sh" }]
+      "hooks": [
+        { "type": "command", "command": "bash .claude/hooks/verify-no-secrets.sh" },
+        { "type": "command", "command": "bash .claude/hooks/rulecatch-check.sh" }
+      ]
     }]
   }
 }</code></pre>
@@ -707,7 +727,7 @@ <h3><code>/install-global</code></h3>
             <ul>
               <li><strong>Smart merge</strong> &mdash; if you already have a global <code>CLAUDE.md</code>, it appends missing sections without overwriting yours</li>
               <li><strong>settings.json</strong> &mdash; merges deny rules and hooks (never removes existing ones)</li>
-              <li><strong>Hooks</strong> &mdash; copies <code>block-secrets.py</code> and <code>verify-no-secrets.sh</code> to <code>~/.claude/hooks/</code></li>
+              <li><strong>Hooks</strong> &mdash; copies <code>block-secrets.py</code>, <code>verify-no-secrets.sh</code>, and <code>rulecatch-check.sh</code> to <code>~/.claude/hooks/</code></li>
             </ul>
             <p>Reports exactly what was added, skipped, and merged. Your existing config is never overwritten.</p>
           </div>

global-claude-md/settings.json

@@ -27,6 +27,10 @@
           {
             "type": "command",
             "command": "bash ~/.claude/hooks/verify-no-secrets.sh"
+          },
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/rulecatch-check.sh"
           }
         ]
       }