reversa-detective

Extract implicit business knowledge from legacy projects via Git history and code.

1|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/stribus/pygerengastos --skill reversa-detective-stribus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-detective
Source: https://github.com/stribus/pygerengastos/tree/main/.agents/skills/reversa-detective
Command: npx skills add https://github.com/stribus/pygerengastos --skill reversa-detective-stribus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extract implicit business knowledge from legacy software projects, including rules of business, ADRs traced through Git history, machine states, and RBAC/permissions models, enabling clearer interpretation and safer evolution.

Core Features & Use Cases

  • Git archaeology to surface historical business decisions, rationale, and refactoring notes from repository commits.
  • Implicit domain understanding: extract domain concepts, validations, constraints, and access controls from code and comments.
  • Artifact generation: produce domain.md, state-machines.md, permissions.md, and ADRs to document decisions and governance.

Quick Start

Invoke the detective on your project to generate domain knowledge artifacts from the existing codebase 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 implicit business knowledge from legacy code?

Extracting implicit business knowledge from legacy code involves analyzing Git history and codebase logic to surface historical decisions, domain constraints, and permission models. This process generates structured artifacts like domain.md and ADRs to document the project's rules.

What is the best way to document permissions and state machines in an existing codebase?

Documenting permissions and state machines in an existing codebase is best achieved by reverse-engineering the code to extract access controls and machine states. This generates dedicated permissions.md and state-machines.md files according to a configurable documentation level.

How does Git archaeology help recover architecture decision records from a project?

Git archaeology recovers architecture decision records by tracing historical commits, refactoring notes, and business rationale embedded in repository history. This surfaces past technical decisions and governance logic, enabling safer evolution of legacy software.

Can I generate domain documentation for legacy software without explicit comments?

You can generate domain documentation for legacy software without explicit comments by analyzing the code's implicit validations, constraints, and logic. This extracts the embedded domain knowledge and produces a comprehensive domain.md artifact.

Does this approach require specific dependencies or components to analyze repository history?

This approach requires no specific dependencies or components to analyze repository history. It operates directly on your existing codebase and Git commits to identify implicit domain knowledge and generate documentation artifacts.