legacy-archaeologist

Analyze legacy codebases to map entry points, data flows, and dependencies.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/k1lgor/virtual-company --skill legacy-archaeologist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: legacy-archaeologist
Source: https://github.com/k1lgor/virtual-company/tree/main/skills/25-legacy-archaeologist
Command: npx skills add https://github.com/k1lgor/virtual-company --skill legacy-archaeologist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Legacy software often lacks documentation, making it hard to understand architecture, data flows, and dependencies.

Core Features & Use Cases

  • Discovery of entry points, data flows, and dependencies to map the true structure.
  • Assessment of dead code, hot spots, and risk areas to inform a refactoring strategy.
  • Planning and documentation of incremental migration paths with clear action items.

Quick Start

Analyze a legacy codebase to sketch an initial map and refactoring plan.

Frequently Asked Questions about legacy-archaeologist

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

FAQPage Schema
How do I analyze a legacy codebase to map dependencies and data flow?

Analyzing a legacy codebase involves discovering entry points, mapping data flows, and tracing dependencies to reveal the true structural architecture. This process documents unknown project structure, assesses risk areas like dead code, and informs an incremental refactoring strategy.

What is the best way to plan a refactor for a messy project with no documentation?

Planning a refactor for undocumented code requires assessing hot spots and dead code to determine risk areas. You then document an incremental migration path with clear action items, ensuring a structured and safe transition for the messy project.

Can I discover entry points and assess risk in an unknown codebase?

Yes, you can discover entry points and assess risk in an unknown codebase by mapping its structure and tracing dependencies. This identifies hot spots and dead code, providing a clear report of risk areas to inform your refactoring strategy.

How does incremental refactoring migration work for legacy code?

Incremental refactoring migration works by first mapping the existing architecture and assessing risk areas. It then plans a step-by-step migration path with clear action items, allowing you to safely update the legacy codebase without a full rewrite.

When do I need to map dependencies and document structure in a legacy project?

You need to map dependencies and document structure in a legacy project when it lacks documentation and you must understand its architecture. This is essential before planning refactors, assessing dead code, or updating data flows to ensure safe modifications.