Skip to content

stribus/pygerengastos / .agents/skills/reversa-paradigm-advisor

reversa-paradigm-advisor

Verified

Primeiro agente do Time de Migração. Detecta o paradigma do sistema legado a partir das specs, infere o paradigma natural da stack alvo, alerta sobre gaps e força uma decisão consciente do usuário. Produz paradigm_decision.md, leitura obrigatória de todos os agentes posteriores. Ativação: /reversa-paradigm-advisor (geralmente invocado por /reversa-migrate).

FileKindSize
SKILL.mdskill md8.2 KB
references/paradigm-catalog.mdmarkdown6.2 KB
references/templates/paradigm_decision.mdmarkdown2.4 KB

references/templates/paradigm_decision.md

View on GitHub
---
schemaVersion: 1
generatedAt: <ISO-8601>
reversa:
  version: "x.y.z"
kind: paradigm_decision
producedBy: paradigm_advisor
hash: "sha256:<hash do corpo abaixo do front-matter>"
---

# Paradigm Decision

> Decisão consciente sobre como tratar a mudança (ou ausência) de paradigma entre o legado e a stack alvo.
> Este artefato é leitura obrigatória primeiro para qualquer agente posterior e para o agente de codificação.

## Paradigma do legado detectado
- **Paradigma principal**: <procedural | OO clássico | OO com DI | funcional | event-driven | actor model | dataflow | híbrido: ...>
- **Confiança**: 🟢 CONFIRMADO | 🟡 INFERIDO | 🔴 LACUNA | ⚠️ AMBÍGUO
- **Evidências**:
  - <evidência 1, com referência a artefato do `_reversa_sdd/`>
  - <evidência 2>
- **Variações observadas** (se híbrido):
  - <componente A: paradigma X, evidência>
  - <componente B: paradigma Y, evidência>

## Stack alvo declarada
- Linguagem: <do migration_brief.md>
- Framework: <do migration_brief.md>
- Infra: <do migration_brief.md>

## Paradigma natural inferido
- **Paradigma**: <inferido via paradigm_catalog>
- **Justificativa**: <por que essa stack tem esse paradigma natural>
- **Alternativas viáveis**: <ex: OO com DI também é viável em Node, com custo X>

## Gap identificado
- **Severidade**: alto | médio | baixo | nenhum
- **Implicações concretas** (não em abstrato; com exemplo do próprio sistema legado):
  - <implicação 1, citando regra/fluxo do legado afetado>
  - <implicação 2>
  - <implicação 3>
  - <implicação 4>

## Opções apresentadas ao usuário
1. **Adotar paradigma natural da stack** (transformacional)
   - Consequências: <lista>
2. **Forçar paradigma similar ao legado** (conservador)
   - Consequências: <lista>
3. **Híbrido** (equilibrado)
   - Consequências: <lista>

## Decisão do usuário
- **Escolha**: <1 | 2 | 3>
- **Justificativa do usuário**: <texto livre>
- **Decidido em**: <ISO-8601>

## Apetite derivado
- `derived_appetite`: conservative | balanced | transformational

## Implicações pendentes para próximos agentes
| Agente | Implicação | Como honrar |
|---|---|---|
| Curator | <implicação> | <ação esperada> |
| Strategist | <implicação> | <ação esperada> |
| Designer | <implicação> | <ação esperada> |
| Inspector | <implicação> | <ação esperada> |

## Notas
<Qualquer ponto adicional que o agente de codificação precisa saber sobre o paradigma alvo.>
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