Transformar notas do Obsidian em brief de implementação para Claude Code

Se o vault Obsidian tem a resposta, mas toda sessão Claude Code começa com a mesma explicação, o problema não são as notas. É o formato do handoff.

Este artigo cria um formato de issue brief para Claude Code. Em vez de colar a nota inteira, passe fatos, decisões, dúvidas, próxima ação e provas.

Leituras relacionadas: claude-code-obsidian-integration, claude-code-claude-md-templates, claude-code-session-handoff-template. A base oficial de instalação está em Anthropic Claude Code getting started.

Por que isso vem antes do primeiro comando

O centro deste tema é transformar conhecimento do Obsidian em brief de implementação. Claude Code pode avançar rápido, mas quando a primeira entrada é ampla demais, diffs de baixo valor, hipóteses antigas e formatação sem impacto em receita recebem o mesmo peso do trabalho importante.

Para pessoas com boas notas, mas handoff pesado para Claude Code, a meta não é fazer a tarefa parecer grande. A meta é dizer o que ler, o que não tocar, o que tentar primeiro e para onde voltar se falhar. Isso vale para operação de conteúdo e desenvolvimento de produto.

Fluxo prático

1. Separar a nota em fatos, decisões, dúvidas e próxima ação
2. Deixar hipóteses antigas fora do brief
3. Incluir decisões de CTA e produto quando conteúdo muda
4. Exigir build e screenshot mobile como prova final

Essa ordem muda o pedido de “pense livremente” para “trabalhe dentro deste limite e deixe prova”. Claude Code ainda pode raciocinar, mas as áreas perigosas ficam fechadas antes da primeira edição.

Situação	Movimento seguro	Prova a guardar
Melhoria de artigo	Passar intenção de busca e política de CTA sem reescrita total	build, diff, URL
Correção de bug	Separar fatos reproduzidos de causas não verificadas	build, diff, URL
Preparar consultoria	Converter notas do cliente em escopo, áreas bloqueadas e perguntas	build, diff, URL

Com essa prova, Claude Code é avaliado pelo trabalho visível, não por uma frase confiante.

Prompt e código para copiar

Converta esta nota do Obsidian em um brief de implementação Claude Code. Separe fatos, decisões, dúvidas, próxima ação, áreas bloqueadas e prova. Coloque hipóteses antigas separadas e não misture com instruções.

const note = {
  title: "Checkout CTA wraps on mobile",
  facts: ["375px screenshot shows two-line button", "Gumroad URL is correct"],
  decision: "keep free PDF before paid guide",
  unknowns: ["which component owns the button spacing"],
  nextAction: "find component, make smallest CSS change, verify mobile",
};

function toClaudeBrief(item) {
  return [
    `Goal: ${item.nextAction}`,
    `Facts: ${item.facts.join("; ")}`,
    `Decision: ${item.decision}`,
    `Do not assume: ${item.unknowns.join("; ")}`,
    "Proof: build plus mobile screenshot",
  ].join("\n");
}

console.log(toClaudeBrief(note));

O código é uma checagem pequena. Em um projeto real, cole a saída em CLAUDE.md, issue ou nota de handoff para reutilizar a mesma decisão na próxima sessão.

Exemplos reais e falhas

Situação	Movimento seguro	Prova a guardar
Melhoria de artigo	Passar intenção de busca e política de CTA sem reescrita total	build, diff, URL
Correção de bug	Separar fatos reproduzidos de causas não verificadas	build, diff, URL
Preparar consultoria	Converter notas do cliente em escopo, áreas bloqueadas e perguntas	build, diff, URL

• Colar o vault inteiro mistura decisões antigas e restrições atuais.
• Colar só a decisão esconde a razão do trabalho.
• Omitir CTA pode melhorar texto e enfraquecer receita.

A falha comum não é falta de capacidade do Claude Code. A fronteira de entrada era fina demais. Quando a fronteira é fina, o assistente amplia a tarefa para ajudar. Em artigos monetizados, escolher entre PDF gratuito, Gumroad e consultoria também faz parte dessa fronteira.

Levar o leitor ao PDF, Gumroad e consultoria

Se os comandos básicos ainda parecem confusos, comece pelo cheatsheet gratuito. Se o gargalo está em setup, permissões, CLAUDE.md, MCP ou CI, o próximo passo pago é o Setup Guide. Se você reescreve prompts de review, debugging ou refactor, use 50 Prompt Templates. Se houver adoção por equipe ou desenho de receita, avance para consultoria. A comparação de produtos começa em products.

Um CTA não precisa aparecer só no final. Perto da introdução, o PDF gratuito reduz atrito. Depois dos exemplos, Gumroad faz sentido. Quando o tema entra em equipe ou produção, consultoria vira o próximo passo natural.

Métricas para observar depois da publicação

Depois observe cliques dos artigos Obsidian para Prompt Templates e Setup Guide.

Depois de publicar, separe PV, leitura do início, cliques internos, cadastros no PDF gratuito, cliques Gumroad e visitas à consultoria. HTTP 200 não basta. h1, canonical, heroImage, CTA e corpo localizado precisam apontar para a mesma ação.