workflow-execute-plans

プランの実行（バッチ実行＋チェックポイント）

目的

「作成済みのプランファイル」を確実に実装結果へとつなげ、すべてを一度に進めることによる計画からの逸脱やリスクの蓄積を防ぎます。

基本方針：バッチ実行＋各バッチ後にフィードバックを求めて一時停止します。

入力／出力（連携に推奨）

入力（パスのみを渡します）：

• plan_path：プランファイル（通常は run_dir/03-plans/ 内）
• repo_root
• run_dir

出力（永続化）：

• プランの実行状況：logs/state.json（または 03-plans/<plan>-status.md）
• バッチごとの検証結果：該当するプランファイルまたは 05-final/ の概要に追記

実行フロー

ステップ 1）プランを読み、レビューする（最初に重要な点を確認）

1. plan_path を読みます
2. プランに次の問題がないか確認します：
   • 依存関係の不足（インストールが必要なパッケージ／環境変数／外部サービス）
   • タスクの粒度が大きすぎる（検証できない、ロールバックが難しい）
   • 受け入れ基準または検証コマンドの不足
   • 明らかに誤ったタスクの順序
3. 重大な問題が見つかった場合：まず停止し、懸念点を1〜3個の箇条書きで提示してから、実行を開始する前に人間の確認を待ちます。

ルール：「作業しながら推測」してはいけません。プランが不明確な場合は、明確にしてください。

ステップ 2）バッチ実行（デフォルトは1バッチあたり3タスク）

プランの最初の3タスクを実行してから停止し、報告します。

各タスクについて：

1. in_progress に設定します
2. プランに厳密に従って実行します（範囲を広げないでください）
3. プランに従って検証を実行します（テスト／ビルド／型チェック／リンティング／手動検証手順）
4. completed に設定します

状況の記録（いずれかを選択し、構造化された方法を推奨）：

• logs/state.json のタスク状況を更新します
• または plan_path にチェックリスト（[ ]→[x]）を記録し、検証結果も併記します

ステップ 3）バッチ報告（必ずフィードバックを待つ）

各バッチの後、次の3点を報告します：

• 変更内容：変更したファイル／実装した内容（簡潔に）
• 検証：実施した検証とその結果（重要な情報のみ。長いログは不要）
• 次のバッチ：次に実施する3タスク

任意ですが、推奨：

• このバッチの最終レビューには review-merge-readiness を使用します（特に、モジュールをまたぐ変更、リスクの高い変更、またはマージが近い場合）

最後の行は次のとおりにします：

フィードバックをお待ちしています。

その後、人間からのフィードバックを待ちます。次のバッチへ自動的に進んではいけません。

ステップ 4）フィードバックに基づいて続行する

• フィードバックで変更を求められた場合：まず修正して再検証してから、次のバッチに進みます
• フィードバックが問題なしの場合：次のバッチに進みます（引き続きデフォルトは3タスクです）

ステップ 5）完了処理（すべて完了した後）

すべてのタスクが完了し、検証済みになったら：

• プロジェクトの規約に従って、全テスト／ビルドを実行します
• 05-final/summary.md に、実施内容／検証方法／リスクとロールバック／次の手順を記載します
• skill-evolution の進化チェックポイント（3つの質問）を実施します。ユーザーが「最適化したい」を選んだ場合は、この run_dir に基づいて skill-improver を実行し、最小限のパッチ提案を作成します
• finishing-a-development-branch スキルがある場合は、そのスキルに従ってマージ／PR／クリーンアップの方法を選択し、完了させます

停止してサポートを求める場合（必須ルール）

次のいずれかに該当した場合は、ただちに実行を停止し、問題を報告します：

• 途中で作業がブロックされた（依存関係の不足、環境の誤り、権限の問題）
• テスト／検証に失敗し、原因をすぐに特定できない
• プランの手順が不明確（正しい実装方法を判断できない）
• データ損失や広範な副作用につながる可能性のある操作があるが、プランに確認ポイントが含まれていない

覚えておくこと

• 開始前にプランを批判的にレビューします
• 小さなバッチで実行します（デフォルトは3タスク）
• 各バッチで検証と報告を行い、その後フィードバックを待ちます
• ブロックされたら停止し、推測で進めません