パス: ファイルパス (references/, ../ln-*) はこのスキルディレクトリからの相対パスです。

プロジェクト構造監査ツール

タイプ: L3 ワーカー

物理的なプロジェクト構造が意図されたアーキテクチャを反映しているかを監査する L3 ワーカーです。

目的とスコープ

• モジュール、ドメイン、レイヤーレイアウト、フレームワーク配置、ジャンク・ドロワーディレクトリを監査
• アーキテクチャの操作と強制を困難にする構造のドリフトを検出
• コードレベルの境界チェックを物理的な構造の証拠で補完
• MOVE_MODULE、SPLIT_JUNK_DRAWER、ALIGN_DOMAIN_STRUCTURE を発行
• コンプライアンススコア(X/10)を計算

スコープ外:

• .gitignore、.dockerignore、テンポラリファイル、ビルドアーティファクト、プラットフォーム残存物、大規模バイナリ
• インポートレベルのレイヤー違反
• パッケージセキュリティ、環境ファイルの衛生管理、ランタイムライフサイクルチェック
• ファイルの移動・削除

入力

必須読込: references/audit_worker_core_contract.md を読み込んでください。 ツールポリシー: ホストの AGENTS.md MCP プリファレンスに従い、ホストポリシーが不在の場合または MCP 動作が不明確な場合にのみ references/mcp_tool_preferences.md と references/mcp_integration_patterns.md を読み込んでください。

tech_stack、architecture、codebase_root、output_dir、domain_mode、scan_path を含む contextStore を受け取ります。

アーキテクチャサマリーが構造の調査結果を大幅に改善する場合は hex-graph を最初に使用してください。利用可能な場合は、ローカルコード、設定、マニフェストの読込に hex-line を最初に使用してください。MCP が利用不可、非対応、またはインデックス化されていない場合は、組込みの Read/Grep/Glob/Bash で継続し、レポート内でフォールバックを記述してください。

ワークフロー

検出ポリシー: 2 層検出（候補スキャン、次にコンテキスト検証）を使用します。検証方法があいまいな場合にのみ references/two_layer_detection.md を読み込んでください。

1. コンテキストを解析 -- ドメイン認識スコープまたはコードベースルートから scan_root を決定
2. テックスタックと意図された構造を検出
   • 必須読込: references/stack_detection.md を読み込んでください
   • 明示的なアーキテクチャドキュメント/設定がある場合はそれを優先し、ない場合はソースレイアウトから推論
3. 構造チェック(レイヤー1)を実行
   • フレームワークの予想されるソース位置
   • ドメイン/モジュールグループ化
   • レイヤーディレクトリレイアウト
   • ジャンク・ドロワーディレクトリ
   • 命名と配置の一貫性
4. コンテキスト(レイヤー2)を検証
   • 小規模プロジェクトは完全なドメイン/レイヤー分解を必要としない可能性
   • フレームワークの慣例は検出されたフレームワークにのみ適用
   • 混合レイアウトはアプリ/パッケージ/テストタイプで分割され、文書化されている場合は許容
5. 重大度、位置、アクション、対応時間、推奨事項とともに調査結果を収集
6. references/audit_scoring.md を使用してスコアを計算
7. {output_dir}/ln-646--{identifier}.md にレポートを作成
8. references/audit_summary_contract.md に従ってサマリーを返す

監査ルール

1. フレームワーク配置

概要: ソースファイルがフレームワークまたはスタック慣例の外に配置されている

検出: references/structure_rules.md を読み込み、検出されたスタックのルールのみを適用

重大度: ツーリング/ルーティングを破壊する場合は HIGH、保守性のドリフトは MEDIUM

アクション: MOVE_MODULE

2. ドメインとレイヤーレイアウト

概要: ドメインまたはレイヤーディレクトリが意図されたアーキテクチャを反映していない

検出:

• 文書化された、または推論されたドメイン/レイヤーと物理ディレクトリを比較
• 予想されるサブ構造がないドメインを検出
• プロジェクトに明確なモジュール構造がある場合、ルートまたは一般的なフォルダ内のソースファイルを検出

重大度: デフォルトは MEDIUM、構造が重要な所有権を隠す場合は HIGH

アクション: ALIGN_DOMAIN_STRUCTURE

3. ジャンク・ドロワー

概要: 一般的なディレクトリに関連のないモジュールが蓄積される

検出: utils、helpers、common、shared、services、lib などのディレクトリをチェックして、プロジェクト閾値を超える混在した無関係な責務がないか確認

重大度: 広範な混在した責務は MEDIUM、小規模な局所的ドリフトは LOW

アクション: SPLIT_JUNK_DRAWER

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

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

出力フォーマット

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

references/audit_summary_contract.md に従って JSON サマリーを作成してください。マネージドモードではカラーが runId と summaryArtifactPath の両方を渡し、スタンドアロンモードではワーカーが共有コントラクトに従って独自の実行スコープ付きアーティファクトパスを生成します。

レポートを {output_dir}/ln-646--{identifier}.md に書き込み、category: "Project Structure" とチェック: framework_placement、domain_layer_layout、junk_drawers を含めてください。

summaryArtifactPath がない場合は、.hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json の下にスタンドアロン実行時サマリーを作成し、オプションで同じサマリーを構造化出力でエコーしてください。

重要ルール

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

• 自動修正は不可: レポートのみで、ファイルの移動や削除は一切しない
• ユニークな視点: 物理的なアーキテクチャ構造のみを監査。ファイル衛生管理、無視ファイル、パッケージヘルス、環境衛生管理、インポートレベル境界、ランタイムライフサイクルは監査しない
• 自動検出、推測なし: 検出されたスタックのみにフレームワークルールを適用
• 常に証拠を含める: すべての調査結果にファイルパスを含める
• アクション必須: すべての調査結果は MOVE_MODULE、SPLIT_JUNK_DRAWER、ALIGN_DOMAIN_STRUCTURE を使用

完了の定義

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

• contextStore が正常に解析された
• scan_root が決定された
• テックスタックと意図された構造が検出された
• フレームワーク配置がチェックされた
• ドメイン/レイヤーレイアウトがチェックされた
• ジャンク・ドロワーディレクトリがチェックされた
• レイヤー2コンテキスト検証が適用された
• 重大度、位置、アクション、対応時間、推奨事項とともに調査結果が収集された
• references/audit_scoring.md に従ってスコアが計算された
• レポートが {output_dir}/ln-646--{identifier}.md に書き込まれた(アトミック単一 Write 呼び出し)
• サマリーがコントラクトに従って書き込まれた

---

バージョン: 1.0.0 最終更新: 2026-03-15