Skip to content

Release guide: the merged prep's tag is the conductor's - #237

Merged
johnnyt merged 1 commit into
mainfrom
px-fgiq-release-tag-wording
Sep 27, 2026
Merged

johnnyt merged 1 commit into
mainfrom
px-fgiq-release-tag-wording

Conversation

@johnnyt

@johnnyt johnnyt commented Sep 27, 2026

Copy link
Copy Markdown
Member

The release extension (.claude/wurk/release.md) carried two sentences that kept the tag with the operator: "Tag and push stay separately human-gated." under the mix hex.publish section, and "The tag, the push and the publish stay the operator's" under the release trigger. CLAUDE.md now says otherwise: the release-prep mechanics row gives the tag of a merged prep to the agent ("The tag of that prep, once it is merged to origin/main, is the agent's too"), and the Release preps paragraph names who ("the conductor or the session that owns the release bead tags that merged commit with the new version and pushes the tag"). The first sentence now points at the release trigger as the tag's owner; the second restates the Release preps paragraph and keeps the publish - mix hex.publish, a docs republish included - as the operator's one release step that no consent or relay delegates. .claude/wurk/commit.md was read and says nothing about the tag, so it is unchanged.

Review (in-turn, docs-only): each new sentence was checked against CLAUDE.md's mix hex.publish row, the release-prep row and the Release preps paragraph. Both grant nothing CLAUDE.md does not, and no authority row or other file changes. No gate run: .claude/ is outside the manifest's gated paths, and CLAUDE.md's commit row lets a change touching no Elixir code commit on review of the diff alone. No changelog fragment: changelog.d/README.md excludes agent tooling changes.

Provenance: ADR-0006 still describes tag, push and publish as the human's steps at release. It is a record and is left alone here; the wording change was ruled by the operator, 2026-09-25, and recorded in CLAUDE.md.

@codecov

codecov Bot commented Sep 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

The release extension still said the tag and its push stayed with the
operator, in the section on mix hex.publish and again under the release
trigger. CLAUDE.md's release-prep row and its Release preps paragraph
now give the tag of a merged release prep to the conductor or the
session that owns the release bead. Both sentences now say that, in
this file's own words, and the publish (mix hex.publish, a docs
republish included) stays the operator's one release step.

Agent tooling only: no code, and no changelog fragment
(changelog.d/README.md excludes agent tooling changes).

Refs: px-fgiq
@johnnyt
johnnyt force-pushed the px-fgiq-release-tag-wording branch from 8335bcd to 1c6340c Compare September 27, 2026 15:31
@johnnyt
johnnyt merged commit 7783920 into main Sep 27, 2026
2 checks passed
@johnnyt
johnnyt deleted the px-fgiq-release-tag-wording branch September 27, 2026 15:35
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.

1 participant