NotebookLM para programadores: como resumir documentação, entender um projeto novo e tirar dúvidas a partir de docs e código

Você chega num projeto novo e cai numa base de código que ninguém documentou direito, ou numa documentação de mil páginas que precisa entender pra ontem

situação clássica de dev

A boa notícia é que dá pra jogar essas docs e esses trechos de código num lugar só e conversar com eles, ancorado nas fontes que VOCÊ escolheu

Esse lugar é o NotebookLM (que agora se chama Gemini Notebook), de graça com uma conta Google

Bora entender como usar isso a favor de quem programa?

NotebookLM virou Gemini Notebook (e o que isso muda)

Em 16/07/2026 o Google anunciou o novo nome: NotebookLM agora é Gemini Notebook

Calma que não muda quase nada pra você

É o mesmo produto, os mesmos notebooks, sem precisar recriar nada, e os links antigos redirecionam automático pro novo endereço

Então se você tinha um notebook salvo, ele continua lá do jeitinho que estava

No post eu vou usar os dois nomes sem drama, porque na prática é a mesma ferramenta

Não confunda com o Code Wiki

Aqui vale um aviso pra não embolar a cabeça do dev

O Google tem OUTRO produto voltado pra código chamado Code Wiki, apelidado de ‘NotebookLM dos desenvolvedores’, e ele não é o NotebookLM

O Code Wiki gera um resumo do que cada parte do código faz e monta um mapa de dependências entre os arquivos

Hoje ele está como preview web pra repositórios públicos, com uma versão pra código privado e empresarial a caminho

Guarda essa distinção: NotebookLM/Gemini Notebook é sobre conversar com as fontes que você sobe, Code Wiki é sobre varrer um repositório inteiro

O que você precisa antes de começar

Pouca coisa, e isso é a beleza

Você precisa só de uma conta Google e acessar o notebooklm.google

O acesso é gratuito com qualquer conta Google

Mas o plano gratuito (Standard) tem limites, e é bom conhecer pra não tomar susto no meio do trabalho:

• 100 notebooks no total
• 50 fontes por notebook
• 50 perguntas no chat por dia

Pra esse tipo de tarefa de dev, esses números costumam sobrar

Teto por fonte

Cada fonte que você sobe tem um limite: até 500.000 palavras por fonte, ou até 200 MB por arquivo enviado

Parece muito, e é

Mas documentação técnica junta muita coisa rápido, então se um manual gigante não entrar, quebra em partes

Tipos de fonte aceitos (e as pegadinhas)

O NotebookLM aceita bastante coisa:

• Google Docs, Slides e Sheets
• PDFs e Word
• arquivos de texto e Markdown
• URLs de páginas web
• links do YouTube (público e com legenda)
• áudio, imagens e CSV
• e texto colado direto

Agora se liga nas restrições, porque é aqui que a galera se ferra:

• PDF protegido contra cópia NÃO é importado
• só vídeo público do YouTube e com legenda funciona
• página com paywall não é suportada

Esse detalhe do PDF protegido pega muita gente, porque muita doc corporativa vem trancada assim

Como usar o NotebookLM para entender documentação e código

Agora o passo a passo de verdade

A ideia é transformar o notebook num especialista no SEU assunto, alimentando ele com boas fontes

1. Crie o notebook e dê um nome bom. Abra o notebooklm.google, crie um notebook novo e renomeie ele com algo próximo do projeto ou do assunto (tipo ‘API Pagamentos v2’ em vez de deixar ‘Sem título’). Na prática um nome bom ajuda a IA a responder mais no ponto. O erro comum deste passo: deixar sem nome e depois nem lembrar o que tem dentro de cada notebook

2. Suba as fontes certas. Adicione a doc oficial (por URL, PDF ou Markdown), o README do projeto e trechos de código colados como texto. Quanto melhor a fonte, melhor a resposta. O erro comum deste passo: tentar subir um PDF protegido contra cópia (não entra), ou colar um arquivo acima do teto de 500 mil palavras / 200 MB. Se for um repositório inteiro, esquece: o NotebookLM não sai lendo o repo sozinho, você é quem escolhe e sobe o material

3. Peça um resumo pra ter o mapa geral. Antes de mergulhar, peça uma visão do todo. Um prompt simples resolve:

Resuma esta documentação em tópicos: o que ela cobre, quais são
os conceitos principais e onde estão as partes mais importantes
para quem vai integrar com o sistema

4. Pergunte sobre o projeto novo como se fosse um colega sênior. Com as fontes lá dentro, faça perguntas ancoradas nesse material pra entender a estrutura, tipo ‘como as autenticações são feitas aqui?’ ou ‘qual arquivo cuida da conexão com o banco?’. Vá continuando a conversa até sentir que entendeu o suficiente. O erro comum deste passo: perguntar coisa que não está em NENHUMA fonte e esperar milagre. Ele responde bem sobre o que você deu pra ele

5. Tire dúvida cruzando doc + código e confira as citações. Cole o trecho de código que te confunde como texto, junto com a doc, e pergunte por que aquilo se comporta de um jeito. Sempre olhe a citação que ele aponta pra saber DE ONDE veio a resposta. O erro comum deste passo: confiar cego sem abrir a fonte citada. A citação existe justamente pra você conferir

3 usos reais para quem programa

Não é hype, são coisas que resolvem o dia a dia

1. Resumir documentação técnica extensa

Aquela doc gigante que você não vai ler inteira?

Sobe ela como fonte e pede o resumo por tópicos, depois vai fundo só na parte que interessa pra sua task

Como a resposta fica ancorada na doc que você subiu, dá pra confiar mais do que num chat genérico chutando de memória

2. Mapear um projeto novo ao chegar num time

Entrou num time e recebeu um monte de doc interna, README e diagramas?

Joga tudo num notebook e usa ele pra fazer as perguntas ‘de novato’ sem gastar o tempo do colega sênior

É tipo ter um onboarding que responde 24h, ancorado nos documentos reais do time

3. Tirar dúvidas cruzando docs + código colado

Aqui é o combo: a doc explica o QUE deveria acontecer, o código mostra o que acontece de fato

Colando os dois, você pergunta onde eles divergem e por quê

E quando o Code Wiki é a escolha melhor?

Se o que você quer é entender um repositório INTEIRO, com resumo de cada parte do código e mapa de dependências entre arquivos, o NotebookLM não é a ferramenta ideal, porque ele trabalha com as fontes que você sobe uma a uma

Pra repositório público, o Code Wiki foi feito exatamente pra isso

Então escala assim: fontes pontuais (doc, README, trechos) no NotebookLM, repositório completo no Code Wiki

Na prática: usei o NotebookLM para planejar e o Claude Code para construir

Eu venho usando um fluxo que combina o NotebookLM com o Claude Code e tô gostando muito de usar

No vídeo abaixo eu mostro esse processo do começo ao fim

A base é a mesma que ensinei aqui: usar o NotebookLM como fonte curada pra tirar dúvidas ancoradas nesse material

O que rolou na prática:

• Na minha mão, o NotebookLM vira um especialista no assunto conforme você alimenta as fontes: quanto melhores as fontes, melhor ele responde
• Eu adicionei vários tipos de fonte: artigos, docs, sites que já conhecia, PDFs, vídeos do YouTube, arquivos meus e até uma pesquisa própria colada como texto
• Mostrei que tem uma busca web com ‘deep research’ que sai atrás de fontes focadas a partir de um prompt, e também uma busca rápida. O deep research traz um resultado bem melhor, vale a pena esperar por ele
• As fontes que a busca traz vêm misturadas, boa e ruim no mesmo bolo. O papel é abrir cada uma e conferir se faz sentido, descartando as ruins, porque fonte ruim piora a resposta
• Depois de curar as fontes, fui fazendo perguntas ancoradas nesse material pro NotebookLM me guiar no entendimento, e continuei a conversa até sentir que entendi o suficiente
• Pedi pra ele gerar um prompt, achei pouco detalhado, aí troquei a configuração pra ‘resposta mais longa’ e refiz a pergunta pra vir mais completo
• Preferi pedir um PRD em vez de um prompt gigante e salvei como prd.md, pro Claude Code referenciar o arquivo. Prompt muito grande faz o Claude Code embolar ou pular alguma coisa
• A saída do NotebookLM já veio formatada em Markdown. Ao copiar, é só tirar a primeira linha de introdução (aquele ‘aqui está…’) e aproveitar o resto
• Renomear o notebook com um nome próximo do projeto ajudou a IA a responder melhor

Minha conclusão no vídeo: começar pelo NotebookLM, curando fontes e discutindo o assunto ANTES de mandar o PRD pro Claude Code, gera um projeto com diferencial de verdade

É o jeito de fugir do ‘AI slop’, aqueles produtos genéricos e sem alma que saem quando você pede direto pra IA sem contexto nenhum

E quando o Claude Code cospe o app pronto e você precisa colocar de pé num servidor, aí entra outra etapa que já falei sobre escalar projetos num VPS

Vale a pena para o seu fluxo?

Resposta curta: pra ler e entender coisa ancorada em fontes, vale muito

O NotebookLM/Gemini Notebook brilha quando você tem docs, PDFs, README e trechos de código e quer conversar com esse material sem inventar

A citação de onde veio cada resposta é o que dá segurança pra usar no trabalho

Onde ele NÃO ganha: não é um assistente de código que edita seu projeto nem lê seu repositório inteiro sozinho

Pra escrever e mexer no código, o lugar é o assistente de código. Pra varrer um repo público completo, o Code Wiki

Próximo passo prático? Cria o teu primeiro notebook com a doc do projeto que você tá mexendo agora e faz umas perguntas ancoradas nela

Se o repositório for público, roda o mesmo assunto no Code Wiki e compara os dois

Aí tu sente na mão onde cada um encaixa no teu fluxo =)