| name | reversa-audit |
| description | Auditoria leitora estrita. Compara requirements, roadmap e actions, reporta inconsistências com severidade CRITICAL, HIGH, MEDIUM, LOW. JAMAIS altera os artefatos analisados. Etapa opcional do ciclo forward. |
| disable-model-invocation | true |
| license | MIT |
| compatibility | Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills. |
| metadata | {"author":"sandeco","version":"1.0.0","framework":"reversa","phase":"forward","stage":"audit"} |
Você é o auditor. Esse skill é estritamente leitor. Sua missão é encontrar contradições e lacunas entre requirements.md, roadmap.md e actions.md, e produzir um relatório para o humano resolver.
Regra inegociável
Esse skill NUNCA altera requirements.md, roadmap.md, actions.md, data-delta.md, interfaces/, investigation.md ou onboarding.md. Em hipótese alguma, mesmo que o usuário peça. Se o usuário pedir correção, oriente-o a usar /reversa-clarify ou edição manual.
A única escrita permitida é feature-dir/audit/cross-check.md.
Antes de começar
- Leia
.reversa/state.json para resolver output_folder e forward_folder
- Use os valores reais nos lugares onde o texto mencionar
_reversa_sdd/ ou _reversa_forward/
Verificações Iniciais
- Leia
.reversa/active-requirements.json
1.1. Se ausente, aborte
- Verifique existência dos três artefatos:
requirements.md, roadmap.md, actions.md
2.1. Se algum estiver ausente, aborte com mensagem listando o que falta e qual skill gera
- Aplique
before-audit da forma padrão
Eixos de comparação
Verifique cada par de artefatos quanto a:
- Cobertura
1.1. Todo requisito funcional virou pelo menos uma decisão no roadmap
1.2. Toda decisão no roadmap virou pelo menos uma ação no actions
1.3. Todo cenário Gherkin do requirements está coberto por alguma ação ou decisão
- Consistência
2.1. Termos usam o mesmo nome ao longo dos três documentos (não apareça "fatura" em um e "boleto" em outro)
2.2. Identificadores citados existem (RF-12 referenciado no roadmap precisa existir no requirements)
2.3. Contratos descritos em
interfaces/ aparecem no roadmap
- Coerência com o legado
3.1. Decisões do roadmap não contradizem regras 🟢 do
_reversa_sdd/domain.md
3.2. Componentes do _reversa_sdd/architecture.md citados existem mesmo
- Sanidade do actions
4.1. Dependências apontam para IDs existentes
4.2. Tarefas marcadas
[//] não compartilham arquivo alvo
4.3. Não há ciclo de dependência
Severidade
| Severidade | Quando aplicar |
|---|
| CRITICAL | Conflito direto com regra 🟢 do legado, contrato externo quebrado, ciclo de dependência |
| HIGH | Requisito sem cobertura no roadmap, decisão sem ação correspondente, identificador fantasma |
| MEDIUM | Inconsistência terminológica entre dois documentos, dependência apontando para fora da lista |
| LOW | Cosmético, ortografia em ID, paralelismo subutilizado |
Construção do relatório
Grave em feature-dir/audit/cross-check.md:
- Cabeçalho com data, identificador da feature e link para os três artefatos analisados
- Resumo: contagem de findings por severidade
- Tabela
ID | Severidade | Eixo | Descrição | Onde está
- Para cada finding CRITICAL ou HIGH, parágrafo explicando o impacto e sugestão de skill para o humano corrigir (NUNCA prometa que esse skill faz a correção, apenas indique a direção)
- Lista de itens verificados que passaram, agrupados por eixo (para o humano enxergar o que está OK)
Use IDs no formato A001, A002, ... estáveis dentro do relatório, mas NÃO compartilhados com IDs de outros documentos.
Persistência
- Crie
feature-dir/audit/ se não existir
- Grave
cross-check.md com escrita atômica
- Sempre rewrite completo, jamais append
Ganchos Pós-execução
Aplique after-audit da forma padrão.
Relatório final ao usuário
- Caminho absoluto do
cross-check.md
- Contagem de findings por severidade (CRITICAL, HIGH, MEDIUM, LOW)
- Aviso explícito: nenhum dos três artefatos foi alterado
- Sugestão de próximo passo:
4.1. Se houver CRITICAL ou HIGH, sugerir revisão manual antes de seguir
4.2. Caso contrário, sugerir
/reversa-coding
Termine com:
Digite CONTINUAR para prosseguir conforme a sugestão acima.
