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:
27
CLAUDE.md
27
CLAUDE.md
@@ -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/`
|
||||
|
||||
Reference in New Issue
Block a user