Revise o código
que seu agente de IA escreveu
Seu agente terminou uma tarefa e o diff é maior do que você consegue ler com atenção. Abra o projeto no Yenpo, comece por Local Changes ou pelo diff de uma branch e use a busca, a navegação e o AI Reader para examinar uma mudança de cada vez.
Instalação e abertura do primeiro projeto
Arquivos locais no Mac · IA opcional · Mudanças locais e diffs Gitv0.1.303 EAP · Apple silicon & Intel · macOS 14+Expira em (UTC)A IA exige um provedor de modelos configurado; aplicam-se as cobranças de uso dele.
Transforme uma mudança aceita em código que você sabe explicar
Depois de uma rodada com Claude Code, Codex ou Cursor, escolha uma pequena mudança que queira dominar. Faça uma pergunta concreta: quais itens esse filtro deve retornar agora, qual regra exclui um item e o que mudaria se a regra fosse alterada? Anote sua previsão antes de pedir uma explicação.
Mantenha a entrada ao lado da regra
Abra os dados, a função de filtragem e o chamador em abas separadas. Use a busca de arquivos e de texto para encontrar os nomes presentes no recurso. Leia quais valores o chamador realmente fornece.
Confira uma explicação no código-fonte
Com um provedor configurado, pergunte sobre a regra ou ramificação que você não consegue explicar. Siga as referências e leia as condições ao redor; depois descreva o resultado com suas palavras.
Mude uma regra e confira o resultado
Escolha uma pequena edição manual. Preveja quais casos mudarão e quais continuarão iguais; depois execute o comando ou teste específico no terminal. Guarde a explicação nas suas anotações.
Experimente o ciclo de aprendizado com um filtro pequeno e executável
O exercício inclui dados fictícios, três previsões de saída, uma mudança de uma linha e verificações do novo comportamento. Você pode fazê-lo sem uma conta de modelo. O Yenpo oferece um espaço para ler código local; você executa o exemplo e as verificações.
Revise uma mudança pelo comportamento que ela afeta
Acompanhe um comportamento criado pela sua IA
Escolha um pequeno comportamento que seu agente adicionou e que você ainda não sabe explicar. Preveja a saída, leia a regra que a determina e faça uma mudança que você mesmo possa verificar.
Aprenda com um exercício executável de filtragemConecte uma ramificação aos seus chamadores
Pergunte qual entrada seleciona uma implementação, o que acontece após a chamada e onde um erro interrompe a execução. Leia também o chamador da função explicada.
Siga uma requisição HTTPConfira uma mudança escrita por IA
Compare commits ou branches selecionados com foco em uma questão específica. Confira a ramificação citada, os chamadores não alterados e as asserções dos testes antes de aceitar a explicação.
Revise as asserções alteradasO Yenpo atende ao trabalho em que você continua lendo o repositório enquanto discute uma mudança. Ele não é um agente de programação: não executa builds nem testes e não mescla patches. Faça essas etapas no Claude Code, Codex, Cursor ou no seu terminal.
Faça um pequeno mapa antes de explorar todo o repositório
Neste projeto didático, preview imprime “Moon Kite · paper” e list mostra os nomes das peças. Ambos usam os mesmos dados. Siga os caminhos no código com as anotações de leitura escritas à mão abaixo.
- Confirme o ponto de entrada. Leia README.md e package.json. O script de prévia seleciona src/preview.mjs com moon-kite como entrada. Já o script de listagem inicia src/list.mjs. Guarde o comando e a versão do código nas suas notas.
- Use uma saída como pista. Buscar Moon Kite leva a catalog.mjs, que contém dados. Siga findExhibit até seu chamador em build-label.mjs e depois buildLabel até preview.mjs. Confira o script de inicialização antes de considerar uma ocorrência de busca como ponto de entrada.
- Defina o papel de cada arquivo. preview.mjs recebe o identificador e imprime o resultado. build-label.mjs coordena a busca e a formatação. catalog.mjs encontra o registro; format-label.mjs o transforma em texto. Esses quatro papéis bastam para a pergunta.
Baixe o projeto, o mapa preenchido e o modelo de anotação. Descompacte, entre em exhibit-labels e execute estes comandos no Terminal com Node.js 22 ou posterior. Não é preciso instalar dependências nem conectar um modelo.
node src/preview.mjs moon-kite
node src/list.mjs
node --test tests/lab.test.mjsA prévia imprime “Moon Kite · paper”; a listagem imprime “Moon Kite” e “Cloud Loom” em linhas separadas. Os 5 testes passam, incluindo a seleção de outra peça e a interrupção por identificador desconhecido antes da saída. O arquivo inclui posições no código-fonte e um manifesto de hashes dos arquivos.
No seu repositório, deixe as perguntas em aberto ao lado do mapa: de onde vêm os argumentos de inicialização, qual implementação é escolhida e os dados vêm de arquivo ou serviço? Escolha o próximo arquivo a partir de uma dessas perguntas. A árvore de pastas, sozinha, não revela o caminho executado.
Mantenha os arquivos relevantes abertos enquanto pergunta
- Encontre um ponto de partida. Abra a pasta exhibit-labels extraída como projeto local. Use Command-P para encontrar preview.mjs ou Search All Files para buscar Moon Kite. Mantenha a entrada e o catálogo abertos enquanto segue os imports. Um arquivo, pasta ou seleção pode dar um ponto de partida ao AI Reader.
- Pergunte sobre um comportamento. Por exemplo: “No comando de prévia com moon-kite, quais arquivos selecionam o registro, formatam o texto e o imprimem? Mostre as posições no código e mantenha o comando de listagem separado.” Limite a resposta a esse caminho.
- Abra as referências ao código-fonte. Uma referência abre as linhas citadas em Code Quick Look. Use Open File para ler o código ao redor em uma aba. Confira se essas linhas realmente sustentam a afirmação.
- Siga as consequências. Use suas anotações para registrar os arquivos conferidos, seus papéis e a próxima questão em aberto. Execute um comando ou teste específico no Terminal quando precisar confirmar o comportamento. O AI Reader não o executa por você.
Saiba o que fica local e o que vai para seu modelo
Leitura local e leitura assistida por modelo
Navegar e pesquisar nos arquivos locais não exige conta de modelo. Para perguntar ao AI Reader, configure provedor, tipo de API, endpoint e modelo em Settings. Os tipos aceitos são Chat Completions compatível com OpenAI, OpenAI Responses e Anthropic Messages. O acesso e as cobranças de uso dependem da sua conta no provedor.
A pergunta, o contexto relevante, os anexos e o código lido durante a investigação são enviados ao endpoint configurado. O AI Reader pode ler arquivos relacionados além dos anexos. Um provedor remoto processa esse conteúdo fora do Mac.
Configure um provedor de modelosEscolha a próxima verificação pelo que ainda está incerto
Se a peça errada for selecionada no laboratório, leia a entrada e a busca. Se o registro estiver certo, mas o rótulo errado, leia o formatador. Em um projeto maior, escolha da mesma forma: siga a pergunta em uma investigação específica.
- Qual configuração prevaleceu? Siga um valor da entrada à saída.
- Deixe um registro de entrega reproduzível
- A explicação da IA se sustenta? Confira uma afirmação de cada vez.
- Onde a execução falhou? Siga o erro até a origem.
- O que uma mudança pode afetar? Examine os consumidores e suas expectativas.
O exercício anterior de ramificação em um único arquivo continua disponível se você quiser começar por algo menor.
Experimente na próxima mudança
que sua IA fizer.
Diffs, Local Changes e busca funcionam desde o início. Conecte um provedor de modelos quando quiser perguntar algo ao AI Reader.
Baixar EAPA interface está disponível em inglês, chinês simplificado e tradicional, japonês, espanhol, português do Brasil, coreano, alemão, francês e russo.
v0.1.303 EAP · Apple silicon & Intel · macOS 14+Expira em (UTC)