🇺🇸English

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. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.

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/audit_worker_core_contract.md.

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

| Category | What to Check

---|---|---
1 | Hierarchy & Links | CLAUDE.md is root; all docs reachable via links; no orphaned files; no broken links
2 | Single Source of Truth | No content duplication; duplicates replaced with links to source; clear ownership
3 | Proactive Compression | Eliminate verbose/redundant content; prose to tables; remove meaningless info; compress even under-limit files; see size_limits.md
4 | Requirements Compliance | Correct sections; within size limits; no code blocks (tables/ASCII diagrams/text only); stack-appropriate doc links
5 | Freshness Indicators | Detect staleness signals: dates >6 months in content, deprecated API/tool references, TODO/FIXME markers, placeholder text left in place; deep fact-checking handled by dedicated worker
6 | Legacy Cleanup | No history sections; no "was changed" notes; no deprecated info; current state only
7 | Stack Adaptation | Links/refs match project stack; no Python examples in .NET project; official docs for correct platform

Severity Mapping

Scoring Algorithm

MANDATORY READ: Load shared/references/audit_worker_core_contract.md and shared/references/audit_scoring.md.

Output Format

MANDATORY READ: Load shared/references/audit_worker_core_contract.md and shared/templates/audit_worker_report_template.md.

Write report to {output_dir}/611-structure.md with category: "Documentation Structure" and checks: hierarchy_links, ssot, compression, requirements_compliance, freshness_indicators, 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

MANDATORY READ: Load shared/references/audit_worker_core_contract.md.

• 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)
• No deep fact-checking: Detect staleness signals only (dates, deprecated refs, TODO markers)
• 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

MANDATORY READ: Load shared/references/audit_worker_core_contract.md.

• 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

• Size limits and targets: references/size_limits.md
• Detailed checklist: references/audit_checklist.md

Version: 1.0.0 Last Updated: 2026-03-01

Weekly Installs

106

Repository

levnikolaevich/…e-skills

GitHub Stars

262

First Seen

Mar 1, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

cursor99

codex97

opencode96

gemini-cli96

github-copilot96

amp96