librarian

Documentation consolidation requires analyzing prose content to group related concepts together, resolving semantic contradictions, and ensuring referential integrity across all markdown files to create a logically organized knowledge base.

Semantic organization analyzes prose content to group related ideas by conceptual affinity rather than file location. It identifies explanations split across multiple files and unrelated topics crammed into one document, then refactors them into topically coherent markdown files.

Finding contradictions involves analyzing prose content across a specified documentation path to identify conflicting explanations. The process detects semantic inconsistencies between files and helps consolidate them into a single authoritative document while updating all related references.

Refactoring documentation organization maintains referential integrity by detecting and updating links when consolidating scattered explanations or separating mixed topics. It ensures all markdown file references remain valid after restructuring content by concept instead of file structure.

Documentation refactoring operates on any specified directory path, making it suitable for large projects with hundreds of markdown files. It analyzes prose content at scale to detect fragmentation, mixed topics, and semantic contradictions across the entire knowledge base.