ce-plan について
ce-plan は、合意済みの作業を技術計画にまとめるスキルです。実装は行わず、調査、技術的な判断、計画の作成とレビュー、次の作業への引き継ぎを支援します。
主な機能
- 01計画の出力形式を選択
- 02調査と技術的な判断
- 03計画の作成とレビュー
- 04次の作業への引き継ぎ
活用シーン
- 01実装前のソフトウェア変更の計画
- 02継続的に参照する技術計画の作成
- 03合意した方針を実行手順に整理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill ce-planインストール後、Claude Code で/ce-planを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/approach-altitude.mdbakeoff.mddeepening-workflow.mdfinal-review.mdhtml-rendering.mdintake.mdmarkdown-rendering.mdoutput-contracts.mdoutput-mode.mdplan-handoff.mdplan-sections.mdreasoning-elevation.mdresearch.mdresume.mdsettled-decisions.mdstructure.mdreferences/agents/agent-native-planning-strategist.mdarchitecture-strategist.mdbest-practices-researcher.mddata-integrity-guardian.mdframework-docs-researcher.mdgit-history-analyzer.mdlearnings-researcher.mdpattern-recognition-specialist.mdperformance-oracle.mdrepo-research-analyst.mdsecurity-sentinel.mdslack-researcher.mdspec-flow-analyzer.mdweb-researcher.md詳細
技術計画の作成
現在の年は2026年です。
目的: 合意した作業の成果と制約を維持しながら、作業を実施し、確認するための計画を作成します。技術的な選択は根拠に基づいて判断し、適切な指示は変更せずに残します。ce-brainstorm は WHAT を定義し、ce-plan は HOW を計画し、ce-work は実行します。事前のブレインストーミングは任意です。
明示的な呼び出しでは、必ず計画を作成します。 直接呼び出された場合に「計画タスクではない」と分類して、別の処理に回してはいけません。以下の出力契約のいずれも選択でき、最小限の有効な計画はチャットでの数文です。
調査し、判断し、計画を書くこと。決して実装してはいけません。 本番コードを書いたり、テストを実行したり、実行時の結果から学んだりしないでください。設計を伝えるための方向性を示す疑似コードや文法のスケッチは使えますが、挙動を確認するためにコードを変更する作業は ce-work に属します。
必須の完了条件
実行は、出力契約に定められた完了条件を満たすと完了です。計画成果物またはチェックポイントを作成する通常の対話フローはすべて、ユーザーに次の行動を尋ねるまでは未完了です。すでに次の行動が許可されている依頼は、その回答に当たります。再開チェックを通過して続行する Durable なソフトウェア実装計画の実行では、Phase 5.4 のメニューを提示し、選択されたアクションを実際に実行した時点で完了です。Direct では、変更内容を示して引き継ぎを提案します。Chat brief では、概要と、保存または ce-work に進むための一行の提案をチャットで示します。どちらも Phase 5.4 のメニューは提示しません。ソフトウェア以外の計画とアプローチレベルの計画は、それぞれの参照ワークフローで定められた引き継ぎをもって終了します。質問に答えるだけの実行は、参照ワークフローで保存や共有が求められていない限り、回答後に終了できます。
ファイルの作成、確信度の確認、ce-doc-review の実行または明示的なスキップは、中間のマイルストーンです。パイプラインモードでは、計画、確信度の確認、非対話型のドキュメントレビューの状態を呼び出し元に返した時点でのみ実行が完了します。その後の対応は呼び出し元が決定します。
対話方法
現在のツール一覧にある、ホスト提供のブロッキング式質問ツールを使って、一度に一つ質問してください。機能で選び、ユーザー向けツールを試して見つけようとしてはいけません。一覧に質問ツールがない場合、または実際の質問呼び出しでエラーが発生した場合は、チャットに番号付きの選択肢を表示してください。必須の質問を黙って省略してはいけません。機能の説明が提供されていない場合は、何を計画するかを尋ね、回答を待ってください。
出力契約
スコープ設定の開始時(Phase 0.6)に、深さを決める前、またスコープの要約を作成する前に、どの出力契約が適用されるかを決定してください。この判定は、再開ルート(Phase 0.1)が実行されず、ソース確認(Phase 0.2)で上流の成果物が見つからなかった場合にのみ適用されます。サブエージェントを呼び出さず、依頼で指定された内容を対象に、範囲を限定してインラインで読み取り、根拠を確認してください。次のいずれかを選択します。
- Direct — ユーザーが判断する必要のある選択肢がなく、作業を一度の工程で記述、実施、検証できます。変更内容を数文で述べ、
ce-workまたはユーザーへの引き継ぎを提案します。実行を開始できるのは実装の許可がある場合のみです。詳細はreferences/output-contracts.mdの定義に従います。 - Chat brief — 範囲が限定され、ユーザーが判断する選択肢が最大一つで、リスク要因がない作業です。チャットで提示して終了します。
- Durable — それ以外のすべてです。以下のワークフローを続行します。
references/output-contracts.md では Direct と Chat brief を定義しています。どちらかを選択した場合は、同ファイルを読んでください。読み取り後も区分を判断できない場合は、より上位の区分を選択してください。読み取りによってユーザーが判断する選択肢、リスク要因、または複数回の検証が明らかになった場合は、内容を出力する前に、より上位の区分へ移行してください。規模にかかわらず、以下は Durable です。今回のターンにチャットで応答する同期的なユーザーがいない実行(パイプライン、ヘッドレス、目標またはスケジューラーによる実行)、計画、計画ファイル、または出力形式を求める依頼、既存の計画項目の続行依頼、リスク要因(認証、支払い、移行、外部契約)。
ワークフロー
参照によって別の経路に進む場合や、途中で終了する場合を除き、フェーズは順番に実行します。そのフェーズに入ったら、そのフェーズで必須とされる参照資料を最後まで読んでください。フェーズに入る前に読んでいても要件を満たしたことにはなりません。また、最終ステップで指定された参照資料は、すでにコンテキストに含まれていても、そのステップで改めて読みます。必須の参照資料を読めない場合は、その資料が適用される操作を行う前に停止し、ブロッカーと復旧方法を報告してください。不足しているルールを記憶から再構成してはいけません。パイプラインモードでは、必須の参照資料の読み込みに失敗するたびに、status: blocked、phase、blocker、recovery_pathを返します。成果物が存在する場合は、artifact_pathを含め、成果物を保持してください。成果物が存在する場合でも、ブロックされたことを報告してください。
フェーズ 0:出力、再開、範囲
- まず出力を確認します。 フェーズの解釈を始める前に、
references/output-mode.mdを読みます。トークンの解析、出力と確認の優先順位、レンダラーの選択、成果物の保存先、リポジトリを解決できるタイミングが定義されています。 - 再開、要件の拡充、詳細化、アプローチ、領域。 操作を始める前に、
references/resume.mdを読みます。既存の計画の再開、要件のみの計画の拡充、詳細化、アプローチレベルの計画、ソフトウェア/非ソフトウェアの分岐が定義されています。選択された終端ルートがあればそれに従い、なければ続行します。 - ソースと範囲。 フェーズ 0.2 の前に
references/intake.mdを読み、フェーズ 0.7 までその指示に従います。上流の成果物の特定と保持、ブートストラップ作業への分岐、確認が必要な質問、詳細度、名前付きリソース、範囲の統合が定義されています。上記の出力契約の判断は、この資料の中で行います。未解決の判断ポイントを先に進めてはいけません。
フェーズ 1~4:調査と作成
- コンテキストを収集する前に、
references/research.mdを読みます。 - 質問を解決したり計画を構成したりする前に、
references/structure.mdを読みます。 references/plan-sections.mdと、output-mode.mdで選択された形式レンダリングの参照資料をもとに作成します。
フェーズ 5:レビュー、書き込み、詳細化、引き継ぎ
- 書き込み前のレビューに入る前に、
references/final-review.mdを読みます。この資料ではフェーズ 5.1 から 5.3.2 までが定義されています。ブレインストーミングから対話型で実行する場合、書き込み前にフェーズ 5.1.5 の範囲の統合をチャットでユーザーに提示します。確認を待つか、自動で続行する旨を一行で通知します。 - モデルの引き上げ。 作成の直前に、
references/reasoning-elevation.mdを読み、この時点で選択を確定して、その指示に従います。有効化の判断が完了し、選択されたディスパッチまたは透過的なフォールバックが確定するまでは、作成を始めてはいけません。 - パイプラインモードでは、セッション中に確定した判断を無効にする証拠が見つかった場合、書き込みを停止します。厳密に
settled-decision-invalidated、該当する判断、理由を返してください。判断を黙って解決し直してはいけません。 - 選択肢を提示する前に計画を書き込み、その後、
final-review.mdで定義されている信頼度の手順を完了します。
停止してください。フェーズ 5.3.8 と 5.4 の直前に、references/plan-handoff.mdを読みます(ドキュメントレビューと引き継ぎメニュー)。Durableプランではドキュメントレビューが必須です。デフォルトは非対話型(mode:non-interactive)です。ソフトウェアの対話型実行では、必ず次のように質問します。「<absolute path to plan>に計画を用意しました。次はどうしますか?」メニューを提示して、回答を待ちます。選択がユーザーのターン後に届いた場合は、操作を始める前にreferences/plan-handoff.mdを読み直してください。メニューの表示、選択の受信、ルートの通知だけでは完了ではありません。選択された操作を実行してください。