flutter-executing

Flutter 実装計画の実行

概要

計画を読み込み、批判的にレビューし、タスクをバッチ単位で実行して Flutter の検証を行い、バッチ間でレビュー用に報告します。

基本原則： レビュー用のチェックポイントを設けてバッチ単位で実行します。

開始時に宣言： 「flutter-executing スキルを使って、この計画を実装します。」

手順

ステップ 1：計画の読み込みとレビュー

1. 計画ファイルを読む

   cat docs/plans/YYYY-MM-DD-<feature>-plan.md
   

2. 最初に依存関係を確認する

   cat pubspec.yaml
   

3. 必要に応じて新しい依存関係をインストールする

   flutter pub get
   

4. 批判的にレビューする：

   • ファイルパスは正しいですか？
   • レイヤーの順序（Domain → Data → Presentation）に従っていますか？
   • 計画に抜け漏れはありませんか？

5. 懸念がある場合： 作業を始める前に伝える

6. 懸念がない場合： todo エントリー（タスク追跡ツール）を作成して続行する

ステップ 2：バッチを実行する

デフォルト：最初の 3 タスク

各タスクについて：

1. タスク追跡ツールでステータスを in_progress にする
2. 指定どおりにファイルを作成／変更する
3. コードをすべて記述する（計画に基づく）
4. 検証を実行する：

   flutter analyze lib/features/<feature>/
   

5. コミットする：

   git add <files>
   git commit -m "<conventional commit message>"
   

6. タスク追跡ツールでステータスを completed にする

ステップ 3：バッチを検証する

3 タスクが完了したら、全体の検証を実行します：

# Static analysis
flutter analyze
# Expected: No issues found!

# Run tests (if test files exist)
flutter test test/features/<feature>/
# Expected: All tests passed!

# Quick build check (optional — full build runs once in flutter-finishing)
flutter build <target> --debug   # apk / ios / web / windows … per project platform
# Expected: Built successfully

ステップ 4：報告する

バッチが完了したら、次の内容を報告します：

## Batch N Complete

**Tasks completed:**
1. ✅ Task 1: [description]
2. ✅ Task 2: [description]
3. ✅ Task 3: [description]

**Verification:**
- flutter analyze: No issues found
- flutter test: X/X passed

**Files created/modified:**
- lib/features/.../entity.dart
- lib/features/.../repository.dart
- ...

**Ready for feedback.**

ステップ 5：続行する

フィードバックに基づいて：

• 必要に応じて変更を適用する
• 次の 3 タスクのバッチを実行する
• すべてのタスクが完了するまで繰り返す

ステップ 6：開発を完了する

すべてのタスクが完了し、検証も済んだら：

1. 最終検証を実行する：

   flutter analyze
   flutter test
   flutter build <target> --debug  # per project platform (apk/ios/web/…)
   

2. 宣言する： 「flutter-finishing スキルを使って、この作業を完了します。」

3. 必須のサブスキル： flutter-craft:flutter-finishing を使用する

   • テストを検証する
   • 4 つの選択肢（マージ／PR／維持／破棄）を提示する
   • 選択された内容を実行する
   • 該当する場合はワークツリーをクリーンアップする

Flutter 固有の検証コマンド

段階	コマンド	期待される出力
ファイルごと	flutter analyze lib/path/file.dart	問題は見つかりませんでした
バッチごと	flutter analyze lib/features/<feature>/	問題は見つかりませんでした
テスト	flutter test test/features/<feature>/	すべてのテストに合格しました
最終	flutter build <target> --debug	ビルドに成功しました

停止して助けを求めるタイミング

次の場合は、ただちに実行を停止します：

• flutter analyze で（警告だけでなく）エラーが表示された
• 原因が不明な状態でテストが失敗した
• pubspec.yaml にない依存関係が不足している
• 計画の指示が不明確である
• 計画内のファイルパスがプロジェクト構造と一致しない
• 状態管理のパターンが不明確である

推測するのではなく、確認を求めてください。

レイヤー順序の検証

実行前に、計画が次の順序に従っていることを確認してください：

1. Domain Layer tasks first
   ├── Entities
   ├── Repository interfaces
   └── UseCases

2. Data Layer tasks second
   ├── Models
   ├── DataSources
   └── Repository implementations

3. Presentation Layer tasks third
   ├── State Management
   ├── Widgets
   └── Screens

4. Test tasks after implementation
   ├── Repository tests (priority 1)
   ├── State tests (priority 2)
   ├── Widget tests (priority 3, optional)
   └── Golden tests (priority 4, optional, visual regression)

計画がこの順序に従っていない場合は、作業を始める前に懸念を伝えてください。

必須のサブスキル

実行中

各バッチの後、続行する前に必ず次を呼び出してください： → flutter-craft:flutter-verification（続行前に検証）

すべてのタスク完了後

完了時の選択肢を提示するため、必ず次を呼び出してください： → flutter-craft:flutter-finishing（完了時の選択肢を提示）

注意事項

• まず計画を批判的にレビューする - 盲目的に実行しない
• レイヤーの順序に従う - Domain → Data → Presentation
• バッチごとに flutter analyze を実行する - 早い段階でエラーを見つける
• 各タスクの後にコミットする - アトミックなコミットにする
• 報告して返答を待つ - フィードバックなしに続行しない
• 行き詰まったら停止する - 推測せず、質問する