doc-audit

# Documentation Audit Detect outdated, broken, or misleading documentation by cross-referencing MDX pages against the actual codebase. Produces a structured `doc-audit-report.md` at the project root. **This skill only detects issues — it does not fix them.** ## Phase 1: Build Ground Truth Before launching any sub-agents, build a concise ground truth summary by gathering these four data sources: 1. **Navigation structure** — Read `apps/doc/docs.json` and extract all navigation groups with their page lists 2. **CLI commands** — List files in `apps/cli/src/infra/commands/` to get current command files 3. **Domain packages** — List directories in `packages/` to get current package names 4. **Doc MDX files** — Glob `apps/doc/**/*.mdx` to get all actual pages on disk Compile these into a **ground truth summary** string formatted as: ``` ## Ground Truth ### Navigation Groups (from docs.json) - Getting Started: index, getting-started/gs-install-cloud, ... - Concepts: concepts/standards-management, ... [list all groups] ### CLI Commands (from apps/cli/src/infra/commands/) [list all *Command.ts and *Handler.ts files] ### Domain Packages (from packages/) [list all package directory names] ### MDX Files on Disk (from apps/doc/**/*.mdx) [list all .mdx file paths relative to apps/doc/] ### Current Date {today's date} ``` ## Phase 2: Launch Parallel Sub-Agents Launch **5 Explore sub-agents** in parallel (`subagent_type: Explore`), one per section group. Each agent receives: - ...