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/questions-template.md
View on GitHub# Template — _reversa_sdd/questions.md
Este arquivo é gerado pelo Revisor e preenchido pelo usuário.
---
## Como o Revisor cria este arquivo
Para cada lacuna 🔴 que só o usuário pode resolver, crie uma entrada:
```markdown
## Pergunta [N]
**Contexto:** [Onde no sistema surgiu esta dúvida — módulo, função, linha]
**Spec afetada:** [`_reversa_sdd/<unit>/{requirements|design|tasks}.md`]
**Pergunta:** [Pergunta direta, sem ambiguidade]
**Impacto:** [O que muda na spec dependendo da resposta]
**Resposta:** <!-- preencha aqui -->
```
---
## Como o usuário responde
O usuário deve:
1. Preencher o campo `**Resposta:**` de cada pergunta
2. Avisar ao Revisor quando terminar (digitar `reversa` ou "respondi as perguntas")
---
## Como o Revisor processa as respostas
Após receber aviso do usuário:
1. Leia o arquivo completo
2. Para cada pergunta com resposta preenchida:
- Atualize a spec correspondente
- Reclassifique o item conforme a resposta (🔴→🟢 ou 🔴→🟡)
- Marque a pergunta como `✅ Respondida` acima do campo Resposta
3. Para perguntas sem resposta: mantenha como 🔴 no relatório final
4. Atualize `confidence-report.md` com os novos percentuais
---
## Exemplo de arquivo gerado
```markdown
# Perguntas para Validação — [Nome do Projeto]
> Gerado pelo Revisor em [data]
> Responda cada pergunta e me avise quando terminar.
---
## Pergunta 1
**Contexto:** Módulo `auth` — função `validateSession()` em `src/auth/session.ts:47`
**Spec afetada:** [`_reversa_sdd/auth/requirements.md`]
**Pergunta:** A sessão expira por inatividade ou apenas por tempo absoluto? O código usa `lastActivity` mas não há lógica de expiração visível.
**Impacto:** Se for por inatividade, a spec precisa incluir o tempo máximo de idle e o comportamento ao renovar a sessão.
**Resposta:** <!-- preencha aqui -->
---
## Pergunta 2
**Contexto:** Módulo `orders` — constante `MAX_ITEMS_PER_ORDER = 50` em `src/orders/constants.ts:12`
**Spec afetada:** [`_reversa_sdd/orders/requirements.md`]
**Pergunta:** O limite de 50 itens por pedido é uma regra de negócio ou um limite técnico temporário? Há planos de aumentar?
**Impacto:** Se for regra de negócio, precisa constar como 🟢 nas restrições. Se for técnico, deve ser 🟡 com nota de revisão futura.
**Resposta:** <!-- preencha aqui -->
```
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 |