ln-830-code-modernization-coordinator

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリを基準とします。

ln-830-code-modernization-coordinator

種類： L2 ドメインコーディネーター カテゴリ： 8XX 最適化

コードのモダナイゼーションを行う、ランタイムを利用したコーディネーターです。OSS の置き換えとバンドルサイズの作業を分離された子ランに委任し、機械可読なワーカーの要約を記録して、最後にコーディネーターの要約を出力します。

---

概要

項目	詳細
入力	監査レポート、対象モジュール、またはモダナイゼーションの対象範囲
出力	永続的なワーカー成果物を含む、集約されたモダナイゼーションレポート
ワーカー	ln-831（OSS 置き換え担当）、ln-832（バンドル最適化担当）
ランタイム	.hex-skills/modernization/runtime/runs/{run_id}/

---

ワークフロー

フェーズ： 事前確認 -> 入力の分析 -> ワーカーへの委任 -> 結果の収集 -> 要約の検証 -> レポート

---

ランタイム契約

必須の読み込み： references/ci_tool_detection.md を読み込みます 必須の読み込み： references/coordinator_runtime_contract.md、references/modernization_runtime_contract.md、references/coordinator_summary_contract.md を読み込みます

ランタイム CLI：

node references/scripts/modernization-runtime/cli.mjs start --identifier repo-modernization --manifest-file <file>
node references/scripts/modernization-runtime/cli.mjs status --identifier repo-modernization
node references/scripts/modernization-runtime/cli.mjs checkpoint --phase PHASE_2_DELEGATE_WORKERS --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-worker-result --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-summary --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs advance --to PHASE_3_COLLECT_RESULTS
node references/scripts/modernization-runtime/cli.mjs complete

必須の状態フィールド：

• worker_plan
• worker_results
• child_runs
• verification_passed
• report_ready
• summary_recorded

ドメインのチェックポイント：

• PHASE_1_ANALYZE_INPUT：対象モジュール、ワーカーの選択、スタックの検出
• PHASE_2_DELEGATE_WORKERS：委任したワーカーごとに、ワーカー名、runId、summaryArtifactPath を含む child_run を 1 つ記録
• PHASE_3_COLLECT_RESULTS：記録済みのワーカー要約と未解決の失敗
• PHASE_4_VERIFY_SUMMARY：最終レポートのパス、検証結果、要約の準備状況

ガードルール：

• 計画したすべてのワーカーが有効な modernization-worker 要約を出力するまで、PHASE_2_DELEGATE_WORKERS から先に進まないでください
• 最終レポートのチェックポイントが存在し、modernization-coordinator の要約が記録されるまで完了しないでください
• ワーカーの JSON 要約のみを使用してください。文章形式の出力からワーカーの状態を推測してはいけません

---

フェーズ 0：事前確認

モダナイゼーションの依頼に有効な対象範囲があり、ランタイムの対象が確定していることを確認します。

確認項目	必須	欠けている場合の対応
監査レポートまたは対象モジュール	はい	モダナイゼーションをブロックします
プロジェクトパス	はい	モダナイゼーションをブロックします
利用可能な検証コマンド	はい	ワーカーが変更を検証できない場合はブロックします
識別子に対応する既存のアクティブなラン	いいえ	競合するランがある場合は一時停止します

---

フェーズ 1：入力の分析

プロジェクトの種類と検出結果に基づいてワーカーを選択します。

ワーカーの選択：

条件	ln-831	ln-832
監査結果に OSS の候補が含まれる	はい	いいえ
package.json がある JS/TS プロジェクト	いいえ	はい
両方の条件に該当する	はい	はい
明示的に対象モジュールのみ指定されている	はい	バンドルへの影響がある場合は任意

スタックの検出：

指標	スタック	ln-832 の対象
package.json + JS/TS ファイル	JS/TS	はい
*.csproj	.NET	いいえ
requirements.txt または pyproject.toml	Python	いいえ
go.mod	Go	いいえ

チェックポイントのペイロードには、次の内容を含める必要があります：

• input_source
• worker_plan
• stack_detection
• skipped_reasons

---

Phase 2：ワーカーへの委任

選択した各ワーカーにつき、子ランを1つ委任します。子ランは決定論的で、成果物を基準に実行されます。

以下のルーティングルールで選択された具体的なワーカー ID を使って委任してください。プロンプト内でファミリーのプレースホルダーや推測したスキル ID を作成しないでください。

委任コンテキスト：

フィールド	型	説明
projectPath	string	対象プロジェクトの絶対パス
auditReport	string	該当する場合、監査出力のパス
targetModule	string	任意の対象モジュールパス
identifier	string	安定したワーカー識別子
runId	string	決定論的な子ラン ID
summaryArtifactPath	string	ワーカーサマリーの正確な JSON パス
options	object	検証フラグとワーカー固有の設定

委任ルール：

• 両方が選択されている場合は、ln-832 より先に ln-831 を起動します
• ln-832 は、推測したベースラインではなく、受け入れ済みのモダナイゼーション変更によって生成されたプロジェクトの状態を使用します
• 結果を待つ前に、各子ランのチェックポイントを作成します
• 出力されたすべてのワーカーサマリーを record-worker-result で記録します

---

Phase 3：結果の収集

検証済みのワーカーサマリーのみを集約します。

コーディネーターが使用するワーカーサマリーのフィールド：

フィールド	説明
producer_skill	ワーカー ID（ln-831 または ln-832）
summary_kind	modernization-worker である必要があります
identifier	安定したワーカー識別子
payload.status	completed、partial、または failed
payload.changes_applied	保持された変更
payload.changes_discarded	破棄された実験
payload.verification	ビルド／テストの検証結果
payload.artifact_path	ワーカーが所有する永続レポートのパス
payload.warnings	ブロック要因ではない問題

収集結果：

• worker_results
• success_count
• partial_count
• failed_count
• warnings

---

Phase 4：サマリーの検証

最終的なモダナイゼーションレポートを作成し、コーディネーターが決定論的に完了できることを検証します。

検証チェックリスト：

• 計画されたすべてのワーカーが、有効なサマリーエンベロープを1つ生成している
• 集計数が、記録されたワーカー結果と一致している
• 最終レポートのパスが存在するか、書き込み可能な状態になっている
• 完了前に report_ready と verification_passed が true になっている

失敗時の処理：

1. 成功したワーカーの結果はそのまま保持します。
2. コーディネーターレポートで、失敗したワーカーを明示します。
3. ワーカーがすでに検証した内容を超えて、ロールバック処理を捏造しないでください。

---

Phase 5：レポート

コーディネーターレポートのスキーマ：

フィールド	説明
input_source	監査レポートまたは対象モジュール
workers_activated	委任されたワーカー
modules_replaced	適用された OSS 置き換え
loc_removed	削除されたカスタムコード
bundle_reduction	最終的なバンドル削減の概要
verification_passed	検証全体の判定
per_worker[]	機械可読なワーカー結果サマリー
warnings[]	ワーカー間の警告

完了手順：

1. 永続レポートを書き込みます。
2. レポートのパスと検証判定のチェックポイントを作成します。
3. record-summary で modernization-coordinator サマリーエンベロープを記録します。
4. レポートのチェックポイントとコーディネーターサマリーが存在してから、ランタイムを完了します。

---

設定

Options:
  audit_report: "docs/project/codebase_audit.md"
  target_module: ""
  enable_oss_replacer: true
  enable_bundle_optimizer: true
  run_tests: true
  run_build: true

---

エラー処理

回復可能：

エラー	回復方法
ln-831 の部分的な結果	引き続き適用可能な場合は、ln-832 を続行します
ln-832 の失敗	ln-831 の結果を保持し、モダナイゼーションが部分的であると報告します
いずれかのワーカーでのビルド失敗	コーディネーターレポートに失敗を記載し、収集を続行します

致命的：

エラー	対応
ワーカーが起動されていない	空の結果レポートで完了します
ランタイム検証の失敗	ランを一時停止し、介入を求めます
計画された子ランのワーカーサマリーがない	収集から先へ進みません

---

参考資料

• ../ln-831-oss-replacer/SKILL.md
• ../ln-832-bundle-optimizer/SKILL.md
• ../ln-645-architecture-modernization-auditor/SKILL.md
• references/ci_tool_detection.md

---

TodoWrite の形式（必須）：

- Analyze modernization input (in_progress)
- Delegate ln-831-oss-replacer child run (pending)
- Delegate ln-832-bundle-optimizer child run (pending)
- Aggregate modernization-worker summaries (pending)

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

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

• Claude：Skill ツールを上記のとおり正確に呼び出します。
• Codex：Skill ツールがない場合は、利用可能なスキルから指定されたスキルを探し、その SKILL.md を読み、args を $ARGUMENTS として扱い、そのスキルのワークフローを実行してから、結果または成果物を持ってここに戻ります。
• ワーカーの処理をインラインで実行したり、対象のスキルを実行せずにワーカーを完了扱いにしたりしないでください。

フェーズ	ワーカー	コンテキスト
2	ln-831-oss-replacer	runId と正確な summaryArtifactPath を指定した分離された子実行
2	ln-832-bundle-optimizer	runId と正確な summaryArtifactPath を指定した分離された子実行

すべてのワーカーで、子ランタイムを起動して child_run メタデータをチェックポイントに記録した後、ワーカーのスキルを明示的に呼び出し、record-worker-result を通じて出力された modernization-worker サマリーエンベロープを取り込みます。

# Sequential per selected worker (ln-831 before ln-832 when both selected):
node references/scripts/modernization-runtime/cli.mjs start --skill {worker} --identifier {identifier} --manifest-file {workerManifestPath} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}
node references/scripts/optimization-runtime/cli.mjs checkpoint --phase PHASE_2_DELEGATE --payload '{"child_run":{"worker":"{worker}","run_id":"{childRunId}","summary_artifact_path":"{childSummaryArtifactPath}"}}'
Skill(skill: "{worker}", args: "{identifier} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}")
Read {childSummaryArtifactPath}
node references/scripts/optimization-runtime/cli.mjs record-worker-result --payload-file {childSummaryArtifactPath}

ワーカートークンの置換：{worker} は ln-831-oss-replacer または ln-832-bundle-optimizer です。

---

完了の定義

• 検証済みのマニフェストと安定した識別子を使用してランタイムを起動した
• 実際の入力をもとにモダナイゼーションの対象範囲を分析し、ワーカーを選定した
• 選定したワーカーごとに子実行を1つ委任した
• すべての子実行で有効な modernization-worker サマリーを出力した
• コーディネーターレポートに置換、バンドルの変更、警告、検証結果を集約した
• 完了前に最終的な modernization-coordinator サマリーを記録した

---

フェーズ 6：メタ分析

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

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

---

バージョン： 1.0.0 最終更新日： 2026-03-08