{
  "markdown": "# Flutter-Craft\n\n[English](README.md) | [한국어](README.ko.md)\n\nFlutter development skills for Claude Code - Feature-Driven Development with Clean Architecture.\n\n## Overview\n\nFlutter-Craft provides a comprehensive set of skills for Flutter development, following:\n- **Feature-Driven Development** (FDD) workflow\n- **Clean Architecture** (Domain → Data → Presentation)\n- **Priority-based Testing** (Repository → State → Widget)\n\n## Installation\n\n```bash\n# Step 1: Add marketplace\n/plugin marketplace add https://github.com/vp-k/flutter-craft.git\n\n# Step 2: Install plugin\n/plugin install flutter-craft@vp-k/flutter-craft\n```\n\n## Skills\n\n### Project Setup Skills\n\n| Skill | Description |\n|-------|-------------|\n| `flutter-project-init` | Create new Flutter project with Clean Architecture and domain patterns |\n\n### Core Workflow Skills\n\n| Skill | Description |\n|-------|-------------|\n| `start-flutter-craft` | Skill system gatekeeper (auto-injected on session start) |\n| `flutter-brainstorming` | Feature design with Clean Architecture |\n| `flutter-planning` | Implementation plan with layer-ordered tasks |\n| `flutter-executing` | Batch execution with verification checkpoints |\n| `flutter-verification` | Evidence-based completion verification |\n| `flutter-debugging` | Systematic debugging with Flutter DevTools |\n\n### Testing & Review Skills\n\n| Skill | Description |\n|-------|-------------|\n| `flutter-testing` | Priority-based test writing (Repository → State → Widget) |\n| `flutter-review-request` | Request code review with Flutter checklist |\n| `flutter-review-receive` | Process review feedback technically |\n\n### Utility Skills\n\n| Skill | Description |\n|-------|-------------|\n| `flutter-subagent-dev` | Per-task subagent with 2-stage review |\n| `flutter-parallel-agents` | Parallel execution for independent tasks |\n| `flutter-worktrees` | Isolated workspace with Flutter setup |\n| `flutter-finishing` | Completion workflow (merge/PR/keep/discard) |\n| `flutter-writing-skills` | Create new flutter-craft skills |\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/init` | Create a new Flutter project with Clean Architecture |\n| `/brainstorm` | Start feature design |\n| `/plan` | Create implementation plan |\n| `/execute` | Execute plan in batches |\n| `/test` | Write priority-based tests |\n| `/verify` | Evidence-based completion verification |\n| `/debug` | Systematic debugging |\n| `/finish` | Final verification + merge/PR/keep/discard |\n\n## Clean Architecture\n\nFlutter-Craft enforces Clean Architecture layer order:\n\n```\nlib/features/<feature>/\n├── domain/           # First: Entities, Repository interfaces, UseCases\n├── data/             # Second: Models, DataSources, Repository implementations\n└── presentation/     # Third: State Management, Widgets, Screens\n```\n\n## Test Priority\n\n1. **Priority 1:** Repository & DataSource unit tests (business logic)\n2. **Priority 2:** State Management unit tests (BLoC/Provider/Riverpod)\n3. **Priority 3:** Widget tests (optional, for complex UI)\n\n## Example Workflow\n\n```\n1. User: \"Add login feature\"\n\n2. Claude: Uses flutter-brainstorming\n   - Explores requirements\n   - Designs Clean Architecture structure\n   - Saves to docs/plans/YYYY-MM-DD-auth-design.md\n\n3. Claude: Uses flutter-planning\n   - Creates task list following layer order\n   - Saves to docs/plans/YYYY-MM-DD-auth-plan.md\n\n4. Claude: Uses flutter-executing\n   - Executes 3 tasks at a time\n   - Runs flutter analyze after each batch\n   - Reports progress\n\n5. Claude: Uses flutter-verification\n   - Runs flutter analyze, flutter test\n   - Verifies build\n\n6. Claude: Uses flutter-finishing\n   - Presents 4 options (merge/PR/keep/discard)\n   - Executes chosen option\n```\n\n## State Management Support\n\nFlutter-Craft supports multiple state management patterns:\n\n- **Riverpod + Freezed** (Recommended for new projects)\n- BLoC / Cubit\n- Provider\n\nThe chosen pattern should be consistent within a project.\n\n## Recommended Packages\n\n```bash\n# State Management (choose one)\nflutter pub add flutter_riverpod    # Recommended\nflutter pub add flutter_bloc        # Alternative\n\n# Immutable States & Code Generation\nflutter pub add freezed_annotation\nflutter pub add dev:freezed\nflutter pub add dev:build_runner\n\n# Routing\nflutter pub add go_router\n\n# Network\nflutter pub add dio\n\n# DI\nflutter pub add get_it\nflutter pub add injectable\nflutter pub add dev:injectable_generator\n\n# Riverpod Code Generation (if using Riverpod)\nflutter pub add dev:riverpod_generator\n\n# Testing\nflutter pub add dev:mocktail\nflutter pub add dev:bloc_test\n```\n\n## Directory Structure\n\n```\nflutter-craft/\n├── .claude-plugin/\n│   └── plugin.json\n├── agents/\n│   ├── flutter-code-reviewer.md\n│   └── flutter-dart-specialist.md\n├── commands/\n│   ├── init.md\n│   ├── brainstorm.md\n│   ├── plan.md\n│   ├── execute.md\n│   ├── test.md\n│   ├── verify.md\n│   ├── debug.md\n│   └── finish.md\n├── hooks/\n│   ├── hooks.json\n│   ├── run-hook.cmd\n│   └── session-start.sh\n└── skills/\n    ├── start-flutter-craft/\n    ├── flutter-project-init/\n    ├── flutter-brainstorming/\n    ├── flutter-planning/\n    ├── flutter-executing/\n    ├── flutter-verification/\n    ├── flutter-debugging/\n    ├── flutter-testing/\n    ├── flutter-review-request/\n    ├── flutter-review-receive/\n    ├── flutter-subagent-dev/\n    ├── flutter-parallel-agents/\n    ├── flutter-worktrees/\n    ├── flutter-finishing/\n    └── flutter-writing-skills/\n```\n\n## License\n\nMIT\n",
  "bytes": 5432,
  "sha": "ca442fc14c205e96315f9f50b45c4ae351211498618610e7b5e0e1f34264a32a",
  "repo_slug": "vp-k/flutter-craft",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_vp_k_flutter_craft_flutter_verification_5d53305f/readme"
}