Prpack: empacote PRs em Markdown para revisão com LLM

O problema de revisar código com LLM

Você já tentou pedir para um modelo como o Claude revisar uma pull request? A ideia é óbvia: colar o diff e pedir uma análise. Mas na prática, o modelo perde contexto. Ele não vê o resto da função, não sabe como os callers usam o código alterado, nem o que o módulo exporta. Colar o repositório inteiro é caro em tokens e dilui a atenção. O prpack resolve isso de forma cirúrgica.

O que é o prpack

É um utilitário de linha de comando que pega uma PR (ou qualquer diff entre dois refs) e empacota tudo em um único arquivo Markdown. Esse arquivo contém a lista de commits, o diff e o conteúdo completo pós-alteração de cada arquivo tocado. O resultado é um contexto limpo e suficiente para um LLM revisar sem ruído.

O uso é simples: prpack --out ctx.md gera o arquivo. Depois é só jogar no Claude, Cursor ou qualquer modelo e pedir a revisão. O criador sugere um prompt como: 'Review this PR. The diff and full file contents are below. Flag bugs, missing edge cases, and anything that would make a reviewer pause.'

Como funciona (visão de operador)

O prpack é um CLI em Node.js (requer Node 18+ e git no PATH). Ele não faz chamadas de rede, tudo é local. Anda pelo diff entre dois refs (padrão: origin/main vs HEAD), lista os arquivos modificados e, para cada um, extrai o diff e o conteúdo completo após a mudança. Ele também respeita um limite de tamanho por arquivo (200 KB por padrão) e permite exclusões via glob.

O custo computacional é mínimo: operações locais de git e formatação de texto. O arquivo gerado tem cerca de 6.150 tokens para 7 arquivos, como no exemplo. Isso é bem menor que um repositório inteiro, mas muito mais rico que apenas um diff.

Uma feature interessante é o --include-tests, que automaticamente descobre e inclui arquivos de teste adjacentes, mesmo que não tenham sido alterados. Isso é útil para dar contexto de como o código é testado.

O que isso muda na prática

Para desenvolvedores que já usam LLMs para code review, o prpack elimina a dança de copiar e colar arquivos manualmente. Você ganha tempo e consistência. Para equipes, isso pode padronizar a forma como as revisões são submetidas ao modelo, garantindo que o contexto seja sempre o mesmo.

Quem perde? Ferramentas pagas que oferecem code review como serviço talvez percam relevância para quem prefere um modelo próprio. Mas o prpack não substitui uma revisão humana – ele só prepara o terreno.

Ação prática: Se você usa Claude ou Cursor para revisar código, experimente o prpack no seu próximo PR. Rode npx github:Lucas2944/prpack --out ctx.md e veja a diferença na qualidade da resposta.

Tensão: isso escala?

O prpack é ótimo para PRs pequenas e médias. Mas diff de centenas de arquivos ou arquivos enormes (limite de 200 KB) podem gerar um contexto muito grande, estourando o limite de tokens do modelo. O próprio README menciona a opção --no-content para incluir só o diff, mas aí perde-se o contexto. O balanço entre quantidade de contexto e custo de tokens continua sendo um trade-off.

Outra dúvida: o modelo realmente entende o contexto completo? Muitas vezes, mesmo com o conteúdo completo, o LLM pode ignorar dependências indiretas ou lógicas espalhadas em outros arquivos. O prpack resolve até onde os arquivos modificados alcançam, mas não vai além. É uma ferramenta útil, mas não uma bala de prata.

Conclusão

O prpack é uma adição inteligente ao fluxo de code review com LLMs. Ele resolve um problema real de contexto de forma elegante e sem firulas. Mas o gargalo ainda é a capacidade do modelo de raciocinar sobre o código. Vale a pena testar e ver se a qualidade das revisões melhora no seu dia a dia.