Template

Files

lmiranda 3561025dfc feat(projman): add visual output requirements to agents and commands

Add Visual Output sections to all projman files:
- 4 agent files with phase-specific headers (PLANNING, EXECUTION, CLOSING)
- 16 command files with appropriate headers

Headers use double-line box characters for projman branding:
- Planning phase: TARGET PLANNING
- Execution phase: LIGHTNING EXECUTION (+ progress block for orchestrator)
- Closing phase: FLAG CLOSING
- Setup commands: GEAR SETUP

Closes #273, #274

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-28 17:10:49 -05:00

3.0 KiB

Raw Blame History

/suggest-version

Analyze CHANGELOG.md and suggest appropriate semantic version bump.

Behavior

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
Analyze [Unreleased] section:
- Extract all entries under ### Added, ### Changed, ### Fixed, ### Removed, ### Deprecated
- Categorize changes by impact

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

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

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

3.0 KiB Raw Blame History