lmiranda
c81c4a9981
clear-cache.md and suggest-version.md were missing the required YAML frontmatter with description field. This caused Claude Code to skip loading the entire projman plugin's commands. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
96 lines
3.1 KiB
Markdown
96 lines
3.1 KiB
Markdown
---
|
|
description: Analyze CHANGELOG.md and suggest appropriate semantic version bump
|
|
---
|
|
|
|
# Suggest Version
|
|
|
|
Analyze CHANGELOG.md and suggest appropriate semantic version bump.
|
|
|
|
## Behavior
|
|
|
|
1. **Read current state**:
|
|
- Read `CHANGELOG.md` to find current version and [Unreleased] content
|
|
- Read `.claude-plugin/marketplace.json` for current marketplace version
|
|
- Check individual plugin versions in `plugins/*/. claude-plugin/plugin.json`
|
|
|
|
2. **Analyze [Unreleased] section**:
|
|
- Extract all entries under `### Added`, `### Changed`, `### Fixed`, `### Removed`, `### Deprecated`
|
|
- Categorize changes by impact
|
|
|
|
3. **Apply SemVer rules**:
|
|
|
|
| Change Type | Version Bump | Indicators |
|
|
|-------------|--------------|------------|
|
|
| **MAJOR** (X.0.0) | Breaking changes | `### Removed`, `### Changed` with "BREAKING:", renamed/removed APIs |
|
|
| **MINOR** (x.Y.0) | New features, backwards compatible | `### Added` with new commands/plugins/features |
|
|
| **PATCH** (x.y.Z) | Bug fixes only | `### Fixed` only, `### Changed` for non-breaking tweaks |
|
|
|
|
4. **Output recommendation**:
|
|
```
|
|
## Version Analysis
|
|
|
|
**Current version:** X.Y.Z
|
|
**[Unreleased] summary:**
|
|
- Added: N entries (new features/plugins)
|
|
- Changed: N entries (M breaking)
|
|
- Fixed: N entries
|
|
- Removed: N entries
|
|
|
|
**Recommendation:** MINOR bump → X.(Y+1).0
|
|
**Reason:** New features added without breaking changes
|
|
|
|
**To release:** ./scripts/release.sh X.Y.Z
|
|
```
|
|
|
|
5. **Check version sync**:
|
|
- Compare marketplace version with individual plugin versions
|
|
- Warn if plugins are out of sync (e.g., marketplace 4.0.0 but projman 3.1.0)
|
|
|
|
## Examples
|
|
|
|
**Output when MINOR bump needed:**
|
|
```
|
|
## Version Analysis
|
|
|
|
**Current version:** 4.0.0
|
|
**[Unreleased] summary:**
|
|
- Added: 3 entries (new command, hook improvement, workflow example)
|
|
- Changed: 1 entry (0 breaking)
|
|
- Fixed: 2 entries
|
|
|
|
**Recommendation:** MINOR bump → 4.1.0
|
|
**Reason:** New features (Added section) without breaking changes
|
|
|
|
**To release:** ./scripts/release.sh 4.1.0
|
|
```
|
|
|
|
**Output when nothing to release:**
|
|
```
|
|
## Version Analysis
|
|
|
|
**Current version:** 4.0.0
|
|
**[Unreleased] summary:** Empty - no pending changes
|
|
|
|
**Recommendation:** No release needed
|
|
```
|
|
|
|
## Visual Output
|
|
|
|
When executing this command, display the plugin header:
|
|
|
|
```
|
|
╔══════════════════════════════════════════════════════════════════╗
|
|
║ 📋 PROJMAN ║
|
|
║ Version Analysis ║
|
|
╚══════════════════════════════════════════════════════════════════╝
|
|
```
|
|
|
|
Then proceed with the version analysis.
|
|
|
|
## Integration
|
|
|
|
This command helps maintain proper versioning workflow:
|
|
- Run after completing a sprint to determine version bump
|
|
- Run before `/sprint-close` to ensure version is updated
|
|
- Integrates with `./scripts/release.sh` for actual release execution
|