Skip to content

docs(agents): document version bumps, releases and the CI workflows - #1575

Merged
joaodinissf merged 1 commit into
masterfrom
docs/agents-version-bumping
Oct 19, 2026
Merged

joaodinissf merged 1 commit into
masterfrom
docs/agents-version-bumping

Conversation

@joaodinissf

Copy link
Copy Markdown
Collaborator

Why the change

Version bumps in this repository aren't obvious, and nothing told agents (or people) how they work: #1558 and #1573 both failed CI with "Only qualifier changed" before the right bumps were added. The CI/CD section was also out of date.

Special things to note

  • New "Bumping Versions" task under Common Tasks: bump a changed published bundle once per release cycle (compared with the last release tag), bump both features after a release, no bump for unpublished modules, and the local command that runs the release version check through the features. Checked against ddk-parent/pom.xml, release.yml, the 19.3.0 update site, and the bumps in build: prepare DDK release 19.3.0 #1561 and after 19.2.0.
  • CI/CD section corrected: verify.yml runs on pull requests and the merge queue (not on pushes to master); snapshot.yml and release.yml are listed; merging through the queue and the release workflow's requirements are described.
  • Kept short, in the file's existing style; AGENTS.md goes from 146 to 157 lines.

🤖 Generated with Claude Code

Add a "Bumping Versions" task: when a change to a published bundle needs a
bundle version bump, when both features need one, what needs none, and the
local command that runs the release version check through the features.
Update the CI/CD section, which still described verify.yml as running on
pushes to master: list the three workflows, merging through the merge
queue, and how releases work.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@joaodinissf
joaodinissf marked this pull request as ready for review October 17, 2026 08:57
@joaodinissf
joaodinissf enabled auto-merge October 17, 2026 09:01
@joaodinissf
joaodinissf added this pull request to the merge queue Oct 19, 2026
Merged via the queue into master with commit 1c2a5f6 Oct 19, 2026
4 checks passed
@joaodinissf
joaodinissf deleted the docs/agents-version-bumping branch October 19, 2026 07:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants