| name | version-updates |
| description | Bump project versions across configs, docs, and changelog using git-workspace-review context. |
| category | artifact-generation |
| tags | version, release, changelog, semver, bump |
| tools | Read, Write, Edit, Bash, TodoWrite |
| complexity | medium |
| estimated_tokens | 700 |
| dependencies | sanctum:shared, sanctum:git-workspace-review |
Version Update Workflow
When to Use
Use this skill when preparing a release or bumping the project version.
Run Skill(sanctum:git-workspace-review) first to capture current changes.
Required TodoWrite Items
version-update:context-collectedversion-update:target-filesversion-update:version-setversion-update:docs-updatedversion-update:verification
Step 1: Collect Context (context-collected)
- Confirm which version to apply (default: bump patch).
- If the prompt provides an explicit version, note it.
- Ensure
Skill(sanctum:git-workspace-review)has already captured the repository status.
Step 2: Identify Targets (target-files)
- List configuration files that store the version (e.g.,
Cargo.toml,package.json,pyproject.toml). - Include changelog and README references that mention the version.
Step 3: Update Versions (version-set)
- Update each target file with the new version.
- For semantic versions, follow
MAJOR.MINOR.PATCHor the specified format. - If the project supports multiple packages, document each update.
Step 4: Update Documentation (docs-updated)
- Add or update changelog entries with today's date.
- Refresh README and docs references to mention the new version and any release notes.
Step 5: Verification (verification)
- Run relevant builds or tests if version bumps require them (e.g.,
cargo test,npm test). - Show
git status -sbandgit diffexcerpts to confirm the version bumps.
Output Instructions
- Summarize the files changed and the new version number.
- Mention follow-up steps, such as publishing or tagging, if applicable.