Skip to content

docs(sync): mandatory GitHub release step in sync procedure #117

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
satwareAG-ironMike merged 1 commit into from
Sep 3, 2026
Merged

docs(sync): mandatory GitHub release step in sync procedure #117

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions specs/upstream-release-sync-strategy/spec.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,7 @@ The fork MUST maintain `AGENTS.md`, `specs/metadata.json` with upstream/downstre
| Integrations functional | `specify init --help` lists agy, bob, cline, hermes, kimi as available integrations |
| Version correct | `pyproject.toml` version matches merged tag |
| No custom code lost | `git diff` shows all 5 fork agent directories intact post-merge |
| Release published | Every pushed `satware-v*` tag has a GitHub release object; `releases/latest` returns the newest fork tag |

## Sync Procedure (Reference Implementation)

Expand Down Expand Up @@ -143,8 +144,21 @@ uv run pytest tests/ -x -q

# 8. Commit and push
git push origin HEAD

# 9. Cut the fork release tag (annotated, after the sync PR merges)
git tag -a satware-vX.Y.Z+1 <merge-commit-on-main> -m "satwareAG fork release: upstream spec-kit vX.Y.Z integrated"
git push origin satware-vX.Y.Z+1

# 10. Publish the GitHub release object (NEVER skip - a tag without a
# release is invisible to `releases/latest` consumers)
gh release create satware-vX.Y.Z+1 --title "satware-vX.Y.Z+1 - upstream vX.Y.Z" \
--notes-file <release-notes.md> --latest
```

**Release step is mandatory** (#112): every pushed `satware-v*` tag MUST get a GitHub
release object in the same pass as the tag-cut. For backfills of older tags, pass
`--latest=false` so the newest release keeps the `latest` marker.

## Out of Scope

- Automated CI sync (future consideration)
Expand Down
Loading