reversa-detective

Extracts implicit business knowledge from legacy codebases into structured documentation.

Updated May 16, 2026
One-click install
npx skills add https://github.com/ricardops34/rcg-crm --skill reversa-detective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-detective
Source: https://github.com/ricardops34/rcg-crm/tree/main/.agents/skills/reversa-detective
Command: npx skills add https://github.com/ricardops34/rcg-crm --skill reversa-detective

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams uncover the hidden “why” behind legacy system behavior by converting implicit business knowledge into explicit, reviewable documentation.

Core Features & Use Cases

  • Git-based business archaeology: Extracts decision rationale from commit history (including fixes/hotfixes, refactors, reverts) to reconstruct retroactive ADRs.
  • Implicit rule extraction: Identifies domain validations, constraints, enums/constants, and TODO/FIXME hints that reveal unstated requirements.
  • State machines and RBAC mapping: Documents entity lifecycles with transitions and generates permission matrices when status/RBAC is central.

Quick Start

Run the reversa workflow in interpretacao to generate _reversa_sdd/domain.md and—based on doc_level—derive state machines, permissions, and retroactive ADRs from the project’s legacy artifacts and Git history.

Frequently Asked Questions about reversa-detective

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

FAQPage Schema
How do I extract business rules from a legacy codebase?

You extract business rules from a legacy codebase by analyzing Git commit history and system contexts to reconstruct implicit domain validations, state transitions, and access control permissions into structured markdown documentation.

What is the best way to generate ADRs from Git commit history?

Generating retroactive ADRs from Git history involves analyzing commits for fixes, refactors, and reverts to reconstruct past decision rationale, turning implicit historical changes into reviewable architecture decision records.

How do I map state machines and RBAC permissions from existing code?

Mapping state machines and RBAC from existing code requires analyzing entity lifecycles and domain constraints to document state transitions and generate permission matrices when access control is central to the system.

Can I document implicit domain validations and constraints from legacy system artifacts?

Yes, you can document implicit domain validations by extracting enums, constants, and TODO hints from legacy system artifacts and contexts, transforming unstated requirements into explicit structured documentation.

What level of documentation is generated when reverse engineering legacy behavior?

The documentation level generated when reverse engineering legacy behavior is gated by configuration settings, always producing a core domain markdown file while additionally deriving state machines, permission matrices, and retroactive ADRs based on the specified level.