Skip to content

Commit 48b3cae

Browse files
committed
chore(skills): add a worked smoke test example to release-manager
Documents the v0.2.2 (PR #2016) smoke test run: choosing a target project pinned to the previous release for a real upgrade path, passing the full build commit SHA when the PR head has moved, the shape of a passing run, and the single-version pass criteria with the release-blocker rule on failure.
1 parent 5f9e252 commit 48b3cae

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

.claude/skills/release-manager/SKILL.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,6 +174,38 @@ If the release manager says yes:
174174

175175
The workflow triggers only on the `labeled` event, not on new pushes. To rebuild after the head moves (e.g. after a step 5 merge from `main`), remove and re-add the label (this cancels an in-flight build for the branch). A stale build whose diff to the new head is test-only is still valid for smoke testing; ask before re-triggering.
176176

177+
### Example (v0.2.2, PR #2016)
178+
179+
Changelog complete, CI green, release manager approved the smoke test. A build existed for head `06708538`; the head had since moved by a test-only merge from `main`, so that build was still valid and was not re-triggered.
180+
181+
Pick a target project pinned to the **previous release** so the run exercises the real upgrade path (here: vibe-dashboard `main`, a pnpm monorepo on `vite-plus 0.2.1`), and pass the **full commit SHA** of the published build rather than the PR number whenever the PR head has moved past it:
182+
183+
```bash
184+
.github/scripts/test-pkg-pr-new-migrate.sh \
185+
06708538195014078c8ecd4c4a4df7239ac0a309 \
186+
/path/to/vibe-dashboard --no-interactive
187+
```
188+
189+
A passing run looks like:
190+
191+
```
192+
◇ Updated . to Vite+ 0.0.0-commit.06708538...
193+
• Dependencies:
194+
vite-plus 0.2.1 → 0.0.0-commit.06708538...
195+
vite → 8.1.2
196+
✓ Dependencies installed in 5.7s
197+
198+
Migration worktree changes (.npmrc force-staged so it survives .gitignore):
199+
A .npmrc # bridge registry written by vp migrate
200+
M package.json / pnpm-workspace.yaml / pnpm-lock.yaml
201+
202+
Found 1 version of @voidzero-dev/vite-plus-core
203+
Found 1 version of vite-plus
204+
Found 1 version of vitest
205+
```
206+
207+
Pass criteria: the upgrade lands on the `0.0.0-commit.<sha>` build, the install succeeds through the bridge registry, and each of `@voidzero-dev/vite-plus-core`, `vite-plus`, and `vitest` resolves to exactly ONE version (`vitest` at the bundled upstream version). Multiple or stale versions mean the migration or install is broken: stop and treat it as a release blocker. Report the outcome to the release manager either way.
208+
177209
## 5. Release-branch CI
178210

179211
Fixes for CI failures go through a **separate PR to `main`**, never as commits on the release branch (the binding sync in step 2 is the sole exception). After the fix PR merges:

0 commit comments

Comments
 (0)