From cce41faa399edfb2a222e130898b3ea9f014b9bf Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Mon, 16 Mar 2026 05:32:21 +0000
Subject: [PATCH] =?UTF-8?q?fix(plugin):=20remove=20block-docs=20hook=20?=
 =?UTF-8?q?=E2=80=94=20was=20blocking=20specs=20and=20RFCs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Virgil <virgil@lethean.io>
---
 claude/core/hooks/hooks.json      | 10 ---------
 claude/core/scripts/block-docs.sh | 37 -------------------------------
 2 files changed, 47 deletions(-)
 delete mode 100755 claude/core/scripts/block-docs.sh

diff --git a/claude/core/hooks/hooks.json b/claude/core/hooks/hooks.json
index fc38fe6..c14cfe7 100644
--- a/claude/core/hooks/hooks.json
+++ b/claude/core/hooks/hooks.json
@@ -12,16 +12,6 @@
         ],
         "description": "Block destructive commands (rm -rf, sed -i, xargs rm) and enforce core CLI"
       },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/block-docs.sh"
-          }
-        ],
-        "description": "Block random .md file creation"
-      }
     ],
     "PostToolUse": [
       {
diff --git a/claude/core/scripts/block-docs.sh b/claude/core/scripts/block-docs.sh
deleted file mode 100755
index 676f1c2..0000000
--- a/claude/core/scripts/block-docs.sh
+++ /dev/null
@@ -1,37 +0,0 @@
-#!/bin/bash
-# Block creation of random .md files - keeps docs consolidated
-
-read -r input
-FILE_PATH=$(echo "$input" | jq -r '.tool_input.file_path // empty')
-
-if [[ -n "$FILE_PATH" ]]; then
-    # Allow known documentation files
-    case "$FILE_PATH" in
-        *README.md|*CLAUDE.md|*AGENTS.md|*CONTRIBUTING.md|*CHANGELOG.md|*LICENSE.md)
-            echo "$input"
-            exit 0
-            ;;
-        # Allow docs/ directory
-        */docs/*.md|*/docs/**/*.md)
-            echo "$input"
-            exit 0
-            ;;
-        # Allow Claude memory and plan files
-        */.claude/*.md|*/.claude/**/*.md)
-            echo "$input"
-            exit 0
-            ;;
-        # Allow plugin development (commands, skills)
-        */commands/*.md|*/skills/*.md|*/skills/**/*.md)
-            echo "$input"
-            exit 0
-            ;;
-        # Block other .md files
-        *.md)
-            echo '{"decision": "block", "message": "Use README.md or docs/ for documentation. Random .md files clutter the repo."}'
-            exit 0
-            ;;
-    esac
-fi
-
-echo "$input"