ios-builder

# Build an Apple App Turn the user's idea into a working, tested implementation in their available coding environment. Start with the existing project when present; otherwise use a new directory. Make routine design choices and record assumptions. Ask only for missing information that materially blocks the app, such as required service credentials. When the `ios-agent` server's build-agent tools are available (`ios_preflight`, `ios_plan`, `ios_create_project`, `ios_build`, `ios_run`, `ios_screenshot`, `ios_report`; server 2.10.0 or later), use them: follow `docs/tooling/ios-build-agent.md` (in Claude Code, the `/ios-build` command). They plan, create the project, build with a bounded fix loop, screenshot each screen and write a run report. Use the steps below when those tools are not available or the user wants to work from a starter. 1. Read `docs/tooling/app-description-workflow.md` and define the user flows, screens, data, and acceptance criteria from the brief. 2. Read `docs/tooling/offline-source-library.md` and search local source first. With terminal access use `node scripts/query-library.mjs search "feature"`; read only needed sections or complete source files. Find frameworks in `docs/apple/all-technologies.md`. Load only relevant guides. Consult `docs/apple/updates-and-release-notes.md` for SDK changes and use source dates honestly. 3. With terminal access, scaffold via `npx -y ios-agent-mcp@2.9.0 new AppName --brief "the app idea" --xcodegen`. Use a validated Swift identifier for AppName and pass user text as an argument rather than interpolating it into shell syntax. Read the generated `App/APP_BRIEF.md` and implement it; the scaffolder itself does not generate the finished product from natural language. 4. Implement features using the existing app architecture. Use `templates/` and `patterns/` only where appropriate. Add real loading, empty, error and populated states; provide preview data and keep live service dependencies injectable. 5. Read `docs/design/icon-composer.md`. Create and customize separate SVG/PNG foreground layers plus a background decision. Use Icon Composer to annotate and verify the native document when available. Never claim a flattened image or renamed JSON is a native layered icon. 6. Generate the project with XcodeGen when using that scaffold, build with the actual Xcode SDK, run meaningful tests, then inspect app screens and accessible interactions. Fix failures before reporting completion. 7. Report files changed, runnable commands, test/build evidence, and anything needing credentials, hardware or user decisions. Do not publish an app or create paid service resources without the user's authorization. If the environment lacks filesystem or Xcode access, deliver the concrete plan/source artifacts it can support and explain what must run in a local coding environment. A plugin installation is not evidence that an app has been built. These bundled references are a dated snapshot; consult linked official sources for changing APIs. ## MCP tools Use `search_local_references`, `get_reference_outline`, and `read_local_reference` for local source with bounded output. Use `search_apple_technologies`, `get_apple_technology`, and `get_apple_updates` for focused retrieval instead of loading the whole catalog. `plan_ios_app` supplies the brief workflow and safe CLI arguments; `plan_app_icon` supplies the layer specification. These knowledge tools never write files or build apps. Use the local analysis tools to review the actual Swift project, then the host coding tools to implement and validate changes. For optional local Simulator control and a browser/sidebar preview, read `docs/tooling/ios-simulator-mcp.md`. Inspect installed device profiles before claiming support for a newly announced phone; current Duo guidance is in `docs/platforms/iphone-duo.md`. Runtime control requires a local Mac with Xcode.