Skip to content

stagehand-python@4.5.0a0.dev1728

@shrey150 shrey150 tagged this 20 Nov 22:26
<!-- 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>&nbsp;<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>&nbsp;</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>
Assets 2
Loading