reversa

🚀 Reversa — Engenharia Reversa de Legados & SDD para Agentes de IA

📄 Base Teórica e Paper: Reversa: A Reverse Documentation Engineering Framework for Converting Legacy Software into Operational Specifications for AI Agents — Macedo & da Costa (Maio de 2026). 🏛️ Arquitetura: Skill-MCP-Cliente (Zero-Storage). O código local não sai do seu ambiente; a inteligência e os templates de contratos SDD são orquestrados via Habilis MCP.

---

🚀 Onboarding & Setup Rápido (Primeiro Uso)

Ao executar a skill pela primeira vez, verifique se o checklist de ambiente está preenchido:

📋 Checklist de Ambiente & Configuração

• 1. Habilis MCP Token (Obrigatório):
  • Obtenha seu token de acesso em https://ia.sthub.com.br.
  • Defina no seu ambiente:

    export HABILIS_API_KEY="hab_live_..."
    

• 2. Conexão MCP Habilis no config.yaml:
  • Adicione o endpoint MCP no seu Hermes ou cliente MCP:

    mcp_servers:
      habilis:
        url: "https://ia.sthub.com.br/api/mcp"
        headers:
          Authorization: "Bearer ${HABILIS_API_KEY}"
    

• 3. Diretório do Projeto:
  • Posicione o terminal na raiz do projeto legado a ser analisado.

🩺 Autodiagnóstico de Conectividade (Doctor)

hermes run "reversa_analyze_legacy(projectPath='.', focusAreas=['architecture'])"

---

🛠️ Ferramentas Disponíveis (Habilis MCP)

---

📖 Fluxo Operacional

Passo 1: Iniciar Descoberta (Arqueologia & Arquitetura)

hermes run "reversa_analyze_legacy(projectPath='.', focusAreas=['architecture', 'business_rules', 'data_models'])"

Passo 2: Gerar Contratos SDD

hermes run "reversa_generate_sdd(moduleName='checkout_e_pagamentos', specType='complete_sdd')"

Passo 3: Codificar com Segurança (Coding Agent)

Passe o contrato SDD como restrição obrigatória para o agente de codificação:

"Implemente a nova feature garantindo conformidade estrita com os contratos em _reversa_sdd/checkout_e_pagamentos_spec.md."

Passo 4: Auditoria de Não-Regressão

hermes run "reversa_audit_contracts(projectPath='.')"

---

🔒 Segurança & Privacidade (Diretriz Zero-Storage)

• Zero-Storage: O servidor MCP Habilis não persiste código-fonte, dados de banco ou segredos do cliente.
• Leitura Local: Os arquivos são lidos e processados pelo agente local no seu terminal/servidor.