From 95021f1461f982c239a5309c45df6ada2b87fe61 Mon Sep 17 00:00:00 2001
From: Ben Drucker <bvdrucker@gmail.com>
Date: Wed, 17 Dec 2025 17:49:38 -0800
Subject: [PATCH 1/2] Rename marketplace to agents-md

---
 .claude-plugin/marketplace.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 2f489c9..94270ff 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,5 +1,5 @@
 {
-  "name": "agents-md-marketplace",
+  "name": "agents-md",
   "owner": {
     "name": "Ben Drucker",
     "url": "https://github.com/bendrucker"

From 43f704823966cb621a9c61c0386f1beb5510bfc5 Mon Sep 17 00:00:00 2001
From: Ben Drucker <bvdrucker@gmail.com>
Date: Wed, 17 Dec 2025 18:19:28 -0800
Subject: [PATCH 2/2] Fix marketplace source path, document hooks workaround

- Change plugin source from "./../" to "./" to pass validation
- Add marketplace metadata description
- Document workaround for plugin hooks not being registered (#11509)
---
 .claude-plugin/marketplace.json |  5 ++++-
 README.md                       | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 94270ff..2d5b306 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,5 +1,8 @@
 {
   "name": "agents-md",
+  "metadata": {
+    "description": "Automatic AGENTS.md file loading for Claude Code"
+  },
   "owner": {
     "name": "Ben Drucker",
     "url": "https://github.com/bendrucker"
@@ -7,7 +10,7 @@
   "plugins": [
     {
       "name": "agents-md",
-      "source": "./../",
+      "source": "./",
       "description": "Loads AGENTS.md files automatically into Claude Code sessions",
       "version": "1.0.0",
       "author": {
diff --git a/README.md b/README.md
index 00a638b..08c2087 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,39 @@ claude plugin marketplace add bendrucker/claude-code-agents-md
 claude plugin install agents-md
 ```
 
+## Known Issue
+
+Due to [a bug in Claude Code](https://github.com/anthropics/claude-code/issues/11509), plugin hooks are not registered. Until this is fixed, you must manually add the hooks to your user settings (`~/.claude/settings.json`):
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ~/.claude/plugins/cache/agents-md-marketplace/agents-md/1.0.0/agents-md-marketplace/.claude-plugin/hook.ts"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ~/.claude/plugins/cache/agents-md-marketplace/agents-md/1.0.0/agents-md-marketplace/.claude-plugin/hook.ts"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
 ## How It Works
 
 The plugin uses two hooks to inject `AGENTS.md` content into Claude Code sessions: