release
Installation
SKILL.md
Release context-mode v2 (ADR-0013). Starting the skill is the approval for this release; the preview in step 6 is for information, not a second approval. Stop and report at the first step that fails; do not retry a failed step with a different method.
- Check the start state. Run
git branch --show-currentandgit status --porcelain. The branch must bev2and the tree must be clean; if not, stop and report what is dirty. Rungh auth statusandgit pull --ff-only. - Run the E2E cases:
node e2e/cases/run.mjs. If a row isFAIL, stop and report the failing case ids. - Run the v1 KEEP-PASS unit tests (GS4).
npm ciinstalls the dev toolchain only (ADR-0013 "Trust boundary"); users never run npm. Then runnpx vitest run. If one of the 131 tracked tests fails, stop and show its name. - Run the live test:
node e2e/live/run.mjs --all(Sonnet 5, effort low, ADR-0017) and show its table. If a row isFAIL, stop. Then update the live-skip streak ine2e/live/skip-streak.json({ "streak": <n> }): if the table has one or moreSKIPPEDrows, add 1 tostreak; if it has none, reset it to 0. If the file changed, commit it onv2and push. Ifstreakis nowLIVE_SKIP_LIMIT(3) or more, refuse to continue: report which cases were skipped and the note on each row. - v1 migration checkpoint (GS10). The cases
e2e/live/cases/v1-migration-*.jsonran in step 4 (theircoverspaths includev1-transition, so--allselects them). Do not run them again; confirm each one isPASSin the step 4 table, and stop if one is not. - Preview. Run
node scripts/release/plan.mjs --dry-run. Show the owner the next version and the release notes. If it says there is nothing to release, stop. - Start the release:
gh workflow run release.yml --ref v2 -f sha=$(git rev-parse HEAD). - Follow the new run with
gh run watchand report each job status as it changes. At the end, report in one short table: version, release commit onrelease, GitHub Release URL, live test (passed, or skipped), and the smoke-install result per agent.
skip-live: if the owner types /release skip-live, skip steps 4 and 5 (the streak file does not change) and in step 6 run node scripts/release/plan.mjs --dry-run --skip-live, so the release notes carry the line "Live E2E skipped for this release." Say in the final report that the live test was skipped.
This skill never runs these one-time steps: switching the marketplace to ref: "release", adding workflows to main, and npm deprecate. Ask the owner about each one separately.