| name | change |
| description | Create a beachball change file for the current changes. Determines change type (patch/minor) and generates a description from the diff. |
| disable-model-invocation | true |
| allowed-tools | Bash Read Grep Glob |
Create a Beachball Change File
Generate a change file for the current branch's modifications using the repo's beachball setup.
Steps
-
Determine the change type:
patch — bug fixes, internal refactors, test-only changes
minor — new features, new exports, new component variants
none — changes that don't affect the published package (stories, docs, tests only)
- Never use
major without explicit user approval
-
Generate a descriptive message following the format: fix(package-name): description or feat(package-name): description
-
Run the repo's change script to create the change file:
yarn change
This runs beachball change --no-commit (configured in root package.json).
Beachball automatically detects which packages need change files.
For non-interactive usage with a specific type and message:
yarn beachball change --no-commit --type <type> --message "<message>"
-
Verify the change file was created:
yarn check:change
Rules
- Always use
yarn change or yarn beachball change — never manually create change files
- The message should describe the user-facing impact, not the implementation detail