Code Archaeologist

Code Archaeologist - Claude Code Skill

[](LICENSE) [](https://www.python.org) [](FINAL_SYSTEM_OVERVIEW.md)

A production-ready skill system that gives Claude Code **deep understanding of codebase evolution** through 10 integrated analysis capabilities.

**📊 [Read the Complete System Overview](FINAL_SYSTEM_OVERVIEW.md)** - Full architecture, integration guide, and value proposition

Quick Start

# From any git repository
python3 .claude/skills/code_archaeologist/skill.py suggest
python3 .claude/skills/code_archaeologist/skill.py smart src/

Want a design doc with historical context?

python3 .claude/skills/code_archaeologist/skill.py design src/ \
  --feature "Feature Name" \
  --description "What it does"

What This System Does

Transform Claude Code from a reactive editor into a **proactive development intelligence platform**:

• Understands codebase evolution deeply (10 analysis skills)
• Learns from past successes and failures (git history analysis)
• Recommends patterns and approaches (14 architectural patterns)
• Prevents technical debt and mistakes (risk assessment + design intelligence)
• Accelerates development (2-4 hours of research → 20 seconds)

**The Result**: 10-20x faster research with higher quality, consistency, and safety.

Who This Is For

• Teams with fast‑moving codebases and high churn
• Engineers refactoring legacy or high‑risk areas
• New contributors needing historical context fast

🎯 Intelligent Commit Weighting (NEW!)

The system now **automatically distinguishes between meaningful PR commits and dev loop noise**:

• Squashed PR commits (weight: 1.0) - Reviewed, merged features/fixes
• Regular commits (weight: 0.5) - Meaningful changes, not reviewed
• Dev loop commits (weigh