ln-645-architecture-modernization-auditor

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

アーキテクチャ近代化監査

タイプ： L3 ワーカー

アーキテクチャレベルの簡素化と近代化の機会を見つける L3 ワーカーです。

目的と範囲

• 時代遅れの独自アーキテクチャ機構、過剰に作り込まれた拡張ポイント、回避可能なアーキテクチャ上の間接化を監査します
• 現在のアーキテクチャ上の価値をもたらさず、保守コストを増加させる機構を特定します
• 移行時の安全性に配慮した近代化に関する指摘を生成します
• SIMPLIFY_ARCHITECTURE、RETIRE_CUSTOM_MECHANISM、または CONSOLIDATE_EXTENSION_POINT を出力します
• 適合スコアを算出します（X/10）

入力

必須の読み込み： references/audit_worker_core_contract.md と references/mcp_tool_preferences.md を読み込みます。 ツールポリシー：ホストの AGENTS.md が対象範囲外となる独立したサブエージェントとして実行される場合があるため、ファイルの読み取り、検索、編集にはまず hex-line MCP を使用してください。MCP の動作が不明確な場合にのみ references/mcp_integration_patterns.md を読み込みます。

次の情報を含む contextStore を受け取ります：tech_stack、architecture、codebase_root、output_dir、domain_mode、scan_path。

参照情報、アーキテクチャ指標、または実装間の関係が近代化に関する指摘の質を大きく高める場合は、まず hex-graph を使用してください。利用可能な場合、ローカルコードの読み取りにはまず hex-line を使用してください。MCP が利用できない、未対応、またはインデックス化されていない場合は、組み込みの Read/Grep/Glob/Bash を使用して続行し、レポートにフォールバックしたことを記載してください。

ワークフロー

検出ポリシー：2 層検出（候補のスキャン、続いてコンテキストの検証）を使用します。検証方法が曖昧な場合にのみ references/two_layer_detection.md を読み込みます。

1. コンテキストを解析 -- ドメインを考慮したスコープまたはコードベースのルートから scan_root を特定します
2. 近代化候補を特定（レイヤー 1）
   • 実装が 1 つしかない独自のプラグイン／拡張システム
   • 使用範囲が限られている、手作りのサービスロケーター、レジストリ、ディスパッチャー、バス、アダプター、またはファクトリー
   • 非推奨のコメントや未使用の互換性分岐があるレガシーアーキテクチャ機構
   • 同じ問題を解決する並行したアーキテクチャ機構
3. アーキテクチャ上の価値を検証（レイヤー 2）
   • その機構はフレームワークまたはデプロイモデルで必須ですか？ -> スキップします
   • 外部の利用者がいる公開拡張 API ですか？ -> 優先度を下げるか、スキップします
   • 複数の実際の実装がある、変化しやすい境界を分離していますか？ -> スキップします
   • 置き換えが単なるパッケージの交換またはユーティリティの書き換えにすぎませんか？ -> スキップします
4. 指摘事項を収集し、重大度、場所、アクション、作業量、移行リスク、推奨事項を記録します
5. references/audit_scoring.md を使用してスコアを算出します
6. {output_dir}/ln-645--{identifier}.md にレポートを作成します
7. references/audit_summary_contract.md に従って概要を返します

監査ルール

1. 時代遅れの独自機構

概要： プロジェクトで不要になった後も残されている独自のアーキテクチャ機構

検出：

• Legacy、Compat、Shim、Adapter、Registry、Plugin、Extension、ServiceLocator、Dispatcher、EventBus を検索します
• 参照と実装の数を確認します
• 非推奨のコメントや ADR があれば確認します

重大度： クリティカルパス上の機構は HIGH、広範に使われているがクリティカルではない機構は MEDIUM、局所的な整理は LOW

アクション： RETIRE_CUSTOM_MECHANISM

2. 過剰に作り込まれた拡張ポイント

概要： 実装が 1 つしかなく、実際に変化するポイントもない拡張またはプラグインアーキテクチャ

検出：

• 1 つの実装だけで使用されているインターフェース／抽象クラス
• 登録済みの型が 1 つしかないファクトリーまたはレジストリ
• 1 つのプラグインがハードコードされた、設定駆動のプラグイン読み込み

重大度： デフォルトは MEDIUM、間接化によってクリティカルなフローが見えにくくなっている場合は HIGH

アクション： CONSOLIDATE_EXTENSION_POINT

3. 並列するアーキテクチャメカニズム

内容： 2つ以上のアーキテクチャメカニズムが、異なるモジュールで同じ問題を解決しています。

検出方法：

• 複数のディスパッチ／レジストリ／イベントメカニズム
• 複数のサービス合成スタイル
• 同じ境界に対する複数のアダプター規約

重大度： 一貫性のない動作を引き起こす場合は HIGH、主に保守コストを増やす場合は MEDIUM

アクション： SIMPLIFY_ARCHITECTURE

スコアリングアルゴリズム

必読： references/audit_scoring.md を読み込んでください。

出力形式

必読： references/templates/audit_worker_report_template.md を読み込んでください。

references/audit_summary_contract.md に従って JSON サマリーを作成してください。マネージドモードでは呼び出し元が runId と summaryArtifactPath の両方を渡します。スタンドアロンモードでは、ワーカーが共通コントラクトに従って、実行単位の成果物パスを独自に生成します。

{output_dir}/ln-645--{identifier}.md に、category: "Architecture Modernization" と、チェック項目 obsolete_mechanisms、overbuilt_extension_points、parallel_mechanisms を含むレポートを作成してください。

summaryArtifactPath がない場合は、スタンドアロンのランタイムサマリーを .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json に書き込み、構造化出力にも同じサマリーを出力してかまいません。

重要なルール

すでに読み込まれている references/audit_worker_core_contract.md を適用してください。

• 自動修正禁止： レポートのみを作成し、アーキテクチャを書き換えないでください。
• 独自の観点： アーキテクチャレベルのモダナイゼーションのみを監査してください。パッケージの健全性、CVE、汎用ユーティリティの置き換え、コードの複雑さ、ランタイム設定の衛生状態は監査しないでください。
• パッケージの推奨禁止： オープンソースの代替品を検索したり、依存関係の入れ替えを推奨したりしないでください。
• 根拠必須： モダナイゼーションに関するすべての指摘に、実装数、参照根拠、移行リスクを含めてください。
• アクション必須： すべての指摘で SIMPLIFY_ARCHITECTURE、RETIRE_CUSTOM_MECHANISM、CONSOLIDATE_EXTENSION_POINT のいずれかを使用してください。

完了の定義

すでに読み込まれている references/audit_worker_core_contract.md を適用してください。

• contextStore が正常に解析された
• scan_root が特定された
• 古くなったカスタムメカニズムを確認した
• 作り込みすぎた拡張ポイントを確認した
• 並列するアーキテクチャメカニズムを確認した
• Layer 2 のアーキテクチャ価値検証を適用した
• 重大度、場所、アクション、工数、移行リスク、推奨事項を含む指摘を収集した
• references/audit_scoring.md に従ってスコアを算出した
• {output_dir}/ln-645--{identifier}.md にレポートを出力した（Write を1回だけ使用したアトミックな書き込み）
• コントラクトに従ってサマリーを出力した

---

バージョン： 1.0.0 最終更新日： 2026-02-26