stribus/pygerengastos / .agents/skills/reversa-reviewer
reversa-reviewer
VerifiedRevisa criticamente as especificações geradas pelo reversa-writer — encontra inconsistências, reclassifica confiança e gera perguntas para validação humana. Use na fase de revisão de uma análise de engenharia reversa.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.4 KB |
| references/confidence-report-template.md | markdown | 1.5 KB |
| references/confidence-rules.md | markdown | 2.6 KB |
| references/questions-template.md | markdown | 2.3 KB |
references/confidence-rules.md
View on GitHub# Regras de Classificação de Confiança
Use esta escala em **toda** afirmação nas specs. Sem exceções.
## Definições
| Símbolo | Nome | Significado |
|---------|------|-------------|
| 🟢 | CONFIRMADO | Extraído diretamente do código — pode ser citado com arquivo e linha |
| 🟡 | INFERIDO | Deduzido de padrões, nomes, convenções ou contexto — pode estar errado |
| 🔴 | LACUNA | Não foi possível determinar pelo código — requer validação humana |
## Quando usar cada nível
### 🟢 CONFIRMADO
- O comportamento está explícito no código (if/else, return, throw)
- O valor é uma constante ou enum definido no código
- A regra está em um comentário descritivo junto ao código relevante
- Existe um teste automatizado que cobre exatamente esse comportamento
- A DDL/migration define a constraint diretamente
### 🟡 INFERIDO
- O nome da função/variável sugere o comportamento, mas não há lógica explícita
- O comportamento é consistente com convenções do framework (ex: soft delete em Eloquent)
- Há indícios no código mas a lógica completa não está visível no escopo analisado
- A regra foi inferida de múltiplos exemplos semelhantes, não de uma definição única
- Comentário antigo ou TODO que pode não refletir o estado atual
### 🔴 LACUNA
- A funcionalidade é referenciada mas não implementada no código visível
- A lógica depende de configuração externa não acessível (variável de ambiente, banco, API)
- O comportamento esperado contradiz o que está no código (possível bug ou lógica oculta)
- Código gerado ou compilado sem acesso ao source original
- Regra de negócio que só existe na cabeça dos stakeholders
---
## Reclassificação durante revisão
### Upgrade: 🟡 → 🟢
Condições: encontrar evidência direta no código que confirma a afirmação.
Ação: anote a evidência (arquivo + linha) na spec.
### Upgrade: 🔴 → 🟡
Condições: encontrar indícios suficientes para uma inferência razoável.
Ação: reformule a afirmação como inferência, não certeza.
### Upgrade: 🔴 → 🟢
Condições: o usuário confirma com evidência concreta (ex: "sim, essa é a regra").
Ação: atualize a spec e registre a confirmação.
### Downgrade: 🟢 → 🟡
Condições: encontrar contradição entre a spec e o código real.
Ação: sinalize a contradição e reclassifique.
### Downgrade: 🟡 → 🔴
Condições: encontrar evidência de que a inferência estava errada.
Ação: reclassifique e crie pergunta para o usuário se necessário.
---
## Regra de ouro
**Quando houver dúvida, use o nível mais baixo.**
Uma 🔴 honesta é mais útil do que uma 🟡 enganosa.
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 |