---
name: second-brain-bootstrap
description: Entrevista o usuário e constrói um second brain mínimo com Claude — pasta com voce.md, acesso do Claude, regras e 1 cliente. Use quando alguém pede ajuda pra começar segundo cérebro do zero ou quer destravar o Claude com contexto.
type: skill
aliases:
  - /second-brain
---

# second-brain-bootstrap

Constrói um second brain funcional em 3 camadas via entrevista guiada, com o Claude já tendo acesso e contexto pra trabalhar.

## Quando disparar

- Usuário roda `/second-brain`
- Usuário diz "quero criar meu segundo cérebro" / "quero destravar o Claude com contexto"
- Usuário está zerado e quer começar agêntico

## Quando NÃO disparar

- Usuário já tem segundo cérebro funcional
- Usuário só quer instruções técnicas (responder direto, sem entrevista)

---

## Modo — perguntar uma vez

> *"Antes de começar — você quer fazer rápido (≈10 min, só `voce.md` + acesso do Claude) ou o flow completo (≈30 min, 3 camadas com regras e 1 cliente real)?"*

- **Express** = Camadas 1+2 apenas
- **Full** = Camadas 1+2+3
- **Default se silêncio** = Express

---

## Camada 1 — pasta + voce.md

1. Perguntar onde criar (sugerir `~/vault` ou `~/Documents/vault`)
2. Detectar Obsidian: `ls /Applications/Obsidian.app >/dev/null 2>&1 && echo ok || echo missing`
   - Se faltar: avisar que **não bloqueia** (vault é só uma pasta), sugerir `brew install --cask obsidian` pra depois, seguir
3. `mkdir -p <pasta>`
4. Rodar entrevista de 3 perguntas — texto exato em `prompts/fase-1-entrevista.md`
5. Preencher template `templates/voce.md` com as respostas
6. **Mostrar preview** ao usuário
7. Salvar como `<pasta>/voce.md`
8. Confirmar Camada 1 ✓

## Camada 2 — Claude lê o vault

1. Detectar Claude Code: `command -v claude >/dev/null 2>&1 && echo ok || echo missing`
   - Se faltar: **bloquear** e instruir install em `claude.com/code`. Pausar até voltar.
2. Instruir o usuário: `cd <pasta> && claude` (aceitar permissão de filesystem)
3. **Teste:** pedir pro Claude ler `voce.md` e devolver 1 insight surpreendente sobre o usuário
4. Se passar → Camada 2 ✓
5. Se falhar → diagnosticar (ver [Fallbacks](#fallbacks))

> **Se modo = Express, encerrar aqui** com versão curta de `prompts/encerramento.md`. Oferecer `/second-brain --full` pra continuar depois.

## Camada 3 — regras + 1 cliente real

1. Rodar entrevista de regras — texto exato em `prompts/fase-3-regras.md`
2. Preencher template `templates/CLAUDE.md`. Mostrar preview. Salvar em `<pasta>/CLAUDE.md`
3. Rodar entrevista de cliente — texto exato em `prompts/fase-3-cliente.md`
4. Derivar `{{slug-cliente}}` em kebab-case do nome (ex: "Mentoria MAPA" → `mentoria-mapa`)
5. `mkdir -p <pasta>/Areas/Clientes`
6. Preencher template `templates/cliente-x.md`. Mostrar preview. Salvar em `<pasta>/Areas/Clientes/{{slug-cliente}}.md`
7. **Teste real:** rodar comando montado dinamicamente (ver `prompts/fase-3-cliente.md` → seção "Montagem dinâmica do teste") usando os 3 arquivos
8. Mostrar output → confirmar Camada 3 ✓

---

## Encerramento

Texto exato em `prompts/encerramento.md`. Cobre: resumo dos arquivos criados, próximos 3 movimentos, aviso honesto (sistema vive de manutenção).

---

## Iron Laws

1. **Preview antes de salvar** — sempre mostrar o conteúdo proposto antes de gravar
2. **Não pular fase** — Camada N exige que N-1 tenha passado
3. **Test-driven** — cada camada termina com teste real, não com "criado"
4. **Curto > completo** — `voce.md` de 5 linhas hoje vence `voce.md` perfeito nunca
5. **Quando o output sair errado, corrige o ARQUIVO, não o prompt** — esse é o ensinamento central a transmitir

---

## Fallbacks

### Claude Code instalado mas falha em ler `voce.md`

Diagnosticar em ordem:
1. **Path** — `pwd` bate com pasta do vault?
2. **Permissão** — Claude precisa permissão de filesystem; reaceitar se foi negada
3. **Arquivo** — `ls voce.md` retorna? `wc -l voce.md` > 0?

Mensagem genérica:
> *"Algo travou. Me passa o output de `pwd && ls -la voce.md && claude --version` que eu te ajudo a debugar."*

### Sistema operacional ≠ macOS

v1 é macOS-only. Se `[ "$(uname)" = "Darwin" ]` falhar:

> *"Você tá em {{OS}} — essa v1 foi calibrada pra macOS. O espírito funciona em qualquer SO, mas alguns comandos vão falhar. Se quiser tentar mesmo assim, me avisa que trato cada falha quando aparecer."*

---

## Arquivos da skill

```
SKILL.md                          ← este arquivo
templates/voce.md                 ← estrutura do voce.md
templates/CLAUDE.md               ← estrutura do CLAUDE.md
templates/cliente-x.md            ← estrutura do cliente
prompts/fase-1-entrevista.md      ← perguntas Camada 1
prompts/fase-3-regras.md          ← perguntas Camada 3 (regras)
prompts/fase-3-cliente.md         ← perguntas Camada 3 (cliente) + teste dinâmico
prompts/encerramento.md           ← texto de fechamento
```