aio-doc-writerlisted

# Codebase Oracle ```bash SCRIPTS="${CLAUDE_PLUGIN_ROOT}/skills/aio-doc-writer/scripts" ``` ## Environment - GitNexus: !`npx gitnexus status 2>/dev/null && echo "AVAILABLE" || echo "NOT INSTALLED"` Comprehensive architecture documentation powered by GitNexus knowledge graph combined with Oracle direct documentation writing and LSP precision analysis. **Core Philosophy:** Oracle **writes all documentation from scratch** using GitNexus's knowledge graph (structure, dependencies, clusters, flows, hybrid search) combined with LSP type-aware analysis and direct source code reading. **What GitNexus Provides:** A precomputed knowledge graph — nodes (functions, classes, modules), edges (imports, calls, inheritance), clusters (functional communities with cohesion scores), execution flows from entry points, and hybrid search (BM25 + semantic). All from a single `npx gitnexus analyze`. **What LSP Provides:** Type-aware precision — hover info, exact reference counts, caller tracing, diagnostics, rename safety. **What Oracle Provides:** All written documentation — module docs, architecture analysis, key flows, dependency narratives, failure modes, design rationale, and decision guidance. ## Documentation Intent Contract Before writing or updating any docs, declare this contract: - **Audience**: Who will use this doc (`new engineer`, `oncall`, `feature owner`, `refactor owner`). - **Primary tasks**: Top 2-3 questions the reader should answer quickly. - **Decision horizon**: What