Claude CodeでREADME.mdのアーキテクチャを適用させたら素敵なアプリができた

# Flutter 基本開発方針

## アーキテクチャ
`MVVM + Repository`

参考: https://docs.flutter.dev/app-architecture/guide

## 利用パッケージ
### 状態管理
[hooks_riverpod](https://pub.dev/packages/hooks_riverpod)  
[state_notifier](https://pub.dev/packages/state_notifier)

### ルーティング
[go_router](https://pub.dev/packages/go_router)

### API通信
[dio](https://pub.dev/packages/dio) 
[retrofit](https://pub.dev/packages/retrofit)

### モデルユーティリティ
[freezed](https://pub.dev/packages/freezed)  
[json_serializable](https://pub.dev/packages/json_serializable)

### ロギング
[logger](https://pub.dev/packages/logger)

### コードスタイル
[flutter_lints](https://pub.dev/packages/flutter_lints)

### デザイン
[flutter_gen](https://pub.dev/packages/flutter_gen)

### テスト
[mocktail](https://pub.dev/packages/mocktail)
or
[mockito](https://pub.dev/packages/mockito)

### コード自動生成
[riverpod_annotation](https://pub.dev/packages/riverpod_annotation)  
[riverpod_generator](https://pub.dev/packages/riverpod_generator)  
[retrofit_generator](https://pub.dev/packages/retrofit_generator)  
[build_runner](https://pub.dev/packages/build_runner)  

参考: https://qiita.com/softbase/items/401d574a44a7b947b275

## フォルダ構成
    ├── lib
    |   ├── models
    │   ├── apis
    |   ├── repositories
    |   ├── pages
    │   ├── constants
    |   ├── views
    │   ├── providers    
    │   ├── utils
    │   ├── extensions
    ├── assets                      
    │   ├── images/

# 例：今回の最初の指示
「Dio と Retrofit を使ったFlutterサンプルアプリを作りたい。
これらのパッケージが活かせるオープンソースのAPIを提案して」

> 1. OpenWeatherMap API - 天気予報データ(https://openweathermap.org/api)
  2. NewsAPI - 世界中のニュース記事 (https://newsapi.org/)
  3. PokéAPI - ポケモンの詳細データ (https://pokeapi.co/)
  4. REST Countries - 国の情報（国旗、人口、通貨、言語など）(https://restcountries.com/)

# Pokemon App

PokéAPIを使用したFlutterサンプルアプリケーション。
MVVM + Repositoryアーキテクチャ、hooks_riverpod、freezed、retrofitなど、モダンなFlutter開発のベストプラクティスを実装しています。

## 使用技術

### 状態管理
- hooks_riverpod - 状態管理
- flutter_hooks - Hooksを使用したWidget開発
- state_notifier - ViewModelの状態管理

### ルーティング
- go_router - 宣言的ルーティング

### API通信
- dio - HTTPクライアント
- retrofit - 型安全なRESTクライアント

### モデル
- freezed - イミュータブルなモデルクラス生成
- json_serializable - JSONシリアライゼーション

### その他
- logger - ロギング
- flutter_lints - Lintルール
- mocktail - テスト用モック

## セットアップ

### 1. 依存関係のインストール

```bash
fvm flutter pub get
```

### 2. コード生成

```bash
fvm flutter pub run build_runner build --delete-conflicting-outputs
```

または、ファイル変更を監視して自動生成する場合:

```bash
fvm flutter pub run build_runner watch --delete-conflicting-outputs
```

または、シェルスクリプトで一括実行:

```bash
./generate.sh
```

### 3. アプリの起動

```bash
fvm flutter run
```

## 開発コマンド

### コード生成
```bash
# 一度だけ実行
fvm flutter pub run build_runner build --delete-conflicting-outputs

# ファイル変更を監視
fvm flutter pub run build_runner watch --delete-conflicting-outputs
```

### テスト実行
```bash
# 全テスト実行
fvm flutter test

# 特定のテストファイル実行
fvm flutter test test/repository/pokemon_repository_test.dart

# カバレッジ付き実行
fvm flutter test --coverage
```

### コード解析
```bash
fvm flutter analyze
```

### コード整形
```bash
fvm flutter format .
```

## アーキテクチャ

```
[UI層]
 View (HookConsumerWidget)
 ↓
 ViewModel (StateNotifier)
 ↓
[データ層]
 Repository
 ↓
 ApiClient (Retrofit)
 ↓
 Dio
```

## フォルダ構成

```
lib/
├── model/                  # データモデル (Freezed)
├── api/                    # APIクライアント (Retrofit)
├── repository/             # リポジトリ層
├── page/                   # 画面UI
│   ├── pokemon_list_page/
│   │   ├── pokemon_list_page.dart
│   │   └── component/
│   │       ├── pokemon_list_state.dart
│   │       └── pokemon_list_viewmodel.dart
│   └── pokemon_detail_page/
│       ├── pokemon_detail_page.dart
│       └── component/
│           ├── pokemon_detail_state.dart
│           └── pokemon_detail_viewmodel.dart
├── provider/               # Riverpod Provider
├── util/                   # ユーティリティ
└── main.dart               # エントリーポイント
```

## 機能

- ポケモン一覧表示（無限スクロール対応）
- ポケモン詳細表示
- プルダウンリフレッシュ
- エラーハンドリング
- ロギング

## 参考リンク

- [PokéAPI](https://pokeapi.co/)
- [Flutter Architecture Guide](https://docs.flutter.dev/app-architecture/guide)