Mobile Agency

The complete AI dev team for mobile engineers.

17 personality-driven agents · 35 composable skills · 13 end-to-end workflows Android · iOS · Flutter · React Native · Unity · Unreal

Installation Guide · Wiki · Getting Started · Contributing

Most AI coding toolkits are generic. Mobile Agency is built specifically for mobile and game development workflows — with agents that know your platform from the inside.

Install

New to AI coding tools? Start with the step-by-step Installation Guide.

Fast path:

npx mobile-agency install

This installs Mobile Agency for Claude Code. For Cursor, Windsurf, GitHub Copilot, Codex, platform-only installs, and troubleshooting, see docs/installation.md.

Common installs:

| I use... | Run this | |---|---| | Claude Code | npx mobile-agency install | | Cursor | npx mobile-agency install --tool cursor | | Windsurf | npx mobile-agency install --tool windsurf | | GitHub Copilot | npx mobile-agency install --tool copilot | | Codex / OpenAI | npx mobile-agency install --tool codex | | All supported tools | npx mobile-agency install --tool all |

Local clone install:

git clone https://github.com/salmanashraf/mobile-agency
cd mobile-agency
./install.sh --platform android
./install.sh --platform flutter --tool cursor
./install.sh --tool all

See It In Action

/flutter-review on a real Flutter project — prioritized findings, zero setup:

https://github.com/user-attachments/assets/427422db-b6b1-4e93-96d0-ad5dd2843f53

@AXIOM reviewing Android Kotlin/Compose code — Clean Architecture, lifecycle leaks, coroutine misuse, and Compose anti-patterns:

https://github.com/user-attachments/assets/ee8bbd61-9c64-47bf-a9b3-7812cc12412c

More context: AXIOM discussion

How It Works

1. Install          npx mobile-agency install
2. Open project     Claude Code · Cursor · Windsurf · Copilot · Codex
3. Invoke           @AXIOM · @CRASHER · /flutter-review · /perf-audit
4. Get results      Platform-specific findings, ranked by severity, with fixes

Examples:

@AXIOM review HomeViewModel.kt
@CRASHER analyze crash.log
/flutter-review lib/home_screen.dart
/perf-audit startup

Start Here

Not sure where to begin? Pick your situation:

| I want to… | Use this | |---|---| | Debug a crash | @CRASHER + paste your stacktrace | | Review Android code | @AXIOM + paste your Kotlin file | | Design Compose navigation | @NAVIGATOR + list screens and flows | | Review Flutter code | /flutter-review + paste your Dart file | | Optimize a slow screen | /perf-audit + describe the screen | | Test on a device or emulator | /mobile-mcp-qa + provide app id and flow | | Build, test, and verify a feature | @MOBILE-HARNESS + approved PRD/design/tasks | | Prepare a release | /release-prep | | Generate release notes | @SCRIBE + paste your git log | | Build an app from idea to store | @APPFORGE + answer the discovery questions |

Before vs After

Android — Memory Leak

| | | |---|---| | Input | HomeViewModel holding a Context reference | | Agent | @AXIOM | | Output | CRITICAL: Context leak via ViewModel — replace with ApplicationContext or use WeakReference | | Result | Leak eliminated before PR merge |

Android — ANR

| | | |---|---| | Input | Network call on main thread in onCreate() | | Agent | @AXIOM | | Output | CRITICAL: Blocking IO on main thread — move to viewModelScope.launch(Dispatchers.IO) | | Result | ANR fixed with coroutine scope and dispatcher |

Flutter — Widget Review

| | | |---|---| | Input | HomeScreen with setState on a 400-line widget | | Agent | /flutter-review | | Output | 9 ranked findings: draft hydration in build(), ScrollController leak, missing semanticLabels, touch targets below 48dp | | Result | Findings fixed before merge, accessibility score improved |

Why Mobile Agency?

| | Generic AI prompt repos | Mobile Agency | |---|---|---| | Platform knowledge | Generic | Android · iOS · Flutter · React Native · Unity · Unreal | | Agent personalities | None | 17 named specialists with opinions | | Real workflows | No | 13 end-to-end processes | | Real examples | Toy pseudocode | Production code input/output pairs | | Installable | Copy-paste | npx mobile-agency install | | Severity levels | None | CRITICAL · WARNING · INFO | | Slash commands | No | 35 composable skills |

Agent Roster

Platform Agents

| Agent | Platform | Personality | Mission | |---|---|---|---| | AXIOM | Android | Battle-scarred architect. Zero tolerance for GlobalScope. Has survived 3 Jetpack migrations. | Reviews Kotlin/Compose for Clean Architecture, leaks, and anti-patterns | | NAVIGATOR | Android | Back-stack cartographer. Every destination has a type and every pop has a reason. | Generates and reviews type-safe Compose navigation, nested graphs, deep links, and bottom navigation | | SWIFT | iOS | Elegant, memory-safety obsessed. Will shame your retain cycles. | Reviews Swift/SwiftUI for memory safety, concurrency, and idiomatic patterns | | DART | Flutter | Pixel-perfect widget obsessive. Counts rebuilds like a miser counts coins. | Reviews Flutter for rebuild efficiency, state management, and performance | | BRIDGE | React Native | JSI evangelist. Tracks every bridge crossing like a border guard. | Finds bridge bottlenecks, re-renders, and New Architecture migration paths | | FORGE | Unity | Game systems architect. Frame budget is sacred. | Reviews C# for GC pressure, Update() abuse, and draw call inefficiency | | UNREAL | Unreal Engine | Blueprint-to-C++ enforcer. Every Tick() must earn its place. | Blueprint optimization, C++ migration, and Tick() abuse |

Cross-Platform Agents

| Agent | Personality | Mission | |---|---|---| | CRASHER | Forensic investigator. Nothing escapes. | Crash log → root cause → concrete fix, all platforms | | SENTINEL | Paranoid by design. Every input is malicious until proven otherwise. | OWASP Mobile Top 10 security audit | | APPFORGE | End-to-end product lead. Practical, launch-focused, allergic to vague MVPs. | Rough app idea → PRD → tasks → QA → Play Store launch prep | | MOBILE-HARNESS | Principal delivery lead. Trusts evidence, not vibes. | Autonomous top-level orchestrator for planning, build, memory, tests, UI verification, Mobile MCP QA, and launch | | MRECALL | The archivist. Never loses anything. | Mobile knowledge graph + context preservation across any AI tool | | LAUNCHPAD | ASO-obsessed conversion scientist. | Play Store + App Store copy, keywords, screenshot brief | | PIPELINE | Automation purist. If it's done manually twice, it's a pipeline waiting to exist. | GitHub Actions / Bitrise / Fastlane configuration | | PERF | Frame-rate zealot. Carries a stopwatch everywhere. | Profile slow screens → concrete optimization plan | | SCRIBE | User-first writer. Translates git commits into things humans understand. | Git log → polished release notes | | FIGMA | Pixel-perfect or it didn't happen. | Figma spec → Compose / SwiftUI / Flutter / RN code |

Skills Library

35 focused prompt modules — use inline or compose with agents.

Android

| Skill | What It Does | |---|---| | /anr-investigation | Evidence-first Android ANR classification, root cause, fix, and verification | | /android-tdd | Red-green-refactor loop for JUnit5 + Compose UI tests | | /compose-review | Recomposition audit before PR | | /compose-migration | XML layouts → Jetpack Compose | | /kotlin-modernize | Old Kotlin → modern idioms | | /memory-leak-investigation | LeakCanary reference-path and lifecycle ownership analysis | | /proguard-rules | R8/ProGuard rules from your dependency list |

iOS

| Skill | What It Does | |---|---| | /ios-tdd | XCTest TDD loop for Swift/SwiftUI | | /swiftui-review | View lifecycle + memory audit + unnecessary redraws | | /swift-concurrency | Completion handlers → async/await safely | | /xcode-warnings | Explains and fixes Xcode warnings in plain English |

Flutter

| Skill | What It Does | |---|---| | /flutter-tdd | Widget test + unit test + Bloc test loop | | /flutter-review | Widget tree audit, const constructors, state management | | /widget-extract | Extracts oversized build() into reusable components | | /dart-modernize | Pre-null-safety Dart → Dart 3.x patterns |

React Native

| Skill | What It Does | |---|---| | /rn-tdd | Jest + React Native Testing Library loop | | /rn-review | Bridge calls audit + re-render profiling | | /new-arch-migrate | Step-by-step New Architecture migration | | /expo-optimize | Expo config + OTA + bundle size audit |

Gaming

| Skill | What It Does | |---|---| | /unity-tdd | NUnit + Unity Test Runner (EditMode + PlayMode) | | /shader-gen | Plain English → HLSL/ShaderLab shader | | /game-perf | Frame budget audit + draw call optimizer | | /blueprint-to-cpp | Unreal Blueprint → C++ with explanation |

Cross-Platform

| Skill | What It Does | |---|---| | /grill-mobile | 20 questions before any mobile code is written | | /crash-triage | Paste stacktrace → root cause → fix | | /perf-audit | Slow screen → systematic profiling guide | | /clean-code-audit | App-wide clean code, model separation, and architecture boundary audit | | /security-audit | Complete mobile app security audit for release readiness | | /store-listing | Conversation → ASO-optimized listing copy | | /feature-slice | Epic → independently shippable tickets | | /release-prep | Full release checklist from freeze to store | | /accessibility-audit | WCAG 2.1 AA + platform accessibility review | | /api-versioning | API deprecation strategy for mobile clients | | /deeplink-debug | Diagnoses broken deep links across Android and iOS | | /mobile-mcp-qa | Run AI-assisted QA on iOS/Android devices, simulators, and emulators | | /mrecall-save | Checkpoint your session — resume on any AI tool instantly | | /mrecall-graph | Build a mobile knowledge graph from your codebase files |

Workflows

13 end-to-end processes that chain agents and skills together.

| Workflow | What It Covers | |---|---| | feature-ship | Ticket → /grill-mobile → /feature-slice → implement → review → test → PR | | crash-to-fix | Crash alert → CRASHER → fix → regression test → deploy | | app-launch | Release build → SENTINEL → PERF → LAUNCHPAD → SCRIBE → /release-prep → store | | new-screen | Figma spec → FIGMA → implement → review → performance check | | ci-setup | PIPELINE → generate config → secrets → test → document | | release-cycle | Feature freeze → CRASHER → SENTINEL → SCRIBE → /release-prep → staged rollout | | perf-sprint | Baseline → /perf-audit → fix → re-measure → document | | game-level | Design doc → FORGE/UNREAL → /shader-gen → /game-perf → /unity-tdd → playtest | | new-project-setup | /grill-mobile → architecture → CI → security baseline → test infrastructure | | mrecall-workflow | Restore context → capture decisions → save MRECALL.md → hand off across AI tools | | appforge-workflow | App idea → PRD → design plan → tasks → implementation gates → QA → Play Store | | mobile-mcp-qa | Install/launch app → inspect UI → run flows → capture screenshots → QA report | | mobile-harness | Approved task → implementation → tests → UI match → Mobile MCP QA → report |

Release Process

npm publishing is handled by GitHub Actions from git tags. Do not run npm publish manually.

# 1. bump package.json version, for example 1.0.15
git add package.json
git commit -m "Release v1.0.15"

# 2. create and push the release tag
git tag v1.0.15
git push origin main
git push origin v1.0.15

GitHub Actions publishes npm after the tag push. Full guide: docs/release-process.md

APPFORGE — Idea to Store

APPFORGE turns a rough mobile app idea into a small, shippable MVP plan and Play Store launch package.

@APPFORGE
1. Discovery        → refined ideas + best MVP recommendation
2. PRD              → PRD.md
3. Free design plan → screens, wireframes, design system, states
4. Task breakdown   → TASKS.md + DEPENDENCIES.md + ROADMAP.md
5. Implementation   → one approved subtask at a time
6. UI match review  → layout, spacing, colors, accessibility
7. Full QA          → QA_REPORT.md + launch readiness score
8. Store prep       → PLAYSTORE_LISTING.md + SCREENSHOT_PLAN.md + RELEASE_CHECKLIST.md

APPFORGE does not write code until the PRD, design plan, and task breakdown are approved. It pairs with AXIOM, SWIFT, DART, and BRIDGE for platform review, then LAUNCHPAD and /release-prep for store launch.

Mobile MCP fits the QA stage next: use it for emulator, simulator, or real-device automation once the app is ready for flow testing.

Mobile MCP — Device QA Automation

Mobile MCP gives Mobile Agency a device automation layer for iOS and Android simulators, emulators, and real devices.

/mobile-mcp-qa
1. List devices
2. Install or launch app
3. Capture screenshot + UI elements
4. Tap, type, swipe, rotate, restart
5. Verify happy path and edge cases
6. Produce MOBILE_MCP_QA_REPORT.md

Use it inside APPFORGE Stage 7 Full QA, UI match review, launch readiness checks, and screenshot validation. Full guide: docs/mobile-mcp.md

Mobile Harness — Top-Level Orchestrator

Mobile Harness is the autonomous top-level orchestrator for the whole Mobile Agency system. It can start from a rough idea or existing codebase, then coordinate APPFORGE, MRECALL, platform reviewers, tests, UI verification, Mobile MCP QA, accessibility, performance, and launch prep.

The purpose is near-zero human effort. It creates missing docs, chooses practical MVP defaults, implements one approved task at a time, verifies against PRD/design, runs device QA when available, updates project memory, and stops only for approvals, credentials, paid/destructive actions, legal/store ownership, or major product decisions.

@MOBILE-HARNESS
1. Load or create MRECALL.md
2. Run APPFORGE if PRD/design/tasks are missing
3. Select exactly one approved task
4. Implement only that task
5. Run AXIOM / SWIFT / DART / BRIDGE review
6. Run tests and PRD verification
7. Compare UI against design
8. Run /mobile-mcp-qa
9. Update MRECALL.md
10. Produce MOBILE_HARNESS_REPORT.md

Use it when you want one agent to manage the complete build, verify, remember, and ship loop with minimal hand-holding. Full guide: docs/mobile-harness.md

MRecall — Never Lose Context

When tokens run out or you switch AI tools, your entire session context — architectural decisions, agent findings, code in progress — vanishes. MRecall captures everything into a single portable MRECALL.md file.

/mrecall save     → produces MRECALL.md (full knowledge graph + session context)
/mrecall restore  → any AI tool loads it and continues instantly
/mrecall graph    → builds mobile architecture graph from your code files

Works across Claude Code, Cursor, Windsurf, ChatGPT, and Gemini. Integrates with every Mobile Agency agent — AXIOM findings, CRASHER analysis, and LAUNCHPAD copy are all preserved in the same file.

Inspired by Graphify's token reduction approach, built for mobile architecture. Up to 80× token reduction on large mobile projects vs reading raw files.

Full guide: docs/mrecall.md

The Viral File

mobile-karpathy.md — 4 rules that stop AI coding agents shipping broken mobile apps.

Add it to your project's CLAUDE.md. Share it independently. It's designed to travel.

Rule 1 — Ask the API level before assuming
Rule 2 — Check for existing platform components first
Rule 3 — Never touch what wasn't asked
Rule 4 — Performance is a feature, not an afterthought

Real Examples

Every agent ships with a real worked example — production code in, structured findings out.

| Example | Input | Output | |---|---|---| | Android review | examples/android-code-review/input.kt | output.md | | Crash triage | examples/crash-triage/input.txt | output.md | | Flutter review | examples/flutter-review/input.dart | output.md | | Store listing | examples/store-listing/input.md | output.md | | New screen workflow | examples/new-screen-workflow/figma-spec.md | output.kt | | App idea to store | agents/cross-platform/appforge/agent.md | Stage-gated discovery, PRD, design, tasks, QA, and store prep |

Multi-Tool Support

| Tool | How to Use | |---|---| | Claude Code | npx mobile-agency install | | Cursor | npx mobile-agency install --tool cursor | | Windsurf | npx mobile-agency install --tool windsurf | | GitHub Copilot | Paste agent system prompt into Copilot instructions | | Codex / OpenAI | Use agents as system prompts via API or CLI | | Local repo | git clone + ./install.sh |

Contributing

See CONTRIBUTING.md for the full guide.

• Every agent needs a personality, not just a function
• Every agent needs a real worked example using production code
• Run your agent against at least 2 real files before submitting
• Skills must have a slash command name
• Workflows must list every agent and skill used, step by step

Community

• GitHub Discussions — share your output, ask questions, show and tell
• Issues — bug reports, new agent requests

If Mobile Agency saved you time, a star helps others find it.

Built for mobile engineers who ship real apps.