pb-release-aos
Release a new AOS version to npm through the release-please PR: check the commit subjects, review and gate the release PR, merge it only after GO, watch the release workflow and check version drift. U
SKILL.mdskills/playbooks/pb-release-aos/SKILL.md
GitHubRelease AOS to npm
What you get: a new AOS version on npm through the release-please PR, never a hand bump, with the PR reviewed and gated before your GO.
Inputs
- repo (optional) — the AOS checkout, default the current directory;
<owner/repo>comes fromgit -C <repo> remote get-url origin
Steps
- Preflight —
gh auth statusand bdb-ecosystem-health listed in the harness skill list or its SKILL.md under the harness skills dir (~/.claude/skills,~/.agents/skills,~/.codex/skills,~/.config/opencode/skills) → run log header — gh missing or unauthenticated → log it, give thegh auth loginhint, stop; not installed → log "health skill not installed" and skip the drift report in step 7; the npm check still runs - github — commits since the last tag (
git -C <repo> fetch --tags, thengit -C <repo> describe --tags --abbrev=0, thengit -C <repo> log <tag>..HEAD --format=%s) → subject list in the run log, every non-Conventional subject flagged (release-please cannot see it, see AGENTS.md) — stops for approval - github —
gh pr list -R <owner/repo> --state open --head release-please--branches--main --json number,title,headRefName→ the release PR number in the run log — none → stop with "no release PR" - Review and gate on that PR, using these skills:
- git-pr-review —
gh pr view <n> -R <owner/repo> --json commits→ description draft in the run log — draft only, nothing posted - pr-recap — recap file written → link it; recap not buildable → log "pr-recap skipped: <reason>" and paste
gh pr diff <n> -R <owner/repo> --name-onlyinstead; nonpxwithout approval - reviewer (agent; no subagent support → the main session reads agents/reviewer.md and runs the review inline, using only the diff and the contract, never the session's reasoning) —
gh pr diff <n> -R <owner/repo>; the contract is the commit list from step 2, never the PR body → findings table — any openblockingfinding stops the run - bdb-shipping-skill — door class of the release PR (two-way or one-way; unclear counts as one-way) → class in the run log; one-way → ADR-lite
production_artifacts/decisions/<date>-<slug>.md— class recorded - godmode-shipping —
gh pr checks <n> -R <owner/repo>all pass (pending,gh pr checksexit 8, counts as not passed), plus the local gate exactly as pb-ship step 8 gives it (scratch worktree frompull/<n>/head, lint, typecheck and test scripts that exist, a fork PR skips the local gate and is held, worktree removed without--force) → exit codes in the run log
- git-pr-review —
- [GO] github —
gh pr merge <n> -R <owner/repo> --squash— the WAITING FOR GO line names PR number, title, base branch, method and the version in.release-please-manifest.json. The run stops here until the human types GO. (Where the go-gate hook runs — Claude Code, OpenCode, agy — it coversgh pr merge; otherwise this GO is the only guard.) Nevernpm versionornpm publishby hand. - github —
<sha>= the merge commit (gh pr view <n> -R <owner/repo> --json mergeCommit -q .mergeCommit.oid);gh run list -R <owner/repo> --workflow release-please.yml --commit <sha> --limit 1 --json databaseId(wait until a run exists), thengh run watch <id> -R <owner/repo> --exit-status→ conclusion in the run log — exit 0 - npm check and drift —
npm view @hybridlabor-api/aos version→ run log — always run; equals the version in.release-please-manifest.jsonon main. bdb-ecosystem-health drift report only if step 1 found the skill - quick-recap — run log → final line
🟢|🟡|🔴with the released version — line written
Run log: production_artifacts/pb-release-aos-<date>.md in the start directory, never committed
Rules
- Anything other than the literal GO (case-insensitive) is not a GO; a GO covers only that one step, one time.
- A failed check stops the run: write the failure into the run log and report. No silent retries.
- Write one run-log line per step as it completes (
N. done|skipped|failed — artifact — check result) andWAITING FOR GO: <step>at each gate. - GO is by contract in every harness. The go-gate hook is only a backstop on Claude Code, OpenCode and agy (Codex: unverified; Cursor, Kimi: none). A missing hook is never permission to proceed.