القائمة
FVM rules for the Flutter-AdaptiveCards monorepo. Prefix every `flutter` and `dart` shell command with `fvm`. Use when vendored dart/flutter skills show bare commands, when installing or switching the pinned SDK, or before analyze, test, pub, or build_runner workflows.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Semantics contract for Adaptive Card elements — how labels, headings, live regions, and decorative-vs-meaningful images are exposed to screen readers, and how to test them with `tester.ensureSemantics()`. Use when adding or changing any element, input, or action widget, and at code review.
Optional flutter_adaptive_cards_host_fs package — backend invoke serialization, PlainJson/Teams adapters, AdaptiveCardBackendHandlers, and response effects. Use when wiring Submit/Execute/Refresh/onChange to a flow-service or reviewing associatedInputs + invoke round-trips.
Use when finalizing a change in the Flutter-AdaptiveCards monorepo — before you propose, commit, or merge — as the manual or AI-assisted review gate. Checks monorepo hygiene, Adaptive Cards spec compliance, theming, widget keys, accessibility, and testing.
Classify, audit, and enforce the Diátaxis documentation framework across the Flutter-AdaptiveCards canonical `docs/` and package READMEs. Keeps each doc in exactly one quadrant (tutorial / how-to / reference / explanation) and flags mixed-mode drift. Use when writing or reviewing a doc under `docs/`, adding a `doc_type:` front-matter tag, auditing the doc set for gaps or violations, or when the user mentions Diátaxis or documentation structure. Advisory only — it proposes splits, it does not silently move or rewrite files.
Use before adding a new Adaptive Card element type — implementing its widget, registering it, or testing it. Covers the StatefulWidget + mixin pattern, CardTypeRegistry registration, the extension API, and optional packages (charts).
Use when writing or reviewing model (de)serialization or theming in this repo, or before adding a `fromJson`/`toJson`. The library packages diverge from two things generic Flutter skills assume: they hand-write serialization (no `json_serializable` / code-gen) and style elements from HostConfig (not app-level `ThemeData`/`GoogleFonts`). Read this when a generic skill or habit points you at `@JsonSerializable`, `build_runner` for models, or `ColorScheme` app theming inside `packages/`.
| name | adaptive-cards-dart-flutter-fvm |
| description | FVM rules for the Flutter-AdaptiveCards monorepo. Prefix every `flutter` and `dart` shell command with `fvm`. Use when vendored dart/flutter skills show bare commands, when installing or switching the pinned SDK, or before analyze, test, pub, or build_runner workflows. |
This monorepo pins Flutter/Dart with fvm. Every shell
command that invokes flutter or dart must use the fvm prefix.
For which directory to run a command from, see
adaptive-cards-monorepo-workspace. For library test conventions, see
adaptive-cards-testing.
When a vendored skill, doc, or tool shows a bare command, translate it:
| Shown | Run in this repo |
|---|---|
flutter … | fvm flutter … |
dart … | fvm dart … |
dart analyze | fvm flutter analyze (repo root) |
dart fix --apply | fvm dart fix --apply (package directory) |
dart test (Flutter packages) | fvm flutter test (package directory) |
dart run build_runner build | fvm dart run build_runner build |
flutter pub get | fvm flutter pub get |
flutter pub publish | fvm flutter pub publish |
Run from the repository root:
fvm install <flutter-version> # e.g. 3.44.0 — skip if already installed
fvm use <flutter-version>
fvm flutter --version
Confirm these files agree on the version:
.fvm/fvm_config.json.fvmrc.github/workflows/test.yml → flutter-version: (see adaptive-cards-release-flutter-upgrade-sdk for the full bump checklist)Check the pin without switching:
cat .fvmrc
fvm when the pinned version matters.dart.flutterSdkPath to .fvm/versions/<version>.| Skill | Role |
|---|---|
adaptive-cards-monorepo-workspace | Layout, working directories, dependencies |
adaptive-cards-testing | flutter_adaptive_cards_fs test helpers and goldens |
adaptive-cards-release-flutter-upgrade-sdk | Pubspec, CI, changelog steps after SDK bump |