<!-- CURSOR_AGENT_PR_BODY_BEGIN -->
# why
Agent-written changesets keep coming out verbose and low quality. We
have good conventions in the existing changelog but no written guidance
for humans or AI agents to follow.
# what changed
- Created `.changeset/README.md` with guidance on writing good
changesets: one terse user-facing sentence, imperative/past tense,
specific identifiers, no internal details
- Added four real good examples from history
- Added two bad-vs-good rewrites showing common mistakes
- Included a quick-reference table for packages and bump levels
- Added a "Writing a good changeset" subsection to `CONTRIBUTING.md`
pointing to the README
- Added a one-line rule to `AGENTS.md` for AI agent contributors
# test plan
- Verified formatting with `pnpm run fmt:check`
<!-- CURSOR_AGENT_PR_BODY_END -->
<div><a
href="https://cursor.com/agents/bc-cec19de1-dfb2-55f1-b9f7-097d71f60231?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-web-light.png"><img
alt="Open in Web" width="114" height="28"
src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a> <a
href="https://cursor.com/background-agent?bcId=bc-cec19de1-dfb2-55f1-b9f7-097d71f60231&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img
alt="Open in Cursor" width="131" height="28"
src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a> </div>
<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Adds written guidelines for writing good changesets so release notes
stay terse and user-facing, for both humans and AI agents.
- Creates `.changeset/README.md` with writing rules, good examples,
bad-to-good rewrites, and a package/bump-level reference table covering
protocol patches.
- Adds a "Writing a good changeset" subsection to `CONTRIBUTING.md` and
a contributor rule to `AGENTS.md`.
<sup>Written for commit bf3befa9eac7d30d5b71933c32495bb1610dc760.
Summary will update on new commits.</sup>
<a
href="https://cubic.dev/pr/browserbase/stagehand/pull/3508?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="View guided diff"
src="https://www.cubic.dev/buttons/review-in-cubic-light.svg"></picture></a>
<a
href="https://www.cubic.dev/action/auto-fix/pr/browserbase/stagehand/3508?returnTo=https%3A%2F%2Fgithub.com%2Fbrowserbase%2Fstagehand%2Fpull%2F3508&source=description"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/turn-on-auto-fix-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/turn-on-auto-fix-light.svg"><img
alt="Turn on auto-fix"
src="https://www.cubic.dev/buttons/turn-on-auto-fix-light.svg"></picture></a>
<!-- End of auto-generated description by cubic. -->
---------
Co-authored-by: Cursor Agent <cursoragent@cursor.com>