# evanca/flutter-ai-rules architecture

> Architecture diagram of the GitHub repository evanca/flutter-ai-rules, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/evanca/flutter-ai-rules
- Repository: https://github.com/evanca/flutter-ai-rules

## Overview

This repository is a curated library of Flutter and Dart guidance skills distributed to AI coding agents, with legacy static rules and pre-combined bundles as alternate formats. The main workflow is: a developer installs the skills, an agent matches a task to relevant skill descriptions, then reads that skill’s guidance. README statements support the distribution and loading relationships; source excerpts were not provided, so internal skill-to-skill links are omitted.

Main entry points: [`skills`](https://github.com/evanca/flutter-ai-rules/tree/main/skills) (Skill catalog), [`.claude-plugin`](https://github.com/evanca/flutter-ai-rules/tree/main/.claude-plugin) (Plugin manifests), [`skills/flutter-best-practices`](https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-best-practices) (Flutter and Dart foundations), [`skills/flutter-app-architecture`](https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-app-architecture) (App architecture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Flutter and Dart guidance"]
  node_foundations["Flutter and Dart foundations"]
  node_architecture["App architecture"]
  node_state_management["State management"]
end

subgraph group_integrations["Platform integrations"]
  node_firebase_services["Firebase services"]
  node_firebase_ai["Firebase AI"]
  node_genkit["Genkit Dart"]
end

subgraph group_quality["Quality and product guidance"]
  node_testing["Testing and review"]
  node_accessibility["Accessibility and inclusion"]
  node_shipping["Shipping guidance"]
end

subgraph group_distribution["Agent distribution"]
  node_skills_cli["Skills CLI"]
  node_skill_catalog["Skill catalog"]
  node_plugin_manifests["Plugin manifests<br/>[.claude-plugin]"]
end

subgraph group_legacy["Legacy formats"]
  node_legacy_rules["Static rules"]
  node_combined_sets["Combined sets"]
end

node_developer(("Developer"))
node_agent(("Coding agent"))

node_developer -->|"installs skills"| node_skills_cli
node_skills_cli -->|"discovers and installs"| node_skill_catalog
node_developer -->|"installs plugin"| node_plugin_manifests
node_plugin_manifests -->|"points to"| node_skill_catalog
node_agent -->|"matches and reads"| node_skill_catalog
node_agent -->|"loads guidance"| node_foundations
node_agent -->|"loads guidance"| node_architecture
node_agent -->|"loads guidance"| node_state_management
node_agent -->|"loads guidance"| node_firebase_services
node_agent -->|"loads guidance"| node_firebase_ai
node_agent -->|"loads guidance"| node_genkit
node_agent -->|"loads guidance"| node_testing
node_agent -->|"loads guidance"| node_accessibility
node_agent -->|"loads guidance"| node_shipping
node_developer -->|"uses static rules"| node_legacy_rules
node_developer -->|"uses bundles"| node_combined_sets

click node_skill_catalog "https://github.com/evanca/flutter-ai-rules/tree/main/skills"
click node_plugin_manifests "https://github.com/evanca/flutter-ai-rules/tree/main/.claude-plugin"
click node_foundations "https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-best-practices"
click node_architecture "https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-app-architecture"
click node_state_management "https://github.com/evanca/flutter-ai-rules/tree/main/skills/riverpod"
click node_firebase_services "https://github.com/evanca/flutter-ai-rules/tree/main/skills/firebase-auth"
click node_firebase_ai "https://github.com/evanca/flutter-ai-rules/tree/main/skills/firebase-ai"
click node_genkit "https://github.com/evanca/flutter-ai-rules/tree/main/skills/developing-genkit-dart"
click node_testing "https://github.com/evanca/flutter-ai-rules/tree/main/skills/testing"
click node_accessibility "https://github.com/evanca/flutter-ai-rules/tree/main/skills/accessibility"
click node_shipping "https://github.com/evanca/flutter-ai-rules/tree/main/skills/store-listing-assets"
click node_legacy_rules "https://github.com/evanca/flutter-ai-rules/tree/main/rules"
click node_combined_sets "https://github.com/evanca/flutter-ai-rules/tree/main/combined"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_foundations,node_architecture,node_state_management toneBlue
class node_firebase_services,node_firebase_ai,node_genkit toneAmber
class node_testing,node_accessibility,node_shipping toneMint
class node_skills_cli,node_skill_catalog,node_plugin_manifests toneRose
class node_legacy_rules,node_combined_sets,node_developer,node_agent toneIndigo
```

## Components

### Flutter and Dart guidance

- [Flutter and Dart foundations](https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-best-practices): `skills/flutter-best-practices`
- [App architecture](https://github.com/evanca/flutter-ai-rules/tree/main/skills/flutter-app-architecture): `skills/flutter-app-architecture`
- [State management](https://github.com/evanca/flutter-ai-rules/tree/main/skills/riverpod): `skills/riverpod`

### Platform integrations

- [Firebase services](https://github.com/evanca/flutter-ai-rules/tree/main/skills/firebase-auth): `skills/firebase-auth`
- [Firebase AI](https://github.com/evanca/flutter-ai-rules/tree/main/skills/firebase-ai): `skills/firebase-ai`
- [Genkit Dart](https://github.com/evanca/flutter-ai-rules/tree/main/skills/developing-genkit-dart): `skills/developing-genkit-dart`

### Quality and product guidance

- [Testing and review](https://github.com/evanca/flutter-ai-rules/tree/main/skills/testing): `skills/testing`
- [Accessibility and inclusion](https://github.com/evanca/flutter-ai-rules/tree/main/skills/accessibility): `skills/accessibility`
- [Shipping guidance](https://github.com/evanca/flutter-ai-rules/tree/main/skills/store-listing-assets): `skills/store-listing-assets`

### Agent distribution

- **Skills CLI**
- [Skill catalog](https://github.com/evanca/flutter-ai-rules/tree/main/skills): `skills`
- [Plugin manifests](https://github.com/evanca/flutter-ai-rules/tree/main/.claude-plugin): `.claude-plugin`

### Legacy formats

- [Static rules](https://github.com/evanca/flutter-ai-rules/tree/main/rules): `rules`
- [Combined sets](https://github.com/evanca/flutter-ai-rules/tree/main/combined): `combined`

### Other components

- **Developer**
- **Coding agent**

## Connections

- Developer → Skills CLI: installs skills (evidence: `README.md`)
- Skills CLI → Skill catalog: discovers and installs (evidence: `README.md`)
- Developer → Plugin manifests: installs plugin (evidence: `README.md`)
- Plugin manifests → Skill catalog: points to (evidence: `README.md`)
- Coding agent → Skill catalog: matches and reads (evidence: `README.md`)
- Coding agent → Flutter and Dart foundations: loads guidance (evidence: `README.md`)
- Coding agent → App architecture: loads guidance (evidence: `README.md`)
- Coding agent → State management: loads guidance (evidence: `README.md`)
- Coding agent → Firebase services: loads guidance (evidence: `README.md`)
- Coding agent → Firebase AI: loads guidance (evidence: `README.md`)
- Coding agent → Genkit Dart: loads guidance (evidence: `README.md`)
- Coding agent → Testing and review: loads guidance (evidence: `README.md`)
- Coding agent → Accessibility and inclusion: loads guidance (evidence: `README.md`)
- Coding agent → Shipping guidance: loads guidance (evidence: `README.md`)
- Developer → Static rules: uses static rules (evidence: `README.md`)
- Developer → Combined sets: uses bundles (evidence: `README.md`)
