codebase-archaeology

Extract business rules, data flows, and dependencies into structured archaeology reports.

2|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/Executioner1939/claude-code-skills --skill codebase-archaeology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-archaeology
Source: https://github.com/Executioner1939/claude-code-skills/tree/main/skills/codebase-archaeology
Command: npx skills add https://github.com/Executioner1939/claude-code-skills --skill codebase-archaeology

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematically reverse-engineers and analyzes existing codebases to extract business rules, map data flows, trace dependencies, assess risk, and produce transformation plans.

Core Features & Use Cases

  • Two-phase analysis orchestrating code archaeology across multiple lenses to reveal the structure and rules of a codebase.
  • Supports multiple lenses (migration, architecture, decomposition, risk, documentation, debt, test strategy) to tailor outputs to objectives.
  • Produces structured artifacts (archaeology reports, known unknowns, risk registers, and transformation plans) that guide planning and modernization.
  • Ideal for migrations, architectural changes, due diligence, and comprehensive codebase understanding.

Quick Start

Invite the codebase-archaeologist agent against a target repository to generate a complete archaeology report.

Frequently Asked Questions about codebase-archaeology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract business rules and data flows from an existing codebase?

To extract business rules and data flows from a codebase, you can perform a systematic reverse-engineering analysis that identifies and catalogs dependencies, producing a structured archaeology report to guide transformations.

What is the best way to assess risk and trace dependencies for architectural restructuring?

Assessing risk and tracing dependencies for architectural restructuring is best handled by applying a risk lens during codebase analysis, which generates a risk register alongside a structured transformation plan.

Can I use codebase analysis to support migration and documentation generation across different languages?

Yes, codebase analysis supports migration and documentation generation across diverse languages and architectures by orchestrating multiple analytical lenses to reveal structural rules and produce supporting templates.

How do I generate a transformation plan for a legacy system modernization?

Generating a transformation plan for legacy modernization involves reverse-engineering the existing codebase to map data flows and extract business rules, resulting in structured artifacts that guide the modernization process.

What lenses are available for codebase decomposition and debt analysis?

Available lenses for codebase decomposition and debt analysis include migration, architecture, risk, documentation, debt, and test strategy, allowing you to tailor the reverse-engineering output to specific objectives.