Transforme notas do Obsidian em um pedido que o Claude Code implementa hoje

Numa sexta à noite, deixei no Obsidian só esta anotação: “a chamada para o cadastro está fraca. Acho que muita gente nem percebe o link do PDF grátis sem rolar a página.” Na segunda de manhã, colei a nota inteira no Claude Code e pedi “resolve isso aí”. O que voltou foram duas telas de “resumo da situação atual”. Nem uma linha de código.

A nota não estava ruim. O problema foi ter colado a nota do jeito que estava. Naquela manhã, perdi 30 minutos só ouvindo a explicação do contexto que eu mesmo já conhecia.

O conhecimento se acumula no Obsidian, mas você escreve a mesma introdução para o Claude Code toda vez. Se isso soa familiar, o que falta não é uma IA mais esperta, e sim um modelo para aparar a nota até virar um pedido.

Pontos principais

• Colar a nota inteira faz o Claude Code virar resumidor e atrasa a implementação. O que você entrega não é o texto todo, e sim uma única tarefa que termina hoje.
• Da nota você extrai apenas seis itens: objetivo, área protegida, primeira ação, forma de conferir, caminho de CTA e como reverter.
• Escrever antes “o que pode ler” e “o que não pode tocar” elimina o acidente de a IA se espalhar sozinha para pagamento ou autenticação.
• Transformado em modelo e salvo no Obsidian, o pedido deixa de precisar ser reescrito do zero na próxima vez.
• Em vez de confiar no “concluído”, você decide pelas provas: a captura de tela, o resultado do build, o diff.

Por que não dá para entregar a nota inteira

A nota do Obsidian é uma carta para o seu eu do futuro. Tem contexto, tem as dúvidas, tem tudo. É justamente por isso que, ao entregá-la para a IA, ela tenta “ler tudo e entender tudo”.

Um colega humano lê a nota longa e apara sozinho: “ah, no fundo é a posição do link de chamada”. O Claude Code não tem essa malícia. Ele devolve um resumo caprichado proporcional ao volume de texto que recebeu. É gentil, mas resumo não é o que você quer.

Por isso você apara antes de entregar. De uma nota de mil caracteres, sobram só os trinta que importam para implementar. Esse trabalho de aparar é o atalho que faz a introdução repetida desaparecer.

Quem quer delegar a própria organização das notas ao Claude Code ganha tempo lendo antes o básico da integração com o Obsidian: o passo a passo deste artigo se encaixa melhor depois disso.

Os seis itens que extraio da nota

O que eu tiro de toda nota são só estes seis. Não precisa que os seis estejam prontos na nota. Os campos que faltam, eu decido na hora de aparar.

Item	Conteúdo	Exemplo
Objetivo	O resultado que o usuário ganha, em uma frase	O visitante percebe o link do PDF grátis antes de rolar
Área protegida	O que não pode quebrar	Processamento de pagamento, login, layout no celular
Primeira ação	Por onde começar	Adicionar uma seção na primeira tela do topo
Forma de conferir	A prova de que terminou	Build passa, diff da mudança, aparência na URL pública
Caminho de CTA	Para onde levar o leitor depois	Página de cadastro do PDF grátis
Como reverter	A saída se der errado	Basta desfazer só este commit

O item-chave é “área protegida”. Se deixá-lo em branco, corre o risco de, junto com o conserto do link, ouvir “ajustei também o código de pagamento, de quebra”. Traçar a zona proibida antes é o que mais funciona.

O que delegar à IA e o que a pessoa decide

Misturar isso causa acidente. Vamos deixar a linha clara.

• A pessoa decide: objetivo, área protegida e como reverter. Isso é decisão de negócio, então não se joga na IA.
• A IA executa: detalhar a primeira ação, escrever o código, rodar os comandos de verificação.
• A pessoa confere no fim: a aparência na URL pública e se o diff bate com o esperado. Só isso você confirma com os próprios olhos.

O que dá para delegar é o “como construir”, não o “o que proteger”. Quem decide o que será protegido é sempre a pessoa.

Modelo de prompt para virar pedido

Os seis itens extraídos, num formato pronto para entregar ao Claude Code. Copie o modelo abaixo e cole a nota só no final.

Transforme a nota do Obsidian a seguir em um único pedido que você consiga implementar hoje.
Organize a saída nestes seis títulos. Ainda não escreva código.

- Objetivo (o resultado que o usuário ganha, em uma frase)
- Área protegida (o que não pode ser alterado)
- Primeira ação (a menor mudança possível)
- Forma de conferir (build, diff, URL pública etc.)
- Caminho de CTA (para onde levar o leitor depois)
- Como reverter (passos para voltar ao estado anterior se falhar)

[Nota]
(cole aqui a nota do Obsidian)

O que importa é a última frase: “Ainda não escreva código”. Sem ela, o Claude Code tenta fazer a conversão e a implementação de uma vez só e pula a checagem da área protegida. Peça primeiro o pedido por escrito, confira a zona proibida com olhos humanos e só então devolva “agora implemente exatamente conforme este pedido”. Esse esquema em duas etapas reduz os acidentes.

Quem quer afinar ainda mais a precisão do modelo encontra os detalhes de redação em técnicas avançadas de design de prompt para Claude Code.

Script de conversão para copiar e colar

Se montar o prompt à mão toda vez incomoda, escreva a nota como um objeto e gere o pedido automaticamente. Com Node.js instalado, ele roda direto.

// Script mínimo para converter uma nota em "pedido implementável hoje"
// Uso: node note-to-issue.mjs

const note = {
  objetivo: "O visitante percebe o link do PDF grátis antes de rolar a página",
  areaProtegida: ["Processamento de pagamento", "Login", "Layout no celular"],
  primeiraAcao: "Adicionar uma seção de aviso na primeira tela do topo",
  formaDeConferir: ["Build passa", "Diff da mudança", "Aparência na URL pública"],
  caminhoDeCta: "Página de cadastro do PDF grátis",
  comoReverter: "Desfazer só este commit volta ao estado anterior",
};

function toIssuePrompt(n) {
  // Se faltar um item obrigatório, avisa antes de emitir o pedido
  const required = ["objetivo", "areaProtegida", "primeiraAcao", "formaDeConferir"];
  const missing = required.filter((key) => {
    const v = n[key];
    return v === undefined || (Array.isArray(v) && v.length === 0);
  });
  if (missing.length > 0) {
    throw new Error(`Faltam itens obrigatórios no pedido: ${missing.join(", ")}`);
  }

  const line = (label, value) =>
    `${label}: ${Array.isArray(value) ? value.join(" / ") : value}`;

  return [
    line("Objetivo", n.objetivo),
    line("Área protegida", n.areaProtegida),
    line("Primeira ação", n.primeiraAcao),
    line("Forma de conferir", n.formaDeConferir),
    line("Caminho de CTA", n.caminhoDeCta),
    line("Como reverter", n.comoReverter),
    "Ainda não escreva código; devolva apenas o menor plano de implementação dentro deste escopo.",
  ].join("\n");
}

console.log(toIssuePrompt(note));

Ao executar, sai um pedido de seis linhas mais a frase final. Se você deixar areaProtegida como array vazio e rodar de novo, o script para com “Faltam itens obrigatórios” antes de emitir o pedido. É um jeito de barrar, no próprio código, o acidente de entregar com o campo em branco.

Três situações onde isso funciona de verdade

1. Nota de melhoria de um link de chamada A nota “o link do PDF grátis está fraco”, colada inteira, gera uma explicação interminável de propostas de melhoria. Aparada para um pedido, a primeira ação se reduz a um único ponto, “adicionar uma seção na primeira tela”, e o pagamento fica fora de alcance. Comparando a aparência antes e depois na URL pública, você julga o efeito com os olhos, não no feeling.

2. Nota de investigação de bug A nota “às vezes a tela fica em branco depois do login” tem informação demais. No pedido, reduza a primeira ação para “compartilhe primeiro só as condições de reprodução e os logs de erro”. Em vez de mandar investigar e corrigir de uma vez, faça a IA focar primeiro em reproduzir, e você evita correções fora do alvo.

3. Nota de pauta de artigo Até a nota vaga “no próximo artigo, quero colocar links internos direitinho” vira algo implementável se você aparar o objetivo para “fixar dois links internos para artigos relacionados”. Com a forma de conferir em “build passa”, você barra links quebrados antes de publicar. Antes de delegar tarefas em torno de artigos, vale ganhar prática com a introdução ao Claude Code para quem não é programador.

Guarde o pedido como modelo

O pedido que você criou uma vez não é descartável: devolva-o ao Obsidian. Quando chegar uma nota parecida, você reaproveita os seis títulos inteiros.

Eu criei uma nota só, templates/issue-prompt.md, com o modelo vazio dos seis títulos. Quando chega uma nota nova, copio o modelo e preencho. O tempo de escrever a introdução toda vez sumiu.

Além disso, se você fixar no próprio projeto as regras que o Claude Code deve ler, o pedido fica ainda mais curto. Concentre os combinados comuns do projeto no guia de como escrever o CLAUDE.md e você deixa de repeti-los a cada pedido.

Armadilhas comuns e como corrigir

Listo os erros que cometi no começo, cada um com a correção.

• Colar a nota inteira: o Claude Code vira resumidor. A correção é aparar para os seis itens antes de colar. Nota que não dá para aparar é sinal de que ainda não virou um pedido fechado, então escreva você mesmo uma frase de conclusão primeiro.
• Não escrever a área protegida: a IA se espalha sozinha para pagamento ou autenticação. A correção é não permitir o campo em branco e nem escrever “nenhuma”. Crie o hábito de listar pelo menos uma zona proibida.
• Forma de conferir do tipo “se rodar, está bom”: só sobra confiar no relatório de conclusão. A correção é sempre indicar pelo menos um entre resultado do build, diff e URL pública.
• Mandar implementar de uma vez: conversão e implementação se misturam e a checagem da zona proibida some. A correção é sempre incluir “ainda não escreva código” e só pedir a implementação depois de conferir o pedido.

Todas as armadilhas eram do tipo “dava para evitar com uma linha decidida antes”.

Perguntas frequentes

P. Minha nota é fragmentada e não consigo preencher os seis itens. Não precisa preencher tudo. Basta decidir “objetivo” e “área protegida” para já ter um pedido. O resto você completa depois de emitir o pedido, olhando as sugestões do Claude Code, e ainda dá tempo.

P. Preciso de uma integração que faça o Claude Code ler a nota do Obsidian diretamente? No início, não. Copiar a nota à mão e colar no modelo já funciona muito bem. Só pense em automatizar a integração depois de repetir o mesmo trabalho várias vezes.

P. Mesmo escrevendo “ainda não escreva código”, a IA começa a implementar. Deixe explícito no CLAUDE.md do projeto que “ao converter o pedido, não escreva código” e fica estável. Uma regra comum do projeto é respeitada com mais facilidade do que uma instrução de um prompt único.

P. Qual o tamanho ideal do pedido? Uso como referência seis títulos somando cerca de dez linhas no total. Se passar muito disso, é sinal de que vários objetivos se misturaram em uma tarefa só. Separe as tarefas.

P. Não sei o que colocar na forma de conferir. Na dúvida, comece com dois: “build passa” e “aparência na URL pública”. Só com esses dois você já sai do estado de engolir o relatório de conclusão na fé.

O que aconteceu quando testei na prática

Aparei a nota do link de chamada do começo do artigo com esse modelo de seis itens e entreguei de novo ao Claude Code. Dessa vez não voltou resumo: o que saiu primeiro foi um plano de implementação, “adicionar uma seção de aviso na primeira tela”. No processamento de pagamento, listado como área protegida, não houve nenhum toque.

No script de verificação também, ao deixar areaProtegida vazio de propósito e rodar, ele parou com “Faltam itens obrigatórios” antes de emitir o pedido. Confirmei que o acidente mais comum, entregar com o campo em branco, dá para barrar antes da execução.

Em vez de inventar uma instrução genial toda vez, ter um modelo único para aparar a nota é mais rápido. É essa a minha sensação atual. Quem quer levar a mesma abordagem para a produção de artigos da equipe ou o atendimento de chamados pode montar o modelo junto da operação real em treinamento e consultoria para empresas. Os critérios oficiais você confere na documentação oficial da Anthropic.