plan-recovery

プラン復旧

PlanWeave の実行状態が異常な場合にこのスキルを使用してください。通常の実装作業やレビュー作業は行わないでください。

クイックスタート

1. 依存する作業のディスパッチを停止します。
2. CLI のエントリーポイントを特定し、<pw> help recovery を実行して正確なコマンドを確認します。
3. パッケージ、状態、結果、current/status/explain の出力を調査します。doctor は、状態と結果の整合性に関する疑問がある場合にのみ実行します。
4. プランの欠陥と、実行時の状態／結果の不整合を切り分けます。
5. 状態の書き込みには、必要な修復内容を正確に表す復旧コマンドを使用します。根拠の確認にはファイルを直接調査します。
6. 修復した内容、依然として安全でない点、次にコーディネーターが行うべき操作を報告します。

Doctor の適用範囲

• doctor は、古い current 参照、孤立した結果、状態とインデックス間の run の不一致など、実行時の状態／結果に関する限定的な整合性の問題を検出します。
• doctor --repair は、汎用的なプラン修復ツールではありません。
• 不適切な依存関係、安全でない並列化、プロンプトの欠落、誤ったレビューゲートの設計、不明確なタスク／ブロックの粒度、無効なプロジェクトグラフ、スキーマに適合しないパッケージ構造の修正に doctor を使用しないでください。
• プランに欠陥がある場合は NEEDS_PLAN_UPDATE を報告し、Plan Package、プロンプト、依存関係、またはレビューゲートを手動で編集するよう案内します。

まず診断する

以下を確認します。

• アクティブな current 参照と現在のフィードバック。
• ブロック／タスクのステータスと claim ヒント。
• 最新の run インデックスと、状態ブロックの lastRunId の比較。
• 孤立した結果アーティファクト。
• 古い current 参照。
• 参照が分岐またはブロックされているか、およびその理由。
• レビューの試行、フィードバックのステータス、再レビューの状態。
• 再試行が同一内容の冪等な処理か、新しい作業リビジョンか。

復旧アクション

• 状態／結果を修復する前に doctor を使用します。報告された修正内容が限定的で、根拠に裏付けられている場合にのみ repair を使用します。
• CLI の出力が不完全、矛盾している、または診断に必要な情報が要約されすぎている場合は、パッケージ／状態／結果を直接読みます。
• CLI で安全に claim／submit できない場合は、書き戻しが安全になるまで、コーディネーターがパッケージ／状態／結果を読み、正確な参照を手動で割り当てます。
• 外部の前提条件や一時停止には、blocked／unblocked コマンドを使用します。
• 実装の実態が Plan Package と一致しなくなった場合は、diverged／resolve-divergence を使用します。
• submit が部分的に成功した場合は、新しい run や試行を作成する前に、レポート／結果アーティファクトが保存済みかどうかを確認します。
• フィードバックが解決済みでも current のままの場合は、何かを submit する前に current/status を再確認します。
• 並列化の不一致がある場合は、作業がないと判断する前に、逐次実行時と並列実行時の claim 可能性を比較します。
• 並列化の不一致がパッケージ設計に起因する場合は、repair を実行するのではなく、依存関係、並列実行の安全性、またはレビューゲートの配置を手動で調整します。

手動での代替手段

ファイルを直接調査することも復旧作業の一部です。

• 構造に疑いがある場合は、project-graph.json（存在する場合）、各キャンバスの package/manifest.json、ソースプロンプト、state.json、results/、および planweave schema project/manifest/state/layout を確認します。
• インデックスを信頼する前に、メタデータが同じタスク／ブロック／run に属していることを確認します。
• 機械的なワークスペース操作、検証、復旧トランザクション、実行時の状態／結果の変更には、CLI／ランタイムコマンドを使用します。
• プランの更新にあたる修復では、CLI が返したワークスペースパス内の Plan Package の意味的なファイルを直接編集します。対象は、project-graph.json の依存関係、キャンバスの manifest.json にあるタスク／ブロック／エッジ／受け入れ条件／プロンプトパス、およびソースプロンプトの Markdown です。
• 意味的な変更を正確に表現できる場合は、範囲を絞った CLI 編集コマンドを使用します。それ以外の場合は、ソースパッケージファイルとプロンプトを直接更新します。
• 修正内容を表現できる復旧コマンドがなく、厳密な不変条件を把握しており、ユーザーがリスクを受け入れている場合に限り、state.json または results/ を直接編集します。
• プランを直接編集した後は、編集したキャンバスを対象に検証を実行します。また、project-graph.json、キャンバスのエッジ、または crossTaskEdges を変更した場合は、プロジェクトの検証も実行します。
• 根拠となるパスを保持し、状態／結果を直接書き換えた場合は、その旨を説明します。

停止条件

以下の場合は停止し、ユーザーに確認するか、計画の更新を依頼してください。

• パッケージの依存関係またはプロンプトが誤っています。
• 推測せずに状態を修復できません。
• 複数の現在の参照が、実際の作業の担当範囲と競合しています。
• 結果のメタデータが、誤ったブロックまたはタスクを指しています。
• doctor の実行後も、レビュー／フィードバックの状態に矛盾があります。
• 復旧コマンドによって、実際の製品上または契約上の欠陥が隠れてしまいます。

復旧レポート

以下を報告してください。

• 判定：RECOVERED、NEEDS_PLAN_UPDATE、または BLOCKED。
• 症状と根拠。
• 実行したコマンド。
• 確認したファイル。
• 実施した修復、または意図的に見送った修復。
• plan-coordinator が次に安全に実行できるコマンド。