Skip to content

Knowledge Loading

ACT loads Flutter/Dart knowledge from /act-flutter-development so the AI can plan, review, and write code with the right architectural guidance.

Most of the time, you do not need to think about this directly. /act-workflow-work loads the selected knowledge level automatically.

  • Official rules - Flutter team coding rules from the official rules file
  • Breaking changes - recent Dart, Flutter, and Riverpod changes so the AI avoids outdated APIs
  • Principles - architectural guidance such as YAGNI/KISS, visible errors, state derivation, safe secret handling, and resource disposal
  • Patterns - recommended Flutter and Dart implementation patterns for layout, enums, switch expressions, theming, logging, responsiveness, accessibility, and more
  • Aliases - Flutter and build runner shell aliases used by ACT guidance

The underlying skill also includes setup references for topics such as Riverpod, Sentry, flavors, env files, and constants, but those setup guides are outside the main knowledge-loading modes above.

/act-workflow-work automatically loads Flutter knowledge based on the type argument:

Terminal window
/act-workflow-work ai_specs/feature-plan.md # loads lite (default)
/act-workflow-work ai_specs/feature-plan.md full # loads full
/act-workflow-work ai_specs/feature-plan.md official # loads official rules only

Use this when you are following the standard spec -> plan -> work workflow.

Direct loading with /act-flutter-development

Section titled “Direct loading with /act-flutter-development”

Use /act-flutter-development when you want Flutter guidance outside work, for example during free-form coding, code review, or before writing a spec.

It can help with:

  • loading official rules
  • loading the lite or full knowledge sets
  • browsing a specific area such as patterns, principles, breaking changes, or setup guidance

Loading levels with /act-flutter-development

Section titled “Loading levels with /act-flutter-development”

Use one of these modes depending on how much guidance you want:

Terminal window
/act-flutter-development official
/act-flutter-development lite
/act-flutter-development full
  • official loads the official Flutter team coding guidelines only.
  • lite loads the smaller ACT Flutter knowledge set.
  • full loads the expanded ACT Flutter knowledge set for more complex work.

If the official rules file is missing, run /act-download-flutter-rules first.