code-doclisted

# Code-Doc — Adaptive Codebase Documentation A hybrid documentation generator that combines language-native extractors for API-level accuracy with LLM agents for synthesis, architecture narratives, and developer guides. Zero-config default — just point at a repo. --- ## Delegation Model **Scout orchestrates. Analysts write to files. Doc Writers fan out.** - **You are the Scout** — handle detection, planning, synthesis, and coordination - **Analyst agents** (`task(agent_type='explore')`) read code and write full analysis to `{project}/.codedoc/` files. They return only compact summaries (max 15 lines) to you. You hold summaries, not full analysis — this prevents context overflow. - **Doc Writer agents** (`task(agent_type='general-purpose')`) each read assigned `.codedoc/` files and produce one output document - **Reviewer agents** (`task(agent_type='explore')`) validate generated docs - All agents are stateless — provide complete context in each spawn The `.codedoc/` directory is transient — created at analysis start, consumed by doc writers, and cleaned up before handoff. Never commit it. Prefer adding `.codedoc/` to `.git/info/exclude` for the local run; only modify project `.gitignore` if the user explicitly approves that as part of the documentation plan or commit proposal. ### Analyst Output Protocol Every analyst agent must: 1. Write full analysis to their assigned `.codedoc/{name}-analysis.md` file 2. Cite source paths for material claims and include conf