🏗️ Flutter 構造計画スキル(Stage 2)
目的: アプリケーション全体のファイル構成を計画し、構造計画書を作成する
成果物: 構造計画書(AI/document/structure_plan.md)
⚠️ 重要制約
code
⚠️ アーキテクチャルール(厳守): ✅ AI/architecture/lib/features/features_architecture.md のクリーンアーキテクチャ構造を厳格遵守 ❌ 新しいフォルダ(ディレクトリ)の作成禁止 ✅ 定義済みフォルダ内への必要ファイル配置のみ許可
実行手順
ステップ1: プロセス開始とルール確認
- •
事前準備
- •
AI/document/structure_plan.mdのテンプレートを確認 - •メタ情報を暫定入力
- •仕様書
AI/document/application_specification.mdを確認
- •
- •
アーキテクチャルールの説明と合意
- •クリーンアーキテクチャ構造の説明
- •4層構造(Domain/Infrastructure/Application/Presentation)の説明
- •新規フォルダ作成禁止ルールの確認
- •
ステータス確認
- •コマンド:
/status check
- •コマンド:
ステップ2: 構造計画書草案の作成
- •
仕様書の分析
- •機能一覧の分析
- •必要なDartファイルの洗い出し
- •
ファイル定義表の作成
code✅ 配置パス ✅ ファイル名 ✅ 役割
- •
計画セクションへの記入
- •ディレクトリ構造
- •ルーティング計画
- •状態管理計画
- •データソース計画
- •モデル・リポジトリ計画
- •実装順序
- •
ステータス更新
- •コマンド:
/status update
- •コマンド:
ステップ3: 計画のレビューと修正
- •
レビュー観点での検証
code✅ 仕様書全機能の網羅性 ✅ ファイル分割の適切性 ✅ 役割分担の過不足チェック ✅ 計画解像度の向上
- •
修正点の反映
- •
AI/architecture/lib/features/features_architecture.mdとの整合性確認 - •計画の解像度向上
- •
ステップ4: 構造計画書完成とフェーズ完了
- •
最終確認・合意
- •ユーザーの計画書合意確認
- •最終版「構造計画書」提示
- •
フェーズ完了宣言
code「以上で第二段階の構造計画を完了します。 この計画書を基に、次の第三段階(実装フェーズ)に進みますか?」
- •
ステータス更新とログ記録
- •コマンド:
/status report - •コマンド:
/detect_changes
- •コマンド:
ディレクトリ構造テンプレート
code
lib/
core/
routing/
routing/path/
theme/
api/
exceptions/
database/
database/table/
features/
<permission>/ # admin / user / shared / direct
<feature_name>/
1_domain/
1_entities/
2_repositories/
3_usecases/
exceptions/
2_infrastructure/
1_models/
2_data_sources/
1_local/
exceptions/
2_remote/
exceptions/
3_repositories/
3_application/
1_states/
2_providers/
3_notifiers/
4_presentation/
1_widgets/
1_atoms/
2_molecules/
3_organisms/
2_pages/
参照ドキュメント
- •構造計画書テンプレート:
AI/document/structure_plan.md - •仕様書:
AI/document/application_specification.md - •アーキテクチャ:
AI/architecture/lib/features/features_architecture.md - •命名規則:
AI/architecture/directory_structure_and_naming_rules.md - •詳細手順:
AI/instructions/new_app/002/配下のファイル
制約事項
- •仕様書に記載のない機能のファイルは計画しない
- •新しいディレクトリの作成は禁止(既存構造内のみ)
- •計画変更は必ず構造計画書に反映