fr-goal
1つのオペレータタッチポイントで、ゴールからレビュー済みPRまでを実現します: ブレインストーミング → 一括Q&A → 仕様 → レビュー → fr-plan → レビュー → TDD実装 → レビュー → 単一PR。各レビューでは見つかった問題をすべて修正します。オペレータの自律化指示により、各承認停止はレビュー&修正パスに置き換えられます。ブロックされた場合: 停止し、何がブロックされているか、何を試したかを伝え、質問をします — 間違った推測をPRで出荷する方が、実行を一時停止するよりコストがかかります。
開始時に宣言: 「このゴールをfr-goalを使用して自律実行しています。」
対話が必要な箇所
| タイミング | 理由 |
|---|---|
| 一括Q&A (1回、ブレインストーミング時) | 設計判断はオペレータが所有 — 未回答=停止、デフォルトは不可 |
| マルチプロジェクトリポジトリの場所 | アクセス質問 — ファイルシステムが回答できない場合のみ |
| 手動フェーズ | シークレット、UI操作、デプロイは人間のみ — 配置ポリシー参照 |
| PRマージ | エージェントは自己マージしない |
| マージ後テスト計画 | 実際のデプロイを証明; オペレータの環境が必要 |
1. 一括Q&Aによるブレインストーミング — 分離環境で
fr-brainstorming を呼び出します(fr isolation up を先に実行; devcontainerプロファイルがない場合 → 一時停止してfr-initインタビューを実施)。分離はすべてに優先します — 調査、測定、クラスタ操作も含む; オペレータが「Xから開始」と指示した場合、最初のアクションではなく最初の作業項目が変更されます。調査し、オペレータが所有する判断をすべて収集し、すべてを1回のAskUserQuestion呼び出しで質問します(最大4質問、最初の推奨)。デリバラブルがデプロイされる場合(サービス/ボット/インフラ)にのみ、マージ後テスト計画の質問を含めます。純粋なコードの場合は含めません。遅れて出た質問もバッチ処理します。ハードゲート: 未回答の呼び出しは停止信号です — ターンを終了し、未回答の質問を再度述べて待機します。実際の回答をデフォルト値で代用してはいけません。
2. 仕様 — その後レビュー
docs/superpowers/specs/<YYYY-MM-DD-slug>-design.md を作成し、Q&Aの回答およびコードベースの現実に対してレビューします(記述されたファイル/ヘルパー/サービスが実際に存在するか?)。すべての指摘を修正します。テスト計画が選択された場合、仕様にはマージ後のステップを示す ## Test Plan セクションが含まれます。
3. マルチプロジェクトチェック
クロスリポジトリ仕様(owner/repo:path 形式)の場合、このセッションは1つのリポジトリの計画とPRを担当します。他の各リポジトリについては: 作業コピーを自分で探します(兄弟ディレクトリ、通常のルート)。見つからない場合のみパス/クローンを質問し、Q&Aにバッチ処理します。仕様リファレンスとステップ4からのパイプラインを使用して、リポジトリごとに1つのエージェントをディスパッチします(isolation: "worktree")。計画1つ、PR1つをリポジトリごとに作成します。
4. 計画 — fr-plan、その後レビュー
fr-plan を呼び出し、セクションごとの承認をスキップします(仕様が設計をエンコードしています)。v2計画をフォルダとして保持し、TDD形式のステップにします。レビュー: fr plan self-review がパスし、フェーズが仕様に対して読み返され(すべてカバーされていること)、修正、実装します。
5. 手動フェーズ — デフォルトでバックロード
fr-planのエージェント純粋性ゲートは、手動作業を専用の [manual] フェーズに収集します。fr-goalは配置ポリシーを追加します(計画途中の手動フェーズは実行を停止します):
- デフォルトでバックロード: すべての手動作業を最後のフェーズに配置し、それに依存するエージェントフェーズは置きません。PRは意図的に未実装の状態で出荷され、オペレータ用にマークされ、オペレータが同じPRに実装してプッシュします(
fr plan edit --complete-phase N --note)。 - エージェント作業が本当にそれに依存する場合のみフロントロードします。 計画 + レビューを完了し、仕様 + 計画のPRを開き(手動の指示自体がデリバラブル)、一時停止; オペレータのGo指示があるまで再開しません。
- マルチリポジトリ: クロスリポジトリの依存関係をモデル化 —
depends_onは計画内でのみ有効なので、順序は仕様とPRシーケンスに依存します(あるリポジトリのシークレットが別のリポジトリのフェーズをゲートする可能性があります)。
6. 実装 — fr-executeローカルモード、TDD、サブエージェントなし
ステップ1の分離ワークスペースが作業コピーです — すべてのコマンドは fr isolation exec 経由で実行します。fr-execute をLOCALモードで実行します(計画ディレクトリ + フェーズ)、ディスパッチはしません(仕様/計画がmainになく、fr apply --yes が拒否します)。サブエージェントではなくインラインで実装します(コンテキストとしてQ&A + 仕様の履歴が必要です)。ステップごとにTDD; ステップをチェック/ fr plan edit でフェーズを完了します。手動フェーズは決して実行しません。
実装レイヤーはブランチをプッシュするのみ — PRは開きません(インライン、または委任されたマルチリポジトリビルダーによる)。ここでPRを開くと、レビュー(7)の前にデリバ(8)が順序を入れ替え、オペレータが修正前にマージできるようになり、修正がマージ済みブランチに孤立してしまいます(#320、3回)。オーケストレーターは可視性のために ドラフト PRを開きます — ステップ8まではマージ不可、「Draft」バッジは「まだマージしないで」を意味します。
7. マイルストーンでのレビュー — 見つかったすべてを修正
各マイルストーン(完了したフェーズ、または小規模計画の場合は実装全体)の後、仕様 + 計画 + コードに対して superpowers:requesting-code-review を呼び出します。すべての指摘を即座に修正し、テストを追加します。事実上誤った指摘は反論理由を付けて返答します(superpowers:receiving-code-review)、黙って無視してはいけません。発見リストを保持します。
8. デリバリ — リポジトリごとに1PR、すべての成果物を含む
最初に検証します(superpowers:verification-before-completion): 完全なテストスイート出力、自己レビューパス、ステップがチェック済みであること。PRは今(ステップ7の修正後)のみマージ可能にします: ドラフトに対して gh pr ready — この前に「マージ準備完了」と言ってはいけません。PR本文: サマリー + 仕様/計画パス; レビュー指摘とその修正(反論された指摘があればそれも); バックロードされた手動フェーズが「未実装 — オペレータがこのPRにプッシュ」とマークされていること; テスト計画をそのまま、「ポストマージ — オペレータ駆動」とラベル付け。停止; オペレータがマージします。
9. マージ後クローズアウト
オペレータがマージを報告したとき: まず修正が main に到達したことを確認します — fr isolation verify-merge --branch <b> を実行します(スカッシュ/リベース/マージセーフ; 終了コード1=未確認)。未確認の場合 → 停止して復旧します(チェリーピック / 新しいPR)。次に、テスト計画があれば実行します(エージェントがチェックを実行し、オペレータが到達できないものを確認)。フェーズ完了を確認し(fr status)、fr archive <plan-dir> を実行し、ハウスキーピングPRでコミット、fr isolation down を実行します。