❌ 禁止: エラーが困難だからと言って、簡易的な処理で完了とする
❌ 禁止: 複雑な処理をスキップして「TODO: 後で実装」で済ませる
❌ 禁止: 仕様を満たさない部分的な実装で完了とする

✅ 必須: 困難な場合はユーザーに相談し、代替案を提示する
✅ 必須: 完全な実装が不可能な場合は理由と制限を明示する

❌ 禁止: 本番コードをモックで置き換えて完了とする
❌ 禁止: テストコード以外でモックデータを返す実装
❌ 禁止: API未実装を理由にハードコード値で代替

✅ 必須: 実際の実装を行う
✅ 必須: 外部依存がある場合は正しい待機処理を実装

❌ 禁止: 理解できないコードを「不要」と判断して削除する
❌ 禁止: 既存機能を無断で削除・変更する
❌ 禁止: エラー解消のために機能を減らす

✅ 必須: 削除前にユーザーに確認する
✅ 必須: 削除理由を明確に説明する
✅ 必須: 削除した場合は必ず報告する

❌ 禁止: コンパイルエラーを放置する
❌ 禁止: 「とりあえず動く」状態で完了とする
❌ 禁止: 警告を無視する（特にdeprecated警告）

✅ 必須: 全エラーを解消してから完了とする
✅ 必須: 警告も可能な限り解消する

❌ 禁止: 同じアプローチを3回以上繰り返す
❌ 禁止: ユーザーの要望に忖度して不可能なことを繰り返し試す
❌ 禁止: 根本原因を調べずに試行錯誤を続ける

✅ 必須: 2回失敗したらアプローチを変える
✅ 必須: 不可能と判断したら正直に報告する
✅ 必須: 制限や前提条件を確認する

// ✅ 正しい: Dart
class UserRepository {
  Future<User> getUser(String id) async {
    final response = await dio.get('/users/$id');
    return User.fromJson(response.data);
  }
}

// ❌ 間違い: Kotlin（Flutterプロジェクトなのに）
class UserRepository {
    suspend fun getUser(id: String): User {
        return api.getUser(id)
    }
}

// ❌ 古い: Provider（Riverpod前）
ChangeNotifierProvider(create: (_) => MyModel())

// ✅ 現在: Riverpod 3.0
@riverpod
class MyNotifier extends _$MyNotifier {
  @override
  State build() => State();
}

// ❌ ハルシネーション例: 存在しないメソッド
final user = await FirebaseAuth.instance.getUser(); // 存在しない

// ✅ 正しいAPI
final user = FirebaseAuth.instance.currentUser;

/// [AuthRepository] 認証関連のデータ操作を担当
/// 
/// 依存: [Dio], [FlutterSecureStorage]
/// 使用: [AuthNotifier]
class AuthRepository {
  // ...
}

// ✅ 完全なエラーハンドリング
Future<void> login(String email, String password) async {
  state = const AsyncValue.loading();
  state = await AsyncValue.guard(() async {
    try {
      return await repository.login(email, password);
    } on DioException catch (e) {
      if (e.type == DioExceptionType.connectionTimeout) {
        throw AppException('接続がタイムアウトしました');
      }
      throw AppException('ネットワークエラー: ${e.message}');
    } on AuthException catch (e) {
      throw AppException('認証エラー: ${e.message}');
    }
  });
}

class _MyWidgetState extends State<MyWidget> {
  final _controller = TextEditingController();
  late final AnimationController _animController;
  StreamSubscription? _subscription;

  @override
  void initState() {
    super.initState();
    _animController = AnimationController(vsync: this);
    _subscription = stream.listen(_onData);
  }

  @override
  void dispose() {
    _controller.dispose();       // 必須
    _animController.dispose();   // 必須
    _subscription?.cancel();     // 必須
    super.dispose();
  }
}

推奨構造:
lib/features/auth/
├── presentation/
│   ├── screens/
│   │   ├── login_screen.dart      # 50-100行
│   │   └── register_screen.dart   # 50-100行
│   └── widgets/
│       ├── login_form.dart        # 50-80行
│       └── password_field.dart    # 30-50行