l-make-release
Release the three lockstep packages (@takazudo/zudo-doc-history-server, @takazudo/zudo-doc, create-zudo-doc) by following RELEASE.md's release procedure with the repository helpers in scripts/release/...
| Field | Value |
|---|---|
user-invocable | true |
disable-model-invocation | false |
argument-description | Optional: |
/l-make-release
This file is the agent entry point for both Claude Code (.) and Codex (. is a symlink to this file). The procedure itself lives in RELEASE.md → "Release procedure" — read that section in full and follow its numbered steps; do not work from memory or from an older copy of this skill. The deterministic steps are node scripts/.
Before starting
Work from a clean checkout of
mainin the repository root (not aworktrees/child — pushing from a worktree is blocked by design).Run
node scripts/and keep its capability table in the report. A missing write capability means: do the read-only steps, then hand the write steps to the owner. Never add or ask for a personal access token on your own.release/ release. mjs preflight Pick an evidence directory outside the linked package, e.g.
... / release- evidence/ <version> No npm credential is used anywhere. Do not run
npm login,npm publish, ornpm dist-tagyourself — npm writes happen only in the publish workflows via OIDC.
Autonomy
Default: autonomous through every step in RELEASE.md, including publication (step 9). --confirm: ask exactly once, immediately before step 9, showing the version, the three packages and a one-line summary of each package's note; publish only on an affirmative answer, otherwise stop with the drafts in place. No other prompts.
Step map
| RELEASE.md step | Command |
|---|---|
| 1 Preflight | node scripts/ |
| 2 Prepare | ., fill six notes, pnpm gen:changelog, B4PUSH_SKIP_PIN_PUBLISHED=1 pnpm b4push |
| 3 Release PR | branch release/<version>, commit, push, gh pr create --base main |
| 4 A2 evidence | node scripts/ |
| 5 Merge | normal merge policy |
| 6 Integration | node scripts/ |
| 7 Tags | node scripts/ |
| 8 Draft releases | node scripts/ |
| 9 Publish | node scripts/ |
| 10 Read back | node scripts/ |
Cloud sessions (Claude Code Cloud, Codex Cloud): coordinate, do not push tags
Do steps 1–6 in the session, then run steps 7–9 through the Actions release path (RELEASE.md, "Actions release path"); never run tag, releases or publish from a Cloud shell, and never push a tag from it.
node scripts/prints the inputs forrelease/ release. mjs actions- inputs - - version V - - evidence DIR .from the verified step-4/6 records.github/ workflows/ release- actions. yml Dispatch it on
main, first withstage=admit, thenstage=tag(inspect the three drafts), thenstage=publish:gh workflow run release-, or the GitHub MCP workflow-dispatch tool if the session has one.actions. yml - - repo zudolab/ zudo- doc - - ref main - f … ghbeing unauthenticated is not proof that dispatch is impossible — try the MCP tool before concluding.If neither can dispatch, hand it to a person: Actions → "Release (Actions path)" → Run workflow on
main, with the printed inputs. Report it as handed off, not done.Watch the run (
status, the run's job summaries and itsrelease-evidence-*artifacts). To resume after any failure, dispatch again with the same inputs. Never change the version, integration SHA or evidence identifiers to get past a failure: a source change goes back to fresh A2 (step 4) and integration approval (step 6).If the tag API or a dispatch is refused (401/403), report the job's actual error and the permissions/rulesets it printed, without asserting a cause. Do not retry through another route (local tag push, PAT, ruleset bypass, npm settings); hand it to the owner.
Rules that are easy to get wrong
A green A2 job with a skipped test step is a blocker, not a pass. Expect the first release run to need the build-identity rebaseline (RELEASE.md, "Rebaselining the release build identity").
Bind all three tags to the accepted main integration SHA from
integration.json, nevermain,HEADor the release branch. Never move an existing tag. "main HEAD is green" is never a substitute for the exact A2 run/attempt, artifact digest, tested tree and exact-SHA main workflow evidence.Never dispatch Production Deploy (or any deployment) to manufacture evidence.
Exit code 2 from a helper means unknown (registry/GitHub uncertainty): wait and re-run the same command; never treat it as "absent" and never republish.
An already-published version is reported as verified, not as a fresh publication.
Leave the history-server peer floor alone except at a major bump (RELEASE.md, "First-party peer floor").
Release notes: one truthful EN/JA pair per package, by user-facing package ownership (RELEASE.md, "Package-specific release notes").
Report
Headings state the verdict. Include: version, release PR, A2 run/attempt/artifact, the integration SHA, the release-actions.yml run(s) and who dispatched them (when used), the three tags and release URLs, each package's publish run, registry state and npm publisher identity from publication.json, the Production Deploy run for the integration, and anything blocked or handed to the owner.