obsidian-master-kit

obsidian-master-kit

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.

---

O que você ganha

• 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:4712 onde 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.

---

O que você vai precisar antes

Duas coisas, nada mais:

1. Claude Code instalado no seu computador (Mac, Windows ou Linux).
2. Obsidian instalado — é grátis.

Se você já tem os dois, pula pra instalação.

---

Instalação em 2 passos

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.

Passo 1 — Adicione o kit como "fonte" (marketplace) do seu Claude Code

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.

Passo 2 — Instale o plugin

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.

Confirmando que funcionou

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.

---

Primeiro uso — criando seu segundo cérebro

1. Escolha onde seu Obsidian vai morar

No Terminal, crie uma pasta nova (ou use uma que você já tem em mente):

mkdir -p ~/Documents/MeuSegundoCerebro
cd ~/Documents/MeuSegundoCerebro

Esse comando cria a pasta MeuSegundoCerebro dentro dos seus Documentos e entra nela. Você pode mudar o nome se quiser.

2. Rode o init dentro do Claude Code

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:

1. Seu nome
2. Sua profissão ou função
3. Suas áreas principais de trabalho (ex: "Backend; Mentoria")
4. Seus projetos ativos agora
5. Idioma que você prefere pra escrever sobre você mesmo
6. Seu fuso horário
7. 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.

3. Pronto — abre no Obsidian

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.

---

Como seu vault está organizado

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: