agentleFS
tarunyadav1tarunyadav1/ios-app-lifecycle/skills/ios-lifecycle/SKILL.md

ios-lifecycle

Skill1 starsChanged 36 days agoMITView on GitHub

Map an iOS app request to the right lifecycle phase and skill — idea, research, design, setup, build, debug, test, performance, monetization, release, App Store listing, post-launch. Use when the user says "help me build/ship my iOS app", "what's next for my app", "plan my app", or asks something iOS-related without naming a specific step.

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before doing anything, establish:

    line 12
  2. Very specific:

    Where it is in the lifecycle: Read CLAUDE.md / AGENTS.md / README.md in the repo, the git log (git log --oneline -20), and the marketing …

    line 15
  3. Distinctive:

    What the user wants right now: If it's unclear, propose the next phase from the table below and confirm.

    line 16
  4. Very specific:

    If the repo has no CLAUDE.md, offer to create one with ios-project-setup so later sessions start with context.

    line 18
  5. Distinctive:

    When the user is starting something new:

    line 42
  6. Distinctive:

    Write a one-paragraph product brief: who it's for, the job it does, why now.

    line 44
  7. Distinctive:

    Never touch signing certificates, App Store Connect credentials or API keys yourself.

    line 53
  8. Distinctive:

    Keep the git history clean: one logical change per commit.

    line 58
  9. Distinctive:

    Update the repo's CLAUDE.md when you learn something durable: build commands, schemes, gotchas.

    line 59

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

iOS App Lifecycle (router)

Act as the lead engineer for a solo iOS developer. Work out which phase the request belongs to, load the matching skill, and keep the app moving toward shipping.

Step 1: Orient

Before doing anything, establish:

  1. Which app. Find the Xcode project or workspace (*.xcodeproj, *.xcworkspace, Package.swift, project.yml, Tuist/). If more than one exists, ask which one.
  2. Where it is in the lifecycle. Read CLAUDE.md / AGENTS.md / README.md in the repo, the git log (git log --oneline -20), and the marketing version / build number. Check for fastlane/, .github/workflows/, and StoreKit or RevenueCat usage.
  3. What the user wants right now. If it's unclear, propose the next phase from the table below and confirm.

If the repo has no CLAUDE.md, offer to create one with ios-project-setup so later sessions start with context.

Step 2: Route

PhaseWhenSkill(s)
1. Idea & scopeNew app, feature brainstorm, MVP cutThis skill — see "Planning" below
2. Research"How do other apps do X", UI inspirationMobbin MCP (if connected), web search
3. DesignFigma file, mockups, design tokensFigma connector + figma-implement-design / Figma plugin figma-swiftui
4. Project setupNew project, targets, SPM, config, signing, CI, CLAUDE.mdios-project-setup
5. Build UIScreens, navigation, state, componentsswiftui-ui-patterns, swiftui-liquid-glass, swiftui-view-refactor
6. System integrationSiri, Shortcuts, Spotlight, widgets, controlsios-app-intents
7. Run & debugBuild/run on Simulator, inspect UI, read logsios-debugger-agent (XcodeBuildMCP)
8. TestUnit, UI, snapshot tests, CIios-testing
9. PerformanceJank, slow launch, hangs, memory growthswiftui-performance-audit, ios-ettrace-performance, ios-memgraph-leaks
10. MonetizationSubscriptions, IAP, paywallsios-monetization (RevenueCat MCP / StoreKit 2)
11. ReleaseVersioning, archive, TestFlight, App Review submissionios-release
12. Store listingName, subtitle, keywords, screenshots, privacy labelsapp-store-listing
13. Post-launchCrashes, reviews, metrics, next versionios-crash-monitoring-sentry, ios-post-launch

Load only the skills the current task needs.

Planning (phase 1)

When the user is starting something new:

  • Write a one-paragraph product brief: who it's for, the job it does, why now.
  • Cut an MVP: the smallest set of screens that delivers the core job. List them as a numbered screen inventory.
  • Pick the stack defaults (override only for a reason): SwiftUI, Swift 6 strict concurrency, Observation (@Observable), SwiftData or plain files for persistence, Swift Package Manager, Swift Testing for new tests, minimum iOS version agreed with the user.
  • List the risks: App Review guideline issues (see app-store-listing), entitlements, privacy-sensitive APIs, and anything that needs a backend.
  • Output a milestone plan: MVP → TestFlight beta → 1.0 → 1.x. Each milestone has a short checklist.

Where things run

  • Xcode, xcodebuild, Simulator, Instruments and fastlane only run on macOS. In Claude Code on the Mac (terminal or the desktop Code tab), call them directly. In Cowork, use the XcodeBuildMCP and Xcode MCP servers this plugin configures. Those run on the Mac. Cowork's own shell is a Linux VM and cannot run Xcode tools.
  • Never touch signing certificates, App Store Connect credentials or API keys yourself. Ask the user to set them up, and refer to them only through environment variables or fastlane match.

Habits across every phase

  • Build after every meaningful change. Don't stack unverified edits.
  • Keep the git history clean: one logical change per commit. Commit only when the user asks.
  • Update the repo's CLAUDE.md when you learn something durable: build commands, schemes, gotchas.
  • At the end of a session, summarize what changed and name the next phase.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.