Merge and release are different decisions
A PR to main asks whether a change is safe to accept. A release asks which verified set of changes should be announced as a version. Green CI does not create a release automatically.
Claude Code can prepare release material, but the transition to tag, publish, or deploy must remain an explicit controlled boundary.
| Artifact | Action |
|---|---|
| CHANGELOG draft | Claude can group confirmed changes |
| Release notes | Claude can prepare a draft for review |
| Version proposal | Claude can suggest a SemVer category |
| Git tag, publish, or deploy | Requires explicit decision and human rights |
| Rollback note | Claude can structure it; a person checks feasibility |
SemVer is a guide, not an automatic verdict
Claude may suggest a version level, but a person must assess impact on users, clients, integrations, and migrations. A model suggestion is not compatibility evidence.
| Type | Guide |
|---|---|
| patch | Fix without a public contract change |
| minor | Backward-compatible feature |
| major | Incompatible API or behavior change |
Controlled release workflow
- Analyze changes from the last stable tag to HEAD.
- Group merged PRs or commits by change type with verifiable references.
- Prepare a version proposal, changelog, and rollback note.
- Have a person check completeness and accuracy.
- After approval, create a tag and only then start publish or release work.
- Save the release artifact and actual delivery results.
Record the quality gate boundary
- What Claude Code prepares.
- Which checks are required for a release candidate.
- Where human approval is required.
- Which steps are not automated at this level.
- How changelog, release notes, and rollback are checked.
- Who may tag, publish, or deploy.
Claude: summarize merged changes and draft release notes
Human: verify scope, version, compatibility, and rollback
Human: approve tag and publish
CI: preserve logs and release artifactsA rollback note is part of release work
A rollback draft does not guarantee a safe rollback. Check configuration, dependencies, migrations, and external integrations before release.
| Field | What to record |
|---|---|
| Stable point | Last verified stable tag |
| Procedure | How to return to that state |
| Data impact | Possible impact on data and migrations |
| Owner | Person responsible for the operation |
| Verification | How to confirm recovery is complete |
Canonical lesson source · JavaRush
Open JavaRush material