ln-220-story-coordinator

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

ストーリーコーディネーター

タイプ： L2 ドメインコーディネーター
カテゴリー： 2XX 計画

ランタイムに支えられたストーリー計画コーディネーターです。フロー制御、一時停止と再開、ワーカーの結果追跡はランタイムが担います。

必須の事前読込

実行前に、以下を読み込みます。

• references/coordinator_runtime_contract.md
• references/story_planning_runtime_contract.md
• references/coordinator_summary_contract.md
• references/environment_state_contract.md
• references/storage_mode_detection.md
• references/problem_solving.md

必須の事前読込： エピック、ソースドキュメント、または既存のストーリーに H/G/run ID が記載されている場合、あるいはリサーチグラフの構成によってストーリーの分解方法が変わる可能性がある場合は、references/researchgraph_mcp_usage.md を読み込みます。

目的

• エピック計画のコンテキストを組み立てます
• テクニカルノートに変更が生じる場合に、焦点を絞った標準の調査を行います
• 既存のストーリーを確認する前に、理想的なストーリー計画を作成します
• エピックグループごとにルーティングとモードを検出します
• 委任の前に、子のマニフェスト／アーティファクトの準備をまとめて行います
• 作成または再計画をスタンドアロンワーカーに委任します

入力

パラメーター	必須	説明
epicId	はい	分解するエピック
autoApprove	いいえ	false の場合、ランタイムはプレビュー確認時に一時停止します

ランタイム

ランタイムファミリー：story-planning-runtime

識別子：

• epic-{epicId}

フェーズ：

1. PHASE_0_CONFIG
2. PHASE_1_CONTEXT_ASSEMBLY
3. PHASE_2_RESEARCH
4. PHASE_3_PLAN
5. PHASE_4_ROUTING
6. PHASE_5_MODE_DETECTION
7. PHASE_6_DELEGATE
8. PHASE_7_FINALIZE
9. PHASE_8_SELF_CHECK

終了フェーズ：

• DONE
• PAUSED

サマリーフロー：

• ln-221 / ln-222 の子 story-plan-worker アーティファクトを使用します
• PHASE_7_FINALIZE でコーディネーターの story-plan アーティファクトを書き込みます

フェーズマップ

フェーズ 1：コンテキストの組み立て

エピックを特定し、ストーリーの分解方法に影響する計画入力のみを組み立てます。

• エピックのスコープ
• 成功基準
• 既知のペルソナと制約
• プロジェクトのタスクプロバイダー

チェックポイントのペイロード：

• context_ready

フェーズ 2：調査

ストーリーのテクニカルノートや実装上の制約に変更が生じる場合に限り、焦点を絞った調査を行います。

調査によってストーリーのスコープを広げないでください。

リサーチグラフの構成が存在する場合は、最初に verify_index を使用し、その後、関連するゴール、仮説、エビデンス、または実行のみを照会します。グラフの結果を使って、ストーリーのスコープ、準備状況、テクニカルノートの根拠を示します。グラフに未解決の課題があるというだけで、新たなストーリーのスコープを作成しないでください。

チェックポイントのペイロード：

• research_status
• research_file

フェーズ 3：計画

既存のストーリーを確認する前に、理想的なストーリー計画を作成します。

ルール：

• 垂直スライスのみ
• エピックの内容に応じて 5～10 件のストーリー
• 簡潔なストーリー文と、観測可能な受け入れ基準（AC）
• 計画にオーケストレーションに関する説明を含めない
• 委任する AC では、アクターが何をするかだけでなく、アクターに必要なもの（コンテキスト、指示、ツール、設定）を明記します

チェックポイントのペイロード：

• ideal_plan_summary

フェーズ 4：ルーティング

計画したストーリーをエピックグループにルーティングします。

ファストパス：

• すべてのストーリーを、特定済みのエピックに配置します

ルーティングが曖昧な場合、または確認が必要な場合に限り、一時停止します。

チェックポイントのペイロード：

• routing_summary

フェーズ 5：モード検出

エピックグループごとにモードを判定します。

• CREATE
• REPLAN
• ADD

チェックポイントのペイロード：

• epic_group_modes

フェーズ 6：委任

フェーズ 6 には、内部ステップが 2 つあります。

フェーズ 6a：委任の準備

• ルーティンググループを確定します
• ワーカーマニフェストを作成します
• 各子に対して run_id と summary_artifact_path を事前計算します
• 実行前に、想定されるワーカーセットをチェックポイントに記録します

フェーズ 6b：委任の実行

グループごとに委任します：

• ln-221-story-creator
• ln-222-story-replanner

ワーカーは、単独でも実行できる状態を維持します。管理モードでは、コーディネーターが planning-worker-runtime を通じてワーカーを起動し、runId + summaryArtifactPath を渡し、起動メタデータを child_run に保存したうえで、生成されたワーカーアーティファクトを record-epic で記録します。

ワーカーの要約種別：

• story-plan-worker

フェーズ 7：最終処理

想定されるワーカー要約がすべて記録された後にのみ、最終処理を行います。

コーディネーターの出力：

• 親ランタイム用に 1 つの story-plan 要約を作成します
• node references/scripts/story-planning-runtime/cli.mjs record-plan-summary を通じて書き込みます
• PHASE_8_SELF_CHECK に進む前に、アーティファクトを保存します

テンプレート準拠ゲート： 設定済みのトラッカープロバイダーを通じて、作成した各 Story を取得します（references/tracker_provider_contract.md に定義されている getStory オペレーション）。planning-runtime/lib/template-compliance.mjs の validateTemplateCompliance(description, 'story') を実行します。すべての Story が合格する必要があります（9 つのセクションが順番どおりであること）。状態に template_compliance_passed を記録します。これがない場合、ガードによって SELF_CHECK がブロックされます。

チェックポイントのペイロード：

• final_result
• template_compliance_passed

フェーズ 8：セルフチェック

次の項目を確認します：

• フェーズの網羅性
• 計画した Story 数と作成された Story 数の一致
• Epic グループに漏れがないこと

チェックポイントのペイロード：

• pass
• final_result

保留中の判断

次の場合は、ランタイムの PAUSED + pending_decision を使用します：

• コンテキストが不足している
• ルーティングの確認が必要である
• ADD と REPLAN のどちらかが不明確である
• autoApprove=false の場合にプレビューの確認が必要である

これらの判断をチャット内だけに留めてはいけません。

ワーカー契約

ワーカーは次の条件を満たします：

• コーディネーターを認識しません
• ランタイムの状態を読み取りません
• 単独で実行できる状態を維持します
• summaryArtifactPath を受け取る場合があります
• いずれの場合も共有の要約エンベロープを返します

想定される要約種別：

• 子ワーカー：story-plan-worker
• コーディネーターの出力：story-plan

ワーカーの呼び出し（必須）

ホストスキルの呼び出し： Skill(skill: "...", args: "...") による委任が必須です。

• Claude：Skill ツールを、示されているとおりに正確に呼び出します。
• Codex：Skill ツールが存在しない場合は、利用可能なスキルから指定されたスキルを探し、その SKILL.md を読み、args を $ARGUMENTS として扱い、そのスキルのワークフローを実行してから、結果／アーティファクトを持ってここに戻ります。
• ワーカーのロジックをインラインで記述したり、対象スキルを実行せずにワーカーを完了扱いにしたりしてはいけません。

フェーズ	ワーカー	コンテキスト
6	ln-221-story-creator	CREATE または ADD のパス
6	ln-222-story-replanner	REPLAN のパス

node references/scripts/planning-worker-runtime/cli.mjs start --skill {worker} --identifier {identifier} --manifest-file {workerManifestPath} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}
child_run = { skill, run_id, identifier, summary_artifact_path }
childSummaryArtifactPath = .hex-skills/runtime-artifacts/runs/{parent_run_id}/story-plan-worker/{worker}--{identifier}.json
Skill(skill: "{worker}", args: "{identifier} --ideal-plan {idealPlanJSON} --epic {epicId} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}")
Read {childSummaryArtifactPath}
node references/scripts/story-planning-runtime/cli.mjs record-epic --epic {epicId} --payload-file {childSummaryArtifactPath}
node references/scripts/story-planning-runtime/cli.mjs record-plan-summary --epic {epicId} --payload-file {coordinatorSummaryPath}

TodoWrite の形式（必須）

- Phase 1: Assemble context (pending)
- Phase 2: Research only what changes Technical Notes (pending)
- Phase 3: Build ideal Story plan (pending)
- Phase 4: Route Stories by Epic (pending)
- Phase 5: Detect mode per group (pending)
- Phase 6a: Prepare delegation batch (pending)
- Phase 6b: Execute worker(s) sequentially (pending)
- Phase 7: Finalize result (pending)
- Phase 8: Self-check (pending)

重要なルール

• 既存の Story を確認する前に、理想的な計画を作成します。
• 調査は、Technical Notes と実装の現実性を高める目的に限って行います。
• ルーティングやプレビューの承認をチャット内だけの状態に留めてはいけません。
• 読み取り専用の準備のみをまとめて実行します。ランタイムのセマンティクスで明示的に許可されていない限り、ルーティングされたグループ間で Story の変更を並列化してはいけません。
• ワーカーが実行すべき場合に、Story を直接作成または更新してはいけません。
• ワーカーの自由記述の文章ではなく、ワーカーの要約を使用します。

完了の定義

• Epic スコープの識別子でランタイムを開始した
• コンテキストの組み立てをチェックポイントに記録した
• 調査をチェックポイントに記録した、または明示的に最小限とした
• 理想的な計画をチェックポイントに記録した
• ルーティングをチェックポイントに記録した
• モード検出をチェックポイントに記録した
• 想定されるワーカー要約をすべて記録した
• コーディネーターの story-plan 要約を記録した
• 最終結果をチェックポイントに記録した
• 作成したすべての Story についてテンプレート準拠に合格した
• セルフチェックに合格した

メタ分析

任意の参照資料：実行後のメタ分析またはプロトコル形式の実行振り返りをユーザーから求められた場合に限り、references/meta_analysis_protocol.md を読み込みます。

スキルタイプ：planning-coordinator。依頼された場合、すべてのフェーズ完了後に実行します。プロトコル形式でチャットに出力します。

参照ファイル

• references/environment_state_contract.md
• references/storage_mode_detection.md
• references/replan_algorithm.md

---

バージョン： 5.0.0 最終更新日： 2026-02-03