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.mdnew file mode 100644index 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.