Curadoria e tutorial sobre RepoPrompt, ferramenta de context…
INEMA
🚀 Hacks avançados para RepoPrompt + Claude + O3⌗
🔥 1. Use Claude como orquestrador e O3 como executor⌗
- Claude (Sonnet ou Opus) é ótimo para explorar o contexto e buscar arquivos, mas lento para aplicar código.
- O3 (GPT-4o) é mais rápido e direto para aplicar alterações.
-
📌 Hack: Configure Claude para buscar o contexto e delegar o trabalho pesado para O3 via MCP.
-
Exemplo: Claude identifica funções obsoletas, O3 aplica o refactor.
⚡ 2. Minimalismo no contexto (evite Context Rot)⌗
- Não envie o repositório inteiro para o modelo.
- Selecione apenas os arquivos relevantes com o Context Builder do RepoPrompt.
- 📌 Hack: Priorize arquivos com nomes semelhantes à tarefa (ex:
auth_service.pypara tarefas de login). - Resultado: modelos não ficam “presos” em dados irrelevantes e respostas são mais limpas.
🧠 3. Duplication Trick⌗
- Duplica instruções críticas no prompt (no início e no fim).
-
📌 Hack: aumenta a chance do modelo lembrar das regras ao longo do fluxo agentic.
-
Exemplo:
<instructions> Atualize todas as dependências para Python 3.11 e mantenha compatibilidade. </instructions> ... <instructions> Atualize todas as dependências para Python 3.11 e mantenha compatibilidade. </instructions>
🗂️ 4. Multi-Repo Power⌗
- RepoPrompt permite abrir múltiplos repositórios simultaneamente.
- 📌 Hack: carregue bibliotecas externas e seu projeto juntos para permitir ao modelo analisar dependências cruzadas.
🛡️ 5. Revisão interativa de diffs⌗
-
Antes de aplicar qualquer alteração automática:
-
Use o recurso de “Review Diff” para comparar alterações linha a linha.
- 📌 Hack: combine com logs no código para validar resultados antes de pushar para o repositório.
💸 6. Economize tokens com Claude Desktop⌗
- Cada tool call (chamada de ferramenta) consome tokens pesados.
- 📌 Hack: no fluxo com MCP, desative chamadas automáticas desnecessárias (ex.: leitura completa do repositório).
- Resultado: menos custo e mais controle.
🪜 7. Escape Escape (Claude Code)⌗
-
Durante o uso do Claude Code:
-
Hack secreto: pressione E
SC ESCpara desfazer um passo e reiniciar a partir de um ponto anterior da conversa. - Útil para cortar contextos problemáticos (evita o famoso context rot).
📋 8. Logs são ouro⌗
- Adicione logs estratégicos no código antes de rodar o fluxo agentic.
-
📌 Hack: modelos entendem melhor a execução e erros se o log for passado no contexto.
-
Exemplo: c
onsole.log("auth failure at step X")ajuda o modelo a diagnosticar.
🕹️ 9. Human-in-the-loop Tool Calls⌗
- Não deixe o agente aplicar tudo automaticamente.
-
📌 Hack: configure para que cada tool call pare para revisão antes da aplicação.
-
Resultado: maior segurança e menos rollback.
💡 10. Clipboard XML no Free Tier⌗
- Sem Pro? Use o fluxo Clipboard XML:
- Selecione arquivos e monte prompt no RepoPrompt.
- Copie XML para Claude Desktop ou ChatGPT.
- Cole a resposta de volta no RepoPrompt para aplicar. * 📌 Hack: mantém quase todas as funcionalidades sem pagar o Pro.
🚀 Bônus: Fluxo de ultra performance⌗
- 🪝 Carregue o RepoPrompt com Claude Desktop (Pro) + O3 API + Gemini para alternar entre modelos.
- 📌 Hack: Claude para descoberta, O3 para aplicar, Gemini CLI para auditoria.
- Resultado: máxima eficiência e múltiplos modelos trabalhando em conjunto.
🚀 Passo a Passo: RepoPrompt com Claude e O3⌗
📦 1. Instalar e configurar RepoPrompt⌗
- Acesse o site: https://repoprompt.com
- Baixe e instale a versão para seu sistema operacional.
- Crie uma conta gratuita ou faça upgrade para Pro (para MCP).
- Abra o app e configure:
- Diretório padrão onde ficam os repositórios de código.
-
API Keys:
- Claude (Anthropic): Cole sua chave API no app.
- OpenAI (para O3): Cole sua chave API no app.
🗂️ 2. Preparar o repositório de código⌗
- Clone ou adicione o repositório que quer trabalhar.
- No RepoPrompt:
- Clique em “Add Repo” e selecione a pasta do projeto.
- Visualize a file tree (árvore de arquivos) para confirmar se está correto.
✍️ 3. Fluxo Manual (Grátis)⌗
Esse fluxo funciona sem MCP, útil para quem quer experimentar.
✅ Etapas:
- Selecione os arquivos relevantes:
- Clique nos arquivos na árvore do RepoPrompt.
-
Use o recurso de busca para localizar rapidamente funções ou variáveis. 2. Crie o prompt:
-
Escreva instruções claras no campo de prompt.
-
Exemplo:
Leia o código selecionado e atualize as funções para compatibilidade com Python 3.11 sem alterar a lógica.3. Gere o XML: -
Clique em “Copy XML”.
- Cole no Claude Desktop/Chat ou ChatGPT com O3. 4. Receba a resposta do modelo e aplique manualmente as alterações no código.
🤖 4. Fluxo Agentic com MCP (Pro)⌗
Aqui o Claude e o O3 agem como agentes, acessando o RepoPrompt diretamente.
✅ Etapas:
- Ative o MCP Server no RepoPrompt:
-
Vá em Settings > Enable MCP. 2. Configure Claude Desktop ou Claude Code para detectar o MCP. 3. Inicie o fluxo:
-
Claude pode listar arquivos, buscar trechos de código e até aplicar mudanças automaticamente.
-
Exemplo de comando no Claude:
``` Atualize a documentação do projeto com base no código encontrado na pasta /src/docs
```4. O RepoPrompt envia os arquivos necessários para o modelo:
- Claude busca o contexto sozinho.
- O3 pode ser usado para aplicar mudanças específicas.
🔁 5. Revisão e Controle⌗
- Revise todas as alterações propostas pelo modelo:
- No RepoPrompt, veja o diff (diferenças) antes de aplicar. 2. Aprove ou rejeite mudanças. 3. Use logs e prints para validar se o código está funcionando após alterações.
💡 Dicas Extras⌗
- Human-in-the-loop: mesmo no agentic, sempre valide as alterações antes de aplicar.
- Minimalismo no contexto: evite enviar o repositório inteiro; selecione apenas o necessário.
-
Combinação de modelos:
-
Use Claude para exploração e entendimento do código.
- Use O3 para soluções pontuais e eficientes.
📌 Ferramentas necessárias⌗
| Ferramenta | Versão Recomendada |
|---|---|
| RepoPrompt | Última (Pro se possível) |
| Claude Desktop | Max ou Pro |
| OpenAI API (O3) | GPT-4o ou GPT-4.1 |
| Git (opcional) | Para clonar repositórios |
Esse vídeo é uma entrevista com Eric Provencher, criador do RepoPrompt, onde ele explica como sua ferramenta eleva o nível do desenvolvimento com IA através de context engineering e fluxos agentic. O foco é integrar múltiplos modelos (Claude, O3, etc.), otimizar o uso de contextos grandes e permitir que agentes de IA operem diretamente sobre repositórios de código com segurança e eficiência.
Aqui está o resumo com os principais tópicos:
1. O que é RepoPrompt⌗
- Uma ferramenta para context engineering, permitindo que modelos de linguagem trabalhem com grandes bases de código de forma estruturada.
- Facilita seleção de arquivos relevantes, montagem de prompts otimizados e aplicação automática de mudanças no código.
- Suporta MCP (Model Context Protocol), permitindo que agentes IA como Claude interajam diretamente com o app.
Exemplo: Claude pode abrir múltiplos repositórios, buscar arquivos, entender o contexto e aplicar alterações diretamente.
2. Problema que resolve⌗
- Ferramentas como Cursor ou GitHub Copilot muitas vezes não utilizam todo o contexto disponível (limite de tokens).
- RepoPrompt permite aproveitar o contexto completo de modelos como Claude (200k tokens) e otimizar chamadas de API.
Exemplo: Em vez de enviar todo o repositório de uma vez (context rot), seleciona apenas os trechos de código relevantes.
3. Fluxo agentic com múltiplos modelos⌗
- Claude atua como orquestrador, enquanto modelos como O3 executam tarefas específicas.
- Possibilita que um agente leia código, aplique alterações e valide resultados.
- Claude prefere descobrir o contexto sozinho; O3 precisa ser “spoon-fed” com informações bem preparadas.
Exemplo: Claude busca arquivos com funções específicas, enquanto O3 aplica as edições sugeridas.
4. Context Rot e gerenciamento de contexto⌗
- Context rot: erro ou dado irrelevante no contexto que “prende” a atenção do modelo, causando respostas ruins.
- RepoPrompt ajuda a controlar o contexto: só envia a versão mais recente dos arquivos e permite limpar histórico desnecessário.
5. Integração com Claude Desktop e outros⌗
- Claude Desktop se torna um hub MCP, controlando ferramentas do RepoPrompt.
- Usuários podem rodar workflows complexos localmente ou com baixo custo de API.
- Versão gratuita do RepoPrompt permite uso manual com Claude Desktop; versão Pro desbloqueia automações MCP.
6. Modelos de linguagem e contextos grandes⌗
- O3: bom para soluções curtas e diretas; precisa de prompts bem preparados.
- Claude: excelente para tool calling e descobertas de contexto, mas menos eficiente com contextos enormes.
- Gemini: único modelo que lida relativamente bem com contextos acima de 500k tokens, mas ainda com limitações.
Exemplo prático: Em uma tarefa simples, O3 pode resolver com uma linha de código, enquanto Claude gera múltiplos arquivos desnecessários.
7. Melhores práticas sugeridas⌗
- Human-in-the-loop tool calls: modelo sugere alterações, mas humano revisa antes de aplicar.
- Minimalismo no contexto inicial: dar espaço para o agente preencher com informações relevantes durante execução.
- Documentação constante: resumir conversas com o modelo para reuso e aprendizado.
8. Licenciamento e acesso⌗
- Free tier: prompts manuais com Claude Desktop.
- Pro tier: automações MCP, ferramentas avançadas, suporte multi-repo.
- Cupom fornecido na live: 15% de desconto para novos usuários.
9. Conselhos de aprendizado com IA⌗
- Evitar depender 100% de agentes: entender o código e os erros melhora a qualidade dos prompts e das soluções.
- Experimentar diferentes modelos e ferramentas (Claude, O3, Gemini, Copilot).
- Focar em aprender debugging básico (logs, prints) antes de delegar ao modelo.
Engenharia de Contexto - RepoPrompt
1