stribus/pygerengastos / .agents/skills/reversa-inspector
reversa-inspector
VerifiedQuinto 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.3 KB |
| references/parity-coverage-matrix.md | markdown | 2.8 KB |
| references/templates/parity_specs.md | markdown | 2.5 KB |
| references/templates/parity_test.feature | other | 1.6 KB |
references/templates/parity_specs.md
View on GitHub---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
version: "x.y.z"
kind: parity_specs
producedBy: inspector
hash: "sha256:<hash do corpo abaixo do front-matter>"
---
# Parity Specs
> Estratégia de validação de equivalência comportamental entre legado e sistema novo, adaptada ao paradigma escolhido em `paradigm_decision.md`.
## Estratégia geral
- **Modos de validação aplicáveis** (marcar os usados):
- [ ] Shadow mode (espelhamento de tráfego com comparação assíncrona)
- [ ] Characterization tests (suíte derivada do comportamento atual do legado)
- [ ] Contract tests (interfaces externas)
- [ ] Data parity (snapshots e checksums)
- [ ] Outro: <especificar>
## Critérios de "paridade aceita"
- **Métrica primária**: <ex: índice de divergência funcional < 0,01% em N dias consecutivos>
- **Janela de observação**: <período de avaliação>
- **Critério de bloqueio**: <quando paridade insuficiente bloqueia o cutover>
## Cobertura adaptada ao paradigma
> Esta seção muda conforme o paradigma alvo confirmado em `paradigm_decision.md`.
### Sem mudança de paradigma
- Equivalência funcional padrão: mesma entrada → mesma saída → mesmo efeito colateral observável.
### Mudança síncrono → event-driven
- **Ordem de mensagens**: <critério de aceitação por canal / partição>
- **Idempotência**: <prova de que reprocessamento não duplica efeito>
- **Consistência eventual**: <janela máxima de propagação aceita>
- **Comportamento sob falha de fila**: <retry, DLQ, replay>
### Mudança procedural → OO
- **Invariantes em aggregates**: <conjunto a validar>
- **Validação em factories / construtores**: <casos críticos>
### Mudança OO → funcional
- **Imutabilidade**: <pontos críticos a observar>
- **Ausência de side effects esperados**: <onde o legado tinha efeito colateral implícito>
- **Equivalência sob composição**: <funções compostas equivalem ao fluxo legado>
## Tipos de teste a aplicar
- **Funcionais**: <descrição, ferramenta>
- **Contrato**: <descrição, ferramenta>
- **Carga / performance**: <descrição, alvos>
- **Resiliência** (se aplicável): <falha de fila, dependência externa indisponível>
## Reuso de characterization_specs do time de descoberta
- **Origem**: `_reversa_sdd/characterization_specs/` ou equivalente disponível.
- **Adaptações necessárias para o sistema novo**: <texto>
## Saídas
- `parity_tests/*.feature`: cenários em Gherkin para os fluxos críticos.
## Notas
<Observações adicionais.>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |