---

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

1. 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

2. Generate a descriptive message following the format: fix(package-name): description or feat(package-name): description

3. 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>"
   

4. 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