O 'idea file' de Karpathy: por que, na era dos agentes, vale mais compartilhar a receita do que o aplicativo

A proposta foi direta: em vez de compartilhar o código do aplicativo, compartilhe o arquivo de ideia.

O nome em inglês é idea file. É um documento de texto em linguagem natural. Descreve o que o programa deveria fazer, por que existe, qual é o critério de sucesso e quais são as restrições. Não é especificação técnica nem design doc. É a descrição honesta de um problema e da solução pretendida — exatamente o tipo de clareza que distingue quem orquestra agentes com intenção de quem apenas delega sem critério, como discute a nova abordagem que Karpathy chama de engenharia agêntica.

A intuição de Karpathy vai assim. Na era em que cada usuário tem o próprio agente de IA, não faz mais sentido distribuir um executável. Faz mais sentido distribuir uma receita. O agente de cada pessoa lê a receita, conversa sobre as preferências do dono, e cozinha a versão particular daquele programa.

Quem nunca pensou "se esse app tivesse só uma funcionalidadezinha a mais, seria perfeito para mim"? Pois é. Karpathy aponta que o último 5% de personalização, sempre caro demais para um humano fazer, agora ficou barato.

Por que importa

Vamos pensar passo a passo.

Primeiro, o produto de software como conhecemos foi desenhado para o caso médio. O Spotify funciona razoavelmente bem para milhões porque foi otimizado para o ouvinte mediano. Quem ouve em padrão estranho, quem precisa de algo que 99% não precisam, sempre ficou de fora — e é exatamente essa lacuna que alimenta o otimismo em torno dos agentes de inteligência artificial, tema sobre o qual Andrej Karpathy alertou recentemente que estamos calibrando mal o horizonte de tempo.

A era do software sob medida diz o contrário. Você descreve o seu caso particular para o seu agente — e, como Andrej Karpathy observou ao notar que a profissão está sendo dramaticamente refatorada, ele constrói o tocador exato que você queria. Pode ser feio. Pode não ter loja de apps. Pode rodar só no seu computador. Mas é seu.

Segundo, o gargalo muda de lugar. Antes o gargalo era escrever código. Agora é descrever bem o que você quer. Karpathy defende, indiretamente, que a escrita técnica clara vire habilidade central do profissional moderno.

Não é a escrita acadêmica cheia de jargão. É a escrita honesta: "quero que faça isto, não quero que faça aquilo, o critério de pronto é o seguinte". Quem souber escrever assim, multiplica.

A diferença entre receita e código

Vale entender por que receita não é código.

Código é uma instância. É uma versão fixa, congelada, com decisões do autor original. Quando você baixa o código de outra pessoa, herda todas as decisões dela: a linguagem, o framework, a estrutura de diretórios, a forma de armazenar dados, o estilo da interface.

Receita é uma intenção. Descreve o que o programa deveria fazer, separada da forma específica. Quando o seu agente recebe uma receita, pode fazer escolhas diferentes das que o autor original faria. Escolhas que se encaixam no seu sistema, no seu gosto, na sua estrutura existente.

Karpathy compara isso, em outro tweet, ao que faz um cozinheiro caseiro com receita de família. Ele não copia exatamente. Adapta ao que tem em casa, ao gosto da mesa, ao tempo disponível. A receita sobreviveu gerações por isso — porque é flexível, enquanto o prato pronto seria rígido.

O experimento da frequência cardíaca

O caso contado por Karpathy ilustra bem o ponto. Ele queria baixar a frequência cardíaca em repouso. Os aplicativos de fitness serviam mal: eram genéricos demais, mediam coisas demais, tinham gamificação demais.

O que ele queria era simples. Um sistema que registrasse poucos parâmetros: cardio diário, qualidade de sono, hidratação, frequência matinal. E mostrasse se a tendência estava certa. Sem distração. Sem medalhas. Sem notificação.

Em poucas horas, com o agente, ele tinha a coisa rodando. Não era bonita. Não era produto. Mas resolvia exatamente o problema dele.

Agora imagine que ele queira compartilhar. O caminho antigo seria publicar o código inteiro no GitHub. Quem usasse teria que adaptar à própria realidade — outro sistema operacional, outro relógio inteligente, outro critério de sucesso. Adaptação manual, lenta.

A proposta nova é diferente. Ele compartilha apenas o arquivo de ideia: o quê, o porquê, como medir sucesso. Quem quiser, entrega ao próprio agente. O agente descobre que relógio a pessoa tem, qual critério faz sentido para ela, quanto tempo ela tem por dia, e constrói a versão personalizada naquela tarde.

A receita viaja. A implementação fica.

A leitura para o Brasil

Leio este tweet com duas implicações práticas para o leitor do Mirante.

A primeira é técnica. Programadores, gestores e estudantes deveriam começar a manter um arquivo pessoal de ideias. Coisas que gostariam que existissem. Problemas pequenos mal resolvidos. Automatizadores que melhorariam o dia. Antes, esse arquivo era lista de frustrações. Agora, é lista de programas a uma sessão de Claude Code de existir.

A segunda é cultural. A riqueza de software não é mais só o código aberto. É também a riqueza de intenções bem descritas. Um arquivo de ideia bem escrito vale ouro porque comprime, num parágrafo, o que antes precisava de mil linhas.

Karpathy disse num tweet seguinte que esta era ainda está nascendo. Ele mesmo tenta entender as implicações. Não tem certezas. Tem intuição forte e algumas experiências.

Vale ler os tweets dele direto, não só a tradução brasileira desta coluna. Os links estão abaixo. A ideia aqui é só atravessar a fronteira do idioma. O resto, cada leitor faz com o próprio agente.

Fonte original: tweets do @karpathy (experimento da frequência cardíaca, idea file viral, contexto adicional sobre autoresearch).