RPG: A Repository Planning Graph for Unified and Scalable Codebase Generation
Este artigo apresenta o RPG (Repository Planning Graph), uma representação estruturada que substitui o planejamento em linguagem natural por um blueprint explícito para gerar repositórios de código completos, e introduz o ZeroRepo, um framework que utiliza essa abordagem para superar significativamente os métodos existentes em escala, cobertura e precisão de testes em tarefas de geração de software complexas.
Artigo original sob licença CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta é uma explicação gerada por IA do artigo abaixo. Não foi escrita nem endossada pelos autores. Para precisão técnica, consulte o artigo original. Ler aviso legal completo
Imagine que você pediu a um chef de cozinha para criar um restaurante inteiro do zero, apenas dizendo: "Quero um lugar que sirva comida italiana, tenha um bar e uma área para crianças".
A maioria dos chefs atuais (os modelos de IA comuns) é ótima em cozinhar um prato específico, como uma lasanha perfeita. Mas se você pedir o restaurante inteiro, eles tendem a ficar confusos. Eles podem esquecer de construir a cozinha, colocar o bar no telhado, ou esquecer de conectar o encanamento da água entre a pia e o fogão. O resultado é um prédio cheio de salas bonitas, mas que não funciona como um restaurante.
O artigo "RPG: Um Gráfico de Planejamento de Repositório para Geração Unificada e Escalável de Código" apresenta uma solução para esse problema. Eles criaram uma nova maneira de pensar e planejar, chamada RPG (que significa Repository Planning Graph, ou "Gráfico de Planejamento do Repositório").
Aqui está a explicação simplificada, usando analogias do dia a dia:
1. O Problema: O "Mapa Mental" vs. O "Plano de Engenharia"
Antes, quando a IA tentava criar um software grande, ela usava apenas texto (linguagem natural) para planejar. É como se o arquiteto dissesse: "Vamos fazer uma sala de estar, depois uma cozinha, e talvez um banheiro...".
- O problema: O texto é ambíguo. A IA pode esquecer que a cozinha precisa de um encanamento que vem do banheiro. Com o tempo, o plano fica confuso, as peças não encaixam e o projeto desmorona.
2. A Solução: O RPG (O "Plano de Engenharia" Visual)
Os autores criaram o RPG. Em vez de apenas escrever um texto, eles fazem a IA desenhar um mapa interconectado (um gráfico) antes de escrever uma única linha de código.
Pense no RPG como um esquema de encanamento e elétrica de uma casa, misturado com um índice de um livro:
- Nós (Pontos): Representam o que o software faz (ex: "Carregar dados", "Calcular estatísticas").
- Setas (Conexões): Mostram como as coisas se conectam. Se o "Carregar dados" precisa enviar informações para o "Calcular estatísticas", uma seta liga os dois.
- Estrutura: O gráfico sabe exatamente onde cada arquivo deve ficar, quais classes herdam de quais outras e como os dados fluem.
Isso transforma a IA de um "sonhador que escreve textos" em um "engenheiro que segue um plano rigoroso".
3. Como Funciona o "ZeroRepo" (O Construtor)
Com esse mapa em mãos, eles criaram um sistema chamado ZeroRepo. Ele funciona em três etapas, como se fosse a construção de um arranha-céu:
- Planejamento (O Esboço): A IA olha para o pedido do usuário e desenha o esqueleto do mapa. Ela decide: "Preciso de um módulo para dados, um para algoritmos e um para testes". Ela usa uma "biblioteca de ideias" gigante para garantir que nada importante seja esquecido.
- Detalhamento (A Planta Baixa): Agora, ela preenche o mapa com detalhes. Onde fica o arquivo
load_data.py? Que funções ele tem? Como os dados saem daqui e entram ali? O gráfico é atualizado com essa precisão. - Construção (O Tijolo por Tijolo): A IA começa a escrever o código seguindo a ordem do mapa.
- Ela escreve uma função.
- Testa imediatamente: "Funcionou? Se não, conserte."
- Só depois de passar no teste, ela avança para a próxima parte do mapa.
- Isso garante que, se o prédio tem 100 andares, o 100º andar não vai desmoronar porque o 1º estava mal feito.
4. Os Resultados: Por que isso é incrível?
Os pesquisadores testaram isso criando 6 projetos reais (como uma versão simplificada do scikit-learn ou pandas) e pediram para a IA recriá-los.
- Escala: Enquanto as melhores IAs atuais conseguiam criar um "quartinho" (poucas linhas de código), o ZeroRepo construiu "arranha-céus" inteiros. Eles geraram 3,9 vezes mais código que o concorrente mais forte (Claude Code).
- Qualidade: O código não era apenas grande; funcionava! Eles conseguiram 81,5% de cobertura de funcionalidades (o software fazia quase tudo o que era pedido) e 69,7% de testes passando (o código não tinha bugs graves).
- Descoberta: A IA não apenas copiou o que existia; ela adicionou novas ideias criativas que os humanos nem tinham pensado, mostrando que o planejamento estruturado libera a criatividade da IA.
Resumo da Ópera
Imagine que você quer construir uma cidade inteira.
- O jeito antigo: Você manda o pedreiro escrever um texto dizendo "vamos construir casas". Ele constrói uma casa, depois outra, mas esquece de fazer ruas, esgoto ou luz. A cidade é um caos.
- O jeito novo (RPG/ZeroRepo): Você dá ao pedreiro um mapa de engenharia completo. Ele sabe exatamente onde cada rua, casa e tubulação deve ir. Ele constrói bloco por bloco, testando cada parede antes de subir o próximo andar.
O resultado é uma cidade (software) que é enorme, complexa, mas que funciona perfeitamente, pronta para ser usada no mundo real. O artigo prova que, para criar coisas grandes e complexas, planejar com um mapa visual é muito melhor do que apenas falar.
Afogado em artigos na sua área?
Receba digests diários dos artigos mais recentes que correspondam às suas palavras-chave de pesquisa — com resumos técnicos, no seu idioma.