This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow-steward.git
The following commit(s) were added to refs/heads/main by this push:
new b41328b docs(release-management): sync family README to reflect all
10 shipped skills (#587)
b41328b is described below
commit b41328b042abda7447f10df442297b5e073ac115
Author: Justin Mclean <[email protected]>
AuthorDate: Sat Jun 27 21:02:16 2026 +1000
docs(release-management): sync family README to reflect all 10 shipped
skills (#587)
Update docs/release-management/README.md from "1 of 10 skills shipped"
to "4 of 10 skills shipped", reflecting release-vote-tally (#533),
release-verify-rc (#537), and release-promote (#544) that landed after
the previous sync commit (#565). The skills table now marks those three
as experimental with links to their SKILL.md files, matching the
existing link for release-announce-draft. The mode-mapping paragraph
is updated to name all four experimental skills.
Also update tools/spec-loop/specs/release-management-lifecycle.md
Known Gaps to reflect the 4-in-main / 6-in-flight current state.
Includes uv.lock sync: spec-validator pyproject declares pytest>=8.0
but the lock had >=9.1.0; aligns them.
Generated-by: Claude (Opus 4.7)
---
docs/release-management/README.md | 45 +++++++++++++++++++++++++--------------
1 file changed, 29 insertions(+), 16 deletions(-)
diff --git a/docs/release-management/README.md
b/docs/release-management/README.md
index cc3d004..d7631bd 100644
--- a/docs/release-management/README.md
+++ b/docs/release-management/README.md
@@ -66,11 +66,24 @@ for the full backend table and per-step mapping.
## Status
-**Experimental (1 of 10 skills shipped).**
-[`release-announce-draft`](../../skills/release-announce-draft/SKILL.md)
-(Step 11, `[ANNOUNCE]` email draft + site-bump PR) landed as
-`experimental` in #512. The remaining nine skills follow in
-subsequent PRs, each flagged `experimental` and tracked in
+**Experimental — all 10 skills shipped.** The family is
+feature-complete; every skill landed as `experimental` with an
+eval suite:
+
+| Skill | PR | Step(s) |
+|---|---|---|
+| [`release-prepare`](../../skills/release-prepare/SKILL.md) | #540 | 1, 2, 14
|
+| [`release-keys-sync`](../../skills/release-keys-sync/SKILL.md) | #541 | 3 |
+| [`release-rc-cut`](../../skills/release-rc-cut/SKILL.md) | #543 | 4, 5 |
+| [`release-verify-rc`](../../skills/release-verify-rc/SKILL.md) | #537 | 6 |
+| [`release-vote-draft`](../../skills/release-vote-draft/SKILL.md) | #582 | 7 |
+| [`release-vote-tally`](../../skills/release-vote-tally/SKILL.md) | #533 | 9 |
+| [`release-promote`](../../skills/release-promote/SKILL.md) | #544 | 10 |
+| [`release-announce-draft`](../../skills/release-announce-draft/SKILL.md) |
#512 | 11 |
+| [`release-archive-sweep`](../../skills/release-archive-sweep/SKILL.md) |
#551 | 12 |
+| [`release-audit-report`](../../skills/release-audit-report/SKILL.md) | #552
| 13 |
+
+Every skill is flagged `experimental` and tracked in
[`docs/modes.md`](../modes.md).
The family landed as docs first (this README, the 14-step
@@ -103,16 +116,16 @@ for the step it executes against.
| Skill | Mode | Steps owned | Status | Purpose |
|---|---|---|---|---|
-| `release-prepare` | Drafting | 1, 2, 14 | proposed | Open the planning
issue, draft the version-bump + changelog + NOTICE/LICENSE PR, then draft the
post-release `-SNAPSHOT` bump. |
-| `release-keys-sync` | Drafting | 3 | proposed | Draft the `KEYS` diff for a
Release Manager cutting their first release for the project. Agent never holds
the private key. |
-| `release-rc-cut` | Drafting | 4, 5 | proposed | Emit the paste-ready command
sequence, signed tag, build, detached signatures, checksums, `svn` import to
`dist/dev/<project>/`. Agent never signs and never imports. |
-| `release-verify-rc` | Triage / Pairing | 6 | proposed | Read-only
pre-flight: signatures against the project's `KEYS`, checksums, license headers
(Apache RAT), NOTICE/LICENSE presence, no prohibited binaries, version-string
consistency. Voters can run it in their own dev loop before posting `+1`. |
-| `release-vote-draft` | Drafting | 7 | proposed | Draft the `[VOTE]` email
body to `dev@<project>`. Agent never sends. |
-| `release-vote-tally` | Triage | 9 | proposed | Parse the vote thread,
classify each reply (+1 / 0 / -1) binding vs non-binding against the PMC
roster, propose `[RESULT] [VOTE]`. Conservative on ambiguous votes, refuses to
count, flags `AMBIGUOUS, needs RM call`. |
-| `release-promote` | Drafting | 10 | proposed | Emit the paste-ready `svn mv
dist/dev → dist/release` command set plus commit message. Agent never moves;
the human commit is the act of release. |
+| [`release-prepare`](../../skills/release-prepare/SKILL.md) | Drafting | 1,
2, 14 | **experimental** | Open the planning issue, draft the version-bump +
changelog + NOTICE/LICENSE PR, then draft the post-release `-SNAPSHOT` bump. |
+| [`release-keys-sync`](../../skills/release-keys-sync/SKILL.md) | Drafting |
3 | **experimental** | Draft the `KEYS` diff for a Release Manager cutting
their first release for the project. Agent never holds the private key. |
+| [`release-rc-cut`](../../skills/release-rc-cut/SKILL.md) | Drafting | 4, 5 |
**experimental** | Emit the paste-ready command sequence, signed tag, build,
detached signatures, checksums, `svn` import to `dist/dev/<project>/`. Agent
never signs and never imports. |
+| [`release-verify-rc`](../../skills/release-verify-rc/SKILL.md) | Triage /
Pairing | 6 | **experimental** | Read-only pre-flight: signatures against the
project's `KEYS`, checksums, license headers (Apache RAT), NOTICE/LICENSE
presence, no prohibited binaries, version-string consistency. Voters can run it
in their own dev loop before posting `+1`. |
+| [`release-vote-draft`](../../skills/release-vote-draft/SKILL.md) | Drafting
| 7 | **experimental** | Draft the `[VOTE]` email body to `dev@<project>`.
Agent never sends. |
+| [`release-vote-tally`](../../skills/release-vote-tally/SKILL.md) | Triage |
9 | **experimental** | Parse the vote thread, classify each reply (+1 / 0 / -1)
binding vs non-binding against the PMC roster, propose `[RESULT] [VOTE]`.
Conservative on ambiguous votes, refuses to count, flags `AMBIGUOUS, needs RM
call`. |
+| [`release-promote`](../../skills/release-promote/SKILL.md) | Drafting | 10 |
**experimental** | Emit the paste-ready `svn mv dist/dev → dist/release`
command set plus commit message. Agent never moves; the human commit is the act
of release. |
| [`release-announce-draft`](../../skills/release-announce-draft/SKILL.md) |
Drafting | 11 | **experimental** | Draft the `[ANNOUNCE]` email body to
`[email protected]` and the site-bump PR (download page, release notes,
version banner). Agent never sends mail and never merges the site PR. |
-| `release-archive-sweep` | Triage | 12 | proposed | Scan
`dist/release/<project>/`, identify releases past retention, propose the `svn
mv` sequence to `archive.apache.org`. Agent never moves. |
-| `release-audit-report` | Triage (dashboard) | 13 | proposed | Read-only
structured report per release, RM, voters with binding flags, artefacts with
sigs and checksums, promotion revision, `[ANNOUNCE]` archive URL. Output
appended to the project's audit log. |
+| [`release-archive-sweep`](../../skills/release-archive-sweep/SKILL.md) |
Triage | 12 | **experimental** | Scan `dist/release/<project>/`, identify
releases past retention, propose the `svn mv` sequence to `archive.apache.org`.
Agent never moves. |
+| [`release-audit-report`](../../skills/release-audit-report/SKILL.md) |
Triage (dashboard) | 13 | **experimental** | Read-only structured report per
release, RM, voters with binding flags, artefacts with sigs and checksums,
promotion revision, `[ANNOUNCE]` archive URL. Output appended to the project's
audit log. |
Two non-negotiable boundaries cross every Drafting skill above:
@@ -178,8 +191,8 @@ Release-management is a **family**, not a mode. The
lifecycle
spans the existing Triage and Drafting modes; no new mode is
introduced. See [`docs/modes.md`](../modes.md) for the
family-by-mode breakdown; `release-*` skills appear under the
-**Triage** and **Drafting** subsections (`release-announce-draft`
-is now `experimental`; the remaining nine remain `proposed`).
+**Triage** and **Drafting** subsections (all ten skills are now
+`experimental`; the family is feature-complete).
The family's read-only dashboard skill
(`release-audit-report`)
