Repository navigation
Description
Summary
CFX-Developer-Tools and Unity-Developer-Tools have selective git add lines in their release.yml bump-commit step that omit CLAUDE.md and ROADMAP.md. The other 5 auto-releasing tool repos use git add -A. Result: release-doc-sync correctly rewrites **Version:** in CLAUDE.md and **Current:** in ROADMAP.md, but the bump commit then leaves those edits unstaged. They are discarded when the runner is torn down. CLAUDE.md and ROADMAP.md drift from plugin.json on every release.
Surfaced during
DTD#48 CFX canary. After backfilling CFX's CLAUDE.md with **Version:** 0.8.2, merging the PR fired the release pipeline. release-doc-sync logged changed: true (CHANGELOG.md CLAUDE.md), plugin.json bumped to 0.8.3, the v0.8.3 tag was created, but CLAUDE.md **Version:** line on main is still 0.8.2.
Audit across the 7 auto-releasing tool repos
CFX-Developer-Tools git add .cursor-plugin/plugin.json README.md CHANGELOG.md <-- broken
Unity-Developer-Tools git add .cursor-plugin/plugin.json README.md CHANGELOG.md <-- broken
Docker-Developer-Tools git add -A ok
Home-Lab-Developer-Tools git add -A ok
Monday-Cursor-Plugin git add -A ok
Steam-Cursor-Plugin git add -A ok
Blender-Developer-Tools git add -A ok
Plaid-Developer-Tools (tag-triggered, no auto-bump; not affected)
Why git add -A is the correct pattern here
release-doc-sync is the canonical mechanism for keeping CLAUDE.md and ROADMAP.md in sync with the new version. It has been in use across the ecosystem since DTD#42. The git add -A pattern picks up whatever release-doc-sync rewrites without the bump step having to enumerate every doc file the action might touch. CFX and Unity slipped through a stale era where the git add line was hand-curated for plugin.json + README + CHANGELOG only.
Fix
Replace the selective git add line in CFX and Unity's .github/workflows/release.yml with git add -A. Single-line edit per repo. fix: commit prefix. PATCH version bump on each.
Out of scope
- Plaid's tag-triggered model is a separate convention and does not exhibit this bug.
- The other 5 repos already use
git add -Aand are unaffected. - DTD#48 (CONTRIBUTING.md / CLAUDE.md backfill) is independent; its PR landed cleanly. The canary's intended verification (CLAUDE.md auto-reconcile) is what surfaced this.
Estimate
10 to 15 minutes. Two trivial PRs, single-line edits, identical diff shape.
Activity
TMHSDigital commentedon Apr 26, 2026
Resolved on both affected tool repos. CFX (PR TMHSDigital/CFX-Developer-Tools#16, squash 9f14588) and Unity (PR TMHSDigital/Unity-Developer-Tools#13, squash 3602ad6) both replaced selective
git addwithgit add -Ain release.yml's bump-commit step. Verified end-to-end on Unity's DTD#48 release run (bump commit 033c769): CLAUDE.md was staged alongside plugin.json + README + CHANGELOG, and CLAUDE.md**Version:**line on main now reconciles to plugin.json version (1.4.4 = 1.4.4). Same verification holds for CFX (bump commit 223213f, version 0.8.4 reconciled). The cross-repoCloses #51keyword in the PR bodies does not auto-close, so closing manually here.