Branching Strategy

Branches

Branch	Purpose	Deploys
main	Stable releases	Publishes stable package to GitHub Packages
release	Release candidates	Publishes RC package with rc dist-tag
feat/*	New features	—
fix/*	Bug fixes	—
chore/*	Maintenance, tooling, docs	—

Flow

feat/my-feature ──→ main ──→ publish stable
                      │
                      └──→ release ──→ publish RC

1. Create a feature branch from main (e.g. feat/add-retry-logic)
2. Make changes, commit, push
3. Open a PR targeting main
4. After review and merge, the publish.yml workflow publishes a stable release
5. For release candidates, merge main into release to trigger rc.yml

PR conventions

• Keep PRs focused on a single concern
• Branch names should use the feat/, fix/, or chore/ prefix
• Commit messages should be descriptive of the change