Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

docs: add plugin manifest validation notes

Graceme Kamei04ee20827c4b
diff --git a/.claude-plugin/README.md b/.claude-plugin/README.md
new file mode 100644
index 000000000..7464685e4
--- /dev/null
+++ b/.claude-plugin/README.md
@@ -0,0 +1,5 @@
+### Plugin Manifest Gotchas
+
+If you plan to edit `.claude-plugin/plugin.json`, be aware that the Claude plugin validator enforces several **undocumented but strict constraints** that can cause installs to fail with vague errors (for example, `agents: Invalid input`). In particular, component fields must be arrays, `agents` must use explicit file paths rather than directories, and a `version` field is required for reliable validation and installation.
+
+These constraints are not obvious from public examples and have caused repeated installation failures in the past. They are documented in detail in `.claude-plugin/PLUGIN_SCHEMA_NOTES.md`, which should be reviewed before making any changes to the plugin manifest.