roll-doclisted

# roll-doc Four-phase legacy documentation automation (plus deep-read Phase 3b): scan → index → gap analysis → fill (directory-level) → deep read (cross-directory topics). Works on any project root. No manual mode switching — reads the project state and decides what to do. ## When to Use - Starting to work on a legacy project with scattered or missing documentation - `docs/INDEX.md` is out of date or doesn't exist yet - `roll-.dream` Scan 6 flagged undocumented modules (REFACTOR entry referencing roll-doc) - You want a complete picture of what's documented and what isn't ## When Not to Use - The project has up-to-date, maintained docs — no need to rebuild the index - You need authoritative documentation reviewed and approved (drafts only; human reviews and commits) - You want to write a specific known doc from scratch — write it directly ## Invocation ``` $roll-doc # Full four-phase run $roll-doc --dry-run # Phases 1–2 only; print Phase 3 plan without writing any files $roll-doc --force # Re-generate drafts even for existing files ``` ## Phase 1 — Scan & Index Scan the project root for all `*.md` files and known convention files. **Exclusions — never scan these directories:** ``` node_modules/ .git/ dist/ build/ .shared/ .roll/dream/ .roll/briefs/ ``` **Convention files — detect by filename anywhere in the tree:** ``` AGENTS.md CLAUDE.md GEMINI.md CONVENTIONS.md CONTRIBUTING.md ARCHITECTURE.md ADR-*.md ``` **Classifica