1. Habit
  2. Skills
  3. Flutter Architecture skill
madteacher · 2K installs

Flutter Architecture skill
Runs by itself, PR changes lib/.

Flutter features keep clean layer boundaries.

Install the Flutter Architecture skill and make it a habit: follow https://gethabit.dev/skills/madteacher/flutter-architecture.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

2K installs110 starsMIT licenceSource on GitHub ↗

Flutter Architecture

by madteacher · 2K installs

The skill

Flutter architecture is a skill for Flutter developers who design, review or refactor app structure with MVVM, layered boundaries, feature-first or layer-first layout, repositories, services and Command and Result patterns.

Only when you ask.

The habit

Flutter features keep clean layer boundaries.

↻ Runs by itselfPR changes lib/

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

PR changes lib/. Runs in GitHub Actions or Claude Code routine.

  • ↻ PR changes lib/
  • pull_request.opened touching lib/

02

It checks its work

analyze and tests pass. If a check fails, it tells you.

  • ✓flutter analyze passes
  • ✓focused flutter test suites pass
  • ✓no feature imports another feature's implementation files

03

It remembers

layer violations log. The next run reads it first: violations found before and the chosen structure.

loops/flutter-layer-review-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after one pull request per run, with one retry.

  1. 01

    Read the project

    Inspect pubspec.yaml, lib/ and existing state, routing and DI conventions.

  2. 02

    Check imports

    Confirm new imports respect the feature-first or layer-first boundary.

  3. 03

    Check ViewModels

    Confirm ViewModels hold UI state and do no platform, file or network I/O.

  4. 04

    Check data layer

    Confirm repositories stay UI-independent and services stay stateless.

  5. 05

    Validate

    Run flutter analyze and focused flutter test suites.

  6. 06

    Report

    Log layer violations, missing tests and residual risks.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Flutter Architecture skill helps.

Use it when

  • ✓ You add a Flutter feature
  • ✓ You fix cross-feature imports
  • ✓ You pick a Flutter structure

Skip it when

  • – You build a tiny prototype
  • – You do not use Flutter

Questions

Flutter Architecture skill, answered.

Is a Domain layer required?

No. The skill adds it only for complex or reusable business logic.

Feature-first or layer-first?

Feature-first for larger apps and teams; layer-first for small apps.

How do I install the Flutter Architecture skill?

Copy the prompt at the top into your agent. It installs the skill from madteacher/mad-agents-skills and sets up the habit. Or run npx skills add madteacher/mad-agents-skills --skill flutter-architecture.

Is the Flutter Architecture skill free?

Yes. It is published under MIT. Habit is free too.

Flutter Architecture. Now as a habit.

Install the Flutter Architecture skill and make it a habit: follow https://gethabit.dev/skills/madteacher/flutter-architecture.md

  • Free
  • No account
  • Undo in one line

All madteacher skills →More code skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by madteacher, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.