doc-optimizerlisted

# Documentation Optimizer **Version:** 1.5 **Last Updated:** 2026-04-03 **Status:** ACTIVE **Waves:** 5 waves with 13 agents **Output:** `.claude/state/doc-optimizer/` **What This Does:** Wave-based orchestrator that deploys 13 parallel agents across 5 waves to analyze, auto-fix, report, and recommend improvements for every non-archived document in the repository. **Differentiator from `/audit-documentation`:** That skill is a read-only diagnostic (18 agents, report-only). This skill is a **repair + enhancement tool** -- it auto-fixes formatting/headers/links, reports issues as JSONL, AND generates actionable improvement recommendations. --- ## When to Use - Tasks related to doc-optimizer - User explicitly invokes `/doc-optimizer` ## When NOT to Use - When the task doesn't match this skill's scope -- check related skills - When a more specialized skill exists for the specific task ## Overview ``` Wave 0: Discovery (Orchestrator, sequential) Build file inventory, link graph, metadata index ~2 min Wave 1: Independent Analysis (3 parallel + 1 sequential) 1A: Format & Lint Fixer (AUTO-FIX) 1C: External Link Validator (REPORT) 1D: Content Accuracy Checker (MIXED) 1B: Header & Metadata Fixer (AUTO-FIX) <- sequential after 1A ~8-12 min Wave 2: Graph-Dependent Analysis (4 parallel) 2A: Internal Link Fixer (MIXED) 2B: Orphan & Connectivity (REPORT) 2C: Freshness & Lifecycle (REPORT) 2D: Cross-Ref & Deps (REPORT) ~8-12 min Wave 3: Issue Synthesis (2