fix: restructure plugin system for Claude Code compatibility

Major fixes for Claude Code plugin installation:

1. Moved marketplace.json to repo root (.claude-plugin/)
   - Fixes known bug #11243, #11278 with local marketplace path resolution
   - Claude Code uses marketplace.json file path as base, not directory

2. Simplified plugin.json manifests
   - Removed commands/agents/skills directory declarations
   - Claude Code auto-discovers these from standard directories
   - Specifying directories caused "must end with .md" validation errors

3. Cleaned command frontmatter
   - Removed non-standard fields (name, agent, arguments)
   - Only description field is valid in command frontmatter

4. Removed deprecated claude-plugin-developer skill
   - Skill was never properly integrated
   - Removed from repo and all documentation references

All three plugins now validate successfully:
- projman: Sprint planning with Gitea/Wiki.js
- cmdb-assistant: NetBox CMDB integration
- project-hygiene: Post-task cleanup hooks

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-12 12:29:27 -05:00
parent 8afea1d163
commit 8292e6766b
23 changed files with 10 additions and 4496 deletions

View File

@@ -32,7 +32,7 @@ Only these directories may exist at the repository root:
| Directory | Purpose |
|-----------|---------|
| `.claude/` | Claude Code skills |
| `.claude/` | Claude Code local settings |
| `.claude-plugin/` | Marketplace manifest |
| `.claude-plugins/` | Local marketplace definitions |
| `.scratch/` | Transient work (auto-cleaned) |
@@ -355,24 +355,6 @@ bandit/support-claude-mktplace/
- Defense in depth approach
- Plugin works with or without CLAUDE.md
**Plugin Development:**
- **ALWAYS use the `claude-plugin-developer` skill for all plugin-related work**
- Invoke the skill when:
- Creating new plugin manifests (`plugin.json`)
- Developing commands, agents, hooks, or MCP servers
- Validating plugin structure and security
- Troubleshooting plugin loading issues
- Publishing to marketplaces
- The skill provides:
- Security best practices and validation
- Templates and helper scripts
- Complete reference documentation
- Path safety requirements (`${CLAUDE_PLUGIN_ROOT}`)
- Manifest schema validation
- **Critical:** Ensures compliance with Anthropic's security requirements
- Location: `.claude/skills/claude-plugin-developer/`
- Usage: Invoke via Skill tool when working on plugin components
## Multi-Project Context (PMO Plugin)
The `projman-pmo` plugin coordinates interdependent projects across an organization. Example use cases:
@@ -484,12 +466,6 @@ This repository contains comprehensive planning documentation:
- **`docs/projman-python-quickstart.md`** - Python-specific implementation guide
- **`docs/two-mcp-architecture-guide.md`** - Deep dive into two-MCP architecture
**Skills:**
- **`.claude/skills/claude-plugin-developer/`** - Plugin development guidance and validation tools
- Use this skill for all plugin-related work (manifests, commands, agents, hooks, MCP servers)
- Includes security validation, templates, and helper scripts
- Invoke via Skill tool when working on plugin components
**Start with:** `docs/DOCUMENT-INDEX.md` for navigation guidance
## Recent Updates (Updated: 2025-06-11)
@@ -502,7 +478,6 @@ This repository contains comprehensive planning documentation:
- Hybrid configuration strategy defined (system + project level)
- Wiki.js structure planned with configurable base path
- Repository structure designed with shared MCP servers
- `claude-plugin-developer` skill added to project
### Key Architectural Decisions Made
1. **Shared MCP Servers**: Both plugins use the same MCP codebase at `mcp-servers/`