Transforma uma pasta vazia no seu segundo cérebro em 5 minutos.
Você roda um comando, responde 7 perguntinhas, e pronto — você tem uma estrutura profissional do Obsidian com pastas, templates e um "bibliotecário" de inteligência artificial que organiza tudo pra você sozinho, pra sempre.
- Uma pasta do Obsidian já organizada do jeito certo, sem precisar pensar em estrutura: tem espaço pra suas anotações pessoais, trabalho, pesquisas e memória de projetos.
- Um assistente que cura suas notas sozinho. Sempre que você (ou uma outra IA) escrever alguma coisa no seu Obsidian, ele revisa, põe etiquetas, conecta com outras notas, e mantém um índice sempre atualizado.
- Templates prontos pra cada tipo de anotação: diário, reflexão pessoal, pesquisa, projeto de trabalho, contexto de software que você está construindo.
- Um arquivo de doutrina (
CLAUDE.md) que explica pra qualquer IA que for usar seu Obsidian depois: "as regras da casa são essas aqui". Qualquer skill respeita automaticamente. - Forge (v1.1): um módulo de execução de negócio. Conduz entrevista dos
3 Ps + matemática do resultado + 7 ações macro, e abre um painel ao vivo em
localhost:4712onde você registra progresso com um clique e vê a agulha se mover. Tudo local, sem nuvem.
Tudo em português. Você não precisa saber nada sobre Obsidian pra começar.
Duas coisas, nada mais:
- Claude Code instalado no seu computador (Mac, Windows ou Linux).
- Obsidian instalado — é grátis.
Se você já tem os dois, pula pra instalação.
A instalação é feita dentro do próprio Claude Code, usando o sistema de plugins dele. Você não precisa clonar nada no terminal, nem saber onde os arquivos vão parar — o Claude Code cuida de tudo.
Dentro do Claude Code, digite:
/plugin marketplace add melgarafael/obsidian-master-kit
O que isso faz: diz pro seu Claude Code "olha, esse repositório do GitHub tem plugins que você pode instalar". É uma só vez — depois disso, o Claude Code sabe onde achar o kit.
Ainda dentro do Claude Code:
/plugin install obsidian-master-kit@obsidian-master-kit
Pronto. O Claude Code baixa o plugin, registra as skills, commands e hook. Em alguns segundos os comandos já aparecem no autocomplete.
Digite / no Claude Code e veja se aparecem na lista:
/obsidian-master-kit:init/obsidian-master-kit:sync/obsidian-master-kit:forge-plan/obsidian-master-kit:forge-scan/obsidian-master-kit:forge-dash
Se os 5 aparecerem, tá instalado. Pula pro próximo bloco.
Se não apareceram, vai pra seção Problemas comuns.
No Terminal, crie uma pasta nova (ou use uma que você já tem em mente):
mkdir -p ~/Documents/MeuSegundoCerebro
cd ~/Documents/MeuSegundoCerebroEsse comando cria a pasta MeuSegundoCerebro dentro dos seus Documentos e
entra nela. Você pode mudar o nome se quiser.
Abra o Claude Code nessa pasta (a maioria dos sistemas deixa você clicar com botão direito na pasta e escolher "Abrir no Claude Code"). Depois digite:
/obsidian-master-kit:init
O kit vai te fazer 7 perguntinhas rápidas, todas em português:
- Seu nome
- Sua profissão ou função
- Suas áreas principais de trabalho (ex: "Backend; Mentoria")
- Seus projetos ativos agora
- Idioma que você prefere pra escrever sobre você mesmo
- Seu fuso horário
- Como prefere que a IA fale com você — formal ou casual
Responde cada uma. Não tem resposta certa ou errada — é só pra IA te conhecer.
Quando as perguntas terminam, sua pasta está cheia de arquivos organizados. Abre o Obsidian, vai em File > Open Vault > Open folder as vault, aponta pra pasta que você criou no passo 1.
Boa-vinda ao seu segundo cérebro.
Seu Obsidian tem 4 grandes áreas de partida:
| Pasta | Pra que serve |
|---|---|
| 00 - Pessoal | Quem você é. Diário, reflexões, seu perfil. |
| 01 - Profissional | Seu trabalho. Projetos, áreas de responsabilidade. |
| 02 - Pesquisas e Estudos | Onde vai tudo que você (ou a IA) pesquisa e estuda. |
| 03 - Memoria da IA | Contexto pra quando você está construindo software com IA. |
E, opcionalmente, uma 5ª área criada pelo forge:
| Pasta | Pra que serve |
|---|---|
| 04 - Negocio | Plano de negócio + metas + progresso + scanner de projetos ativos. Criada quando você roda /obsidian-master-kit:forge-plan pela primeira vez. |
Dois arquivos especiais na raiz:
- CLAUDE.md — as regras da casa. Você edita quando quer. Qualquer IA que for mexer no seu Obsidian lê ele primeiro.
- _INDEX.md — o índice vivo. Não edite à mão — é o bibliotecário que mantém atualizado sozinho.
Depois que seu segundo cérebro está de pé, o forge te ajuda a transformá-lo num sistema de execução. É baseado na metodologia "IA é ferramenta, não produto" — você usa IA pra resolver dor específica de mercado real e cobra pelo resultado.
Três comandos, um loop:
/obsidian-master-kit:forge-plan
O Claude Code te conduz por ~15 min de entrevista em 4 passos:
- 3 Ps — Produto (o que você oferece), Problema (a dor que resolve), Pessoa (quem paga).
- Precificação — valor unitário + as 4 bases de valor (resultado potencial, tempo economizado, esforço reduzido, produção aumentada).
- Matemática do Resultado — objetivo em R$ → quantos clientes → quantas reuniões → quantos leads → quanto alcance. O forge valida a aritmética e recusa números que não batem.
- 7 Ações Macro — segundo cérebro, plano, captação via conteúdo, captação/venda, script de reunião, processo de entrega, admin financeiro. Arquivos criados automaticamente.
/obsidian-master-kit:forge-scan
Primeira vez ele te pergunta quais pastas vigiar. Depois, varre git repos ativos
(commit recente ou arquivo mexido na última semana), detecta a stack (Python, Node,
Rust, Go), e escreve uma nota atômica por projeto em 04 - Negocio/contexto/. O
resultado vira contexto que qualquer IA local pode consultar.
/obsidian-master-kit:forge-dash
Sobe um dashboard em http://localhost:4712 (Chrome/Arc/Edge/Brave). Clica
"Escolher meu vault Obsidian" uma vez e pronto — ele lê seu vault direto via
File System Access API. Cinco seções:
- Os 3 Ps (pra você relembrar o norte)
- Matemática do resultado — barras de progresso por etapa do funil
- Ações macro — checkbox pra cada uma das 7 tarefas pendentes; clicar marca no arquivo
- Próximo passo sugerido — determinístico (primeira tarefa pendente da ação mais prioritária)
- Contexto vivo — projetos ativos detectados pelo scanner
Botão + registrar progresso abre um modal: escolhe tipo (lead captado, reunião
realizada, cliente fechado, conteúdo publicado, alcance manual), quantidade,
opcionalmente uma nota. Grava em progresso/YYYY-MM-DD.md, recomputa _metas.md
e as barras sobem ao vivo.
Tudo local. Zero nuvem. Zero processo em background. O dashboard é um HTML estático; o vault é a única fonte da verdade.
Guia rápido completo: docs/forge-quickstart.md.
Depois que seu vault existe, o kit trabalha pra você automaticamente.
Toda vez que você (ou uma skill de IA, tipo um pesquisador automático) adicionar uma nota nova, o bibliotecário entra em ação:
- Confere se a nota está bem formada (tem título, data, etiquetas corretas)
- Conecta a nota com as outras notas relacionadas
- Atualiza o índice
_INDEX.mdcom as novidades - Avisa se alguma coisa está estranha (nota órfã, etiqueta desconhecida)
Você não precisa chamar o bibliotecário — ele aparece sozinho.
Se quiser forçar uma arrumação manual (por exemplo, depois de editar várias notas de uma vez), digita dentro do Claude Code:
/obsidian-master-kit:sync
Não. O Obsidian é grátis pra uso pessoal. O Git é grátis. O kit é MIT (você pode usar, modificar, distribuir). O Claude Code tem planos gratuitos e pagos — se você já usa, está pronto.
É um app grátis que abre pastas de arquivos .md (texto simples) como se fosse
um wiki pessoal. Os arquivos ficam no seu computador, não na internet. Você
pode linkar notas entre si e visualizar tudo em um grafo.
Não. Tudo fica na pasta local que você criou. Nada sai do seu computador a menos que você use um serviço de sincronização (iCloud, Syncthing, Obsidian Sync, etc.) separadamente. O kit não sincroniza nada.
Funciona nos três. Os comandos do Terminal são iguais em qualquer sistema (no Windows, use o PowerShell).
Pode. O kit é idempotente — ele só preenche buracos, nunca sobrescreve nada que já existe. Mas ainda assim, antes de rodar em vault que você já usa, faz um backup (copia a pasta toda pra outro lugar). Por precaução.
Dentro do Claude Code, roda:
/plugin uninstall obsidian-master-kit
Isso remove o kit. Sua pasta do Obsidian continua intacta — ela é só uma pasta de arquivos de texto, independe do kit.
Se quiser também tirar a "fonte" do Claude Code:
/plugin marketplace remove obsidian-master-kit
Pode. O arquivo CLAUDE.md dentro do seu vault é seu — edite quando quiser.
Se você mudar, por exemplo, o nome de uma pasta, o bibliotecário vai respeitar
isso na próxima sincronização. Só não apaga o .obsidian-master/ escondido
dentro do vault — é o marcador que diz "esse vault tem o kit ativo".
Três coisas pra checar, em ordem:
- A instalação terminou de verdade? Dentro do Claude Code, roda
/plugin list. Seobsidian-master-kitaparece na lista, está instalado. Se não aparece, o/plugin installfalhou — repete a instalação. - Você adicionou o marketplace primeiro? O comando
/plugin marketplace add melgarafael/obsidian-master-kitprecisa ter rodado antes do install. Se pulou, volta ao Passo 1. - Seu Claude Code é recente o suficiente? O sistema de plugins é relativamente novo. Atualiza pra versão mais recente e tenta de novo.
- "marketplace not found" → o comando
/plugin marketplace addnão chegou a ser executado. Roda ele antes do install. - "plugin already installed" → você já instalou uma vez. Se quer reinstalar
do zero, roda
/plugin uninstall obsidian-master-kitprimeiro. - "network error" → verifique sua conexão e tente novamente. O Claude Code precisa baixar do GitHub.
O Obsidian precisa que você aponte pra ele via File > Open Vault. Não é só
arrastar a pasta. Se mesmo assim não abrir, confirma que a pasta tem arquivos
.md dentro — se não tiver, o init não rodou como deveria.
Abre uma issue em github.com/melgarafael/obsidian-master-kit/issues descrevendo:
- O que você tentou fazer
- O que aconteceu em vez (copia e cola a mensagem de erro)
- Seu sistema operacional
Resumo do que está entregue no kit agora:
| Skill | Pra que |
|---|---|
obsidian-init |
Scaffold do vault (4 áreas + templates + CLAUDE.md) |
obsidian-librarian |
Curador contínuo (roda via hook em cada escrita) |
obsidian-migrate |
Adoção não-destrutiva sobre vault existente |
obsidian-organizer |
Clusters + duplicatas |
obsidian-expand |
Notas-ponte via LLM restrito |
obsidian-forge (v1.1) |
Plano de negócio + scanner de projetos + dashboard executor |
O kit vai continuar crescendo — diário automático, busca semântica, arquivador
de notas antigas, auditor do grafo. A lista completa está em
docs/ROADMAP.md.
Se você é desenvolvedor e quer entender como o kit funciona por dentro, tem
documentação técnica em docs/DEV.md. Pra integrar com o forge
especificamente, veja docs/forge-quickstart.md.
MIT. Usa, modifica, compartilha, vende, o que quiser. Só não bota meu nome em problema.