everything-claude-code

mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-03-30 13:43:26 +08:00

Files

Affaan Mustafa c9ef02ba42 docs: add requirements section and hooks field warning

- Add minimum Claude Code version requirement (v2.1.0+)
- Document hooks auto-loading behavior to prevent flip-flop cycles
- Add flip-flop history table to PLUGIN_SCHEMA_NOTES.md
- Reference issues #29, #52, #103 that were caused by this confusion
- Explain that regression test now prevents reintroduction

This documentation should prevent future confusion about whether to
add/remove the hooks field from plugin.json.

2026-01-29 00:46:05 -08:00

marketplace.json

fix: remove version fields from marketplace.json

2026-01-22 23:14:23 -08:00

PLUGIN_SCHEMA_NOTES.md

docs: add requirements section and hooks field warning

2026-01-29 00:46:05 -08:00

plugin.json

fix: remove duplicate hooks declaration from plugin.json

2026-01-28 23:02:05 -08:00

README.md

docs: add plugin manifest validation notes

2026-01-28 23:04:58 -08:00

README.md

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.