What problem does it solve? Legacy systems often lack documentation explaining why the code works the way it does. This Skill recovers that implicit business knowledge — business rules, state machines, permission matrices, and retroactive Architecture Decision Records (ADRs) — during the interpretation phase of a reverse engineering analysis. ## Core Features & Use Cases - Git Archaeology: Analyzes commit history (fixes, hotfixes, refactors, reverts) to reconstruct past business and technical decisions as retroactive ADRs. - Business Rule Extraction: Mines conditionals, validations, enums, constants, comments, and TODOs to build a domain glossary and rule catalog. - State Machines & Permissions: Generates Mermaid state diagrams for entities with status fields and RBAC/ACL permission matrices. - Use Case: During a legacy modernization project, run this Skill after the Scout and Archaeologist phases to produce domain.md, state-machines.md, permissions.md, and ADR files with confidence levels (confirmed, inferred, gap). ## Quick Start Ask the agent to run the reversa-detective interpretation phase on this repository to extract business rules, state machines, permissions, and retroactive ADRs into the output folder.
