O CEO da empresa que desenvolve o Obsidian lançou um manual de instruções gratuito para IA.
Você pode encontrá-lo aqui:
https://github.com/kepano/obsidian-skills
Ele contém apenas 5 arquivos de texto. Leva apenas 5 minutos para instalar e não vai quebrar nenhuma das suas anotações existentes.
Ao adicioná-los, a IA entenderá a formatação específica do Obsidian. Essa é a resposta oficial para o problema de "a IA bagunçar minhas anotações".
Quando vi isso virar um assunto quente e abri meu próprio ambiente para instalar, percebi que ele já estava lá...
A data do arquivo era 26 de abril. Eu tinha instalado há três meses e meio e tinha esquecido completamente (risos).
Então, o que mudou no meu Obsidian nesses três meses e meio? Fiquei curioso, mas os resultados foram bem decepcionantes.
Para ir direto à conclusão: as instruções oficiais sozinhas não são suficientes. Há mais uma página que você precisa escrever por conta própria.
O que a IA não sabe é a sintaxe específica do Obsidian
O Obsidian tem vários recursos únicos que o diferenciam dos aplicativos de anotações comuns.
Para vincular notas, você as envolve com [[ ]]. (Links)
Para fazer uma nota se destacar, você usa uma sintaxe específica para criar uma caixa colorida. (Callouts)
No topo de um arquivo há uma seção para datas e tags. (Properties)
A IA escreve sem saber disso. Então, embora o texto possa estar bom, quando você o abre no Obsidian, os links não estão conectados ou as caixas não aparecem.
Os 5 arquivos que linkei no início preenchem essa lacuna. Eles estão divididos assim:
- obsidian-markdown (Sintaxe correta para links e caixas)
- obsidian-bases (Organizando notas como uma tabela de banco de dados)
- json-canvas (Criando diagramas que conectam notas com linhas)
- obsidian-cli (Pesquisando todo o vault via comandos)
- defuddle (Importando páginas da web como notas limpas)
Você pode baixá-los gratuitamente no link acima.
Eles não são específicos de nenhuma ferramenta de IA, então funcionam da mesma forma com Claude Code ou Codex.
Quase nada mudou após 3,5 meses com eles instalados
Sinceramente, ri quando os encontrei. Eu já tinha as famosas instruções... e nem percebi (risos).
No entanto, como elas só funcionavam no Claude Code, copiei os mesmos 5 arquivos para o Codex em 9 de agosto para poder usá-los em qualquer um dos dois.
Agora, aqui está o ponto principal.
O que mudou no meu Obsidian depois de três meses e meio?
- Notas usando callouts: 32 de 1.387
- Visualizações de banco de dados: 1
- Canvas: 1
Quase nada mudou.
Isso não quer dizer que as instruções oficiais sejam ruins. Naturalmente, o conteúdo é bem-feito.
Quando as instalei pela primeira vez, testei, pensei "Ah, que útil", e só. Como eu não tinha decidido quando usá-las, esse foi o resultado natural.
O motivo de nada ter mudado é claro: as instruções oficiais ensinam o "como escrever".
Saber escrever não aumenta o conteúdo que você escreve. Também não decide onde colocar as coisas.
Existem dois tipos de instruções para dar à IA
Acho que isso é muito importante.
Existem dois tipos de manuais de instrução para dar a uma IA.
- A sintaxe correta do Obsidian. Ela é a mesma para o Obsidian de todos, então a equipe oficial a fornece.
- Suas próprias regras internas. Onde colocar cada coisa. Quais áreas podem ser mexidas. Para onde devem ir os produtos finalizados.
A equipe oficial fornece apenas o primeiro.
E a causa de um vault bagunçado geralmente é o segundo. É mais problemático ter algo escrito corretamente, mas colocado no local errado, do que ter um erro de sintaxe.
É aqui que você se mete em problemas sem "regras internas":
- Artigos finalizados são salvos em uma pasta diferente toda vez.
- A IA adiciona texto a um diário que você queria manter como somente leitura.
- Mesmo que você tenha mudado o nome de uma pasta, novas notas continuam aparecendo com o nome antigo.
Em todos esses casos, a sintaxe está perfeita. Apenas a colocação e o manuseio estão errados.
Por exemplo, as instruções oficiais dizem: "Conecte notas relacionadas com links." Isso está correto.
Mas minha regra é o oposto: só linkar notas que eu "com certeza abrirei depois". Se eu aumentar demais os links, não consigo encontrar nada.
Não se trata de qual está certo; é só que o guia oficial não consegue levar em conta minhas circunstâncias específicas.
Não importa o quanto você use IA, seus ativos não vão aumentar sozinhos. Você já tem os materiais; só falta o "recipiente".
As instruções oficiais ensinam o "formato" do recipiente, mas você precisa decidir o que colocar onde.
━━━━━━━━━━━━
Para quem usa IA, mas acha que a criação de conteúdo não está ficando mais fácil:
Pare de começar do zero toda vez: mantenha seus materiais em um só lugar.
Comecei o "Registro de Implementação Obsidian x Agentes de IA do Minami".
Leia gratuitamente aqui ↓
https://lifebaselab-m.com/p/r/j8MTvDdP?free1=x
━━━━━━━━━━━━
Os 4 itens mínimos necessários para suas regras internas
Criei um único arquivo no Obsidian chamado "Regras de Operação" e escrevi tudo lá. Tanto o Claude quanto o Codex leem este arquivo antes de começar a trabalhar.
Aqui estão os 4 itens mínimos para colocar as coisas em funcionamento:
- Áreas que podem ser mexidas vs. áreas somente leitura. No meu caso, diários, clipes da web e notas não classificadas são somente leitura. Esta é a parte mais importante.
- Destino do trabalho finalizado. Defina os locais: posts do X vão aqui, artigos do Note vão ali. Isso impede que a IA pergunte toda vez.
- Rota de fuga para quando estiver indeciso. Se ficar em dúvida por 3 segundos, coloque em "Não classificado". Isso evita travar na classificação.
- Defina um único lugar para as regras. Não escreva regras operacionais em notas aleatórias. Use sempre o arquivo mestre.
Principalmente o 4º item. Sem isso, as regras se espalham por todo lado e você perde o controle de qual é a versão mais recente.
Faço verificações semanais para garantir que não fique só na instalação
Entre os 5 arquivos mencionados anteriormente está o obsidian-cli, que permite inspecionar todo o vault com comandos. Ele encontra notas órfãs, contagens de uso de tags e links quebrados.
É útil, mas não funciona a menos que você o rode.
Então, configurei essa "inspeção" para rodar automaticamente como uma verificação semanal. Ela roda sozinha todo domingo de manhã e produz um relatório de possíveis links quebrados e notas esquecidas.
O maior benefício é não precisar lembrar de fazer isso.
Ter instalado e ter em funcionamento são duas coisas diferentes.
Digo isso como alguém que passou três meses e meio com isso instalado sem que nada mudasse, então provavelmente tenho razão (risos).
Conclusão
Instalar as instruções oficiais leva 5 minutos. É gratuito e não vai quebrar suas anotações. Não custa nada fazer isso.
Mas isso só muda a sintaxe.
O motivo de o Obsidian ficar bagunçado quando deixado nas mãos da IA não é porque você é ruim em usá-lo. É só porque você ainda não tem um único arquivo de "regras internas" que a IA possa ler.
Então, não sinta que precisa memorizar tudo antes de delegar. A equipe oficial fornece a sintaxe; você só precisa escrever uma página.
Se for fazer isso hoje, comece escrevendo uma linha para separar onde a IA pode mexer e onde não pode. "A pasta do diário é somente leitura. Não a reescreva" já é suficiente.
Mesmo isso vai reduzir significativamente a quantidade de correções que você terá que fazer depois que a IA terminar.
━━━━━━━━━━━━
Obrigado por ler até o fim!
Anúncio 📢
Estou com um Open Chat ativo!
Com o objetivo de aumentar os "Obsidianos", compartilho histórias diárias sobre Obsidian x Agentes de IA que não publico no X.
Também distribuo brindes, então, se você tiver interesse, dê uma olhada ↓
