| name | mobile-app-builder |
| description | Full mobile app development pipeline. An agent team collaborates to perform UI/UX design, native/cross-platform code generation, API integration, and store deployment preparation. Use this skill for requests like 'build me a mobile app', 'app development', 'iOS app', 'Android app', 'Flutter app', 'React Native app', 'app UI design', 'app store deployment', 'app API integration', and other general mobile app development. Also supports API integration and store deployment for existing codebases. However, actual build/compilation (Xcode, Gradle), actual store submission, and CI/CD pipeline setup are outside this skill's scope. |
Mobile App Builder — Full Mobile App Development Pipeline
An agent team collaborates to generate mobile app UX design, code, API integration, and store deployment all at once.
Execution Mode
Agent Team — 5 agents communicate directly via SendMessage and cross-verify.
Agent Composition
| Agent | File | Role | Type |
|---|
| ux-designer | .claude/agents/ux-designer.md | UX/UI design, wireframes, design system | general-purpose |
| app-developer | .claude/agents/app-developer.md | Native/cross-platform app code generation | general-purpose |
| api-integrator | .claude/agents/api-integrator.md | API client, auth, caching | general-purpose |
| store-manager | .claude/agents/store-manager.md | Store metadata, ASO, review preparation | general-purpose |
| qa-engineer | .claude/agents/qa-engineer.md | Quality verification, cross-consistency checks | general-purpose |
Workflow
Phase 1: Preparation (performed directly by the orchestrator)
- Extract from user input:
- App Type: What kind of app (social, commerce, utility, game, etc.)
- Platform: iOS / Android / Cross-platform
- Framework Preference (optional): Flutter, React Native, SwiftUI, Jetpack Compose
- Backend API (optional): If an existing API spec exists
- Existing Files (optional): Design, code, API specs, etc.
- Create
_workspace/ directory at the project root
- Organize input and save to
_workspace/00_input.md
- If existing files are provided, copy them to
_workspace/ and skip the corresponding Phase
- Determine execution mode based on request scope (see "Scale-Based Modes" below)
Phase 2: Team Assembly and Execution
Assemble the team and assign tasks. Task dependencies are as follows:
| Order | Task | Owner | Dependencies | Deliverables |
|---|
| 1 | UX/UI Design | ux-designer | None | _workspace/01_ux_design.md |
| 2a | App Code Generation | app-developer | Task 1 | _workspace/02_app_code/, 02_app_architecture.md |
| 2b | Store Metadata | store-manager | Task 1 | _workspace/04_store_listing.md |
| 3 | API Integration | api-integrator | Tasks 1, 2a | _workspace/03_api_integration.md |
| 4 | QA Verification | qa-engineer | Tasks 2a, 2b, 3 | _workspace/05_qa_report.md |
Tasks 2a (app code) and 2b (store metadata) run in parallel.
Inter-team Communication Flow:
- ux-designer completes → delivers screen structure/design tokens to app-developer, screenshot scenarios to store-manager, data fields to api-integrator
- app-developer completes → delivers Repository interfaces to api-integrator, permission list to store-manager
- api-integrator completes → delivers API client code to app-developer
- qa-engineer cross-verifies all deliverables. On 🔴 required fix: requests fix from relevant agent → rework → re-verify (max 2 rounds)
Phase 3: Integration and Final Deliverables
Organize final deliverables based on the QA report:
- Verify all files in
_workspace/
- Confirm all 🔴 required fixes from the QA report have been addressed
- Report final summary to the user:
- UX Design —
01_ux_design.md
- App Architecture —
02_app_architecture.md
- App Code —
02_app_code/
- API Integration —
03_api_integration.md
- Store Deployment —
04_store_listing.md
- QA Report —
05_qa_report.md
Scale-Based Modes
| Request Pattern | Execution Mode | Deployed Agents |
|---|
| "Build me a mobile app", "full development" | Full Pipeline | All 5 |
| "Just design the app UI" | UX Mode | ux-designer + qa-engineer |
| "Generate code from this design" (existing design) | Code Mode | app-developer + api-integrator + qa-engineer |
| "Prepare app store deployment" (existing app) | Store Mode | store-manager + qa-engineer |
| "Review this app code" | Review Mode | qa-engineer alone |
Leveraging Existing Files: If the user provides design documents, code, or other existing files, skip the corresponding phases.
Data Transfer Protocol
| Strategy | Method | Purpose |
|---|
| File-based | _workspace/ directory | Store and share main deliverables |
| Message-based | SendMessage | Real-time key info delivery, fix requests |
| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |
File naming convention: {order}_{agent}_{deliverable}.{extension}
Error Handling
| Error Type | Strategy |
|---|
| Platform unspecified | UX designer defaults to cross-platform (Flutter), reflecting both platform guidelines |
| No backend API | API integrator designs mock API, structured for easy replacement with real API |
| Agent failure | Retry once → proceed without that deliverable if failed, note in QA report |
| 🔴 found in QA | Request fix from relevant agent → rework → re-verify (max 2 rounds) |
| Framework compatibility | App developer suggests alternative framework with pros/cons comparison |
Test Scenarios
Normal Flow
Prompt: "Build me a to-do management app in Flutter. I need add/delete/complete-check, category classification, and notification features."
Expected Result:
- UX Design: 5 screens (list/add/detail/category/settings), navigation structure, design system
- App Code: Flutter + Riverpod + go_router, MVVM structure, per-screen widgets/viewmodels
- API Integration: RESTful CRUD endpoints, auth, local cache
- Store: iOS + Android metadata, ASO keywords
- QA: Full cross-verification, consistency matrix
Existing File Flow
Prompt: "Generate iOS app code from this Figma design" + design file
Expected Result:
- Existing design copied to
_workspace/01_ux_design.md
- Code Mode: app-developer + api-integrator + qa-engineer deployed
- ux-designer, store-manager skipped
Error Flow
Prompt: "Build me an app quickly, anything is fine"
Expected Result:
- App type unclear → UX designer proposes 3 trending app types then proceeds
- Full pipeline mode execution
- QA report notes "assumption-based design due to absent user requirements"
Agent Extension Skills
Extension skills that enhance each agent's domain expertise:
| Skill | Target Agent | Role |
|---|
mobile-ux-patterns | ux-designer | iOS HIG/Material Design 3 comparison, navigation patterns, design tokens |
app-store-optimization | store-manager | ASO metadata optimization, keyword strategy, review rejection response |
