By tjdrhs90
Automate the full lifecycle of Flutter/Flame games from concept research to store submission, including AI-assisted idea discovery, PRD creation, design token generation, gated code generation with quality checks, AdMob integration, signed builds via Fastlane, screenshot capture, and app store metadata upload.
Phase 7 — analyze the game, decide a rewarded-ad strategy, guide manual AdMob ad-unit creation, and inject google_mobile_ads + ATT/UMP consent code.
Phase 8 — bootstrap signing credentials, generate fastlane config from templates, and build + upload signed IPA (TestFlight) and AAB (internal track).
Phase 4 — propose verifiable completion criteria and mandatory hard gates; reach AGREED (1-pass default, multi-round negotiation in --strict).
Phase 3 — define the Flutter design_tokens.dart spec (palette, typography, spacing), the game's art/visual concept, and the asset/audio sourcing plan.
Phase 6 — skeptical QA. Run the game, watch it, then judge against the contract. Default = functional check; --strict adds quality and edge-case passes.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimnpx claudepluginhub tjdrhs90/flutter-flame-harness --plugin flutter-flame-harnessBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
English | 한국어

A Claude Code plugin that takes a Flutter/Flame game from raw idea all the way to the app stores. The harness orchestrates a structured pipeline of skills — research, planning, design, contract negotiation, and a generator–evaluator build loop — so every stage produces a verified, hand-off-ready artifact before the next one begins.
AI coding tools usually skip the boring parts — they code before pinning requirements, skip tests, and stop while it's half-done. This harness delegates the process, not just the code: guardrails → plan → a generator↔evaluator build loop with a skeptical QA that runs the game before judging → human review. And it isn't theory — the fixes earned shipping real Flame games (audio pooling, haptics, app-lifecycle, performance, store/build pitfalls) are baked in, so a generated game doesn't re-walk the same traps.
Phase A (complete): research → plan → design → contract → generator ↔ evaluator → playable game
The generator and evaluator negotiate completion criteria before any code is written, then build the Flutter/Flame project in three sub-phases (scaffold → API wiring → UI polish), with the evaluator gating each hand-off.
See docs/SMOKE-TEST.md for the full manual smoke-test procedure.
Phase B (complete): admob, build, screenshot, submit, retro
Automates AdMob integration, release builds (Android + iOS), App Store / Play Store screenshots, submission, and a post-launch retrospective.
See docs/SMOKE-TEST-phaseB.md for the full manual deploy dry-run procedure.
/plugin marketplace add <projects-dir>/flutter-flame-harness
/plugin install flutter-flame-harness
The plugin is copied into a cache at install time, so editing the source doesn't take effect until you re-sync. After pulling new commits (the version bumps each release):
/plugin marketplace update flutter-flame-harness # re-sync the latest version into the cache
/reload-plugins # apply it in the current session
Confirm the new version in /plugin. If a change doesn't appear, reinstall:
/plugin uninstall flutter-flame-harness@flutter-flame-harness
/plugin install flutter-flame-harness@flutter-flame-harness
(Last resort if the cache is stuck: rm -rf ~/.claude/plugins/cache, then restart Claude Code.)
/flame-harness "<idea>"
/flame-harness
Run with a quoted idea to seed the pipeline directly. Run with no idea and the AI researches the
market, recommends 2-3 game concepts, and waits for you to pick one before proceeding. Add
--auto-idea to skip that prompt: no idea + --auto-idea → AI generates, scores, and auto-picks
a concept with no prompts (fully hands-off).
Flags:
| Flag | Default | Description |
|---|---|---|
--strict | off | Run the evaluator in strict 3-phase QA mode |
--rounds N | 3 | Maximum generator–evaluator negotiation rounds |
--skip-research | off | Skip the market-research phase |
--skip-admob | off | Skip the AdMob phase |
--auto-idea | off | Research scores its generated concepts and auto-picks the best — no pick prompt |
--auto-deploy | off | Skip the post-QA human-review pause; PASS continues straight to deploy |
--resume | — | Resume a paused run |
By default, after the build passes QA the harness pauses for you to play and approve the game
(cd <slug> && flutter run) before any deploy work; /flame-harness --resume continues to
admob→build→screenshot→submit. --auto-deploy skips this gate, and --auto-idea --auto-deploy
together run fully hands-off from idea to deploy.
| Skill | Trigger command | Purpose |
|---|---|---|
flame-harness-research | /flame-harness-research | Market research and genre analysis |
flame-harness-plan | /flame-harness-plan | PRD (in your language), Flame component map, lib/ structure |
flame-harness-design | /flame-harness-design | Visual style system and component specs |
flame-harness-contract | /flame-harness-contract | Generator/evaluator negotiate completion criteria |
flame-harness-generator | /flame-harness-generator | Build the Flutter/Flame project in 3 sub-phases |
flame-harness-evaluator | /flame-harness-evaluator | QA gating — functional check or strict 3-phase |
React Native app development harness — from market research to store submission. Automates the entire mobile app lifecycle: ideation, planning, design, development, AdMob integration, EAS build, screenshots, and App Store / Google Play submission.
Use this agent when you need expert assistance with Flutter mobile development tasks, including code analysis, widget creation, debugging, performance optimization, or architectural decisions. Examples: <example>Context: User is working on a Flutter app and faces issues with navigation. user: 'My Navigator.push isn't updating the UI correctly when moving to a new screen' assistant: 'Let me use the flutter-dev agent to analyze your navigation setup and provide a solution' <commentary>Since this is a Flutter-specific navigation issue, use the flutter-dev agent to provide expert guidance on Navigator problems.</commentary></example> <example>Context: User wants to create a custom widget that aligns with their app's design system. user: 'I need to create a custom button widget that matches our app's design system' assistant: 'I'll use the flutter-dev agent to create a button widget that aligns with your existing codebase structure and design patterns' <commentary>The user needs a Flutter widget that follows existing patterns, so use the flutter-dev agent.</commentary></example>
Flutter app development with widget creation and platform channels
Flutter deployment agents for iOS App Store and Google Play Store. Includes iOS Deployment (code signing, TestFlight, App Store Connect) and Android Deployment (app signing, Play Console, release management).
Use this agent when you need expert assistance with Flutter mobile development tasks, including code analysis, widget creation, debugging, performance optimization, or architectural decisions. Examples: <example>Context: User is working on a Flutter app and faces issues with navigation. user: 'My Navigator.push isn't updating the UI correctly when moving to a new screen' assistant: 'Let me use the flutter-dev agent to analyze your navigation setup and provide a solution' <commentary>Since this is a Flutter-specific navigation issue, use the flutter-dev agent to provide expert guidance on Navigator problems.</commentary></example> <example>Context: User wants to create a custom widget that aligns with their app's design system. user: 'I need to create a custom button widget that matches our app's design system' assistant: 'I'll use the flutter-dev agent to create a button widget that aligns with your existing codebase structure and design patterns' <commentary>The user needs a Flutter widget that follows existing patterns, so use the flutter-dev agent.</commentary></example>
The game studio for the agent internet. Build, monetize, and ship browser games with one command. Phaser 2D, Three.js 3D, Play.fun monetization. Works with 40+ AI coding agents.
Process and shipping skills: game jam, fast prototyping, Steam, itch.io.