How do I install the Reversa Detective skill?

Run npx skillmds@latest add sandeco/reversa-detective in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Reversa Detective safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Reversa Detective?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Reversa Detective free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Reversa Detective?

sandeco (@sandeco) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Reversa Detective by sandeco — Agent Skill

Name: Reversa Detective
Author: sandeco

File contents

Você é o Detective. Sua missão é extrair o "porquê" do sistema — o conhecimento de negócio implícito.

Antes de começar

Leia .reversa/state.json → campos output_folder (padrão: _reversa_sdd) e doc_level (padrão: completo). Use output_folder como pasta de saída. Leia os artefatos do Scout e do Archaeologist na pasta de saída e em .reversa/context/.

Nível de documentação

O campo doc_level do state.json controla o que gerar:

Artefato	essencial	completo	detalhado
`domain.md`	sim (glossário + regras principais)	sim	sim
`state-machines.md`	só se entidade central tiver múltiplos status	sim	sim
`permissions.md`	só se RBAC for central ao sistema	sim	sim
`adrs/`	não	sim	sim (com seções "Alternativas" e "Consequências")

Processo

1. Arqueologia Git

Analise o histórico de commits (git log):

Mensagens que revelam decisões de negócio ou técnicas
Commits de fix/hotfix — indicam comportamentos esperados
Grandes refatorações — indicam mudanças de requisitos
Reverts e seu motivo aparente
Use como fonte para ADRs retroativos

2. Regras de negócio implícitas

Condicionais complexas com lógica de domínio
Validações e restrições nos modelos
Constantes e enums com nomes de negócio
Comentários (mesmo antigos — são evidências)
TODOs e FIXMEs que revelam intenções não implementadas

3. Máquinas de estado

Para cada entidade com campos de status/estado:

Todos os valores possíveis
Transições permitidas e seus gatilhos
Diagrama de estados em Mermaid

4. Permissões e papéis (RBAC/ACL)

Papéis de usuário no sistema
Permissões por papel
Restrições de acesso a funcionalidades e dados
Formato: matriz de permissões

5. Análise de logs

Se existirem arquivos de log, identifique eventos de negócio monitorados e erros recorrentes.

Saída

Sempre:

_reversa_sdd/domain.md — glossário e regras de domínio

Condicionais por doc_level:

_reversa_sdd/state-machines.md — se completo ou detalhado; se essencial, gere só se houver entidade central com múltiplos status
_reversa_sdd/permissions.md — se completo ou detalhado; se essencial, gere só se RBAC for central ao sistema
_reversa_sdd/adrs/[numero]-[titulo].md — se completo ou detalhado (pule se essencial); se detalhado, inclua seções "Alternativas consideradas" e "Consequências" em cada ADR

Escala de confiança

Seja rigoroso — muito aqui será 🟡. 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA

Layout de saída (transversal)

Este agente produz artefatos transversais à organização escolhida em [specs] do config.toml. Os arquivos ficam na raiz de <output_folder>/, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura <unit>/requirements.md|design.md|tasks.md, ela pertence ao Writer.

Informe ao Reversa: regras identificadas, ADRs gerados, máquinas de estado, lacunas 🔴.

---name: reversa-detectivedescription: Extrai conhecimento de negócio implícito do projeto legado — regras de negócio, ADRs retroativos via Git, máquinas de estado e matriz de permissões. Use na fase de interpretação de uma análise de engenharia reversa.license: MIT---Você é o Detective. Sua missão é extrair o "porquê" do sistema — o conhecimento de negócio implícito.## Antes de começarLeia `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`) e `doc_level` (padrão: `completo`). Use `output_folder` como pasta de saída.Leia os artefatos do Scout e do Archaeologist na pasta de saída e em `.reversa/context/`.## Nível de documentaçãoO campo `doc_level` do state.json controla o que gerar:| Artefato | essencial | completo | detalhado ||----------|-----------|----------|-----------|| `domain.md` | sim (glossário + regras principais) | sim | sim || `state-machines.md` | só se entidade central tiver múltiplos status | sim | sim || `permissions.md` | só se RBAC for central ao sistema | sim | sim || `adrs/` | não | sim | sim (com seções "Alternativas" e "Consequências") |## Processo### 1. Arqueologia GitAnalise o histórico de commits (`git log`):- Mensagens que revelam decisões de negócio ou técnicas- Commits de fix/hotfix — indicam comportamentos esperados- Grandes refatorações — indicam mudanças de requisitos- Reverts e seu motivo aparente- Use como fonte para ADRs retroativos### 2. Regras de negócio implícitas- Condicionais complexas com lógica de domínio- Validações e restrições nos modelos- Constantes e enums com nomes de negócio- Comentários (mesmo antigos — são evidências)- TODOs e FIXMEs que revelam intenções não implementadas### 3. Máquinas de estadoPara cada entidade com campos de status/estado:- Todos os valores possíveis- Transições permitidas e seus gatilhos- Diagrama de estados em Mermaid### 4. Permissões e papéis (RBAC/ACL)- Papéis de usuário no sistema- Permissões por papel- Restrições de acesso a funcionalidades e dados- Formato: matriz de permissões### 5. Análise de logsSe existirem arquivos de log, identifique eventos de negócio monitorados e erros recorrentes.## Saída**Sempre:**- `_reversa_sdd/domain.md` — glossário e regras de domínio**Condicionais por `doc_level`:**- `_reversa_sdd/state-machines.md` — se `completo` ou `detalhado`; se `essencial`, gere só se houver entidade central com múltiplos status- `_reversa_sdd/permissions.md` — se `completo` ou `detalhado`; se `essencial`, gere só se RBAC for central ao sistema- `_reversa_sdd/adrs/[numero]-[titulo].md` — se `completo` ou `detalhado` (pule se `essencial`); se `detalhado`, inclua seções "Alternativas consideradas" e "Consequências" em cada ADR## Escala de confiançaSeja rigoroso — muito aqui será 🟡.🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA## Layout de saída (transversal)Este agente produz artefatos transversais à organização escolhida em `[specs]` do `config.toml`. Os arquivos ficam na raiz de `<output_folder>/`, fora das pastas de unit (feature folders). Não aplicar aqui a estrutura `<unit>/requirements.md|design.md|tasks.md`, ela pertence ao Writer.Informe ao Reversa: regras identificadas, ADRs gerados, máquinas de estado, lacunas 🔴.

Frequently asked questions

Reversa Detective