Flutter Development Ecosystem - Complete Agent Architecture

This repository contains a comprehensive Flutter development ecosystem powered by 19 specialized Claude Code agents and skills, available as modular plugins.

Overview

This system provides 19 specialized agents and 1 comprehensive skill organized into 6 categories that enable seamless Flutter development from design to production deployment on iOS and Android.

Installation

This repository is structured as a Claude Code plugin marketplace. You can install everything at once or choose specific categories:

Install Everything (Recommended)

/plugin marketplace add https://github.com/cleydson/flutter-claude-code
/plugin install flutter-all@flutter-claude-code

Install Specific Categories

/plugin install flutter-ui@flutter-claude-code                    # UI & Design agents
/plugin install flutter-testing-performance@flutter-claude-code   # Testing & Performance
/plugin install flutter-architecture@flutter-claude-code          # Architecture & State Management
/plugin install flutter-platform@flutter-claude-code              # Platform Integration
/plugin install flutter-backend@flutter-claude-code               # Backend Integration
/plugin install flutter-deployment@flutter-claude-code            # iOS & Android Deployment
/plugin install flutter-patterns@flutter-claude-code              # Patterns & Best Practices Skill

See PLUGIN_INSTALLATION.md for detailed installation instructions and plugin documentation.

Quick Links

PLUGIN_INSTALLATION.md - Installation guide
AGENT_USAGE_SCENARIOS.md - Practical usage examples
CONTRIBUTING.md - Contributing guidelines and architecture reference
WORKFLOW_DIAGRAMS.md - Visual workflow diagrams

System Architecture

Category 1: Design-to-Implementation Pipeline

The core workflow for converting designs into pixel-perfect Flutter implementations.

flutter-ui-designer: Flutter UI Designer (Design Analysis & Widget Selection)
flutter-ui-implementer: Flutter UI Implementer (Code Generation & Styling)
flutter-device-orchestrator: Flutter Device Orchestrator (Simulator/Emulator Management)
flutter-ui-comparison: UI Comparison & Validation Specialist
flutter-design-iteration-coordinator: Design Iteration Coordinator (Workflow Orchestrator)

Category 2: Flutter Architecture & Code Organization

Ensures clean, maintainable, and scalable applications.

flutter-architect: Flutter Architect (Project Structure & Patterns)
flutter-state-management: Flutter State Management Specialist

Category 3: Platform-Specific Development

Handles iOS and Android native integrations.

flutter-ios-integration: iOS Integration Specialist
flutter-android-integration: Android Integration Specialist
flutter-platform-channel-architect: Platform Channel Architect

Category 4: Performance Optimization

Ensures smooth, efficient applications.

flutter-performance-analyzer: Flutter Performance Analyzer
flutter-performance-optimizer: Flutter Performance Optimizer

Category 5: API Integration & Backend Connectivity

Connects to various backend services.

flutter-rest-api: Flutter REST API Specialist
flutter-firebase: Flutter Firebase Integration Expert
flutter-aws: Flutter AWS Integration Expert
flutter-graphql: Flutter GraphQL Integration Expert

Category 6: Quality Assurance & Deployment

Ensures code quality and smooth deployments.

flutter-testing: Flutter Testing Expert
flutter-ios-deployment: Flutter Deployment Specialist (iOS)
flutter-android-deployment: Flutter Deployment Specialist (Android)

Primary Workflows

1. Design-to-Implementation (Core Workflow)

Design Input → UI Designer → UI Implementer → Device Orchestrator →
UI Comparison → Design Iteration Coordinator → Pixel-Perfect Implementation

Capabilities:

Analyze Figma designs or screenshots
Generate Flutter widget hierarchies
Implement with exact styling
Launch on iOS simulators and Android emulators
Compare implementation with original design
Iterate until pixel-perfect (>95% fidelity)

2. Complete Development Lifecycle

Design → Architecture → Implementation → Backend Integration →
Performance Optimization → Testing → Deployment