| name | changeset |
| argument-hint | ["commit message"] |
| description | Generate a Changesets entry and commit it, for Changesets-managed monorepos. Use when the user says "changeset", "add changeset", needs to record a package version bump, or finishes work that should ship in the next release. Detects modified packages from staged files, picks major/minor/patch from the diff, and leaves `changeset version` to CI. Do NOT use for single-package repos or repos without a `.changeset/` directory. |
| allowed-tools | Read, Write, Grep, Bash(git:*), Bash(test:*) |
| model | sonnet |
| effort | medium |
Generate a Changesets entry for the modified packages and commit it. CI applies changesets and publishes — never run changeset version locally.
Read ${CLAUDE_PLUGIN_ROOT}/shared/commit-basics.md first; it owns the pre-commit analysis, staged validation, Conventional Commits format, scope detection, secret scan, and error handling. Don't re-implement those rules here.
Usage
/changeset — interactive/changeset "feat: add feature" — direct/changeset "feat(scope): description" — with scope
1. Validate project
packages/ exists, .changeset/ exists, .git/ exists. Otherwise stop.
2. Pre-commit analysis
Follow commit-basics.md → Pre-commit Analysis and Validate Staged Changes.
3. Detect modified packages
node "${CLAUDE_PLUGIN_ROOT}/dist/bin/dev-workflow.js" detect-packages --json true
Returns { packages: [{ name, shortName, private, dir }, …] }. Private packages are filtered out by default (--include-private true to include them). Empty list → nothing to version, stop.
4. Pick the bump
| Bump | When |
|---|
major | breaking API change, removed/renamed exports |
minor | new exports, new optional params, new functionality |
patch | bug fix, internal refactor, docs |
Default to patch.
5. Write the changeset
node "${CLAUDE_PLUGIN_ROOT}/dist/bin/dev-workflow.js" changeset-name
Prints a collision-free path like .changeset/brave-cats-dance.md. Write:
---
"@scope/package-name": patch
---
Brief description of what changed and why.
6. Commit
If no message was provided, draft one per commit-basics.md → Conventional Commits Format + Scope Detection. Changeset-specific scope rules: single package → its short name; apps/xxx/ → xxx; 3+ packages → omit scope.
git add .changeset/*.md- Commit with the HEREDOC pattern from
commit-basics.md → Commit Execution
- Verify with
git log -1 --oneline and git status
Security and error handling: see commit-basics.md → Security and Error Handling.
