Morgana: Skill for Claude Code

bump_version

Automates version increment for Morgana and all dependent projects when starting a new development cycle.

Trigger

Activated when the user says things like:

• "we just released"
• "bump the version"
• "start a new version"
• "increment version"
• Any request indicating the start of a new development cycle

Hotfix Trigger

For production hotfixes, activated when the user says:

• "prepare a hotfix"
• "we need to ship a production fix"
• "hotfix release"
• Any request indicating a patch fix needs to be distributed

Procedure

1. Extract current version from <repo root>/Morgana/Directory.Build.props

   • It is split in <VersionPrefix>X.Y.Z</VersionPrefix> and <VersionSuffix>betaN</VersionSuffix>
   • The full version is X.Y.Z-betaN. AssemblyVersion and FileVersion stay $(VersionPrefix), because an assembly version cannot carry a suffix

2. Increment the version

   • Default behavior (new development cycle): increment the beta number (N), prefix untouched
     • 1.0.0-betaN → 1.0.0-beta(N+1)
     • Example: 1.0.0-beta1 → 1.0.0-beta2
   • Hotfix behavior: append a patch counter to the suffix
     • 1.0.0-betaN → 1.0.0-betaN.1
     • Example: 1.0.0-beta1 → 1.0.0-beta1.1
   • Leaving beta (1.0.0 final) is the user's decision, never this skill's: then VersionSuffix is removed

3. Update all version files in the following paths:

   • <repo root>/Morgana/Directory.Build.props
   • <repo root>/Channels/Cauldron/Directory.Build.props
   • <repo root>/Channels/Rune/Directory.Build.props
   • <repo root>/Channels/Grimoire/Directory.Build.props
   • <repo root>/Examples/Examples.csproj
   • <repo root>/PromptHarness/PromptHarness.csproj
   • <repo root>/PromptHarness/Plugins/FederationPlugin/FederationPlugin.csproj
   • <repo root>/Alembic/Directory.Build.props

4. Add new section in CHANGELOG.md

   • Read <repo root>/CHANGELOG.md
   • Insert a new section right after the header and preamble
   • For normal version bumps (beta number increment):

   ## [X.Y.Z] - UNDER DEVELOPMENT
   ### ✨ Added
   
   ### 🔄 Changed
   
   ### 🐛 Fixed
   
   ### 📦 Dependencies
   
   ### 🚀 Future Enablement
   
   

   • For hotfixes (patch counter on the suffix):

   ## [X.Y.Z] - UNDER DEVELOPMENT
   ### 🐛 Fixed
   
   

   • Replace X.Y.Z with the newly calculated full version (e.g. 1.0.0-beta2)