Skip to content

Commit 223eaf9

Browse files
authored
Merge pull request #169 from aave/chore/update-publish-skill
chore: update publish skill to match actual workflow
2 parents 820cc38 + 468f454 commit 223eaf9

1 file changed

Lines changed: 9 additions & 11 deletions

File tree

.claude/skills/publish/SKILL.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,12 @@ Publishes `@aave` packages to npm using changesets.
99

1010
## Checklist
1111

12-
**You MUST use TodoWrite to create a todo for EACH step below. Mark each complete only after verification.**
12+
**You MUST use TaskCreate to create a task for EACH step below. Mark each complete only after verification.**
1313

1414
### Pre-flight
1515

1616
- [ ] Verify on `main` branch and up-to-date: `git checkout main && git pull`
1717
- [ ] Verify working directory is clean: `git status` shows no uncommitted changes
18-
- [ ] Run `nvm use` to ensure correct Node.js version
1918
- [ ] Run `corepack enable` to ensure correct pnpm version
2019
- [ ] Run `pnpm install` to update dependencies
2120
- [ ] Run `pnpm build` to build all packages
@@ -25,17 +24,16 @@ Publishes `@aave` packages to npm using changesets.
2524
- [ ] Run `pnpm changeset status` to check for pending changesets (if none exist, nothing to publish — STOP)
2625
- [ ] Run `pnpm changeset version` to bump versions
2726
- [ ] Review the version output and confirm changes look correct
28-
- [ ] Stage and commit: `git add . && git commit -m "chore: bumps up versions"`
27+
- [ ] Stage and commit changed files: `git add <changed files> && git commit -m "chore: bumps up versions"`
2928

3029
### Publish
3130

3231
- [ ] Verify npm authentication: run `npm whoami`
3332
- If it fails: ask user to run `npm login` then re-verify
34-
- [ ] Ask user for npm OTP code (from authenticator app)
35-
- [ ] Run `NPM_CONFIG_OTP=<otp> pnpm changeset publish` with the provided OTP
36-
- If OTP expires mid-publish: ask for new OTP and retry failed packages manually
37-
- If publish fails partially: check npm for which packages published, may need manual recovery
33+
- [ ] Ask user to run `pnpm changeset publish` from their interactive terminal (no OTP required)
34+
- [ ] Wait for user to confirm publish is done
3835
- [ ] Run `git push --follow-tags`
36+
- If direct push to main is rejected (branch protection): create a `chore/bump-versions` branch, push it, and open a PR
3937

4038
## Stop Conditions
4139

@@ -44,10 +42,10 @@ Publishes `@aave` packages to npm using changesets.
4442
| Not on main branch | `git checkout main && git pull` first |
4543
| Uncommitted changes | Stash or commit first |
4644
| `pnpm changeset status` shows no changesets | Nothing to publish — inform user |
47-
| `npm whoami` fails | User must run `npm login` |
45+
| `npm whoami` fails | Ask user to run `npm login` |
4846

4947
## Common Mistakes
5048

51-
1. **Skipping `nvm use`**Wrong Node version causes build failures
52-
2. **Forgetting `--follow-tags`**Git tags not pushed, npm versions unlinked from git history
53-
3. **Committing after `git push --follow-tags`**Version bump commit must be pushed before tags, not after
49+
1. **Forgetting `--follow-tags`**Git tags not pushed, npm versions unlinked from git history
50+
2. **Committing after `git push --follow-tags`**Version bump commit must be pushed before tags, not after
51+
3. **Assuming direct push to main works**Branch protection requires a PR; tags still push fine

0 commit comments

Comments
 (0)