2a8f19936a
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>
58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# Compounding Engineering Plugin Development
|
|
|
|
## Versioning Requirements
|
|
|
|
**IMPORTANT**: Every change to this plugin MUST include updates to all three files:
|
|
|
|
1. **`.claude-plugin/plugin.json`** - Bump version using semver
|
|
2. **`CHANGELOG.md`** - Document changes using Keep a Changelog format
|
|
3. **`README.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.
|