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.

Documentation Structure Auditor (L3 Worker)

Specialized worker auditing structural quality of project documentation.

Purpose & Scope

• Worker in ln-610 coordinator pipeline - invoked by ln-610-docs-auditor
• Audit documentation for structural quality across 7 categories
• Scan all .md files in project, build hierarchy from CLAUDE.md
• Return structured findings to coordinator with severity, location, recommendations
• Calculate compliance score (X/10) for Documentation Structure

Inputs (from Coordinator)

MANDATORY READ: Load shared/references/task_delegation_pattern.md#audit-coordinator--worker-contract for contextStore structure.

Receives contextStore with: tech_stack, project_root, output_dir.

Workflow

1. Parse Context: Extract tech stack, project root, output_dir from contextStore
2. Scan Docs: Find all .md files in project (CLAUDE.md, README.md, docs/**)
3. Build Tree: Construct hierarchy from CLAUDE.md outward links
4. Audit Categories 1-7: Run structural checks (see Audit Categories below)
5. Collect Findings: Record each violation with severity, location (file:line), effort estimate (S/M/L), recommendation
6. Calculate Score: Count violations by severity, calculate compliance score (X/10)
7. Write Report: Build full markdown report per shared/templates/audit_worker_report_template.md, write to {output_dir}/611-structure.md in single Write call
8. Return Summary: Return minimal summary to coordinator (see Output Format)

Audit Categories

Severity Mapping

Scoring Algorithm

MANDATORY READ: Load shared/references/audit_scoring.md for unified scoring formula.

Output Format

MANDATORY READ: Load shared/templates/audit_worker_report_template.md for file format.

Write report to {output_dir}/611-structure.md with category: "Documentation Structure" and checks: hierarchy_links, ssot, compression, requirements_compliance, actuality, legacy_cleanup, stack_adaptation.

Return summary to coordinator:

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

Critical Rules

• Do not auto-fix: Report violations only; coordinator aggregates for user
• Tech stack aware: Use contextStore tech_stack to apply stack-specific checks (e.g., .NET vs Node.js doc standards)
• Verify facts against code: Actively check every path, function name, API, config mentioned in docs
• Compress always: Size limits are upper bounds, not targets. A 100-line file instead of 300 is a win
• No code in docs: Documents describe algorithms in tables or ASCII diagrams. Code belongs in codebase
• Code is truth: When docs contradict code, report docs as needing update (not code)
• Delete, don't archive: Legacy content should be removed, not moved to "archive"
• Location precision: Always include file:line for programmatic navigation

Definition of Done

• contextStore parsed successfully (including output_dir)
• All 7 structural categories audited
• Findings collected with severity, location, effort, recommendation
• Score calculated using penalty algorithm
• Report written to {output_dir}/611-structure.md (atomic single Write call)
• Summary returned to coordinator

Reference Files

• Worker report template: shared/templates/audit_worker_report_template.md
• Audit scoring formula: shared/references/audit_scoring.md
• Audit output schema: shared/references/audit_output_schema.md
• Size limits and targets: references/size_limits.md
• Detailed checklist: references/audit_checklist.md

Version: 1.0.0 Last Updated: 2026-03-01