Repolode
Enviar
ShadowSwaps

ShadowSwaps/REA-Reconstruction-Companion

Uma skill open source para agentes de IA entenderem softwares existentes, planejarem uma reconstrução e validá-la, em conjunto com a ferramenta REA.

Ver no GitHub
Estrelas
131
Forks
22
Issues abertas
0
Último commit
há 8 dias

O que é?

REA-Reconstruction-Companion é uma skill de agente independente de modelo, escrita como instruções e guias de referência em Markdown no formato Agent Skills. Ela orienta um agente de IA a entender o comportamento de um software existente, transformar essas observações em requisitos e em um plano por etapas e implementar uma parte escolhida somente quando isso for solicitado explicitamente. Em cada etapa, comportamentos observados, inferências e decisões de design ficam separados, e as lacunas são registradas em vez de se presumir que a reconstrução corresponde ao original.

A skill foi projetada para funcionar junto com REA, que fornece as ferramentas para examinar softwares e coletar evidências. A companion ajuda o mesmo agente a usar essas evidências em requisitos, design, implementação e validação. Um instalador incluído, compatível com Node.js 20 ou superior, oferece suporte a Claude Code, Codex e clientes genéricos, com prévia em modo dry-run, verificação e backups. A integração opcional com REA insere uma regra identificada no arquivo de skill do REA para que solicitações relevantes de reconstrução também carreguem a companion.

O projeto também define limites explícitos de custo e permissão: o agente é instruído a não iniciar ações que possam gerar cobranças e a pular qualquer etapa cujo custo zero não possa ser confirmado. Uma verificação de atualizações opcional, desativada por padrão, é executada no máximo uma vez a cada sete dias e ainda exige aprovação do usuário antes de instalar uma nova versão.

Recursos principais

  • 01Transforma observações, arquivos ou gravações em descrições de comportamento, requisitos e questões em aberto.
  • 02Gera especificações e planos de reconstrução por etapas, com critérios de aceitação vinculados às evidências.
  • 03Implementa comportamentos selecionados em incrementos testáveis somente quando a implementação é solicitada.
  • 04Inclui orientações de validação, como fuzzing diferencial, testes de mutação e contratos de interface.
  • 05O instalador oferece suporte a Claude Code, Codex e diretórios de skills genéricos, com modos dry-run e de verificação.
  • 06A integração opcional com REA adiciona uma regra reversível de direcionamento ao arquivo de skill do REA.

Casos de uso

  • Entender como um aplicativo desktop ou web existente lida com salvamento, edição ou importação antes de planejar uma ferramenta semelhante.
  • Planejar a reconstrução de uma função ou formato de arquivo, documentando entradas, saídas e casos de erro.
  • Recriar um fluxo de trabalho selecionado em um projeto local e relatar diferenças ainda não verificadas.
  • Recuperar e modificar uma reconstrução existente, preservando a compatibilidade com trabalhos anteriores.

Início rápido

  1. 1

    Baixe ou clone o repositório do GitHub

  2. 2

    Instale o complemento para Claude Code sem alterar o REA

    node install.mjs --client claude-code --integration off
  3. 3

    Visualize as alterações antes de instalar (opcional)

    node install.mjs --client claude-code --integration off --dry-run
  4. 4

    Verifique a instalação

    node install.mjs --client claude-code --integration off --check

Antes de usar

  • É necessário ter o Node.js 20 ou posterior para executar o instalador.
  • A investigação em tempo real exige que o REA seja instalado e configurado separadamente para o seu cliente.
  • Não é possível instalar por meio de clientes que oferecem apenas chat ou clientes de upload hospedado.

Em coleções

Ferramentas de engenharia reversaFerramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceAssistentes e agentes de programação com IABibliotecas de skills para agentes de IA

Tópicos

#agent-skill#ai-agent#reverse-engineering#software-reconstruction#claude-code#codex#developer-tools#agent-skills#ai-agent-framework#ai-agents

Perguntas frequentes

O que é REA-Reconstruction-Companion?
Uma skill open source para agentes de IA entenderem softwares existentes, planejarem uma reconstrução e validá-la, em conjunto com a ferramenta REA. REA-Reconstruction-Companion é uma skill de agente independente de modelo, escrita como instruções e guias de referência em Markdown no formato Agent Skills. Ela orienta um agente de IA a entender o comportamento de um software existente, transformar essas observações em requisitos e em um plano por etapas e implementar uma parte escolhida somente quando isso for solicitado explicitamente. Em cada etapa, comportamentos observados, inferências e decisões de design ficam separados, e as lacunas são registradas em vez de se presumir que a reconstrução corresponde ao original.
REA-Reconstruction-Companion é gratuito? Qual é a licença?
REA-Reconstruction-Companion é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
REA-Reconstruction-Companion ainda é mantido?
Manutenção ativa. O último commit de REA-Reconstruction-Companion foi em 30 de out. de 2026.
Para que posso usar REA-Reconstruction-Companion?
Entender como um aplicativo desktop ou web existente lida com salvamento, edição ou importação antes de planejar uma ferramenta semelhante. Planejar a reconstrução de uma função ou formato de arquivo, documentando entradas, saídas e casos de erro. Recriar um fluxo de trabalho selecionado em um projeto local e relatar diferenças ainda não verificadas. Recuperar e modificar uma reconstrução existente, preservando a compatibilidade com trabalhos anteriores.
Como instalar REA-Reconstruction-Companion?
Baixe ou clone o repositório do GitHub Instale o complemento para Claude Code sem alterar o REA: node install.mjs --client claude-code --integration off Visualize as alterações antes de instalar (opcional): node install.mjs --client claude-code --integration off --dry-run Verifique a instalação: node install.mjs --client claude-code --integration off --check
Onde consigo REA-Reconstruction-Companion?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ShadowSwaps/REA-Reconstruction-Companion

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados