archaeologist
Detect legacy patterns and guide compatibility decisions.
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.
| name | archaeologist |
|---|---|
| description | Detect legacy patterns and guide compatibility decisions. |
| short-description | Legacy detection |
Purpose
Avoid inconsistent refactors by mapping old vs new patterns.
Steps
- Identify legacy and modern patterns.
- Recommend global modernization or local consistency.
- Record trade-offs in an ADR.