From 9d1fedd3a531d8529c89c84d9e16464bc22c1ef5 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Sun, 25 Jan 2026 15:33:49 -0500 Subject: [PATCH] docs: add plugin.json format rules to CLAUDE.md Add critical warning about hooks and agents field formats to prevent future manifest validation failures. References lesson: plugin-manifest-validation---hooks-and-agents-format-requirements Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 3e1d326..b4eb294 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -163,6 +163,12 @@ leo-claude-mktplace/ - **MCP server venv path**: `${CLAUDE_PLUGIN_ROOT}/mcp-servers/{name}/.venv/bin/python` - **CLI tools forbidden** - Use MCP tools exclusively (never `tea`, `gh`, etc.) +#### ⚠️ plugin.json Format Rules (CRITICAL) +- **Hooks MUST be inline** - NEVER use `"hooks": "path/to/file.json"` +- **Agents auto-discover** - NEVER add `"agents": ["./agents/"]` - .md files found automatically +- **Always validate** - Run `./scripts/validate-marketplace.sh` before committing +- See lesson: `lessons/patterns/plugin-manifest-validation---hooks-and-agents-format-requirements` + ### Hooks (Valid Events Only) `PreToolUse`, `PostToolUse`, `UserPromptSubmit`, `SessionStart`, `SessionEnd`, `Notification`, `Stop`, `SubagentStop`, `PreCompact`