obsidian-init

# obsidian-init Scaffolda um vault Obsidian completo seguindo o padrao `obsidian-master-kit`: 4 areas, CLAUDE.md doutrina, `_INDEX.md` vivo, MOCs por area, templates por tipo de nota. ## Quando usar - Usuario diz: "quero criar meu segundo cerebro", "inicia meu vault Obsidian", "scaffolda um Obsidian pra mim", "cria a estrutura de pastas do Obsidian" - Usuario invoca `/obsidian-master-kit:init` (slash command) - Usuario aponta para uma pasta vazia e quer transformar em vault ## Quando **nao** usar - Usuario ja tem um vault funcionando e so quer adicionar notas (use outras skills) - Usuario quer editar o CLAUDE.md do vault (ele mesmo edita, nao a IA) - Usuario quer sincronizar um vault existente (use `obsidian-librarian`) ## Como usar — fluxo canonico ### Passo 1: Determine o diretorio-alvo Pergunte onde scaffoldar. Candidatos comuns: - Pasta atual (pwd) — se o usuario ja fez `cd` para la - `~/Documents/<NomeDoVault>` — escolha dele - Um `--path` explicito que ele pode ter passado Sempre confirme antes de prosseguir. **Nao scaffolda em `~` ou em pasta com codigo**. ### Passo 2: Cheque estado do alvo Se a pasta tem arquivos: - Tem `.obsidian-master/marker.json`? Ja e um vault-master — aborte e sugira `/obsidian-master-kit:sync` em vez disso. - Tem outros arquivos? Confirme com o usuario antes de prosseguir. O script preserva arquivos existentes (so preenche buracos), mas avise. ### Passo 3: Conduza a entrevista Siga o roteiro em `references/interview-script.md`. Sao 7 perguntas curtas em pt-br. Se o usuario passou `--profile <arquivo>`, leia o arquivo e pule perguntas ja cobertas. ### Passo 4: Invoque o script Use o script `scripts/scaffold_vault.py` passando todas as respostas via flags. Exemplo: ```bash python3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-init/scripts/scaffold_vault.py \ --path "/Users/nome/Documents/MeuVault" \ --owner-name "Nome Sobrenome" \ --owner-profession "Desenvolvedor de software" \ --owner-areas "Backend; DevOps; Mentoria" \ --owner-projects "Projeto A; Projeto B" \ --owner-lang "pt-br" \ --owner-timezone "America/Sao_Paulo" \ --owner-tone "casual" \ --vault-name "Meu Segundo Cerebro" ``` O script: 1. Copia a arvore de `assets/vault-template/` para o alvo. 2. Interpola placeholders (`{{OWNER_NAME}}`, `{{DATE_TODAY}}`, etc.). 3. Gera stubs por projeto em `01 - Profissional/Projetos/`. 4. Gera stubs por area em `01 - Profissional/Areas/`. 5. Escreve `.obsidian-master/marker.json` com a versao do kit. 6. Imprime relatorio: arquivos criados, projetos stubados, proximos passos. **Nunca sobrescreve arquivos existentes.** Use `--dry-run` antes se incerto. ### Passo 5: Reporte proximos passos Depois que o script termina: - Diga ao usuario para abrir a pasta no Obsidian (File > Open Vault). - Sugira revisar `00 - Pessoal/Perfil.md` e ajustar a bio. - Sugira criar a primeira entrada de diario usando o template. - Mencione que daqui pra frente o bibliotecario cuida do `_INDEX.md` sozinho. ## Flags do script — referencia rapida | Flag | Obrigatoria? | Default | Descricao | |---|---|---|---| | `--path` | nao | pwd | Onde scaffoldar o vault | | `--owner-name` | sim | — | Nome do dono | | `--owner-profession` | sim | — | Funcao / profissao | | `--owner-areas` | nao | "" | Areas separadas por `;` | | `--owner-projects` | nao | "" | Projetos separados por `;` | | `--owner-lang` | nao | pt-br | Idioma do journaling | | `--owner-timezone` | nao | America/Sao_Paulo | Fuso | | `--owner-tone` | nao | casual | `casual` ou `formal` | | `--vault-name` | nao | basename do path | Nome humano do vault | | `--profile` | nao | — | YAML/JSON com todas as respostas | | `--dry-run` | nao | false | Imprime plano, nao escreve | | `--force` | nao | false | Permite escrever em pasta ja com conteudo | ## Guardrails - **Nunca** rode o script sem confirmar path com o usuario. - **Nunca** rode em `$HOME`, `/`, `/Users`, `/tmp` (sem `--force`) ou em pasta com `.git` que nao seja um vault-master. - **Nunca** sobrescreve arquivos existentes (o script ja protege, mas confirme antes). - Se a pasta tem `.obsidian-master/marker.json`, nao rode init — use o librarian. ## O que este skill NAO faz - Nao instala o Obsidian (app). Isso e manual. - Nao configura plugins do Obsidian (Dataview, Templater, etc.). Ver roadmap. - Nao sincroniza com nuvem. Ver FAQ do README principal. - Nao edita o CLAUDE.md do vault depois de criado — isso e territorio humano.