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.

ArtifactAction
CHANGELOG draftClaude can group confirmed changes
Release notesClaude can prepare a draft for review
Version proposalClaude can suggest a SemVer category
Git tag, publish, or deployRequires explicit decision and human rights
Rollback noteClaude 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.

TypeGuide
patchFix without a public contract change
minorBackward-compatible feature
majorIncompatible API or behavior change

Controlled release workflow

  1. Analyze changes from the last stable tag to HEAD.
  2. Group merged PRs or commits by change type with verifiable references.
  3. Prepare a version proposal, changelog, and rollback note.
  4. Have a person check completeness and accuracy.
  5. After approval, create a tag and only then start publish or release work.
  6. 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.
Preparation and action boundary
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 artifacts

A 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.

FieldWhat to record
Stable pointLast verified stable tag
ProcedureHow to return to that state
Data impactPossible impact on data and migrations
OwnerPerson responsible for the operation
VerificationHow to confirm recovery is complete

Canonical lesson source · JavaRush

Open JavaRush material