パス: ファイルパス (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 を読み込んでください。

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

完了の定義