Markdown ドキュメントを Overseer タスクに変換する

/overseer-plan を使用して、任意のマークダウン計画ドキュメントを追跡可能な Overseer タスクに変換します。

使用時期

• プラン モードで計画を完成させた後
• 仕様書/設計ドキュメントを実装タスクに変換する場合
• ロードマップまたはマイルストーン ドキュメントからタスクを作成する場合

使用方法

/overseer-plan <markdown-file-path>
/overseer-plan <file> --priority 1           # 優先度を設定 (0-2、0=最高)
/overseer-plan <file> --parent <task-id>     # 既存タスクの子として作成

動作内容

1. マークダウン ファイルを読み込む
2. 最初の # 見出しからタイトルを抽出（「Plan: 」プレフィックスを削除）
3. Overseer マイルストーンを作成（--parent 指定時は子タスク）
4. 子タスク分割の構造を分析
5. 適切な場合、子タスク（深さ 1）またはサブタスク（深さ 2）を作成
6. タスク ID と分割の概要を返す

階層レベル

深さ	名前	例
0	マイルストーン	「ユーザー認証システムを追加」
1	タスク	「JWT ミドルウェアを実装」
2	サブタスク	「トークン検証関数を追加」

分割の判定

サブタスクを作成する場合:

• 3～7 個の明確に分離可能な作業項目
• 複数のファイル/コンポーネントにまたがる実装
• 明確な順序の依存関係

単一のマイルストーンのままにする場合:

• 1～2 つのステップのみ
• 作業項目が密結合
• 計画が探索的/調査的

タスク品質基準

すべてのタスクは以下を満たす必要があります:

• アトミック: コミット可能な単一の作業単位
• 検証済み: テストを持つ、または文脈内に明示的な受け入れ基準がある（「完了条件: ...」）
• 明確: 技術的、具体的、命令形の動詞

すべてのマイルストーンは以下を満たす必要があります:

• デモ可能: 実行/テスト可能な増分を生成
• 前に基づく: 前のマイルストーンの出力に依存できる

レビュー ワークフロー

1. ドキュメントを分析 → 分割を提案
2. Oracle を呼び出して分割をレビューし、改善を提案してもらう
3. フィードバックを組み込む
4. Overseer で作成（MCP を経由して SQLite に永続化）

作成後

await tasks.get("<id>");                    // TaskWithContext (完全なコンテキスト + 学習内容)
await tasks.list({ parentId: "<id>" });     // Task[] (コンテキスト チェーンなしの子)
await tasks.start("<id>");                  // Task (VCS 必須 - ブックマークを作成、開始コミットを記録)
await tasks.complete("<id>", { result: "...", learnings: [...] });  // Task (VCS 必須 - コミット、学習内容をバブル)

VCS 必須: start と complete は git が必要です（見つからない場合は NotARepository で失敗）。CRUD 操作は VCS なしで動作します。

注: 優先度は 0～2 である必要があります。ブロッカーは祖先または子孫にはできません。

使用しない場合

• ドキュメントが未完成または探索的
• コンテンツが実行可能でない
• 意味のある計画コンテンツがない

---

読む順序

タスク	ファイル
API の理解	@file references/api.md
エージェント実装	@file references/implementation.md
例を参照	@file references/examples.md

このリファレンスの内容

ファイル	目的
references/api.md	Overseer MCP codemode API のタイプ/メソッド
references/implementation.md	エージェント実行の段階的な手順
references/examples.md	完全に解説された例