agf-releasing-apple
agf-releasing-apple integrates with Claude Code to handle the final stages of iOS app delivery—taking merged main branch code and producing signed, release-ready Apple distributables. Built on App Genesis Forge's 19-role workflow model, it enforces quality gates and process discipline at each step, ensuring consistent, production-grade app releases without manual friction.
agf-releasing-apple takes your merged main branch code and orchestrates the complete signing and distribution pipeline. It coordinates with fastlane to invoke the appropriate lane (TestFlight, App Store, or DMG), manages code signing via match and App Store Connect API keys, and produces a release-ready distributable. The skill enforces pre-flight checks and smoke testing on real output before handoff to ensure quality gates are met.
AI-generated summary based on this skill's SKILL.md
Install
pcliangx/AppGenesisForge/agf-releasing-apple · repository language: Python
git clone https://github.com/pcliangx/AppGenesisForge
cp -r AppGenesisForge/.claude/skills/agf-releasing-apple ~/.claude/skills/agf-releasing-appleFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to build and sign Apple distributable from main?
agf-releasing-apple takes your merged main branch code and orchestrates the complete signing and distribution pipeline. It coordinates with fastlane to invoke the appropriate lane (TestFlight, App Store, or DMG), manages code signing via match and App Store Connect API keys, and produces a release-ready distributable. The skill enforces pre-flight checks and smoke testing on real output before handoff to ensure quality gates are met.
What does agf-releasing-apple do for macOS notarization?
agf-releasing-apple notarizes your macOS app and verifies it with spctl before handing off to QA or distribution. It automates the notarytool workflow, waits for Apple's notarization service to complete, and confirms the developer ID signature is valid. This ensures your DMG or direct-distribution app meets Apple's security requirements and runs without Gatekeeper warnings on end-user machines.
How does agf-releasing-apple handle fastlane lanes?
agf-releasing-apple executes fastlane lanes tailored to your release target: TestFlight for beta pilots, App Store for production submission, or DMG for macOS direct distribution. It passes build metadata, signing certificates, and App Store Connect credentials, then monitors lane execution. Once the lane completes, the skill performs smoke tests on the real output and generates a release report with gate verdict for your product lead.
What pre-flight checks does agf-releasing-apple run?
agf-releasing-apple performs pre-flight checks to validate build configuration, signing materials availability, and App Store Connect connectivity before invoking fastlane. It verifies keychain access, match repository readiness, and build number/version consistency. These gates prevent failed builds and ensure all prerequisites are in place, reducing friction and rework in the release pipeline.
How does agf-releasing-apple notify about release status?
agf-releasing-apple generates a release report documenting the build outcome, notarization status, smoke test results, and gate verdict. It then notifies your product lead with a structured handoff message, enabling quick decision-making on whether to proceed to QA or rollback. This keeps stakeholders informed and maintains transparency across the App Genesis Forge 19-role workflow model.
SKILL.md
rendered from the published skill — quoted content, verbatim
Releasing the Apple distributable (sign → notarize → package → smoke)
把合并到 main 后的干净代码构建成签名分发包，冒烟自检通过后交接 apple-qa-engineer。本 skill 是 apple-release-engineer 的分步 runbook；契约 SSOT 是 deployment.md §7，流水线决策是 ADR-009。
适用门
满足以下全部才进入构建：
- 角色 =
apple-release-engineer（deploy-only，不修业务源码；apple/fastlane/配置是可写域）。 - 目标是 Apple 原生链路（
apple/工程）。Web docker UAT → 归 deploy-engineer；小程序体验版 → 归 miniapp 轨。均不适用。 - apple code review（含 SIT Audit）已通过且已合并到 main，product-lead 已确认"构建分发包"（对话内确认或
/agf-apple-release手动触发），且 PRD 已声明渠道。
任一不满足 → 不构建，SendMessage
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.claude/skills/agf-releasing-apple/SKILL.md