Documentation Manager
Comprehensive documentation lifecycle management powered by an MCP (Model Context Protocol) server. Automates documentation creation, maintenance, quality assessment, and synchronization for software projects.
Features
- Automatic change detection - Track code changes and affected documentation
- Link validation - Find broken links and missing assets
- Quality assessment - Evaluate docs against 7 quality criteria
- Symbol tracking - TreeSitter-based code symbol extraction (Python, Go, TypeScript, Rust)
- Dependency mapping - Automatic code-to-docs relationships
- Platform detection - Auto-detect MkDocs, Sphinx, Hugo, Docusaurus, etc.
- Documentation migration - Restructure docs with git history preservation
Installation
Claude Code Plugin (Recommended)
The doc-management plugin provides an interactive documentation workflow with specialized agents and quick commands, powered by the doc-manager MCP server.
Install:
# Add the marketplace
/plugin marketplace add arimxyer/doc-manager-mcp
# Install the plugin (automatically configures MCP server)
/plugin install doc-manager@doc-manager-suite
What you get:
@doc-expert - Documentation expert who analyzes state and directs next steps@doc-writer - Content specialist who creates/updates docs/doc-status, /doc-sync, /doc-quality - Quick commands for common workflows
Example workflow:
You: "Set up documentation management"
Claude: [Invokes @doc-expert to detect platform and initialize]
You: "/doc-sync"
Claude: [Detects changes, updates docs via @doc-writer, validates, updates baselines]
You: "Check quality before release"
Claude: [Runs quality assessment and shows actionable findings]
See the Claude Code Plugin guide for details.
Standalone MCP Server
For using the MCP server without the plugin.
Claude Code:
claude mcp add doc-manager --scope project -- uvx doc-manager-mcp
Claude Desktop:
Add to your claude_desktop_config.json:
{
"mcpServers": {
"doc-manager": {
"command": "uvx",
"args": ["doc-manager-mcp"]
}
}
}
Restart your client. Your AI assistant can then use the 8 doc-manager tools directly.
Other MCP clients:
See Installation Guide for local development setup and alternative installation methods.
Quick Start
With Claude Code plugin:
You: "Set up documentation management for this project"
You: "/doc-sync"
With any MCP client:
Ask your AI assistant to initialize documentation management, check sync status, or validate quality. The AI will use the appropriate tools (docmgr_init, docmgr_sync, etc.) automatically.
See Quick Start Guide for complete workflows and examples.
MCP Server Tools
The doc-manager MCP server provides 8 tools for documentation management:
docmgr_init - Initialize doc-manager for a project (modes: existing, bootstrap)docmgr_detect_changes - Detect code/doc changes (read-only, never writes baselines)docmgr_detect_platform - Auto-detect documentation platform (MkDocs, Sphinx, Hugo, etc.)docmgr_validate_docs - Check for broken links, missing assets, invalid code snippetsdocmgr_assess_quality - Evaluate documentation against 7 quality criteriadocmgr_update_baseline - Update all baselines atomically (repo, symbols, dependencies)docmgr_sync - Orchestrate change detection + validation + quality + baseline updatesdocmgr_migrate - Restructure/migrate documentation with git history preservation
See Tools Reference for complete API documentation.
Architecture
Baseline System
Doc-manager maintains 3 baseline files in .doc-manager/memory/:
repo-baseline.json - File checksums and metadatasymbol-baseline.json - TreeSitter code symbols (functions, classes, config fields)dependencies.json - Code-to-docs dependency mappings
Workflow:
1. docmgr_init → Create initial baselines
2. (make code changes)
3. docmgr_detect_changes → Detect changes (read-only)
4. (update documentation)
5. docmgr_update_baseline → Refresh baselines
Or use docmgr_sync mode="resync" to combine steps 3-5.
Configuration
Example .doc-manager.yml:
arimxyer