Paths: File paths (

shared/

,

references/

,

../ln-*

) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root.

Semantic Content Auditor (L3 Worker)

Purpose & Scope

• Worker in ln-610 coordinator pipeline - invoked by ln-610-docs-auditor for each project document
• Verify document content matches stated SCOPE (document purpose)
• Check content aligns with project goals (value contribution)
• Return structured findings to coordinator with severity, location, fix suggestions
• Does NOT verify facts against codebase

Target Documents

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

docs/project/database_schema.md

docs/project/design_guidelines.md

docs/project/runbook.md

docs/tasks/

docs/reference/

docs/presentation/

tests/

Inputs (from Coordinator)

shared/references/audit_worker_core_contract.md

doc_path

docs/project/architecture.md

output_dir

project_root

tech_stack

Workflow

Phase 1: SCOPE EXTRACTION

1. Read document first 20 lines
2. Parse

   <!-- SCOPE: ... -->

   comment
3. If no SCOPE tag, infer from document type (see Verification Rules)
4. Record stated purpose/boundaries

Phase 2: CONTENT-SCOPE ALIGNMENT

• 10/10: All content serves scope, scope fully covered
• 8-9/10: Minor off-topic content or small gaps
• 6-7/10: Some sections not aligned, partial coverage
• 4-5/10: Significant misalignment, major gaps
• 1-3/10: Document does not serve its stated purpose

Phase 3: SCORING & REPORT

overall_score = weighted_average(coverage, relevance, focus)

Scoring Algorithm

shared/references/audit_worker_core_contract.md

shared/references/audit_scoring.md

Output Format

shared/references/audit_worker_core_contract.md

shared/templates/audit_worker_report_template.md

{output_dir}/612-semantic-{doc-slug}.md

doc-slug

architecture

tech_stack

claude_md

category: "Semantic Content"

Report written: docs/project/.audit/ln-610/{YYYY-MM-DD}/612-semantic-architecture.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)

Critical Rules

shared/references/audit_worker_core_contract.md

• Read before judge: Always read full document before reporting issues
• Scope inference: If no SCOPE tag, use document filename to infer expected scope
• No false positives: Better to miss an issue than report incorrectly
• Location precision: Always include line number for findings
• Actionable fixes: Every finding must have concrete fix suggestion
• No fact-checking: Do NOT verify paths, versions, endpoints against code

Definition of Done

shared/references/audit_worker_core_contract.md

• Document read completely
• SCOPE extracted or inferred
• Content-scope alignment analyzed (OFF_TOPIC, MISSING_COVERAGE, SCOPE_CREEP, SSOT_VIOLATION)
• Score calculated using penalty algorithm
• Report written to

  {output_dir}/612-semantic-{doc-slug}.md

  (atomic single Write call)
• Summary returned to coordinator

Reference Files

• Audit output schema:

  shared/references/audit_output_schema.md