SKILL.md
$27
Verify coverage before editing: `git grep -l "\"version\": \"<OLD>\""` should list all seven. If a new manifest has been added since this doc was last updated, update this list.Workflow
- Update: Increment the version string in every path above. Do NOT touch
CHANGELOG.md— it's regenerated.
- Verify:
git grep -n "\"version\": \"<NEW>\""— confirm all seven files match.git grep -n "\"version\": \"<OLD>\""— should return zero hits.
- Build and sync:
npm run build-and-syncto regenerate artifacts, sync the local marketplace copy, restart the worker, and clear the queue. Do not use plainnpm run buildfor release validation because it can leave the local marketplace/worker out of sync.
- Commit:
git add -A && git commit -m "chore: bump version to X.Y.Z".
- Tag:
git tag -a vX.Y.Z -m "Version X.Y.Z".
- Push:
git push origin main && git push origin vX.Y.Z.
- Publish to npm (this is what makes
npx claude-mem@X.Y.Zwork):
npm publishThe prepublishOnly script re-runs the package build automatically. After publish, run npm run build-and-sync again if the publish build touched local artifacts. Confirm publish succeeded:
npm view claude-mem@X.Y.Z version # should print X.Y.ZAlternative: npm run release:patch / release:minor / release:major invokes np and handles tag+push+publish in one shot — use ONLY if you skipped steps 4–6, otherwise np will error on the existing tag.
- GitHub release:
gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES".
- Changelog: Regenerate via the project's changelog script:
npm run changelog:generate(Runs node scripts/generate-changelog.js, which pulls releases from the GitHub API and rewrites CHANGELOG.md.)
- Sync changelog: Commit and push the updated
CHANGELOG.md.
- Notify: Run the Discord notification from
~/Scripts/claude-mem/, where the.envwith Discord webhook details lives:
cd ~/Scripts/claude-mem/ && npm run discord:notify vX.Y.ZDo this even when the release worktree does not have a local .env.
- Finalize:
git status— working tree must be clean.
Checklist
- All seven config files have matching versions
git grepfor old version returns zero hits
npm run build-and-syncsucceeded
- Git tag created and pushed
- **
npm publishsucceeded andnpm view claude-mem@X.Y.Z versionconfirms it** (sonpx claude-mem@X.Y.Zresolves)
- GitHub release created with notes
CHANGELOG.mdupdated and pushed
- Discord notification run from
~/Scripts/claude-mem/
git statusshows clean tree