Starts shippable work from free-form input: feature intent, slash commands, comments, issue/PR links, URLs, or pasted specs. Creates a git branch, implements within scope, and adds a Changesets file so the change joins the automated release (CHANGELOG + npm + GitHub Release). Use when the user invokes /new-feature or new-feature followed by any context they provide.
The user may pass anything after new-feature / /new-feature: a one-liner, a bullet list, a command to run, #123, URLs, design notes, acceptance criteria, or “see thread X”. Treat that blob as the source of truth for scope and naming, not only a title.
Use for work that should appear in the next release (features, fixes, breaking changes). For no-release edits only (docs-only, internal refactors with zero user impact), skip a changeset or use if Changesets still complains locally.
bunx changeset --emptyIf the idea needs design exploration first, use the brainstorming skill, then return here.
Changeset frontmatter must use the npm name from package.json:
@jambulab/openwork
Branch
git fetch origin and base off current main.feat/<slug>: kebab-case ASCII from the strongest short label in the user’s input (issues: feat/issue-123-short-topic; max ~48 chars).Implement
Changeset (required before the PR is merge-ready)
bunx changeset..changeset/<slug>.md:---
"@jambulab/openwork": minor
---
<User-facing summary; imperative/neutral; reflects the input intent>
minor default for new capability; patch fix; major breaking CLI/API for consumers.Validate
bun run build when runtime code or packaging is touched.CI=true bunx changeset status exits 0.Commit
.changeset/*.md.Merging to main runs .github/workflows/release.yml (Version packages PR → merge → npm publish + GitHub Release). Do not hand-bump package.json or tag for normal releases.
- [ ] Parsed user input (commands / references / comments)
- [ ] Branch feat/<slug> from up-to-date main
- [ ] Implementation scoped to input
- [ ] .changeset/<slug>.md (correct bump + changelog line)
- [ ] CI=true bunx changeset status + build/smoke as needed