Como usar o Claude Code para transformar anotações soltas em notas permanentes

Fala aí, beleza? Aposto que tu tem uma pasta cheia de arquivo solto

Print de ideia, três linhas jogadas no meio de uma reunião, um parágrafo copiado de um artigo que tu jurou que ia ler depois

Essa pasta cresce, cresce, e nunca vira conhecimento

A parte boa é que o Claude Code lê e escreve arquivo markdown local, então o fichamento (pegar a captura crua e fechar uma nota que se sustenta sozinha) pode virar um pedido repetível, e não um mutirão de domingo à noite

Neste post eu mostro o passo a passo, o que escrever na skill que guarda a SUA regra de fichamento, e principalmente o que conferir antes de aceitar o que o agente propõe 🙂

O que você precisa antes de começar

São duas frentes: a conceitual (senão tu automatiza bagunça) e a técnica

Nota fugaz e nota permanente: qual é a diferença?

O método por trás disso é o Zettelkasten: cada pensamento mora numa ficha separada, e as fichas relacionadas ficam ligadas entre si

Nota fugaz (fleeting note) é a captura rápida, feita enquanto tu faz outra coisa: ela existe pra ser processada e depois descartada, é matéria-prima, não produto final

Nota permanente é outra história: escrita com cuidado, de uma ideia só, adicionada ao fichário com identificador e ligações, pensada pra ser entendida sozinha

E tem o princípio da atomicidade, que é o coração disso tudo: cada nota carrega uma única ideia completa, pequena o bastante pra se sustentar sozinha, o que facilita conectar, reorganizar e construir em cima

Sacou o pulo do gato? O trabalho do agente aqui NÃO é escrever mais texto, é fechar a nota

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

A parte técnica: onde as notas moram

Nada de mágica: as anotações precisam estar em arquivos markdown, numa pasta que tu consiga apontar

Se o teu cofre de notas fica fora do diretório onde tu abriu a sessão, usa a flag --add-dir, que adiciona diretórios de trabalho extras e valida se cada caminho existe como diretório

claude --add-dir ../apps ../lib

Tome cuidado com uma pegadinha aqui: por padrão, arquivos CLAUDE.md dos diretórios adicionados com --add-dir não são carregados

Pra carregar, a documentação de memória do Claude Code manda subir uma variável de ambiente:

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir <caminho>

E vale lembrar do custo disso: arquivos CLAUDE.md são carregados na janela de contexto no início de toda sessão e consomem tokens junto com a conversa

Por isso a documentação recomenda manter cada CLAUDE.md enxuto… e olha que dividir em imports com a sintaxe @caminho ajuda na organização, mas não reduz o contexto, porque os arquivos importados também carregam na abertura

Se tu ainda não tem esse arquivo, o /init gera um CLAUDE.md, e o /memory abre a pasta de memória automática pra navegar, ler, editar ou apagar os markdown salvos

Passo a passo: do rascunho solto à nota permanente

Bora ver na prática? Cada passo tem a ação e o erro comum que ele costuma cobrar de você

1. Dá acesso à pasta das notas

Abre a sessão dentro da pasta das notas ou aponta ela com --add-dir, do jeito que mostrei ali em cima

O erro comum deste passo: passar um caminho que não existe (a flag valida se cada caminho existe como diretório, então ela reclama na hora) e esquecer que o CLAUDE.md daquela pasta só entra com a variável de ambiente

2. Escreve a regra de fichamento numa skill

Aqui é onde a coisa deixa de ser prompt improvisado e vira processo. Skills do Claude Code ficam em pastas com um arquivo SKILL.md: ~/.claude/skills/<nome>/SKILL.md pra skill pessoal e .claude/skills/<nome>/SKILL.md pra skill do projeto

O SKILL.md tem duas partes: o frontmatter YAML entre os marcadores ---, que diz quando usar a skill, e o corpo markdown com as instruções que o Claude segue

O frontmatter exige name (só minúsculas, números e hifens) e description (não pode ser vazia)

   ---
   name: fichamento
   description: Transforma anotacoes soltas e capturas rapidas em notas permanentes atomicas, com titulo autoexplicativo e links para notas existentes. Use quando o usuario pedir para fichar, processar o inbox ou fechar uma nota
   ---

   # Fichamento de notas permanentes

   Regras do formato:
   - uma ideia por nota, sem juntar dois assuntos no mesmo arquivo
   - o titulo tem que ser uma frase que se entende fora de contexto
   - antes de criar, procure notas ja existentes sobre o assunto e cite os arquivos encontrados
   - nao invente link para nota que nao existe no cofre

O erro comum deste passo: escrever uma description que documenta a skill em vez de acionar ela. A description é injetada no system prompt e o Claude compara o teu pedido com ela pra decidir se carrega a skill, então ela precisa dizer o que a skill faz E quando usar

Nota lateral pra quem vem do formato antigo: comandos personalizados em .claude/commands/ (projeto) e ~/.claude/commands/ (pessoal) são o formato legado. O recomendado hoje é .claude/skills/<nome>/SKILL.md, que aceita a mesma invocação por /nome e ainda pode ser chamado sozinho pelo Claude

3. Roda o fichamento em modo plano

Antes de deixar o agente encostar em arquivo, pede a proposta. O modo plano faz o Claude pesquisar e propor mudanças sem executá-las: ele lê arquivos, roda comandos de exploração e escreve um plano, mas não edita nada

Tem três formas de entrar: Shift+Tab até a barra de status mostrar o modo plano, prefixar um único prompt com /plan, ou já começar a sessão assim:

   claude --permission-mode plan

O Shift+Tab dentro da sessão cicla entre os modos de permissão na ordem default, acceptEdits e plan, então é um toque a mais ou a menos e tu já mudou o jogo

Esse hábito de ver o plano antes vale pra qualquer tarefa de risco, é o mesmo cuidado de quando tu vai refatorar um projeto legado e não quer descobrir o estrago depois

O erro comum deste passo: achar que o modo plano já salvou alguma coisa. Ele lê e propõe, ponto: o arquivo só nasce quando tu aprova e sai do plano

4. Pede a ligação com o que já existe

Nota permanente sem ligação é arquivo perdido. Escreve no prompt (ou no corpo da skill) que, antes de fechar a nota, ele tem que procurar notas relacionadas no cofre

Pra isso o Claude usa o Grep, que busca conteúdo de arquivos com expressões regulares e aceita o parâmetro glob pra limitar o escopo, e o Glob, que encontra arquivos por padrão de nome

O erro comum deste passo: cofre dentro de um repositório com pasta ignorada. O Grep respeita o .gitignore, ou seja, arquivo ignorado pelo git é pulado na busca, e aí o agente jura que não existe nota nenhuma sobre o assunto

5. Confere ANTES de aceitar

Essa é a parte que ninguém mostra e é a que separa fichário de lixão. Passa o olho em quatro coisas:

– uma ideia por nota (se tem dois assuntos, são duas notas) – o título se sustenta sozinho, fora de qualquer contexto – os links apontam pra notas que existem de verdade no cofre – a nota está escrita pra ser entendida sem a captura original do lado

E olha a ferramenta que ele escolheu pra gravar: o Write cria ou sobrescreve um arquivo, o Edit substitui um trecho em arquivo existente

O erro comum deste passo: deixar passar um Write em cima de uma nota que já existia. Sobrescreveu, foi

Se tu já validou o formato e vai rodar um lote, o modo acceptEdits acelera: ele aceita automaticamente edições de arquivo e comandos comuns de sistema de arquivos como mkdir, touch e mv, mas continua perguntando antes de rodar outros comandos de terminal

6. Deixa a rede de segurança armada

O Claude Code registra automaticamente as edições de arquivo feitas na sessão e permite voltar atrás pelo menu de rewind, com um checkpoint capturado antes de cada prompt teu

O menu abre com /rewind ou apertando Esc duas vezes com o campo de prompt vazio, e oferece restaurar código e conversa, restaurar só a conversa ou restaurar só o código

O erro comum deste passo: apertar Esc duas vezes com texto digitado. Aí ele limpa o texto em vez de abrir o menu

E tem o limite honesto: o checkpointing só rastreia arquivos editados dentro da sessão atual, então mudança que tu fez na mão fora do Claude Code, ou edição de outra sessão rodando ao mesmo tempo, normalmente não é capturada

7. Ajusta a skill e roda de novo

Saiu torto? Edita o SKILL.md e manda de novo, sem drama: quando tu adiciona, edita ou remove uma skill em ~/.claude/skills/, no .claude/skills/ do projeto ou num .claude/skills/ dentro de diretório passado com --add-dir, o Claude Code percebe a mudança na sessão atual, sem reiniciar

Pra chamar na mão, é só /nome-da-skill (o nome do comando vem do nome da pasta ou do arquivo), e o modelo também pode acionar sozinho pela description

O erro comum deste passo: reescrever o prompt toda vez em vez de corrigir a skill. Se a regra não mora num arquivo, ela se perde na próxima sessão

Como esse fluxo se comportou no meu Obsidian

Confissão: eu desisti do Obsidian várias vezes

Achava complicado, muita configuração pra pouco resultado, mesmo tendo visto tutorial e um monte de gente usando bem

O que virou a chave foi automatizar a organização com o agente, e o pulo do gato foi bem simples: abrir o Claude Code dentro da pasta do cofre, o que dá acesso pleno aos arquivos de notas

No vídeo eu monto um cofre novo do zero, mas isso é só pra demonstração: dá pra usar um cofre que tu já tem hoje

O que mais pesou no resultado não foi ferramenta nenhuma, foi o arquivo de contexto. Eu escrevi um CLAUDE.md descrevendo o propósito do cofre (no meu caso, um segundo cérebro pra criador de conteúdo de tecnologia) e a estrutura saiu redonda: inbox onde cai tudo que entra, e mais projetos, pesquisa, roteiros, referência, diário e templates

No mesmo pedido eu já defini os templates reutilizáveis: template de projeto de vídeo (tema, status, pesquisa, roteiro, thumbnail, links), de nota de pesquisa (fonte, resumo, pontos principais, como usar no conteúdo), de nota diária e de referência

E pedi dados de exemplo fictícios junto (projetos em status diferentes, notas de pesquisa e notas diárias com referência cruzada) só pra conferir se o esquema funcionava do jeito que eu queria antes de colocar coisa de verdade lá dentro

Agora, o que EU tive que deixar explícito, e recomendo que tu também deixe:

• português brasileiro escrito com todas as letras no arquivo de contexto, porque as skills que eu usei estão em inglês e a IA tende a te responder em inglês
• convenções de link e metadado: links internos em wikilinks, front matter obrigatório com tags e data, notas diárias organizadas por ano/mês/dia
• lista fechada de status pros projetos: ideia, pesquisando, roteiro, gravando, editando, publicando (sem lista fechada, cada nota inventa um status novo)
• nome de arquivo sem acento e sem espaço, usando hífen, pra não dar problema de acesso e edição por nenhuma das partes

Repara que nada disso é recurso da ferramenta, é regra que tu escreve. Wikilink, por exemplo, é convenção do teu cofre: a documentação oficial não diz que o Claude Code entende esse formato por conta própria, então ele faz porque está escrito, não porque adivinha

Durante a execução ele vai pedindo confirmação e eu vou aprovando arquivo por arquivo. Hoje, sabendo do modo plano, eu passaria o lote inteiro por ele antes: é bem mais confortável ler a proposta fechada do que decidir na pressa a cada confirmação

Depois abri o Obsidian e a estrutura estava lá: dá pra navegar nos projetos, ver campos como público-alvo, anotações, links e recursos, e as referências criadas entre as notas

Eu também criei skill própria e local dentro do projeto pra não poluir as skills globais, e usei uma skill de pesquisa pra levantar material sobre um tema de vídeo, gerando a nota de pesquisa já dentro do cofre, prontinha pra começar a produção. Tem até uma que limpa página web salva, tirando navegação, anúncio e rodapé pra sobrar só o conteúdo

Um aviso honesto: as skills de Obsidian que eu uso são de terceiros e eu não consegui confirmar quem mantém cada uma, então não vou sair recomendando nome aqui. O fluxo do post inteiro funciona sem elas, com skill sua escrita à mão

E sim, eu continuo achando o Obsidian sozinho complicado. Gosto dos wikilinks, do mapa visual de notas, do canvas, das bases de dados e dos plugins da comunidade, mas o que me fez ficar foi o agente fazendo a parte chata

No vídeo tu vê a tela inteira: o cofre nascendo do zero, o arquivo de contexto sendo escrito, o prompt que gera a estrutura com os templates e o Obsidian abrindo depois com tudo no lugar

Outras entradas que valem fichar do mesmo jeito

O formato da nota permanente é sempre o mesmo, o que muda é a entrada e uma linha do pedido

Rascunho de reunião:

O texto vem cronológico e misturado (decisão, contexto, fofoca, próximo passo). Pede pra separar decisão de contexto e gerar uma nota por decisão tomada, cada uma com o título já escrito como afirmação

O cuidado aqui: reunião gera muita coisa que é tarefa, não conhecimento. Deixa claro na skill que tarefa não vira nota permanente

Trecho copiado de leitura:

Esse é o clássico do fichamento. Pede a ideia reescrita com as tuas palavras e o trecho original preservado à parte, com a fonte no metadado

Se misturar citação com interpretação, daqui a seis meses tu não sabe mais o que era do autor e o que era teu

Arquivo de inbox que virou um monstro:

Aquele markdown único com trinta ideias jogadas. Pede pra ler o arquivo inteiro, propor UMA nota por ideia atômica e listar as que ele acha que são a mesma coisa repetida

Esse é o caso que mais pede modo plano: ver a lista de notas propostas antes de trinta arquivos aparecerem no cofre

Anotação de estudo:

Aqui a ligação é o que interessa. Pede explicitamente pra procurar no cofre notas do mesmo assunto (via Grep e Glob) e ligar a nota nova nelas, sem inventar link pra nota que não existe

É o passo que transforma pasta de anotação em rede de verdade

Próximo passo

O ganho aqui não é escrever mais rápido

É FECHAR a nota: sair da captura crua e chegar numa ideia que se sustenta sozinha e conversa com o que tu já tinha escrito

Então o próximo passo é bem concreto: cria a skill de fichamento com o formato da SUA nota permanente (~/.claude/skills/<nome>/SKILL.md se for pessoal, .claude/skills/<nome>/SKILL.md se for do projeto) e roda o primeiro lote em modo plano

Lê a proposta com calma. Se o resultado desviar do que tu queria, ajusta a description e o corpo do SKILL.md e roda de novo, que a skill recarrega na hora, sem reiniciar a sessão

Duas ou três voltas e tu tem um fichamento que é teu, não o padrão de fábrica de ninguém 😀

até o próximo post!