Release Dry Run

DevOps & Security

release-dry-run

Release Dry Run is an Agent Skill for devops & security published in the dyoshikawa/rulesync repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Dry run for release: summarize changes since last release and suggest version bump.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/dyoshikawa/rulesync/blob/HEAD/.rulesync/skills/release-dry-run/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/release-dry-run, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

This is a dry run command for release. It will summarize the changes since the last release and suggest the appropriate version bump based on semantic versioning.

Steps

Get the latest release tag.
- Run git fetch --tags to ensure all tags are available.
- Run git describe --tags --abbrev=0 to get the latest tag.
- Assign the result to $latest_tag.
Compare code changes between the latest tag and the current HEAD.
- Run git log ${latest_tag}..HEAD --oneline to get the commit list.
- Run git diff ${latest_tag}..HEAD --stat to get the file change statistics.

Analyze the changes and create a summary in the following format:

## Changes Summary

### Commits since ${latest_tag}
- List of commits with their messages

### Changed Files
- Summary of file changes (added, modified, deleted)

### Change Categories
- **Breaking Changes**: List any breaking changes (API changes, removed features, etc.)
- **New Features**: List new features added
- **Bug Fixes**: List bug fixes
- **Other Changes**: List other changes (refactoring, documentation, tests, etc.)

Based on the analysis, suggest the appropriate version bump following semantic versioning rules:
- MAJOR (X.0.0): Breaking changes that are not backward compatible
  - Removed or renamed public APIs
  - Changed behavior of existing features
  - Dropped support for older Node.js versions
- MINOR (x.Y.0): New features that are backward compatible
  - New CLI commands or options
  - New configuration options
  - New tool support
- PATCH (x.y.Z): Bug fixes and minor improvements
  - Bug fixes
  - Documentation updates
  - Internal refactoring without API changes
  - Dependency updates (unless they cause breaking changes)
Important: Whenever the changes include any feature removal or a change in the behavior of an existing feature, do not hesitate to choose a MAJOR version bump. Prioritize protecting users from unexpected breakage over keeping the version number low.

Output the final recommendation in the following format:

## Version Bump Recommendation

Current version: ${latest_tag}
Recommended bump: MAJOR / MINOR / PATCH
Suggested new version: vX.Y.Z

### Reasoning
- Explain why this version bump is recommended based on the changes.

Note: This is a dry run only. No files will be modified and no commits will be made.