Repository navigation
fix(ci): changelog-gate should accept .changeset/ files as alternative to CHANGELOG.md edits #745
Description
Problem
The \changelog-gate\ CI check in \squad-ci.yml\ requires CHANGELOG.md to be modified when SDK/CLI source files change. This causes merge conflicts when multiple PRs are open simultaneously — every PR edits the same [Unreleased]\ section.
The repo already has Changesets configured (.changeset/config.json). The intended workflow is:
- PRs add a .changeset/*.md\ file (unique per PR, no conflicts)
- CHANGELOG.md is generated at release time via \changeset version`n
Solution
Update \changelog-gate\ job in .github/workflows/squad-ci.yml\ to accept EITHER:
- A .changeset/*.md\ file added/modified, OR
- CHANGELOG.md modified (backward compatible)
Also
- Update CONTRIBUTING.md to document the changeset workflow
- Remove direct CHANGELOG.md edits from existing PRs, replace with .changeset/\ files
- Add \skip-changelog\ label as documented escape hatch
Activity
fix(ci): changelog-gate accepts .changeset/ files as alternative to C…
diberry commentedon Apr 2, 2026
Additional requirement: CHANGELOG.md write protection gate — only approved authors (bradygaster, github-actions[bot]) can modify CHANGELOG.md directly. All others must use changeset files.
fix(ci): changelog-gate accepts changesets + CHANGELOG write protection
fix(ci): changelog-gate accepts changesets + CHANGELOG write protection