Skip to content

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

reversa-inspector

Verified

Quinto agente do Time de Migração. Define como provar que o sistema novo é comportamentalmente equivalente ao legado, com critérios adaptados ao paradigma escolhido. Produz parity_specs.md e parity_tests/*.feature em Gherkin. Ativação: /reversa-inspector (geralmente invocado por /reversa-migrate).

references/parity-coverage-matrix.md

View on GitHub
# Matriz de cobertura de paridade

Tabela de referência para definir o conjunto mínimo de cenários `.feature` por fluxo, conforme transição de paradigma.

## Cobertura por transição

| Transição | Cenários mínimos por fluxo |
|---|---|
| sem mudança | `@paridade` (entrada → saída esperada) |
| procedural → OO | `@paridade` + `@invariante` (invariante de aggregate validado) |
| procedural → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@dlq` (comportamento sob falha de fila) |
| OO clássico → OO com DI | `@paridade` + `@composicao` (sem dependência de Active Record) |
| OO clássico → event-driven | `@paridade` + `@idempotencia` + `@ordem` + `@saga` (compensação ao falhar) |
| OO clássico → funcional | `@paridade` + `@imutabilidade` + `@composicao` |
| OO com DI → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
| funcional → event-driven | `@paridade` + `@idempotencia` + `@ordem` |
| qualquer → actor model | `@paridade` + `@supervisao` (recuperação após falha) |

## Tags convencionadas

- `@paridade`: sempre presente; equivalência principal.
- `@critico`: fluxo crítico (regulatório, financeiro, dados sensíveis).
- `@regulatorio`: quando há requisito formal externo.
- `@idempotencia`: reprocessamento não duplica efeito.
- `@ordem`: ordem por chave respeitada.
- `@dlq`: comportamento ao chegar em dead letter queue.
- `@saga`: compensação em transação distribuída.
- `@invariante`: invariante de aggregate validado.
- `@composicao`: comportamento equivalente sob composição funcional.
- `@imutabilidade`: não há mutação compartilhada.
- `@supervisao`: supervisor recupera ator falhado.

## Critérios de "paridade aceita" típicos

| Tipo de sistema | Métrica primária |
|---|---|
| Web app sem regulação forte | divergência funcional < 1% por 7 dias |
| API pública | divergência funcional < 0,1% por 30 dias + zero divergência em contratos públicos |
| Sistema fiscal / regulatório | divergência funcional < 0,01% por 60 dias + zero divergência em campos regulados |
| Sistema financeiro | divergência financeira por valor monetário < 0,001% + zero divergência em totalizadores |
| Sistema interno baixa criticidade | divergência funcional < 5% por 7 dias |

## Reuso de characterization_specs

Quando `_reversa_sdd/characterization_specs/` existe:

1. Para cada spec → derivar `.feature` correspondente, adaptando entradas/saídas ao sistema novo.
2. Manter o `spec-id` original na rastreabilidade.
3. Adicionar cenários extras conforme a tabela "Cenários mínimos por fluxo".

Quando não existe:

1. Inferir fluxos críticos a partir de `code-analysis.md` + `sequences/` + regras `BR-MIGRAR` marcadas como críticas.
2. Documentar lacuna em `parity_specs.md § Reuso de characterization_specs`.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall