| name | release |
| description | Automates the synchronized Sesori App + Bridge release workflow — bumps versions together and creates a PR |
| compatibility | opencode |
| metadata | {"audience":"maintainers","workflow":"github"} |
Release Skill
This skill automates the synchronized Sesori release process for both App and Bridge. When invoked with a release type (patch, minor, or major), it computes the next shared semantic version and bumps both app and bridge together.
Workflow
Step 1: Determine Release Type
Ask the user:
What type of release is this? Options:
- patch (e.g., 1.0.6 → 1.0.7) — bug fixes, small improvements
- minor (e.g., 1.0.6 → 1.1.0) — new features, backwards compatible
- major (e.g., 1.0.6 → 2.0.0) — breaking changes
If the user does not specify a release type, ask before proceeding.
Alternatively, the user may provide an explicit version: make bump-version VERSION=<version>.
Step 2: Find the Latest Release Tag
Run the following to find the most recent release tag:
git tag -l "v*" --sort=-v:refname | head -n 1
Step 3: Bump Versions
Run the root version bump command:
make bump-version TYPE=<type>
Or for an explicit version:
make bump-version VERSION=<version>
This updates both bridge and mobile semantic versions while preserving the mobile build number.
Stage the version-bumped files.
Step 4: Analyze Changes Since Last Release
Find commits since the last release tag:
git log <previous-tag>..HEAD --oneline
To get diffs for each side:
git diff <previous-tag>..HEAD -- bridge/
git diff <previous-tag>..HEAD -- client/
git log --oneline --name-only <previous-tag>..HEAD
Categorize commits based on their prefixes (used to summarize the PR body):
feat: or feat( → Added
fix: or fix( → Fixed
chore: → Changed (or skip unless significant)
docs: → Changed
refactor: → Changed
This repo does NOT use changelog files. Do not create or update any CHANGELOG.md. The categorized commits above are only used to write the PR body in the next step.
Step 5: Commit the version bump
Stage the version-bumped files and commit on the current release branch:
git commit -m "chore(release): v<version>"
Step 6: Create GitHub Pull Request
Use gh to create the PR:
gh pr create \
--title "chore(release): v<version>" \
--body "$(cat <<'EOF'
## Summary
- Bump shared version to v<version>
## Changes
<list the key changes since v<previous>, or "No changes">
EOF
)" \
--base main
Important Notes
- Always confirm the release type or explicit version with the user before proceeding
- The root
make bump-version command updates both bridge and mobile versions together
- The mobile build number is preserved during version bumps; do not increment it here
- If there are no changes on one side, use
- No changes in that section of the changelog
- The user must be authenticated with
gh CLI (gh auth status)
- The PR is created against
main branch
- GitHub Actions workflows are not edited by this skill