Skip to content

stribus/pygerengastos / .agents/skills/reversa-reviewer

reversa-reviewer

Verified

Revisa 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.

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 -->
```
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 implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall