From 1f1b765bc6df1ece0059e5dd79a3342b1f326b85 Mon Sep 17 00:00:00 2001
From: Affaan Mustafa <affaan@itomarkets.com>
Date: Sun, 26 Jul 2026 05:51:14 -0400
Subject: [PATCH] docs: clarify Hookify match case sensitivity

---
 commands/hookify-help.md                | 2 +-
 tests/docs/hookify-runtime-docs.test.js | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/commands/hookify-help.md b/commands/hookify-help.md
index 1fb37234f..da37dfa3c 100644
--- a/commands/hookify-help.md
+++ b/commands/hookify-help.md
@@ -126,7 +126,7 @@ the warning to stderr.
 
 ### Pattern Tips
 
-- use JavaScript regex syntax; matching is case-insensitive
+- use JavaScript regex syntax; `regex_match` is case-insensitive while literal operators are case-sensitive
 - for `bash`, match against the full command string
 - for `file`, a simple pattern matches the full file path
 - for changed text, use a `content`, `new_text`, or `old_text` condition
diff --git a/tests/docs/hookify-runtime-docs.test.js b/tests/docs/hookify-runtime-docs.test.js
index 12b0e62d1..98378c9cc 100644
--- a/tests/docs/hookify-runtime-docs.test.js
+++ b/tests/docs/hookify-runtime-docs.test.js
@@ -56,6 +56,8 @@ function runTests() {
     const skill = read('skills/hookify-rules/SKILL.md');
 
     assert.ok(help.includes('simple `pattern` matches `file_path`'));
+    assert.ok(help.includes('`regex_match` is case-insensitive'));
+    assert.ok(help.includes('literal operators are case-sensitive'));
     assert.ok(skill.includes('Simple `event: file` patterns match `file_path`'));
     assert.ok(skill.includes('changed content requires explicit conditions'));
   })) passed++; else failed++;