Skip to content

Teach agents to author changeset files directly (SF-15)#303

Closed
alexgrozav wants to merge 1 commit into
mainfrom
agent/mise/fdd37449
Closed

Teach agents to author changeset files directly (SF-15)#303
alexgrozav wants to merge 1 commit into
mainfrom
agent/mise/fdd37449

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

Summary

Agents knew changesets were required (definition of done, review nudges) but the only authoring instruction pointed at pnpm ci:changeset — the interactive changeset prompt, which headless agents cannot drive. So the step was routinely skipped and only caught at review.

This adds a positive, actionable authoring path to the skills every implementing seat carries.

Changes

  • styleframe-verification skill — new "Authoring a changeset" section: when one is needed (publishable engine/*, theme, tooling/* with the exact npm names), the ignore list that needs none, and a step-by-step for writing the .changeset/<area>-<topic>.md file directly — filename convention, frontmatter package+bump lines, bump selection (patch/minor/major, with major gated on Alex's sign-off), body voice, single- and multi-package examples, and pnpm changeset status as the check. Also surfaced in the skill description for discovery.
  • styleframe-team-protocol skill — repointed the Changesets bullet away from the interactive pnpm ci:changeset to "write the file directly," cross-referencing the verification skill.

No product code, tests, or docs touched — skills only.

Note

Multica reads skills at import time, not from git — these lessons go live only after the affected skills are re-imported post-merge.

Closes SF-15.

The changeset policy existed only as a review-time nudge and pointed at
`pnpm ci:changeset`, the interactive prompt headless agents cannot drive.
Add a concrete "Authoring a changeset" how-to (when, publishable vs
ignore list, file format, bump selection, examples) to the near-universal
styleframe-verification skill, and repoint the team-protocol changeset
bullet away from the interactive command. SF-15.
@changeset-bot

changeset-bot Bot commented Jul 12, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 01445ce

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel

vercel Bot commented Jul 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
storybook-styleframe-dev Ready Ready Preview, Comment Jul 12, 2026 3:39pm
styleframe-dev Building Building Preview, Comment Jul 12, 2026 3:39pm

Request Review

@codecov

codecov Bot commented Jul 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant