flowr-usage

FlowR の使用方法

FlowR に関する作業を始める前に、対象パッケージを解決します。

uv run --script .agents/skills/flowr-usage/scripts/resolve.py --task auto

instructions_id ごとに、解決された手順を一度読み込みます。

同梱されている Python のエントリーポイントはすべて、uv run --script <path> で実行してください。依存関係を追加または更新する場合は、uv add --script <path> <dependency> を使用してください。同梱スクリプトを python、python3、uv run python で実行してはいけません。

ルートの選択

• auto は通常のエントリーポイントです。最も近い pubspec.yaml を読み込みます。
• flowr_dart のみに直接依存し、Flutter SDK 依存関係を持たないパッケージは、core に解決されます。Flutter または flowr の資料は読み込みません。
• flowr に直接依存し、Flutter SDK 依存関係を宣言しているパッケージは、flutter に解決されます。まずコアのルールを読み込み、その後に Flutter のルールと任意のプロジェクトプロファイルを読み込みます。
• Flutter SDK 依存関係のない flowr は無効です。対象パッケージを修正してください。黙ってコアルートに切り替えてはいけません。
• --task core と --task flutter は明示的なルートです。リゾルバーは、Dart のみのパッケージに対する flutter を拒否します。

共通ルール

• リポジトリの AGENTS.md に従い、既存のアーキテクチャを維持してください。
• 解決されたすべてのルートで、コアの手順を読み込んでください。Flutter の手順はコアのルールを置き換えるのではなく、拡張するものです。
• パブリックなパッケージのエントリーポイントのみをインポートしてください。アプリケーションコードから flowr/src/... や flowr_dart/src/... をインポートしてはいけません。
• パッケージ API の使用方法はここで扱います。ファイル構成、コンポーネントの所有関係、契約に関する判断は、呼び出し元のアーキテクチャスキルの責任です。

リファレンス

タスクに関連するリファレンスのみを読み込んでください。

• references/core.md：FlowR／FlowB、ロギング、状態、ストリーム、スケジューリング、破棄に関するルール。
• references/flutter.md：FrViewModel、FrBlocViewModel、FrProvider、FrView、リスナー、Flutter の所有関係に関するルール。
• references/flowr-dart-install.md：純粋な Dart パッケージに flowr_dart を追加します。
• references/flowr-install.md：flowr と最初の Flutter プロバイダー／ビューを追加します。
• references/flowr-logging.md、flowr-run-catching.md、flowr-slowly.md、flowr-disposal.md、flowr-update.md：名前に示されたコアの関心事を扱います。
• references/flutter-error-boundaries.md：ローカルの logE による復旧ログを維持しながら、Flutter アプリのエントリーポイントに、相互補完的な FlutterError、PlatformDispatcher、ゾーン境界を設定します。
• references/bloc-concurrency.md：非同期の FlowB または FrBlocViewModel ハンドラーについて、ハンドラーごとのイベント同時実行を評価し、設定します。イベントの重複処理による競合、作業の重複、古い結果の出力、または順序どおりの処理が問題となる可能性がある場合に読み込みます。デフォルトで bloc_concurrency を追加してはいけません。
• references/freezed-install.md：不変な Freezed 状態の生成を追加します。
• references/slang-install.md：型安全な slang 翻訳をインストールして生成します。プロジェクト規約では S. を使用します。
• references/fr-mvvm-locale-slang.md：アプリケーションのロケール管理を fr_mvvm_locale が担う形で、slang 翻訳カタログを統合します。
• references/fr-provider-di.md、fr-vm-communication.md、fr-union.md：Flutter の高度なプロバイダー、VM の連携、FrUnion の使用方法を扱います。
• references/fr-mvvm-*.md：対応する任意の Flutter 拡張機能を扱います。

検証

• 変更した Dart ファイルを、パッケージで設定されている Dart／Flutter ツールでフォーマットします。
• 対象パッケージの関連テストを実行します。
• 共有 API またはパッケージの公開範囲を変更する場合は、リポジトリのアナライザーコマンドを実行します。