mcpField
P
phase-plan

phase-plan

github.com/davidlee開発2142 回インストール4 日前に更新
リポジトリ

phase-plan について

phase-plan は、実行直前に記述済みのフェーズを具体的なタスクへ落とし込む開発スキルです。設計、フェーズ基準、調査資料、プロジェクトの記録に基づいて作業と検証を組み立てます。

主な機能

  1. 01フェーズの開始条件確認
  2. 02設計とフェーズ目標の再確認
  3. 03サブシステム別ガイダンスの取得
  4. 04タスク、対象ファイル、検証の定義

活用シーン

  1. 01次のフェーズの実行準備
  2. 02検証項目と終了基準の対応付け
  3. 03調査更新後の作業計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davidlee/doctrine --skill phase-plan

インストール後、Claude Code で/phase-planを入力して読み込まれたか確認します。

詳細

フェーズ計画

作成済みのフェーズを実行する直前に、そのフェーズの実行時フェーズシートへ展開します。作成済みの計画(plan.toml)には、フェーズで達成すべきことが記載されています。このスキルでは、破棄可能な状態ツリー内で、その実現方法を検討します。

各フェーズの計画は、実行直前に詳細化します。すべてのフェーズをあらかじめ計画することはありません。

入力:

  • フェーズの plan.toml エントリー。その objective、exit_criteria(EX-)、verification(VT-/VA-/VH-)
  • design.md(正規の設計リファレンス)と slice-nnn.md(スコープ)
  • マテリアライズされた実行時フェーズシート state/.../phases/phase-NN.{toml,md}

プロセス

  1. 詳細を計画する前に、フェーズの entrance_criteria(EN-)が満たされていることを確認します。満たされていない場合は、まずそれを解決します(先行フェーズ、設計上の不足など)。
  2. design.md とフェーズの plan.toml エントリーを読み直し、目標、終了基準、検証要件を確認します。
  3. 具体的に変更する予定のファイルやサブシステムに対して /retrieve-memory を実行し、タスクの内訳を決める前に、スコープに関わる注意点やパターンを確認します。
  4. 調査に関する助言を確認します — doctrine slice research <id>。乖離が報告された場合は、影響を受けるスレッドのセクションだけを更新してから、ベースラインを再スタンプします。古い成果物ではなく、更新された成果物に基づいてフェーズを計画します。
  5. 実行時フェーズシート phase-NN.md(.doctrine/state/ 以下、GITIGNORED かつ破棄可能)に、次の内容を記入します。
    • 具体的なタスクの内訳 — 小規模で一貫性のある作業単位
    • 実行時に引き継ぐ前提条件と制約
    • 各 VT-/VA-/VH- 要件を満たす検証手順
    • 各タスクで変更する予定のファイル/コンポーネント
  6. これは実行時の状態です(lib:reference/using-doctrine.md § ストレージ階層)。タスクの詳細や進捗を、作成済みの plan.toml/plan.md に書き戻してはいけません。
  7. フェーズを詳細化する中で新たな設計上の問題、未解決のトレードオフ、またはポリシーの曖昧さが明らかになった場合は、作業を止めます — /consult を使うか、設計自体に不足がある場合は /design に戻ります。その場しのぎで先へ進めてはいけません。
  8. シートの内容に一貫性ができたら、doctrine slice phase(lib:reference/using-doctrine.md を参照)を使ってフェーズを in_progress に切り替え、それから /execute を実行します。

成果

  • 設計に基づいた、具体的で実行可能なタスクの内訳がフェーズに用意されています。
  • 検証手順がフェーズの VT- 基準に対応しています。
  • 作成済みの計画と実行時の状態が、ストレージルールに従ってそれぞれ適切な場所に保たれています。

コメント