{
  "markdown": "# VGV AI Flutter Plugin\n\n[![Very Good Ventures][logo_white]][very_good_ventures_link_dark]\n[![Very Good Ventures][logo_black]][very_good_ventures_link_light]\n\nA [Claude Code][claude_code_link] plugin that accelerates Flutter & Dart development with best-practices skills from [Very Good Ventures][vgv_link].\n\nDeveloped with 💙 by [Very Good Ventures][vgv_link] 🦄\n\n## Overview\n\nVGV AI Flutter Plugin is a collection of contextual best-practices skills that Claude uses when helping you write Flutter and Dart code. Each skill provides opinionated, production-quality guidance covering architecture patterns, naming conventions, folder structures, code examples, testing strategies, and anti-patterns to avoid, so you get code that follows [VGV standards][vgv_link] out of the box.\n\n## Installation\n\nOne-line install from your terminal:\n\n```bash\nclaude plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace && claude plugin install vgv-ai-flutter-plugin\n```\n\nOr inside an active Claude Code session, run these as **two separate commands** (the second only after the first completes):\n\n1. Add the marketplace:\n\n   ```text\n   /plugin marketplace add VeryGoodOpenSource/very-good-claude-code-marketplace\n   ```\n\n2. Install the plugin:\n\n   ```text\n   /plugin install vgv-ai-flutter-plugin\n   ```\n\nFor more details, see the [Very Good Claude Marketplace][marketplace_link].\n\n## Skills\n\n| Skill | Description |\n| ----- | ----------- |\n| [**Create Project**](skills/create-project/SKILL.md) | Scaffold new Dart/Flutter projects from Very Good CLI templates — `flutter_app`, `dart_package`, `flutter_plugin`, `dart_cli`, `flame_game`, and more |\n| [**Animations**](skills/animations/SKILL.md) | Flutter built-in animations — implicit vs explicit decision tree, Material 3 motion tokens (`Durations`, `Easing`), page transitions with GoRouter, Hero animations, staggered animations, and performance guidelines |\n| [**Accessibility**](skills/accessibility/SKILL.md) | WCAG 2.2 compliance with A/AA/AAA conformance level selection across iOS, Android, Web, macOS, Windows, and Linux — semantics, screen reader support, touch targets, focus management, color contrast, text scaling, and motion sensitivity |\n| [**Testing**](skills/testing/SKILL.md) | Unit, widget, and golden testing — `mocktail` mocking, `pumpApp` helpers, test structure & naming, coverage patterns, and `dart_test.yaml` configuration |\n| [**Navigation**](skills/navigation/SKILL.md) | GoRouter routing — `@TypedGoRoute` type-safe routes, deep linking, redirects, shell routes, and widget testing with `MockGoRouter` |\n| [**Internationalization**](skills/internationalization/SKILL.md) | i18n/l10n — ARB files, `context.l10n` patterns, pluralization, RTL/LTR support with directional widgets, and backend localization strategies |\n| [**Material Theming**](skills/material-theming/SKILL.md) | Material 3 theming — `ColorScheme`, `TextTheme`, component themes, spacing systems, light/dark mode support, and refactoring hardcoded or duplicated styling out of widget code |\n| [**Bloc**](skills/bloc/SKILL.md) | State management with Bloc/Cubit — sealed events & states, `BlocProvider`/`BlocBuilder` widgets, event transformers, and testing with `blocTest()` & `mocktail` |\n| [**Layered Architecture**](skills/layered-architecture/SKILL.md) | VGV layered architecture — four-layer package structure (Data, Repository, Business Logic, Presentation), dependency rules, data flow, and bootstrap wiring |\n| [**Security**](skills/static-security/SKILL.md) | Flutter-specific static security review — secrets management, `flutter_secure_storage`, certificate pinning, `Random.secure()`, `formz` validation, dependency vulnerability scanning with `osv-scanner`, and OWASP Mobile Top 10 guidance |\n| [**UI Package**](skills/ui-package/SKILL.md) | Flutter UI package creation — custom widget libraries with `ThemeExtension`-based theming, design tokens, barrel file exports, widget tests, Widgetbook catalog, and consistent API conventions |\n| [**License Compliance**](skills/license-compliance/SKILL.md) | Dependency license auditing — categorizes licenses (permissive, weak/strong copyleft, unknown), flags non-compliant or missing licenses, and produces a structured compliance report using Very Good CLI |\n| [**Dart/Flutter SDK Upgrade**](skills/dart-flutter-sdk-upgrade/SKILL.md) | Bump Dart and Flutter SDK constraints across packages — CI workflow versions, pubspec.yaml environment constraints, and PR preparation for SDK upgrades |\n| [**Very Good Analysis Upgrade**](skills/very-good-analysis-upgrade/SKILL.md) | Upgrade the `very_good_analysis` lint package across Dart/Flutter projects — version bump in `pubspec.yaml`, minimal lint fixes for new rules, and PR preparation |\n| [**Green Gate**](skills/green-gate/SKILL.md) | Autonomous verify-fix-rerun loop that drives a package to green across four quality gates — analyze, format, test, and coverage — exiting only when a final iteration proves all four pass with observed numbers (default 100% coverage, overridable). Also answers how the gates are configured — tool per gate, arguments, order, coverage target and exclusions |\n\n## Agents\n\nThis plugin ships subagents that Claude Code can dispatch as isolated, specialized reviewers. Unlike skills, agents are **not** invoked as slash commands — Claude dispatches them automatically, or you can ask Claude to run one by name (e.g. \"review my changes with the flutter-reviewer agent\").\n\n| Agent | Description |\n| ----- | ----------- |\n| [**Flutter Reviewer**](agents/flutter-reviewer.md) | Read-only reviewer of changed Dart code against the preloaded `bloc`, `testing`, `static-security`, and `accessibility` standards — emits a `location \\| problem \\| fix \\| standard` findings table. Never edits files; Bash is hook-restricted to `git diff`/`git status` |\n\n## Hooks\n\nThis plugin includes SessionStart, PreToolUse, and PostToolUse hooks that validate the Very Good CLI, guard against CLI bypass, and automatically run Dart analysis and formatting on `.dart` files.\n\n| Hook | Trigger | Behavior |\n| ---- | ------- | -------- |\n| **Warn Missing MCP** (`warn-missing-mcp.sh`) | SessionStart | Warns if the Very Good CLI is missing or older than 1.3.0; non-blocking |\n| **Check VGV CLI** (`check-vgv-cli.sh`) | PreToolUse (`mcp__.*very-good-cli__.*`) | Auto-approves Very Good CLI MCP tool calls in every run mode via a PreToolUse `allow` decision, so they never dead-end when the tool isn't on `permissions.allow` (including under `skipAutoPermissionPrompt`); denies with an install/upgrade message if the CLI is missing or < 1.3.0 |\n| **Block CLI Workarounds** (`block-cli-workarounds.sh`) | PreToolUse (`Bash`) | Blocks direct CLI bypass of Very Good CLI commands through the Bash tool; exits 2 on failure (blocking) |\n| **Allow Read-only Git** (`allow-readonly-git.sh`) | PreToolUse (`Bash`, `flutter-reviewer` agent only) | Restricts the `flutter-reviewer` agent's Bash to `git diff`/`git status`; exits 2 on anything else (blocking). Scoped via the agent's frontmatter, not `hooks.json` |\n| **Analyze** (`analyze.sh`) | PostToolUse (`Edit`/`Write`) | Runs `dart analyze` on the modified `.dart` file; exits 2 on failure (blocking — Claude must fix issues before continuing) |\n| **Format** (`format.sh`) | PostToolUse (`Edit`/`Write`) | Runs `dart format` on the modified `.dart` file; always exits 0 (non-blocking — formatting is applied silently) |\n\n### Prerequisites\n\n- **Dart SDK** — must be available on your `PATH`\n- **jq** — used to parse the hook payload; hooks are skipped gracefully if `jq` is not installed\n\n## Evals\n\nSkill evals ask whether Claude routes to a skill and follows it. [promptfoo](https://www.promptfoo.dev) sends each case's prompt through the Claude Agent SDK twice — once with this plugin loaded, once sealed with nothing loaded — so a grader that passes in both columns is measuring the model rather than the skill. They authenticate through your local Claude Code session, so they need no API key.\n\n```bash\nnpx promptfoo@latest eval -c evals/promptfooconfig.yaml\n```\n\nRun them locally before opening a PR that changes a skill. CI also runs them **after** a merge to `main`, scoped to the skills that changed, as an advisory signal rather than a gate — see [evals/README.md](evals/README.md#running-in-ci).\n\nSee [evals/README.md](evals/README.md) for the case format, the assertion reference, prerequisites, and what these evals deliberately do not cover.\n\n## Usage\n\nSkills activate automatically when Claude detects relevant context in your conversation. Simply ask Claude to help with a Flutter or Dart task, and the appropriate skill's guidance will be applied.\n\nFor example:\n\n> **You:** Create a new Bloc for user authentication with login and logout events.\n>\n> **Claude:** _(applies the Bloc skill — uses sealed classes for events and states, follows the Page/View separation pattern, generates `blocTest()` tests with `mocktail` mocks, and follows VGV naming conventions)_\n\nYou can also invoke skills directly as slash commands:\n\n```bash\n/create-project\n/animations\n/accessibility\n/bloc\n/internationalization\n/layered-architecture\n/material-theming\n/navigation\n/static-security\n/testing\n/ui-package\n/license-compliance\n/dart-flutter-sdk-upgrade\n/very-good-analysis-upgrade\n/green-gate\n```\n\n## What Each Skill Provides\n\nEvery skill includes:\n\n- **Core Standards** — recommended conventions (e.g., `mocktail` over `mockito`, sealed classes for Bloc events)\n- **Architecture patterns** — folder structures and layered architecture guidance\n- **Code examples** — ready-to-adapt snippets following best practices\n- **Testing strategies** — unit, widget, and integration testing patterns\n- **Common workflows** — step-by-step guides for tasks like \"adding a new feature\" or \"adding a new route\"\n- **Anti-patterns** — what to avoid and why\n\n## MCP Integration\n\nThis plugin includes a `.mcp.json` configuration that connects Claude Code to two MCP servers — the **Dart and Flutter MCP server** (`dart mcp-server`) and the **Very Good CLI MCP server** (`very_good mcp`). This gives Claude the ability to execute Dart, Flutter, and Very Good CLI actions directly, complementing the skills which provide architectural guidance and best practices.\n\n### Dart and Flutter MCP server (`dart`)\n\nThe Dart and Flutter MCP server ships with the Dart SDK and exposes core Dart/Flutter development actions to Claude.\n\n**Available MCP tools:**\n\n| Tool | What it does |\n| ---- | ------------ |\n| Error analysis & fixing | Analyze the project for static errors and apply fixes |\n| Symbol resolution | Resolve symbols to elements and fetch documentation and signature information |\n| App introspection | Introspect and interact with a running Dart or Flutter application |\n| Package search | Search pub.dev for packages that fit a given use case |\n| Dependency management | Add, remove, and update dependencies in `pubspec.yaml` files |\n| Package source exploration | Resolve `package:` URIs and search dependency sources |\n| Code formatting (`dart_format`) | Format code using the same formatter and config as `dart format` |\n\nThe server's `cli` feature category — `dart_format`, `dart_fix`, `create_project`,\n`run_tests`, and `list_devices` — is **off by default**, so a bare `dart mcp-server`\nadvertises 13 tools with no formatter. `.mcp.json` therefore starts it as\n`dart mcp-server --enable dart_format`. The `green-gate` skill's format gate calls that\ntool; drop the flag and the gate has nothing to call. Test execution is deliberately\nleft disabled — the `test` tool from the Very Good CLI MCP server is used instead.\n\n**Prerequisites:**\n\n- Dart SDK installed with `dart` on your PATH (the MCP server is provided by `dart mcp-server`)\n\n### Very Good CLI MCP server (`very-good-cli`)\n\nThe Very Good CLI MCP server exposes Very Good CLI commands to Claude.\n\n**Available MCP tools:**\n\n| Tool | What it does |\n| ---- | ------------ |\n| `create` | Scaffold projects from templates (`flutter_app`, `dart_cli`, `dart_package`, `flutter_package`, `flutter_plugin`, `flame_game`, `docs_site`) |\n| `test` | Run tests with coverage enforcement |\n| `packages_check_licenses` | Audit dependency licenses against an allowed list |\n| `packages_get` | Get dependencies for a single package or recursively across a monorepo |\n\n**Prerequisites:**\n\n- Very Good CLI v1.3.0+ installed: `dart pub global activate very_good_cli`\n- `very_good` must be on your PATH\n\n**How it works:**\n\nThe `.mcp.json` file at the project root registers the `dart` and `very-good-cli` MCP servers using stdio transport. When Claude Code detects this configuration, it connects to both servers and gains access to the tools above. The skills continue to provide knowledge and best practices while the MCP tools handle execution.\n\n[marketplace_link]: https://github.com/VeryGoodOpenSource/very-good-claude-code-marketplace\n[claude_code_link]: https://claude.ai/code\n[vgv_link]: https://verygood.ventures\n[very_good_ventures_link_dark]: https://verygood.ventures#gh-dark-mode-only\n[very_good_ventures_link_light]: https://verygood.ventures#gh-light-mode-only\n[logo_black]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_black.png#gh-light-mode-only\n[logo_white]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_white.png#gh-dark-mode-only\n",
  "bytes": 13376,
  "sha": "643bd4ab3af8d554e25c21b825b53312dc3d77b442dfefc38cd656b935e8bfe3",
  "repo_slug": "verygoodopensource/very_good_ai_flutter_plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_verygoodopensource_very_good_ai_flutter__9c1dce00/readme"
}