From b5a5d21767ee198d683226fb113bee5538c29311 Mon Sep 17 00:00:00 2001 From: James Magahern Date: Sat, 11 Jul 2026 11:17:05 -0700 Subject: [PATCH] docs: document iOS release workflow --- ios/AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/ios/AGENTS.md b/ios/AGENTS.md index 16ebf3c..9ef1e75 100644 --- a/ios/AGENTS.md +++ b/ios/AGENTS.md @@ -21,6 +21,12 @@ Instructions for work under `/Users/buzzert/src/sybil-2/ios`. - To choose a screenshot path, run `just screenshot path=build/name.png`. - The underlying screenshot command is `xcrun simctl io booted screenshot ` and requires a booted simulator. +## Release Workflow +- iOS release tags use the annotated tag namespace `release/ios/vX.Y.Z`; increment from the latest existing `release/ios/v*` tag. +- Tag message convention is `ios: X.Y.Z`, for example `git tag -a release/ios/v1.13.5 -m "ios: 1.13.5"`. +- Push the release commit and tag together with `git push origin release/ios/vX.Y.Z`. +- Fastlane derives the marketing version from the release tag and stamps `ios/Apps/Sybil/project.yml` during CI, so do not manually bump `MARKETING_VERSION` for normal tagged releases unless explicitly requested. + ## App Structure - App target entry: `/Users/buzzert/src/sybil-2/ios/Apps/Sybil/Sources/SybilApp.swift` - Shared iOS app code lives in Swift package: