Rotina de 10 minutos para transformar notas antigas do Obsidian em brief para o Claude Code

Numa terça-feira de manhã, colei minha nota “reescrita de artigos” do Obsidian direto no Claude Code. Eram três semanas de anotações, mais ou menos 2000 caracteres. O que voltou foi uma sugestão para “vamos corrigir” o texto do botão de CTA que eu já tinha corrigido na semana anterior.

Por quê? Porque naquela nota convivia, na mesma lista de marcadores chapada, a hipótese de três semanas atrás (“talvez o PDF gratuito esteja fraco”) e a decisão da semana passada (“o PDF gratuito vira a rota principal, está fechado”). Para a IA, as duas coisas eram “informação de peso igual escrita na nota”. Por isso ela colocou em dúvida uma decisão já tomada e sugeriu de novo um trabalho que eu já tinha terminado.

Não era falta de notas. A causa era que eu estava entregando hipóteses velhas e decisões fechadas tudo misturado. Hoje vou falar do método que conserta isso em 10 minutos pela manhã.

Pontos principais

• Colar uma nota longa do Obsidian sem mais nem menos faz a IA tratar hipóteses velhas e fatos decididos com o mesmo peso, e ela ressuscita trabalho que já estava encerrado.
• Separar a nota em 5 caixas — “fatos ainda verdadeiros hoje / decisões tomadas / o que ainda é incerto / próxima ação / como verificar” — reduz a informação entregue e melhora a qualidade do julgamento.
• A triagem leva 10 minutos. Mais abaixo deixei um script Node.js que roda colando e dá certo.
• Decidir “é fato ou é hipótese” é trabalho de gente. Escrever o texto é trabalho da IA. Misturar esses dois papéis dá acidente.
• Para conteúdo de iniciante, a saída é a rota de aprendizado gratuita; para melhoria de processo na empresa, é a consultoria. Escolha uma saída só conforme o estágio do leitor.

Por que “colar a nota inteira” dá acidente

A força do Obsidian é deixar você ir acumulando informação. Mas na hora de entregar para a IA, isso joga contra.

Quando uma pessoa lê uma nota, ela pondera sem perceber: “isto é velho, isto é o mais recente”. Pela data e pelo contexto, faz uma seleção automática do que importa. A IA não faz isso por você. A terceira linha e a trigésima linha da lista chegam com o mesmo peso, todas como “informação atual”.

Por isso o “talvez seja assim” de três semanas atrás é tratado como fato fechado no pedido de hoje. E ao contrário, o que ficou decidido na semana passada é rebaixado a mera proposta. O acidente que contei no começo foi exatamente isso. Quanto mais notas, mais necessária fica a triagem antes de entregar.

O método de triagem em 10 minutos

Toda manhã, ou antes de começar a trabalhar, separe a nota-alvo nestas 5 caixas. No máximo 10 minutos. Se você gastar mais que isso, provavelmente está enfiando coisa demais nas caixas.

1. Fatos ainda verdadeiros hoje: deixe só 3. Vale apenas o que está verificado e continua válido hoje.
2. Decisões já tomadas: escreva 2. Diretrizes que não se mexem mais, do tipo “o PDF gratuito é a rota principal”.
3. O que ainda é incerto: escreva só 1. Aquilo que você quer confirmar no pedido de hoje à IA.
4. Próxima ação: resuma numa frase. Uma ação concreta que termina em verbo, como “reescrever um parágrafo de CTA e confirmar que a URL pública abre”.
5. Como verificar: escreva o que precisa estar pronto para dizer “ficou pronto”. Rodar o teste, conferir a exibição, checar link quebrado, e por aí vai.

Fixar o número de caixas tem um motivo. Três fatos, duas decisões, uma dúvida. Se você aumentar mais que isso, volta de novo para o “entrego tudo”. O limite das caixas é o que força a coragem de descartar.

Quando você reescreve nessas 5 caixas, o Obsidian deixa de ser “o depósito onde se joga qualquer coisa” e vira “a bancada de trabalho de hoje”.

O que entregar à IA e o que a pessoa decide

Misturar isto dá acidente. Vou deixar a fronteira bem clara.

Etapa	Responsável	Motivo
Decidir se é fato ou hipótese	Pessoa	A IA tende a tratar hipóteses antigas como fechadas
Quais decisões ainda valem hoje	Pessoa	Só a pessoa sabe se a diretriz está atual
Reordenar e resumir nas 5 caixas	IA (rascunho)	Organização mecânica é rápida
Redigir o texto do brief	IA	Geração de texto é o forte dela
Decisão final de publicar / aplicar em produção	Pessoa	Operações irreversíveis a gente segura

O truque é: só o botão de “isto é fato, está confirmado” é a pessoa quem aperta. Deixe a IA fazer o rascunho e não solte o julgamento final da triagem. Só com isso, o acidente de reabrir decisões praticamente some.

Se você ainda se sente inseguro com a própria gestão de notas, leia antes o básico da integração com o Obsidian e como transformar notas do Obsidian em brief para o Claude Code, e este método entra bem mais fácil.

Modelo de prompt que dá para colar e usar

Se você vai deixar a IA montar o rascunho da triagem, use este texto de pedido como está. Basta colar o corpo da nota do Obsidian no final.

Organize a nota a seguir em 5 caixas. Respeite sempre o limite de cada caixa.

- Fatos ainda verdadeiros hoje: até 3 (só o que está verificado e vale hoje)
- Decisões já tomadas: até 2 (diretrizes que não se mexem mais)
- O que ainda é incerto: só 1 (o que você quer confirmar hoje)
- Próxima ação: uma frase (ação concreta que termina em verbo)
- Como verificar: a condição para dizer que ficou pronto (teste, conferência de exibição etc.)

Regras:
- "talvez", "é possível que" não entram em fatos; vão para o que é incerto.
- Se uma decisão antiga e uma nova se contradizem, adote a nova e descarte a antiga.
- Informação que não cabe na caixa: não force, apague.

Corpo da nota:
(cole aqui a nota do Obsidian)

O ponto é deixar explícito “respeite o limite”. Sem isso, a IA, por gentileza, tenta manter tudo. Diga dentro do pedido que o trabalho é descartar, não preservar.

Script de conversão que roda colando

Este script ajeita o resultado da triagem num formato que você cola direto no primeiro pedido ao Claude Code. Roda no Node.js 18 ou superior, sem instalar nada a mais. Salve como brief.mjs e execute com node brief.mjs.

// Converte a nota separada em 5 caixas num texto de brief para o Claude Code
const note = {
  facts: [
    "no celular, o CTA cabe sem quebrar a linha",
    "a URL do produto no Gumroad já foi trocada pela versão atual",
    "os artigos mais acessados têm intenção de busca de iniciante",
  ],
  decisions: [
    "o PDF gratuito é a rota principal",
    "só os leitores travados em configuração ou permissão vão para o guia pago de setup",
  ],
  unknowns: [
    "qual versão de idioma tem a menor taxa de clique no CTA",
  ],
  nextAction: "reescrever um parágrafo de CTA e confirmar que a URL pública abre certo",
  checks: [
    "o corpo do texto atinge a contagem de caracteres exigida",
    "tirar um print da exibição no celular",
    "conferir se o h1 e a URL canônica da página publicada estão como o esperado",
  ],
};

// Checagem mecânica de que nenhum limite foi ultrapassado (autoconferência da triagem)
function validate(n) {
  const errors = [];
  if (n.facts.length > 3) errors.push("Fatos demais (no máximo 3)");
  if (n.decisions.length > 2) errors.push("Decisões demais (no máximo 2)");
  if (n.unknowns.length > 1) errors.push("Incertezas demais (só 1)");
  if (!n.nextAction || !n.nextAction.trim()) errors.push("A próxima ação está vazia");
  return errors;
}

function toBrief(n) {
  return [
    "[Fatos de hoje] " + n.facts.join(" / "),
    "[Decisões tomadas] " + n.decisions.join(" / "),
    "[Ainda incerto] " + n.unknowns.join(" / "),
    "[Próxima ação] " + n.nextAction,
    "[Como verificar] " + n.checks.join(" / "),
  ].join("\n");
}

const errors = validate(note);
if (errors.length > 0) {
  console.error("A triagem ultrapassou os limites:");
  errors.forEach((e) => console.error("  - " + e));
  process.exit(1);
}

console.log(toBrief(note));

O coração disso é ter colocado o validate. Aquele meu erro de escrever 4 fatos sem perceber e entregar assim mesmo passa a ser barrado pela máquina. As 5 linhas que saem você cola direto no primeiro pedido ao Claude Code. Assim fica fixo o método: não entregar todas as ideias velhas, e sim só os fatos que servem para o julgamento de hoje.

Três usos por tipo de trabalho

O sentido das caixas é o mesmo, mas o conteúdo muda conforme o trabalho. Vou citar três.

1. Operação de artigos e conteúdo Separe a intenção de busca dos artigos populares, a rota de CTA atual e o material que você quer vender em seguida. Para um artigo de iniciante, coloque o PDF gratuito primeiro e mande só os leitores travados na configuração para o guia pago de setup — escreva isso na “próxima ação”. Com isso, a sugestão não fica oscilando a cada vez.

2. Passagem de bastão em desenvolvimento Separe o fato do bug que você conseguiu reproduzir, a decisão de design mais recente e a causa que ainda é incerta. Se aqui você colocar a “hipótese” da causa dentro da caixa de fatos, a IA corre com tudo na direção errada. Se a causa não está confirmada, vá sem hesitar para “ainda incerto”.

3. Preparação de reunião ou consultoria de adoção Separe o que o cliente disse, o escopo de trabalho que foi fechado e as perguntas para a próxima vez. Se você escrever na “próxima ação” até o entregável da reunião, a proposta que você leva fica concreta.

Armadilhas comuns e como corrigir

Três erros em que eu mesmo caí no começo. Escrevo com a correção junto.

O primeiro é colar uma página longa inteira. O volume de informação é grande, mas o julgamento fica raso. A correção é simples: antes de colar, enxugue nas 5 caixas. Não entregue o depósito, entregue a bancada.

O segundo é misturar decisão e indefinição. Se você cola lado a lado “talvez o PDF gratuito esteja fraco” e “o PDF gratuito é a rota principal, fechado”, a IA começa a duvidar do que já estava decidido. Todo “talvez” tem que ir para a caixa de “ainda incerto”. Só isso já para a reabertura de decisões.

O terceiro é não escrever como verificar. Se você só diz “me avise quando ficar pronto”, a IA diz “ficou pronto” pelo critério dela. Entregue antes condições que a máquina consegue julgar, como rodar o teste, conferir a exibição, checar link quebrado. O truque é a pessoa segurar a definição de “concluído”.

Perguntas frequentes

P. Dá para usar com outro app de notas que não seja o Obsidian? R. Dá. No Notion ou no app de notas da Apple, a ideia de separar em 5 caixas é a mesma. O script não liga para a origem, desde que você consiga extrair o texto.

P. Não tenho tempo de triar 10 minutos toda vez. R. Você não precisa fazer com todas as notas. Basta triar a única nota que você vai entregar hoje ao Claude Code. Com prática, dá para terminar em 3 a 4 minutos.

P. Não posso deixar a própria triagem toda por conta da IA? R. Até o rascunho, tudo bem deixar. Mas o julgamento final de confirmar “isto é fato”, “isto é decisão” quem segura é a pessoa. Se você soltar isso, volta o acidente de reabrir decisões do começo do artigo.

P. Qual a diferença entre escrever no CLAUDE.md e colar um brief toda vez? R. Diretrizes que não mudam vão para o CLAUDE.md; os fatos só de hoje e a próxima ação vão para o brief. O papel do CLAUDE.md também está bem resumido na documentação oficial da Anthropic. Para o jeito de escrever, veja também como escrever o CLAUDE.md e receitas de configuração de permissão.

P. Quero subir mais a precisão dos prompts. R. Em como montar prompts reuni medidas concretas para estabilizar o texto de pedido. Combinado com o método de triagem, o efeito aparece.

Na prática, o que aconteceu quando testei

Depois do acidente de reabertura que contei no começo, peguei a mesma nota, fiz a triagem nas 5 caixas e só então entreguei. Confirmei duas coisas.

A primeira: se a resposta que rediscute a decisão sumiria. Bastou colocar “o PDF gratuito é a rota principal, fechado” numa linha dentro da caixa [Decisões tomadas] para a IA passar a trabalhar partindo daquela diretriz, sem reabrir nada de novo. O tempo que gastei na triagem, medido, foi mais ou menos 4 minutos.

A segunda: se o validate realmente barra o erro. Escrevi 4 fatos de propósito e rodei; como esperado, parou com “Fatos demais”. Com isso, nem eu recém-acordado consigo furar o limite. Em vez de ficar pensando num texto de pedido genial, ter um método de enxugar antes de entregar acaba sendo, no fim, o caminho mais rápido. É o que sinto hoje.

Se você quer levar este método até a melhoria de processo do time, na consultoria e treinamento dá para aterrissá-lo na operação real.