executing-plans

計画の実行

目的

承認済みの実装計画を、チェックポイント、検証、レビューのゲートを設けた制御可能なバッチに分けて実行します。

使用するタイミング

以下の場合にこのスキルを使用します。

• 作成済みの実装計画がある
• 定期的なレビューのチェックポイントを設けて作業を実行する必要がある
• リグレッションのリスクがあるため、計画を厳密に遵守し、検証する必要がある

進捗の追跡

各バッチの前に、計画の実行状況を表示します。

[████░░░░░░░░░░░░░░░░] 20% — Phase 1: Loading & Reviewing Plan
[████████░░░░░░░░░░░░] 40% — Phase 2: Executing Batch N
[████████████░░░░░░░░] 60% — Phase 3: Reporting & Verification
[████████████████░░░░] 80% — Phase 4: Awaiting Feedback
[████████████████████] 100% — Phase 5: Final Verification Complete

タスクが多い計画では、実際のタスク完了状況を反映するようゲージを調整します。X/Y tasks done (N%)。

ワークフロー

1. 計画を読み込み、批判的にレビューする
2. 最初のタスクバッチを実行する
3. 結果と検証の出力を報告する
4. フィードバックを待ち、バッチごとに作業を続ける
5. 最終検証を行い、ブランチを完了する

概要

計画を読み込み、批判的にレビューし、バッチごとにタスクを実行します。バッチ間でレビュー用に報告します。

基本原則： アーキテクトによるレビューのチェックポイントを設けて、バッチごとに実行します。

開始時に伝えること： 「計画実行スキルを使用して、この計画を実装します。」

プロセス

ステップ 1：計画を読み込み、レビューする

1. 計画ファイルを読む
2. 批判的にレビューし、計画に関する質問や懸念事項を特定する
3. 懸念事項がある場合：作業を開始する前に、担当者に伝える
4. 懸念事項がない場合：TodoWrite を作成して先に進む

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

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

各タスクについて：

1. in_progress にする
2. 各手順を正確に実行する（計画には細分化された手順が記載されています）
3. 指定された検証を実行する
4. completed にする

ステップ 3：報告する

バッチが完了したら：

• 実装した内容を示す
• 検証の出力を示す
• 「フィードバックをお待ちしています。」と伝える

ステップ 4：続行する

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

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

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

すべてのタスクが完了し、検証されたら：

• 「開発ブランチ完了スキルを使用して、この作業を完了します。」と伝える
• 必須のサブスキル： superpowers:finishing-a-development-branch を使用する
• そのスキルに従ってテストを検証し、選択肢を提示して、選ばれた内容を実行する

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

以下の場合は、すぐに実行を停止します。

• バッチの途中でブロッカーに直面した場合（依存関係がない、テストが失敗する、指示が不明確など）
• 作業を開始できないほど計画に重大な不足がある場合
• 指示を理解できない場合
• 検証が何度も失敗する場合

推測せず、確認を求めてください。

以前の手順に戻るタイミング

以下の場合はレビュー（ステップ 1）に戻ります。

• 担当者がフィードバックに基づいて計画を更新した場合
• 基本的なアプローチを再検討する必要がある場合

ブロッカーを無理に乗り越えようとしないでください。停止して確認を求めます。

注意事項

• まず計画を批判的にレビューする
• 計画の手順に正確に従う
• 検証を省略しない
• 計画にスキルの参照がある場合は、それに従う
• バッチ間では、報告してフィードバックを待つ
• ブロックされたら推測せず停止する
• ユーザーの明示的な同意なしに、main/master ブランチで実装を始めない

連携

必須のワークフロースキル：

• superpowers:using-git-worktrees - 必須：開始前に分離された作業スペースを設定する
• superpowers:writing-plans - このスキルが実行する計画を作成する
• superpowers:finishing-a-development-branch - すべてのタスクの完了後に開発を完了する

重要なルール

• ブロッカーが発生したら、すぐに停止して確認を求めます。
• 計画で定義されている検証コマンドを省略しないでください。
• 報告してフィードバックを待つ前に、次のバッチへ進まないでください。

エラー処理

エラー	考えられる原因	対応
プランファイルが見つからない	指定されたパスが存在しないか、ファイルが移動されています	ユーザーにファイルパスの確認を依頼し、docs/plans/ にあるプランファイルを一覧表示します
タスクの説明が曖昧	プラン内のステップが不明確、または詳細が不足しています	先に進む前に停止し、ユーザーに確認を求めます
タスクが失敗した前提タスクに依存している	先行タスクが失敗したか、スキップされました	依存関係の失敗を報告し、解決するまで続行しません
検証コマンドが失敗する	プランで定義されたテストまたはチェックが失敗しています	直ちに停止し、エラー出力全体を報告して、ユーザーの指示を待ちます
実行中にブロッカーが発生する	想定外の状態、ファイルの競合、またはコンテキストの不足です	一時停止し、ブロッカーの内容を正確に報告して、進め方をユーザーに確認します
バッチの一部が失敗した状態で完了する	バッチ内の一部のタスクが失敗しました	成功したタスクと失敗したタスクを報告し、再試行するかスキップするかをユーザーに確認します

使用例

1. 「executing-plans を使用して docs/plans/2026-02-20-api-hardening.md を実装してください。」
2. 「executing-plans を使用して次の 3 つのタスクを実行し、レビューのために停止してください。」
3. 「executing-plans を使用して残りのタスクを完了し、最終チェックを報告してください。」