Arquivo de contexto no vibe coding: pare de reexplicar quem você é

Você abre uma conversa nova com o assistente e gasta os primeiros minutos contando de novo quem você é, o que já sabe fazer e com que ferramenta trabalha. Dá para escrever isso uma vez só, num arquivo de texto guardado na pasta do projeto, com o nome que a sua ferramenta reconhece. Toda conversa nova daquele projeto passa a começar com esse texto já lido.

Martin Blume mostrou o arquivo dele ao vivo, na live em que abriu a pasta do SaaS que ainda ia construir. O editor carregou a pasta e havia um arquivo lá dentro, antes de existir uma linha de código: Vale ver como isso terminou em arquivo env.

Basicamente, ele fala sobre mim.

O que entra no arquivo de contexto: você, e não o projeto

A primeira linha do documento diz para que ele existe. É um documento de contexto sobre o autor, "pensado para alimentar projetos novos, em especial a pesquisa de qual SAS construir, sem precisar reexplicar tudo do zero".

Depois vêm as seções. Uma sobre a origem dele, onde aparecem a agência de marketing que ele fundou e a bagagem de negócio que veio de casa. Outra chamada "Formação e base técnica", com o que ele estudou e as ferramentas que usa no dia a dia. E uma de competências. Ele resume o conjunto assim:

é um resumo super básico sobre a minha história, as minhas competências

Nada ali descreve o produto ou o stack, e é isso que faz o arquivo valer também para o projeto seguinte. O que está escrito continua verdadeiro depois que ele trocar de ideia sobre qual SaaS construir.

Como produzir esse arquivo falando, em vez de escrevendo

Martin não sentou para redigir a própria biografia em tópicos. Ele falou sobre si e mandou o assistente organizar aquilo:

Quero tipo assim, cara, eu vou pegar e ficar falando com você sobre mim. Eu quero que você organize isso num documento.

O que saiu dali é, na descrição dele, "basicamente um arquivo como se fosse um bloco de notas". Um arquivo de texto comum, sem template. Falar sobre si por alguns minutos e deixar a ferramenta agrupar e nomear as seções resolve numa sentada um documento que, para escrever sozinho, você iria adiando.

O nome do arquivo não é livre

O arquivo só é lido sozinho se tiver o nome que o seu assistente procura quando abre a pasta. Martin avisou isso ao dizer que dá para pedir ao próprio assistente que crie o arquivo:

tem que ser com esse nome, porque essa é a base que ele vai construindo o resto

Esse nome muda conforme o assistente que você usa, então confira na documentação da sua ferramenta qual arquivo ela carrega sozinha na raiz do projeto. Salvo com outro nome, o texto vira um documento qualquer, que só entra na conversa quando você manda abrir.

O que esse arquivo não resolve no vibe coding

Ele descreve você, então o projeto fica de fora: o que o app faz, como o banco está montado. Esse contexto você segue dando, e em outro lugar.

A diferença que importa é de durabilidade. Escrever seu nível de experiência dentro de um pedido resolve aquele pedido e termina com ele, e na conversa seguinte você digita tudo de novo. O arquivo fica na pasta e entra em toda conversa nova daquele projeto sem você lembrar dele. Como no vibe coding quase todo o trabalho passa por conversa, esse texto acaba lido muito mais vezes do que você levou para produzi-lo. Foi o mesmo caminho de vibe coding para o subagente nao compactar o contexto do pai. Isso aparece também em jornada de compra.

O que fazer antes de abrir o próximo projeto

Abra o assistente e diga que você vai falar sobre você e quer aquilo organizado num documento. Conte de onde vem, o que estudou, o que faz hoje e o que ainda não sabe fazer. Peça seções separadas, do jeito que as dele estão: origem, formação e base técnica, competências.

Depois confira na documentação qual é o nome que a sua ferramenta lê sozinha, salve o arquivo com esse nome na raiz do projeto e peça, na primeira conversa, que ela confirme que está lendo. Da próxima vez que abrir uma pasta nova, é só copiar o arquivo para dentro dela.

Dá para assistir à live e ver o arquivo aberto na tela, seção por seção, do jeito que ele leu. Escrever quem você é uma vez só deixa o vibe coding começar do ponto em que você parou, em vez de recomeçar a cada conversa.