Fixes #42 Workflow commands now use `workflows:` prefix to avoid collisions with Claude Code's built-in commands: - `/workflows:plan` (was `/plan`) - `/workflows:review` (was `/review`) - `/workflows:work` (was `/work`) - `/workflows:compound` (was `/compound`) To upgrade: Update to latest plugin version. If you see duplicate `/plan` commands, the new namespaced commands avoid this collision. Also fixed in this release: - Added missing `name:` field to heal-skill.md and create-agent-skill.md - Rewrote corrupted prime.md - Shortened Playwright MCP alias from `playwright` to `pw` - Removed deprecated codify.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2.0 KiB
2.0 KiB
Compounding Engineering Plugin Development
Versioning Requirements
IMPORTANT: Every change to this plugin MUST include updates to all three files:
.claude-plugin/plugin.json- Bump version using semverCHANGELOG.md- Document changes using Keep a Changelog formatREADME.md- Verify/update component counts and tables
Version Bumping Rules
- MAJOR (1.0.0 → 2.0.0): Breaking changes, major reorganization
- MINOR (1.0.0 → 1.1.0): New agents, commands, or skills
- PATCH (1.0.0 → 1.0.1): Bug fixes, doc updates, minor improvements
Pre-Commit Checklist
Before committing ANY changes:
- Version bumped in
.claude-plugin/plugin.json - CHANGELOG.md updated with changes
- README.md component counts verified
- README.md tables accurate (agents, commands, skills)
- plugin.json description matches current counts
Directory Structure
agents/
├── review/ # Code review agents
├── research/ # Research and analysis agents
├── design/ # Design and UI agents
├── workflow/ # Workflow automation agents
└── docs/ # Documentation agents
commands/
├── workflows/ # Core workflow commands (workflows:plan, workflows:review, etc.)
└── *.md # Utility commands
skills/
└── *.md # All skills at root level
Command Naming Convention
Workflow commands use workflows: prefix to avoid collisions with built-in commands:
/workflows:plan- Create implementation plans/workflows:review- Run comprehensive code reviews/workflows:work- Execute work items systematically/workflows:compound- Document solved problems
Why workflows:? Claude Code has built-in /plan and /review commands. Using name: workflows:plan in frontmatter creates a unique /workflows:plan command with no collision.
Documentation
See docs/solutions/plugin-versioning-requirements.md for detailed versioning workflow.