From e636cbadb1693d5e83e0d2e17765bf873f83557c Mon Sep 17 00:00:00 2001
From: Dom Monkhouse <dom@monkhouseandcompany.com>
Date: Tue, 19 May 2026 19:46:37 +0100
Subject: [PATCH] docs(plugin): clarify Hermes versus MemSearch recall

---
 plugins/claude-code/skills/memory-recall/SKILL.md | 4 ++++
 plugins/codex/skills/memory-recall/SKILL.md       | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/plugins/claude-code/skills/memory-recall/SKILL.md b/plugins/claude-code/skills/memory-recall/SKILL.md
index 9f5e70de..04c86029 100644
--- a/plugins/claude-code/skills/memory-recall/SKILL.md
+++ b/plugins/claude-code/skills/memory-recall/SKILL.md
@@ -11,6 +11,10 @@ You are a memory retrieval agent for memsearch. Your job is to search past memor
 
 Collection: !`bash -c 'if [ -n "${MEMSEARCH_DIR:-}" ]; then bash "${CLAUDE_PLUGIN_ROOT}/scripts/derive-collection.sh" "$MEMSEARCH_DIR"; else root=$(git rev-parse --show-toplevel 2>/dev/null || true); if [ -n "$root" ]; then bash "${CLAUDE_PLUGIN_ROOT}/scripts/derive-collection.sh" "$root"; else bash "${CLAUDE_PLUGIN_ROOT}/scripts/derive-collection.sh"; fi; fi'`
 
+## Hermes vs MemSearch impact
+
+When explaining Hermes/MemSearch impact, distinguish runtime behaviour from infrastructure health: Hermes affects Hermes-native runs; MemSearch hooks affect Claude/Codex recall. Answer what changes in live Claude/Codex sessions, not just whether Milvus is healthy.
+
 ## Your Task
 
 Search for memories relevant to: $ARGUMENTS
diff --git a/plugins/codex/skills/memory-recall/SKILL.md b/plugins/codex/skills/memory-recall/SKILL.md
index 804dde06..8865f97c 100644
--- a/plugins/codex/skills/memory-recall/SKILL.md
+++ b/plugins/codex/skills/memory-recall/SKILL.md
@@ -12,6 +12,10 @@ Determine the collection name by running:
 bash -c 'if [ -n "${MEMSEARCH_DIR:-}" ]; then bash __INSTALL_DIR__/scripts/derive-collection.sh "$MEMSEARCH_DIR"; else root=$(git rev-parse --show-toplevel 2>/dev/null || true); if [ -n "$root" ]; then bash __INSTALL_DIR__/scripts/derive-collection.sh "$root"; else bash __INSTALL_DIR__/scripts/derive-collection.sh; fi; fi'
 ```
 
+## Hermes vs MemSearch impact
+
+When explaining Hermes/MemSearch impact, distinguish runtime behaviour from infrastructure health: Hermes affects Hermes-native runs; MemSearch hooks affect Claude/Codex recall. Answer what changes in live Claude/Codex sessions, not just whether Milvus is healthy.
+
 ## Steps
 
 1. **Search**: Run `memsearch search "<query>" --top-k 5 --json-output --collection <collection name from above>` to find relevant chunks.