v0.1: Codebase analysis MCP server + CLI

[EduardPetraeus]

Problem

Developers spend 20+ minutes understanding unfamiliar codebases. Existing tools measure metrics but none explain a codebase the way a senior developer would.

Proposed Solution

Build an MCP server + CLI that analyzes git history, code structure, naming patterns, and dependency graphs to reverse-engineer institutional knowledge.

MCP Server Tools

• analyze_codebase — full codebase analysis with pattern detection
• explain_decision — explain architectural decisions from git history
• generate_claude_md — generate the CLAUDE.md that should have existed
• map_tribal_knowledge — map undocumented conventions

CLI

• archaeologist dig ./my-repo — full analysis report

Dependencies

• Python 3.12+, MCP SDK, Click, GitPython

Success Criteria

• MCP server with 4 tools functional
• CLI produces useful output
• Git history analysis working
• Pattern detection identifies common patterns
• Generated docs are useful on 5+ real repos
• Published to PyPI

Tracking

Deep research BRIEF: ~/deep-research/active/codebase-archaeologist/BRIEF.md