archaeologist

CheekyCodexConjurer's avatarfrom CheekyCodexConjurer

Detect legacy patterns and guide compatibility decisions.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

The Archaeologist Claude skill is a specialized tool for software modernization and technical debt management. It automates the detection of legacy code patterns and provides expert guidance on compatibility decisions, helping engineering teams maintain codebase consistency. By mapping old versus new patterns and documenting trade-offs in Architecture Decision Records (ADRs), it ensures that refactoring efforts are strategic, well-documented, and aligned with modern architectural standards.

Use Cases

  • Legacy Code Auditing: Systematically identify deprecated API usages, outdated design patterns, or legacy libraries within a complex codebase to plan migration paths.
  • Refactoring Strategy Guidance: Determine whether to pursue a global modernization of a specific module or maintain local consistency to minimize regression risks during incremental updates.
  • Technical Debt Documentation: Automatically generate and record the rationale behind architectural trade-offs in ADRs, ensuring future developers understand why specific legacy patterns were retained or replaced.
namearchaeologist
descriptionDetect legacy patterns and guide compatibility decisions.
short-descriptionLegacy detection

Purpose

Avoid inconsistent refactors by mapping old vs new patterns.

Steps

  1. Identify legacy and modern patterns.
  2. Recommend global modernization or local consistency.
  3. Record trade-offs in an ADR.