ln-310-multi-agent-validator

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

タイプ： L2 コーディネーター カテゴリー： 3XX Planning

マルチエージェントバリデーター

次のモードに対応する評価プラットフォームのコーディネーターです。

• mode=story
• mode=plan_review

このスキルでは、評価プラットフォームを次の目的で使用します。

• 公式ドキュメント、MCP Ref、Context7、最新のウェブ情報を必須で調査する
• 読み取り専用のエビデンスレーンを並行して実行する
• ドキュメント作成、修正、マージ、洗練、承認を順次実行する
• ランタイムに基づくワーカープラン、ワーカー概要、エージェント同期、クリーンアップ検証を行う

入力

入力	必須	ソース	説明
storyId	mode=story	args、git ブランチ、kanban、ユーザー	検証するストーリー
plan {file}	mode=plan_review	args または自動	検証するプランファイル

モードの判定：

• plan または plan {file} -> mode=plan_review
• それ以外 -> mode=story

必読項目

必読： references/environment_state_contract.md、references/storage_mode_detection.md、references/input_resolution_pattern.md を読み込みます。 必読： references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_parallelism_policy.md、references/evaluation_research_contract.md を読み込みます。 必読： references/agent_delegation_pattern.md を読み込みます。 必読： references/penalty_points.md を読み込みます。 必読： researchgraph のファイルが変更された場合、または対象が仮説、目標、ベンチマーク、提案の準備状況を主張している場合は、references/researchgraph_mcp_usage.md を読み込みます。 条件付きで読み込み：ln-312 の調査結果概要を使用せず、コーディネーターがインラインで基準のマッピングを行う場合に限り、references/phase2_research_audit.md を読み込みます。

エージェントレビュー方針：ヘルスチェックを実行し、アドバイザーが利用できない場合はスキップ理由を記録し、すべてのアドバイザーの主張をマージ前に検証します。トランスポート、認証、ツールの障害は、ドメイン上の所見ではなく、オペレーター側のエビデンスとして扱います。評価ランタイムの範囲外でライフサイクルや稼働状況の詳細をデバッグする場合に限り、references/agent_review_workflow.md を読み込みます。

ワーカーセット

コーディネーターは次の評価ワーカーを使用します。

• ln-311-review-research-worker
• ln-312-review-findings-worker
• ln-313-review-docs-worker
• ln-314-review-repair-worker
• ln-315-review-merge-worker
• ln-316-review-refinement-worker

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

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

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

委任されたワーカーには Skill ツールを使用します。コーディネーター内でワーカーのロジックをインライン実行しないでください。

TodoWrite の形式（必須）：

• Resolve target and build runtime manifest
• Load target artifacts and metadata
• Launch external agents and verify health
• Run research and findings workers in parallel
• Generate documentation updates
• Apply accepted low-risk repairs
• Sync agents and merge all evidence
• Run refinement (MANDATORY in ALL modes when advisor available — do NOT skip)
• Compute verdict and write review output
• Verify runtime cleanup and self-check

呼び出し例：

Skill(skill: "ln-311-review-research-worker", args: "{identifier} research")
Skill(skill: "ln-312-review-findings-worker", args: "{identifier} findings")
Skill(skill: "ln-313-review-docs-worker", args: "{identifier} docs")
Skill(skill: "ln-314-review-repair-worker", args: "{identifier} repair")
Skill(skill: "ln-315-review-merge-worker", args: "{identifier} merge")
Skill(skill: "ln-316-review-refinement-worker", args: "{identifier} refinement")

ランタイム契約

必ず読むこと： references/loop_health_contract.md を読み込んでください。

ランタイムファミリー：

• evaluation-runtime

識別子：

• ストーリーモードでは story-{storyId}
• プランレビューでは plan-{slug}

フェーズの順序：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVERY
3. PHASE_2_AGENT_LAUNCH
4. PHASE_3_EVIDENCE_LANES
5. PHASE_4_DOCS
6. PHASE_5_REPAIR
7. PHASE_6_MERGE
8. PHASE_7_REFINEMENT
9. PHASE_8_APPROVAL
10. PHASE_9_SELF_CHECK

フェーズポリシー：

• delegate_phases = [PHASE_3_EVIDENCE_LANES, PHASE_4_DOCS, PHASE_5_REPAIR, PHASE_6_MERGE, PHASE_7_REFINEMENT]
• aggregate_phase = PHASE_6_MERGE
• report_phase = PHASE_8_APPROVAL
• cleanup_phase = PHASE_9_SELF_CHECK
• self_check_phase = PHASE_9_SELF_CHECK
• agent_resolve_before = [PHASE_6_MERGE]
• required_phases_when_advisor_available = [PHASE_7_REFINEMENT]

並列処理のルール

並行して実行できるもの：

• 外部エージェント
• ln-311
• ln-312
• ローカルリポジトリの調査と証拠の収集

逐次実行のみ：

• ln-313
• ln-314
• ln-315
• ln-316
• 承認とステータスの変更

ワークフロー

フェーズ 0：設定

1. mode、識別子、ストレージモードを解決します。
2. ストーリーまたはプランの対象を解決します。
3. 以下を含む評価ランタイムマニフェストを作成します。
   • expected_agents
   • required_research=true
   • 正確な phase_order
   • phase_policy
   • レポートパス
4. ランタイムを開始します。

node references/scripts/evaluation-runtime/cli.mjs start \
  --skill ln-310 \
  --identifier {identifier} \
  --manifest-file .hex-skills/evaluation/{identifier}_manifest.json

5. フェーズ 0 のチェックポイントを記録します。

フェーズ 1：検出

1. 対象のアーティファクトを正確に実体化します。
2. 現在のモードに必要なメタデータのみを読み込みます。
3. mode=story の場合は、Story と子タスクを解決します。
4. mode=plan_review の場合は、プランファイルを解決します。
5. researchgraph ファイルに変更があった場合、または対象が H##、G##、実行 ID、ベンチマークマニフェスト、準備完了の主張を参照している場合は、読み取り専用の researchgraph 検証／監査を実行し、その結果を検証証拠として添付します。
6. 解決済みの参照情報を付けて、フェーズ 1 のチェックポイントを記録します。

フェーズ 2：エージェントの起動

1. エージェントのヘルスチェックを実行します。
2. .hex-skills/environment_state.json で無効化されているエージェントを除外します。
3. 利用可能なエージェントがない場合：
   • agents_skipped_reason を記録します
   • フェーズ 2 のチェックポイントを記録します
   • 続行します
4. それ以外の場合：
   • エージェントごとのプロンプトを作成します
   • 利用可能な各エージェントを起動します
   • 起動した各エージェントを登録します。

node references/scripts/evaluation-runtime/cli.mjs register-agent \
  --skill ln-310 \
  --identifier {identifier} \
  --agent {name} \
  --prompt-file {promptPath} \
  --result-file {resultPath} \
  --metadata-file {metadataPath}

5. health_check_done、agents_available、agents_required、および任意の agents_skipped_reason を付けて、フェーズ 2 のチェックポイントを記録します。
6. ドメイン判定の前に、各外部エージェントの結果を分類します。
   • rate_limited、tool_missing、auth_missing、permission_denial、asked_question は、トランスポート／オペレーターの状態です。
   • アーティファクトや所見によるドメイン証拠がない限り、これらを NO-GO に変換しないでください。
   • アドバイザー／セッションの失敗が繰り返される場合は、ループの健全性を記録し、再試行の有用性がなくなったら一時停止します。

フェーズ 3：証拠レーン

このフェーズは、必須の並列証拠バリアです。

1. 以下を含む worker_plan を作成します。
   • レーン research の ln-311（必須）
   • レーン findings の ln-312（必須）
2. 計画したすべてのワーカーを並列で起動します。
3. ワーカーの実行中に、ローカルリポジトリの調査を続け、追加の証拠を収集します。
4. エージェントと随時同期しますが、マージまではエージェントの完了を待たないでください。
5. 各ワーカーの概要を以下の形式で記録します。

node references/scripts/evaluation-runtime/cli.mjs record-worker-result \
  --skill ln-310 \
  --identifier {identifier} \
  --payload-file {childSummaryArtifactPath}

調査はすべてのモードで必須です。

• 公式ドキュメントまたは標準規格
• MCP Ref
• ライブラリまたはフレームワークが関係する場合は Context7
• 最新のウェブ上のベストプラクティス調査

mode=story の場合、所見では引き続き減点ポイントの証拠とカバレッジ分析を提示する必要があります。

フェーズ 4：ドキュメント

1. mode=story でドキュメントの変更が必要な場合は、ln-313-review-docs-worker を実行します。
2. mode=plan_review では、作成するドキュメントの差分がない場合に限りスキップします。
3. ワーカーの概要、または明示的なスキップ理由を記録します。

フェーズ 5：修正

1. ln-314-review-repair-worker を通じて、受け入れた低リスクの修正を適用します。
2. 修正ロジックを調査レーンや所見レーンに統合しないでください。
3. 概要と、クリーンアップに関する証拠を記録します。

フェーズ 6: マージ

前提条件:

• 計画されたすべてのエビデンスワーカーが解決済みである
• 必要なすべてのエージェントが解決済み、または明示的にスキップされている

手順:

1. マージバリアでエージェントを一度同期します:

node references/scripts/evaluation-runtime/cli.mjs sync-agent --skill ln-310 --identifier {identifier}

2. ln-315-review-merge-worker を実行します。
3. 重複を排除します:
   • ローカルの指摘事項
   • ワーカーの指摘事項
   • エージェントの指摘事項
   • 過去のレビュー履歴
4. 裏付けのない主張を却下します。
5. 検証済みで承認された変更のみを適用します。
6. aggregation_summary でフェーズ 6 をチェックポイントします。

フェーズ 7: リファインメント

このフェーズを決してスキップしないでください。 フェーズ 7 はすべてのモード (story、plan_review) に適用されます。 唯一有効なスキップ理由は、ヘルスチェックで利用可能なアドバイザーがいないことです。 モードはスキップ理由にはなりません。複雑さはスキップ理由にはなりません。時間はスキップ理由にはなりません。 アドバイザーが利用可能な状態で ln-316 を実行せずにフェーズ 7 をチェックポイントしようとしているなら — 止まってください。あなたはエラーを犯しています。

モード	フェーズ 7 は必須?	スキップは許可?
story	はい	いいえ (アドバイザーが利用できない場合のみ)
plan_review	はい	いいえ (アドバイザーが利用できない場合のみ)

アドバイザーが利用可能な場合、フェーズ 7 は必須です。コーディネーターは、ln-316 からの記録された review-refinement ワーカーサマリーなしにフェーズ 7 をチェックポイントしてはなりません (MUST NOT)。ヘルスチェックでアドバイザーが利用可能だったにもかかわらずリファインメントサマリーが存在しない場合、ランタイムの advance コマンドはその遷移を拒否します。

ln-316-review-refinement-worker を実行します。リファインメントは 2 段階のステートマシンを使用します:

• ステージ 1: 3 つの並列アドバイザーセッション (dry_run_executor、new_dev_tester、adversarial_reviewer)
• ステージ 2: ステージ 1 の結果をマージした後の 1 つの逐次アドバイザーセッション (final_sweep)

ルール:

• 4 つすべての観点が必須です
• ステージ 1 は並列で実行され、ステージ 2 はステージ 1 のマージ後に実行されます
• 各観点 = agent_runner.mjs を介した独立したアドバイザープロセス (ホストネイティブのサブエージェントではありません (NOT))
• 起動されたすべてのプロセスにはクリーンアップのエビデンスが必要です
• アドバイザーセッションの失敗は agent_runner.mjs の failure_class、progress_signals、session_usable を使用します。分類された転送失敗は、ドメインの指摘事項になるのではなく、一時停止または延期されます
• リファインメントトレースは必須です
• ランタイムの sync-agent を介してアドバイザーの結果を待ちます。Claude ホストは可観測性のために Monitor を使用してもよいです (may)

フェーズ 8: 承認

ストーリーモード:

1. マージ後およびリファインメント後の状態から最終ゲートを計算します。
2. 最終評価モデル:

指標	変更前	変更後	意味
ペナルティポイント	ln-312 から	ln-314 から	0 = すべて修正済み
準備スコア	clamp(1,10,10-floor(before/5))	clamp(1,10,10-floor(after/5))	品質 (1-10)
アンチハルシネーション	—	ln-311 から	VERIFIED/FLAGGED
AC カバレッジ	—	N/N	100% = 合格
ゲート	—	GO/NO_GO	最終判定

3. ゲートルール:
   • GO = penalty_after=0 かつ FLAGGED 項目なし かつ ac_coverage=100%
   • NO_GO = それ以外
   • カバレッジ: 80-99% = +3 ペナルティおよび強制的な NO_GO
   • カバレッジ: <80% = +5 ペナルティおよび強制的な NO_GO
4. GO の場合: ストーリーのステータスを Todo に変更します。kanban_board.md を APPROVED に更新します。
5. ステータス遷移を一度再試行します。失敗した場合 → NO_GO。
6. 基準ごとのペナルティの変更前/変更後の内訳を含む、ユーザー向けのレビュー出力を書き込みます。

プランモード:

• ワークフローを変更せずに最終レビュー出力を書き込みます

コーディネーターサマリーを書き込みます:

node references/scripts/evaluation-runtime/cli.mjs record-summary \
  --skill ln-310 \
  --identifier {identifier} \
  --payload '{...evaluation-coordinator summary...}'

フェーズ 9: セルフチェック

必須チェック:

• ランタイムが起動された
• ディスカバリーチェックポイントが存在する
• エージェントのヘルスが記録されている
• 必須の調査が完了している
• 必要なすべてのワーカーサマリーが記録されている
• マージ前に必要なすべてのエージェントが解決されている
• マージサマリーが存在する
• アドバイザーが利用可能だった場合にリファインメントトレースが存在する
• バックグラウンドクリーンアップのエビデンスが記録されている
• クリーンアップが検証されている
• コーディネーターサマリーが記録されている
• 最終結果が記録されている

次に:

node references/scripts/evaluation-runtime/cli.mjs complete --skill ln-310 --identifier {identifier}

サマリー契約

コーディネーターのサマリー種別：

• evaluation-coordinator

推奨ペイロードフィールド：

• status
• final_result
• report_path
• worker_count
• agent_count
• issues_total
• severity_counts
• warnings
• cleanup_verified
• research_completed
• penalty_before
• penalty_after
• readiness_score
• ac_coverage
• gate（GO/NO_GO）
• flagged_items

完了の定義

• 評価ランタイムを開始済み
• 必須の調査を完了し、記録済み
• 読み取り専用のエビデンスレーンを並行して実行済み
• ドキュメント作成、修復、マージ、改善、承認を順次実行済み
• 必須のワーカーサマリーをすべて記録済み
• マージ前に必須のエージェントをすべて解決済み
• アドバイザーが利用可能な場合は改善を実行済み。ヘルスチェックでアドバイザーが利用できない場合に限り、SKIPPED としている
• クリーンアップのエビデンスを記録し、検証済み
• evaluation-coordinator サマリーを作成済み
• ランタイムが正常に完了済み

メタ分析

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

コーディネーターの実行後に求められた場合は、プロトコルのセクション 7 に従ってセッションを分析し、最終レビュー結果とともにプロトコル形式の出力を含めます。

リファレンス

• ランタイム：references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md
• 調査：references/evaluation_research_contract.md、references/research_tool_fallback.md、references/plan_review_pipeline.md
• 並列処理：references/evaluation_parallelism_policy.md
• ワーカー：../ln-311-review-research-worker/SKILL.md、../ln-312-review-findings-worker/SKILL.md、../ln-313-review-docs-worker/SKILL.md、../ln-314-review-repair-worker/SKILL.md、../ln-315-review-merge-worker/SKILL.md、../ln-316-review-refinement-worker/SKILL.md
• 検証基準：references/phase2_research_audit.md、references/penalty_points.md
• 補助的な検証リファレンス：references/cross_reference_validation.md、references/dependency_validation.md、references/domain_patterns.md、references/templates/mcp_ref_findings_template.md、references/premortem_validation.md、references/quality_validation.md、references/risk_validation.md、references/solution_validation.md、references/standards_validation.md、references/structural_validation.md、references/traceability_validation.md、references/workflow_validation.md

---

バージョン： 8.0.0 最終更新日： 2026-03-22