Antes de começar
- Node.js 22.x a partir de 22.23.4, 24.x a partir de 24.22.1 ou 26.12.1+; confira a faixa atual no README
- Agente compatível com MCP
- Aplicativo próprio ou autorização para analisá-lo
Escolha uma pergunta observável
Comece por uma função pequena: como seu aplicativo calcula o total do carrinho, por exemplo. Separe uma cópia de teste e três entradas com resultados conhecidos. Anote o que você pode inspecionar e quais sistemas ficam fora do escopo. Isso evita uma investigação vaga que consome tempo sem responder à pergunta.
Confira e instale o REA
O projeto atual usa um servidor MCP com instruções de trabalho. Leia o README e o instalador no repositório morluto/rea. Em uma pasta confiável, fora do aplicativo analisado, execute o setup abaixo. Confira as alterações de configuração propostas, escolha seu agente e reinicie-o. Análise de JavaScript e análise nativa têm dependências diferentes; use a seção do seu sistema operacional. Rode node --version e compare com a faixa suportada antes do setup.
npx rea-agents setupPeça primeiro o mapa do fluxo
Abra uma conversa no agente e indique o caminho da cópia. Peça para localizar os componentes envolvidos antes de alterar qualquer arquivo. Se uma ferramenta necessária não estiver disponível, registre a limitação; um palpite sobre o código interno não vale como observação.
Use REA para analisar o cálculo do carrinho deste aplicativo que mantenho. Escopo: somente a cópia local indicada. Liste entradas, transformação e saída; cite arquivos ou observações. Separe fatos observados, hipóteses e dúvidas. Não altere o aplicativo.Compare três casos
Teste um carrinho vazio, outro com um produto e outro com desconto. Guarde entrada, resultado esperado e resultado observado. Se a resposta do agente disser que há arredondamento ou validação, peça a evidência que sustenta essa conclusão. Faça uma nova observação quando o resultado divergir.
Transforme o achado em uma especificação
Escreva um contrato curto: entradas aceitas, regra confirmada, saída e comportamento em caso de erro. Use esse documento para corrigir ou reimplementar a função no seu próprio código. Mantenha uma lista separada dos pontos ainda desconhecidos.
Confira o resultado fora da conversa
Execute novamente os casos de teste e abra o aplicativo. Registre a versão do REA, do aplicativo e as dependências usadas. Entregue a especificação junto com as evidências; assim outra pessoa consegue repetir a investigação sem depender da memória da conversa.
O que você terá ao final
Uma função documentada com casos de teste e uma lista explícita do que ainda precisa ser investigado.
Vale conferir
- Use apenas software próprio ou autorizado. Não burle autenticação, licença ou controles de acesso.
- A instalação pode oferecer ferramentas adicionais; confira a necessidade e a licença de cada uma.
- Guia elaborado a partir da documentação. O fluxo completo não foi executado pela Agentspedia.