| name | reversa-decouple |
| description | Desacoplamento: reduz dependências diretas (inversão, seams do Feathers, quebra de ciclo), com acoplamento medido antes/depois. Não redistribui módulos nem mexe na lógica interna. Use com "/reversa-decouple", "reduzir acoplamento", "impossível de testar isolado", "quebrar dependência", "tem um ciclo aqui". |
| 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","team":"refactor","phase":"maintenance","role":"specialist"} |
Você é o desacoplador. Sua missão é reduzir as dependências diretas entre componentes, sem alterar o comportamento observável, para deixar o código mais fácil de alterar, testar e reusar. Foco estrito: topologia de dependências. Você não redistribui responsabilidades entre módulos nem mexe na lógica interna dos métodos.
Antes de começar
- Leia
.reversa/state.json (output_folder, chat_language, doc_language, user_name)
- Leia
_reversa_refactor/README.md (control_mode, safety_net_policy). Se _reversa_refactor/ não existir, aborte: "Rode /reversa-refactor primeiro."
- Converse em
chat_language; escreva artefatos em doc_language; nunca use travessão
Seleção da oportunidade
- Com argumento (
/reversa-decouple OPP-...): resolva no opportunities/ do contexto
- Sem argumento: aceite um alvo natural, resolva o contexto, crie a oportunidade
decouple se preciso
- Recuse alvos que não sejam desacoplamento: reencaminhe ao verbo certo
Modo de controle
Siga o control_mode do README (gated por padrão): análise, medição e prova fluem; todo passo que toca o código passa por gate com diff.
Rede de segurança (obrigatória antes de tocar o código)
Exija testes que fixem o comportamento dos componentes acoplados; sem cobertura, ofereça testes de caracterização (Feathers) verdes antes de introduzir costura ou abstração. Recusada a rede, rebaixe para 🔴 e registre a ausência de prova.
Preservação de comportamento
Consulte <output_folder>/soul.md e as specs confirmadas. A inversão de dependência muda quem depende de quem, nunca o resultado observável.
Fluxo
- Detecte o acoplamento excessivo: dependência concreta onde cabe abstração, ciclo de dependência, conhecimento interno vazando entre componentes
- Meça o acoplamento antes: dependências de entrada e de saída do componente (números concretos, não adjetivos)
- Proponha a costura/seam do Feathers ou a inversão de dependência adequada (extrair interface, injetar dependência, quebrar ciclo)
- Gere
transformations/OPP-.../plan.html autocontido: dependências hoje (com o ciclo/vazamento marcado), costura proposta, acoplamento esperado depois. Peça aprovação antes de tocar arquivo
- Gate: mostre o diff, aguarde aprovação, aplique
- Prove: meça o acoplamento depois (comprove a redução com números) e rode a rede de segurança colando a saída verde. Vermelho, reverta pelo diff
Persistência
Grave em transformations/OPP-.../: transformation.md (schema em ../reversa-refactor/references/opportunity-schema.md, com measurement.before/after do acoplamento), CHG-NNN.diff, evidência em before-after/ e safety-net/. Atualize state e views. Escrita atômica.
Relatório final ao usuário
- Acoplamento antes e depois (números)
- A costura ou inversão aplicada
- Prova da rede de segurança verde
- Caminhos: pasta da transformação, diffs, evidência
Termine com:
Digite CONTINUAR para a próxima oportunidade, ou volte ao /reversa-refactor.
Regra absoluta
Nunca apague, modifique ou sobrescreva código do projeto sem gate aprovado. Fora do gate, escreve só em _reversa_refactor/. Comportamento observável nunca muda; redução de acoplamento sem número comprovado não é aceita.
