Init

Init — Scaffolding Interativo do Vault Sharon

Você prepara um vault Sharon novo no diretório do usuário. Tudo deve ser idempotente (rodar de novo não sobrescreve arquivos existentes sem confirmação) e em português (pt-BR).

A pasta-raiz do plugin está em ${CLAUDE_PLUGIN_ROOT}. Os arquivos-fonte que você vai copiar/usar estão em:

• ${CLAUDE_PLUGIN_ROOT}/templates/entidades/ — 9 definições de entidade (copiar para entidades/ do vault)
• ${CLAUDE_PLUGIN_ROOT}/templates/domain-templates/ — 8 templates <dominio>._template.md (renomear para <dominio>/_template.md no vault)
• ${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE.md.tmpl — convenções do vault (com placeholders {{nome}}, {{cargo}}, {{empresa}}, {{nome-kebab}})
• ${CLAUDE_PLUGIN_ROOT}/templates/README.md.tmpl — README opcional pro vault
• ${CLAUDE_PLUGIN_ROOT}/templates/.gitignore.tmpl — gitignore sugerido
• ${CLAUDE_PLUGIN_ROOT}/templates/.mcp.json.tmpl — config do MCP de calendar (com placeholder {{vault-path}})
• ${CLAUDE_PLUGIN_ROOT}/templates/contextos-me._template.md — template do perfil do dono (com placeholders {{nome}}, {{cargo}}, {{empresa}}, {{nome-vault}}, {{time}})

---

Fluxo passo a passo

Passo 1: Confirmar diretório

Detecte o CLAUDE_PROJECT_DIR (ou $PWD) e pergunte:

Vou montar o vault Sharon em <path>. Confirma? (s/n)

Se o usuário não confirmar, pergunte onde quer scaffoldar.

Passo 2: Verificar estado atual

Liste o que já existe no diretório (entidades/, pessoas/, daily/, etc.). Se já houver estrutura, mostre:

Algumas pastas/arquivos já existem: <lista>. Vou pular o que existe e só criar o que falta. OK?

Aguarde confirmação. Tudo daqui em diante usa cp -n (no clobber) e checa existência antes de criar.

Passo 3: Coletar perfil do dono do vault

Pergunte em sequência (uma de cada vez, ou tudo de uma vez se o usuário preferir):

• Nome completo (ex: "Alan Pazetto")
• Cargo (ex: "Staff Engineer", "Engineering Manager")
• Empresa (ex: "Stone", "Acme Corp")
• Time/Tribo (ex: "Tribo Vendas Core")
• Nome curto do vault (default: "Vault de <primeiro-nome>")

Calcule nome-kebab a partir do nome completo (ex: alan-pazetto).

Passo 4: Criar estrutura de pastas

Crie (com mkdir -p, idempotente) no diretório do vault:

daily/<ano-atual>/<mes-atual-zero-padded>/
pessoas/
times/
projetos/
reunioes/
one-on-ones/
pdi/
avaliacoes/
contextos/me/
contextos/quarter/
entidades/

Passo 5: Copiar entidades

Para cada .md em ${CLAUDE_PLUGIN_ROOT}/templates/entidades/:

• Se não existir em <vault>/entidades/<arquivo>, copie.
• Se existir, pule (informe ao usuário).

Passo 6: Copiar templates de domínio

Para cada <dominio>._template.md em ${CLAUDE_PLUGIN_ROOT}/templates/domain-templates/:

• Renomeie para <dominio>/_template.md no vault.
• Mapeamento:
  • pessoas._template.md → pessoas/_template.md
  • projetos._template.md → projetos/_template.md
  • daily._template.md → daily/_template.md
  • times._template.md → times/_template.md
  • reunioes._template.md → reunioes/_template.md
  • one-on-ones._template.md → one-on-ones/_template.md
  • pdi._template.md → pdi/_template.md
  • avaliacoes._template.md → avaliacoes/_template.md
• Se já existir, pule.

Passo 7: Criar contextos/me/<nome-kebab>.md

Use ${CLAUDE_PLUGIN_ROOT}/templates/contextos-me._template.md como base. Substitua placeholders:

• {{nome}} → nome completo
• {{cargo}} → cargo
• {{empresa}} → empresa
• {{nome-vault}} → nome do vault
• {{time}} → time/tribo

Salve em <vault>/contextos/me/<nome-kebab>.md. Se já existir, pergunte antes de sobrescrever.

Passo 8: Criar CLAUDE.md na raiz do vault

Use ${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE.md.tmpl como base. Substitua placeholders:

• {{nome}}, {{cargo}}, {{empresa}}, {{nome-kebab}}

Salve em <vault>/CLAUDE.md. Se já existir, mostre o diff e pergunte antes de sobrescrever.

Passo 9: Criar README.md e .gitignore (opcional)

Pergunte: "Quer um README.md e .gitignore básicos no vault?"

Se sim:

• README: copie ${CLAUDE_PLUGIN_ROOT}/templates/README.md.tmpl substituindo {{nome}}, {{cargo}}, {{empresa}}, {{nome-vault}}.
• .gitignore: copie ${CLAUDE_PLUGIN_ROOT}/templates/.gitignore.tmpl (sem placeholders).

Passo 10: Apple Calendar MCP (opcional, macOS-only)

Detecte o OS. Se não for macOS, pule esta etapa e avise.

Em macOS, pergunte: "Quer ativar a integração com Apple Calendar? (precisa de Swift toolchain — xcode-select --install)"

Se sim:

1. Rode bash "${CLAUDE_PLUGIN_ROOT}/bin/build-calendar-mcp.sh" "<vault-path>".
2. O script compila calendar_mcp.swift para <vault>/.mcp-apple-calendar/calendar_mcp (binário executável).
3. Gere <vault>/.mcp.json a partir de templates/.mcp.json.tmpl substituindo {{vault-path}} pelo path absoluto do vault.
4. Avise que na primeira execução o macOS vai pedir permissão de calendário.

Se o build falhar, mostre o erro e ofereça pra continuar sem o MCP.

Passo 11: Resumo final

Mostre:

✅ Vault Sharon pronto em <path>

Estrutura criada:
- entidades/ (9 arquivos)
- pessoas/, times/, projetos/, daily/<ano>/<mes>/, reunioes/, one-on-ones/, pdi/, avaliacoes/, contextos/{me,quarter}/
- Templates _template.md em cada pasta de domínio
- contextos/me/<nome-kebab>.md (seu perfil)
- CLAUDE.md (convenções)

Próximos passos:
- /sharon:daily       → monta sua daily note de hoje
- /sharon:novo-projeto → cria seu primeiro projeto
- /sharon:nova-pessoa  → cadastra alguém do time

📖 Veja CLAUDE.md pra lista completa de comandos.

---

Regras de comportamento

• Idempotência: rodar /sharon:init duas vezes nunca sobrescreve nada sem perguntar.
• Confirmação antes de cada bloco: pergunte antes de criar pastas, copiar arquivos em massa, e antes do build do MCP.
• Fallback gracioso: se algum passo falhar (ex: sem permissão de escrita, build do MCP quebra), avise e continue com o que dá pra fazer.
• Tudo em pt-BR: mensagens, perguntas, arquivos gerados.