ln-612-semantic-content-auditor

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

セマンティックコンテンツ監査担当（L3 ワーカー）

タイプ： L3 ワーカー

プロジェクトのドキュメントが意味的に適切かどうかを監査する専門ワーカーです。

目的と範囲

• ドキュメントの内容が、明記された SCOPE と宣言されたドキュメント種別に合致していることを確認します
• 内容がプロジェクトの目標に沿っていること（価値への貢献）を確認します
• 重要度、場所、修正案を含む、構造化された指摘事項をコーディネーターに返します
• コードベースに照らした事実確認は行いません

対象ドキュメント

プロジェクトのドキュメントにのみ呼び出されます（リファレンス／タスクは対象外）。

ドキュメント	確認の重点
AGENTS.md / CLAUDE.md	入口となる手順が適切な範囲に収まり、参照しやすく、無関係な内容を含んでいないこと
docs/README.md	ナビゲーションの範囲が適切で、説明が関連性を保っていること
docs/documentation_standards.md	標準がこのプロジェクト種別に適用できること
docs/principles.md	原則がプロジェクトのアーキテクチャに関連していること
docs/project/requirements.md	要件の範囲が網羅的で、古くなった項目がないこと
docs/project/architecture.md	アーキテクチャの範囲がすべてのレイヤーを網羅していること
docs/project/tech_stack.md	技術スタックの範囲がプロジェクトの実態と一致していること
docs/project/api_spec.md	API の範囲がすべてのエンドポイントグループを網羅していること
docs/project/database_schema.md	スキーマの範囲がすべてのエンティティを網羅していること
docs/project/design_guidelines.md	デザインの範囲が現在使用中のすべてのコンポーネントを網羅していること
docs/project/infrastructure.md	インフラストラクチャの範囲がすべてのデプロイ先を網羅していること
docs/project/runbook.md	ランブックの範囲がセットアップと運用を網羅していること

対象外： docs/tasks/、docs/reference/、docs/presentation/、tests/

入力

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

呼び出しごとに、コーディネーターから以下を受け取ります。

フィールド	説明
doc_path	監査対象ドキュメントのパス（例：docs/project/architecture.md）
output_dir	レポート出力先のディレクトリ（contextStore から取得）
project_root	プロジェクトのルートパス
tech_stack	検出された技術スタック

このドキュメント専用ワーカーでは、hex-line の使用は任意です。利用可能な場合は、大きな Markdown ファイルの概要把握に使用してください。利用できない場合は、組み込みの Read/Grep/Glob/Bash を使って作業を続け、MCP が利用できないことを理由に作業を中断しないでください。

ワークフロー

フェーズ 1：ヘッダーと契約の抽出

1. まずドキュメントのヘッダーと冒頭のセクションを読みます
2. 以下を解析します。
   • SCOPE
   • DOC_KIND
   • DOC_ROLE
   • READ_WHEN
   • SKIP_WHEN
   • PRIMARY_SOURCES
3. SCOPE タグがない場合は、ドキュメントの種別から推定します
4. DOC_KIND がない場合は、共有契約から期待される値を推定します
5. 明記された目的と、ルーティングの境界を記録します

フェーズ 2：文書の種類を考慮したセマンティック監査

文書の種類に応じて評価します。

DOC_KIND	主なセマンティック上の問い
index	効率よく目的の情報へ案内し、事実の詳細を過剰に詰め込んでいませんか？
reference	正確で、十分に網羅されており、必要な情報を探しやすいですか？
how-to	手順は実行可能で、正しい順序になっていますか？
explanation	適切なメンタルモデルと根拠を構築できていますか？
record	意思決定の経緯と結果が記録されていますか？

明示されたスコープと文書の種類に照らして文書を分析します。

チェック	指摘の種類
スコープに役立っていないセクション	OFF_TOPIC
スコープの要素が網羅されていない	MISSING_COVERAGE
スコープを超える過剰な詳細	SCOPE_CREEP
別の場所に重複している内容	SSOT_VIOLATION

エージェント指示ファイルのチェック（監査対象ファイルが AGENTS.md または CLAUDE.md の場合に適用）：

チェック	指摘の種類	重大度	推奨事項
スタイル／フォーマットのルール（インデント、引用符のスタイル、末尾の空白、命名規則）	NOT_A_LINTER	WARN	Biome、Prettier、Ruff、EditorConfig、または Claude Code の Stop フックに移してください。指示ファイルはすべてのセッションに読み込まれ、約100個の命令という予算のトークンを消費します。決定論的なツールなら、こうしたルールを無料で適用できます。
ルートにある条件付き／普遍的でないルール（when working on src/api/...、if modifying the billing service、for the Z service）	NON_UNIVERSAL_RULE	WARN	paths: フロントマターのフィルターを指定して .claude/rules/*.md に移してください（Anthropic 標準のパススコープ機能）。普遍的でないルールがあると、<system-reminder> ラッパーを通じて Claude Code がファイル全体を無視するように偏ることがあります。
手動の tasks/lessons.md を参照する自己改善ループのルール	OBSOLETE_PATTERN	WARN	削除してください。Claude Code の組み込み自動メモリ ~/.claude/projects/<project>/memory/ がすでに同じ役割を果たすため、並行して手動管理する規約はコンテキストを無駄に消費します。

3項目はいずれも WARN のみです。人間による判断が必要なためです（スタイルルールは意図的なものか？ 条件付きのスコープは実際にはプロジェクト全体に適用されるのか？）。各指摘で references/agent_instructions_writing_guide.md を引用してください。

読み取り方針：

• まずヘッダーと冒頭のセクションを読む
• 判断に必要な本文のセクションだけを読む
• 文書全体を確認しないと安全に判断できない場合に限り、全文を読む

スコアリング：

• 10/10：すべての内容がスコープに沿っており、スコープが完全に網羅されている
• 8～9/10：多少のスコープ外の内容、または小さな抜けがある
• 6～7/10：一部のセクションが目的と合わず、網羅性も部分的
• 4～5/10：大幅に目的と合わず、重要な抜けがある
• 1～3/10：文書が明示された目的を果たしていない

フェーズ 3：スコアリングとレポート

スコープとの整合性に基づいて最終スコアを算出します。

overall_score = weighted_average(coverage, relevance, focus)

網羅性：スコープがどの程度完全に扱われているか。関連性：どの程度の内容がスコープに役立っているか。焦点：スコープ外の内容がどの程度ないか。

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

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

出力形式

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

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

{output_dir}/ln-612--{doc-slug}.md にレポートを書き込みます。doc-slug は文書のファイル名から生成します（例：architecture、tech_stack、agents_md）。

category: "Semantic Content" を指定し、チェック項目には scope_alignment、not_a_linter、non_universal_rule、obsolete_pattern を含めます（最後の3項目は、対象が AGENTS.md または CLAUDE.md の場合にのみ該当します）。

references/audit_summary_contract.md に従ってサマリーを返してください。

summaryArtifactPath が指定されていない場合は、スタンドアロン実行時のサマリーを .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json に書き込み、必要に応じて同じサマリーを構造化出力にも含めてください。

Report written: .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-612--architecture.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)

重要なルール

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

• 段階的に読む： セクションを優先して読み、安全に判断するために必要な場合にのみ全文を読みます
• スコープの推定： SCOPE タグがない場合は、ドキュメントのファイル名から想定されるスコープを推定します
• ドキュメントの種類を考慮する： 汎用的な単一の評価基準ではなく、ドキュメントの目的に基づいて判断します
• 誤検知を避ける： 誤った指摘を報告するくらいなら、問題を見逃す方が適切です
• 位置を正確に示す： 指摘には必ず行番号を含めます
• 修正可能な提案： すべての指摘に、具体的な修正案を付けます
• 事実確認を行わない： パス、バージョン、エンドポイントをコードと照合して検証しないでください
• 共有クラスレジストリ： ドキュメントの境界は docs_quality_contract.md で定められています。ファイルごとに別のスコープルールを作らないでください

完了の定義

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

• ヘッダーの要件を抽出または推定した
• コンテンツとスコープの整合性を分析した（OFF_TOPIC、MISSING_COVERAGE、SCOPE_CREEP、SSOT_VIOLATION）
• DOC_KIND に従って意味的な判断を適用した
• ペナルティアルゴリズムを使用してスコアを算出した
• {output_dir}/ln-612--{doc-slug}.md にレポートを出力した（単一の Write 呼び出しによるアトミックな書き込み）
• コントラクトに従って概要を出力した

参照ファイル

• 監査出力スキーマ： references/audit_output_schema.md

---

バージョン： 2.0.0 最終更新日： 2026-03-01