documentation-librarian

What problem does it solve?

The Documentation Librarian preserves correctness, consistency, and continuity across a repository's documentation by treating docs as a connected, versioned knowledge graph rather than a collection of isolated files.

Core Features & Use Cases

• Graph-based governance: maintains a coherent documentation graph and detects drift across README, SPEC, Reference, ADRs, and roadmaps.
• Incremental repairs: updates the necessary subtree of documents to preserve global consistency without rewriting unrelated content.
• Mode-based operation: supports Bootstrap, Relationship Repair (Mode 2B), and Controlled Refactor workflows; generates change reports and flags risks.
• Operational guidance: outputs minimal edits with explicit tags ([ASSUMPTION], [PENDING], [RISK], [SOURCE]) to preserve traceability.
• Use cases: stabilize cross-document invariants, align boundaries between docs, and verify document graph integrity.

Quick Start

1. Inventory the repo's docs graph using the provided graph index or map.
2. Identify drift between documents (README, SPEC, Reference, ADRs) and determine affected subtree.
3. Run a Mode 2B subtree repair to align the subtree, then generate a concise change report with explicit tags.