stribus/pygerengastos / .agents/skills/reversa-detective
reversa-detective
VerifiedExtrai 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
SKILL.md
View on GitHub---
name: reversa-detective
description: 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
compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
metadata:
author: sandeco
version: "1.1.0"
framework: reversa
phase: interpretacao
---
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 🔴.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |