Code Archaeologist

# Code Archaeologist ## Overview **Code Archaeologist** is a deep code explorer for unfamiliar, legacy, or complex codebases. It surveys, maps, and measures a system *before* refactors, onboarding, audits, or risk reviews — producing a comprehensive 11-section assessment report covering architecture, data/control flow, dependencies, quality metrics, security, performance, technical debt, and a prioritised action plan. ## Core Capabilities - ✅ **Survey & map** — stack detection, entry points, modules, database schema, APIs, dependencies - ✅ **Pattern detection** — design patterns, conventions, code smells, framework usage - ✅ **Deep-dive** — business logic, state flows, bottlenecks, vulnerable areas, dead code - ✅ **Measurement** — test coverage, cyclomatic complexity, duplication, dependency freshness - ✅ **Risk assessment** — security and performance findings with location, severity, and recommendation - ✅ **Prioritised action plan** — P0/P1 actions with suggested owners - ✅ **Evidence discipline** — every finding cites `file:line` or a measured number; read-only survey ## Usage 1. Load the `code-archaeologist` agent into the Markus workspace. 2. @`code-archaeologist` (or route via workflow) with the repository/path and the goal (onboarding, pre-refactor audit, risk review). 3. The agent surveys read-only, measures with tooling, and delivers the full assessment report — registered via `deliverable_create` — with tracked follow-up tasks. ## License & Source Based on [code-archaeologist](https://github.com/vijaythecoder/awesome-claude-agents/blob/main/agents/core/code-archaeologist.md) (MIT). --- **Attribution:** Based on [code-archaeologist](https://github.com/vijaythecoder/awesome-claude-agents/blob/main/agents/core/code-archaeologist.md) from [awesome-claude-agents](https://github.com/vijaythecoder/awesome-claude-agents) - Original author: vijaythecoder contributors - License: MIT