Inicializar Configuração Bootstrap

Este comando ajuda você a criar um arquivo de configuração CLAUDE.md personalizado, fazendo perguntas sobre seu fluxo de trabalho e preferências no Obsidian.

Tarefa

Leia o modelo CLAUDE-BOOTSTRAP.md e colete interativamente informações sobre o usuário:

Estrutura de vault existente (se houver)
Preferências de fluxo de trabalho
Estilo de anotações
Métodos de organização
Requisitos específicos

Em seguida, gere um arquivo CLAUDE.md customizado, adaptado às suas necessidades.

Processo

Configuração Inicial do Ambiente
- Obter data atual com o comando date para timestamps
- Verificar o nome da pasta atual e perguntar se deseja renomeá-la
- Se sim, guiá-lo através da renomeação (lidar com movimentação do diretório pai)
- Verificar se existe package.json e instalar dependências:
  - Tentar pnpm install primeiro (mais rápido, melhor)
  - Recorrer a npm install se pnpm não estiver disponível
- Verificar se as dependências principais estão instaladas
- Verificar status do git:
  - Se não houver pasta .git: Inicializar repositório git
  - Se tiver origin remota: Perguntar sobre trabalho de desenvolvimento
    - Vault pessoal: Remover origin e pasta .github
    - Contribuição: Manter origin e workflows intactos
  - Se repo local limpo: Pronto para prosseguir
- Não criar pastas ainda - aguardar até perguntar sobre método de organização
Verificar Configuração Existente
- Procurar por CLAUDE.md existente
- Se existir, perguntar se deseja atualizar ou começar do zero
- Verificar se o modelo CLAUDE-BOOTSTRAP.md existe
Coletar Informações do Vault
- Pesquisar locais comuns por vaults Obsidian existentes (pasta .obsidian)
- Verificar estes caminhos com limites de profundidade adequados:
  - ~/Documents (maxdepth 3) - todas as plataformas
  - ~/Desktop (maxdepth 3) - todas as plataformas
  - ~/Library/Mobile Documents/iCloud~md~obsidian/Documents (maxdepth 5 - apenas macOS, vaults iCloud)
  - Diretório pessoal ~/ (maxdepth 2) - todas as plataformas
  - Diretório pai atual (maxdepth 2) - todas as plataformas
- Se encontrado, perguntar: "Vault Obsidian encontrado em [caminho]. Este é o vault que deseja importar?"
- Contar arquivos corretamente: find [caminho] -type f -name "*.md" | wc -l (sem limite de profundidade)
- Mostrar tamanho do vault: du -sh [caminho]
- Se confirmado, analisar estrutura do vault:
  - Executar tree -L 3 -d [caminho] para ver a hierarquia de pastas
  - Amostrar 10-15 notas aleatórias para entender os tipos de conteúdo
  - Listar 30-50 nomes de arquivos recentes para detectar padrões de nomenclatura
  - Verificar se existe pasta de notas diárias e formato
  - Identificar as pastas mais ativas por contagem de arquivos
  - Detectar se usa PARA, Zettelkasten, Johnny Decimal ou customizado
- Se não for o vault correto ou nenhum encontrado:
  - Apenas no macOS: Perguntar: "Seu vault está armazenado no iCloud Drive? (sim/não)"
  - Se sim (macOS): "Por favor, insira o caminho completo para o seu vault (ex., ~~/Library/Mobile Documents/iCloud~~md~obsidian/Documents/SeuVault)"
  - Se não, ou no Linux/Windows: "Por favor, insira o caminho para o seu vault existente, ou digite 'pular' para começar do zero"
  - Validar caminhos fornecidos pelo usuário (veja seção "Validação de Caminho do Usuário" abaixo)
- Se não houver vault existente ou o usuário pular, eles estão começando do zero
Fazer Perguntas de Configuração
- "Qual é o seu nome?" (para personalização)
- "Gostaria que eu pesquisasse seu trabalho público para entender melhor seu contexto?"
  - Se sim: Pesquisar informações
  - SEMPRE mostrar os resultados e perguntar "Isto está correto?" para confirmação
  - Se várias pessoas forem encontradas, listá-las numeradas para seleção
  - Se for a pessoa errada, oferecer para pesquisar novamente ou pular
  - Salvar contexto relevante sobre seu trabalho, estilo de escrita, áreas de especialização
- "Você segue o método PARA ou tem um sistema de organização diferente?"
- "Quais são seus principais casos de uso? (pesquisa, escrita, gerenciamento de projetos, base de conhecimento, notas diárias)"
Se usar PARA, fazer perguntas específicas de configuração: Método PARA por Tiago Forte
- "Em quais projetos ativos você está trabalhando?" (Criar pastas em 01_Projects)
- "Quais áreas de responsabilidade você mantém?" (ex., Trabalho, Saúde, Finanças, Família)
- "Quais tópicos você pesquisa com frequência?" (Configurar em 03_Resources)
- "Algum projeto que você concluiu recentemente?" (Pode arquivar com resumos)
Preferências gerais:
- Verificar .obsidian/community-plugins.json para ver quais plugins usam
- Analisar arquivos existentes para detectar convenção de nomenclatura automaticamente
- Verificar se existe pasta de anexos para ver se trabalham com arquivos de mídia
- "Você usa git para controle de versão?"
- "Algum site ou recurso específico que você referencia com frequência?"
- "Você tem alguma preferência de estilo de escrita específica?"
- "Existem fluxos de trabalho ou padrões que você deseja que o Claude siga?"
- "Gostaria de um ritual de revisão semanal? (ex., revisão de projetos na quinta-feira)"
- "Você prefere 'modo pensamento' (perguntas/exploração) vs 'modo escrita'?"
Configuração Opcional de Ferramentas

Gemini Vision (já incluído)
- Perguntar: "O Gemini Vision já está incluído para analisar imagens, PDFs e vídeos. Gostaria de ativá-lo? (sim/não/depois)"
- Explicar: "Você só precisa de uma chave de API gratuita do Google. Isso permite que o Claude analise qualquer conteúdo visual em seu vault."
- Se depois: "Sem problemas! Você pode configurá-lo a qualquer momento obtendo uma chave de API em https://aistudio.google.com/apikey e adicionando GEMINI_API_KEY ao seu perfil de shell, depois executando claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs."
- Se sim:
  - Guiar para obter chave de API em https://aistudio.google.com/apikey (gratuito, leva 30 segundos)
  - Ajudar a adicionar ao perfil de shell (.zshrc, .bashrc, etc.)
  - Executar claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs
  - Configurar .mcp.json com a chave de API
  - Testar a conexão com um comando de exemplo
Firecrawl (já incluído)
- Perguntar: "O Firecrawl está incluído para pesquisa na web. Gostaria de configurá-lo? (sim/não/depois)"
- Explicar: "Isso é um divisor de águas para pesquisa! Quando você encontra um artigo ou site, pode salvá-lo diretamente em seu vault como markdown - preservando o conteúdo para sempre, tornando-o pesquisável e permitindo que o Claude o analise. Perfeito para construir uma biblioteca de pesquisa."
- Exemplo: "Basta dizer ao Claude: 'Salve este artigo no meu vault: [URL]' e está feito!"
- Se depois: "Você pode configurá-lo a qualquer momento obtendo uma chave de API em https://firecrawl.dev e configurando os scripts em .scripts/."
- Se sim:
  - Guiar para obter chave de API em https://firecrawl.dev (camada gratuita disponível)
  - Ajudar a configurar os scripts em .scripts/
  - Mostrar exemplo de uso: .scripts/firecrawl-scrape.sh https://example.com

Gerar Configuração Personalizada

Obter data atual: date +"%B %d, %Y" para o cabeçalho do CLAUDE.md

Salvar preferências em .claude/vault-config.json:

{
  "user": {
    "name": "Jane Smith",
    "background": {
      "companies": ["Variance", "Percolate"],
      "roles": ["Co-founder", "Writer"],
      "publications": ["Why Is This Interesting?", "every.to"],
      "expertise": [
        "Developer tools",
        "Marketing tech",
        "Systems thinking"
      ],
      "interests": ["AI for thinking", "Note-taking systems", "Creativity"]
    },
    "profileSources": [
      "https://whyisthisinteresting.com/about",
      "https://every.to/@username"
    ],
    "customContext": "Focuses on AI as thinking augmentation, not just writing",
    "publicProfile": true
  },
  "vaultPath": "/path/to/existing/vault",
  "fileNamingPattern": "detected-pattern",
  "organizationMethod": "PARA",
  "primaryUses": ["research", "writing", "projects"],
  "tools": {
    "geminiVision": true,
    "firecrawl": false
  },
  "projects": ["Book - Productivity", "SaaS App"],
  "areas": ["Newsletter", "Health"],
  "importedAt": "2025-01-13",
  "lastUpdated": "2025-01-13"
}

Começar com CLAUDE-BOOTSTRAP.md como base
Adicionar seções específicas do usuário:
- Estrutura de pastas personalizada com projetos/áreas reais
- Fluxos de trabalho pessoais
- Ferramentas e scripts preferidos
- Diretrizes específicas
- Configuração MCP, se configurada
Incluir seus sites/recursos, se fornecidos
Adicionar quaisquer convenções de nomenclatura personalizadas
Pré-preencher com seus projetos e áreas:
- Criar pastas de projeto em 01_Projects/
- Criar pastas de área em 02_Areas/
- Criar tópicos de recurso em 03_Resources/
- Adicionar arquivos README explicando cada projeto/área

Importar Vault Existente (se aplicável)
- Se o usuário tiver um vault existente:
  - Criar pasta OLD_VAULT: mkdir OLD_VAULT
  - Copiar vault inteiro preservando a estrutura: cp -r [caminho-do-vault]/* ./OLD_VAULT/
  - Copiar configuração do Obsidian: cp -r [caminho-do-vault]/.obsidian ./
  - Verificar e copiar outros arquivos importantes:
    - .trash/ (lixeira do Obsidian)
    - .smart-connections/ (se estiver usando esse plugin)
    - Quaisquer arquivos de espaço de trabalho: .obsidian.vimrc, etc.
  - Pular cópia de: .git/ (eles terão o seu próprio), .claude/ (usando o nosso)
  - Mostrar resumo: "Vault importado para OLD_VAULT/ (X arquivos, Y pastas)"
  - Explicar: "Sua estrutura original está preservada em OLD_VAULT. Você pode migrar gradualmente os arquivos para as pastas PARA conforme necessário."
Criar Arquivos de Suporte
- Gerar estrutura inicial de pastas, se novo vault
- Criar arquivos README para as pastas principais
- Para cada pasta de projeto, criar subpastas:
  - Research/ (materiais de fonte)
  - Chats/ (conversas de IA)
  - Daily Progress/ (registro contínuo)
- Criar diretório 05_Attachments/Organized/
- Configurar .gitignore se usar git (incluir .mcp.json, node_modules)
- Criar modelos iniciais, se solicitado
- Criar WEEKLY_REVIEW.md se o usuário quiser ritual de revisão
- Remover arquivo de marcador FIRST_RUN, se existir
- Fazer commit git inicial, se o repositório foi inicializado
Executar Comandos de Teste
- Executar pnpm vault:stats para verificar se os scripts funcionam
- Testar comandos de anexos, se as pastas existirem
- Testar ferramentas MCP, se configuradas
- Verificar se o git está rastreando os arquivos corretamente
Fornecer Próximos Passos
- Resumo do que foi criado e configurado
- Guia de início rápido específico para a configuração deles
- Lista de comandos disponíveis que podem usar
- Comandos de teste para verificar se tudo funciona
- Sugestões para primeiras tarefas com base em seus casos de uso
- Como modificar a configuração mais tarde

Exemplo de Saída

# Configuração do Seu Vault Obsidian

Gerado em: [Executar `date +"%B %d, %Y"` para obter a data atual] Última atualização: [Mesma data] Com base em suas preferências para: [principais casos de uso] Configuração concluída com: ✅ Dependências ✅ Estrutura de pastas ✅ Git inicializado

## Sua Estrutura de Pastas Personalizada

[Sua estrutura específica com explicações]

## Seus Fluxos de Trabalho

### Rotina Diária

[Com base nas respostas]

### Gerenciamento de Projetos

[Sua abordagem específica]

### Método de Pesquisa (Estilo Noah Brier)

- Capture tudo o que você lê
- Deixe ideias importantes surgirem naturalmente
- Comece escrevendo para testar o entendimento
- Use pesquisa, não tags, para encontrar coisas
- [Saiba mais sobre o sistema de Noah](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)

### Ritual de Revisão Semanal

[Se ativado: Toda quinta-feira às 16h, revise todos os projetos]

## Suas Preferências

### Nomenclatura de Arquivos

- Padrão: [convenção deles]
- Exemplos: [exemplos específicos]

### Ferramentas e Scripts

[Scripts relevantes para o fluxo de trabalho deles]

## Servidores MCP (se configurados)

### Gemini Vision

- Status: ✅ Configurado e testado
- Chave de API: Definida em .mcp.json
- Teste com: `Use gemini-vision to analyze [caminho da imagem]`

## Comandos Disponíveis

### Gerenciamento do Vault

- `pnpm vault:stats` - Mostrar estatísticas do vault
- `pnpm attachments:list` - Listar anexos não processados
- `pnpm attachments:organized` - Contar arquivos organizados

### Habilidades do Claude

As habilidades são descobertas automaticamente quando você descreve a tarefa. Exemplos:

- "Ajude-me a pensar sobre X" → `thinking-partner`
- "Finalize meu dia" / "revisão diária" → `daily-review`
- "Processe minha caixa de entrada" → `inbox-processor`
- "Reexecutar o assistente de configuração" → `init-bootstrap`

As habilidades residem em `.agents/skills/` (canônico) com links simbólicos em `.claude/skills/` e `.pi/skills/`. Funcionam no Claude Code, OpenCode, Codex, Cursor e Pi.

## Início Rápido

1. [Primeiro passo personalizado]
2. [Próxima ação com base nos objetivos deles]
3. [Específico para o fluxo de trabalho deles]

## Dicas de Especialistas em Pesquisa

- **Seja um maximalista de tokens**: Forneça bastante contexto ao Claude
- **A escrita escala**: Documente tudo para referência futura
  ([Noah Brier](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452))
- **Confie na emergência**: Ideias importantes continuarão surgindo
- **Comece escrevendo**: Sempre inicie projetos em forma de texto
- **Revise regularmente**: Reserve um tempo semanalmente para podar e atualizar
- **Método PARA**: Projetos, Áreas, Recursos, Arquivo
  ([Tiago Forte](https://fortelabs.com/blog/para/))

## Resumo da Configuração

✅ Dependências instaladas (pnpm/npm) ✅ Estrutura de pastas criada ✅ Repositório Git inicializado e desconectado do original ✅ CLAUDE.md personalizado ✅ Configuração de primeira execução concluída [✅ MCP Gemini Vision configurado - se configurado] [✅ Primeiro commit feito - se git foi inicializado]

Notas de Implementação Importantes

Lidando com Múltiplos Vaults

Quando vários vaults são detectados:

Sempre liste todos os vaults encontrados com numeração clara e detalhes
Exija uma seleção explícita - não assuma qual vault usar
Confirme a seleção antes de prosseguir com a importação
Lide com respostas ambíguas - se o usuário fornecer uma entrada pouco clara (como colar uma captura de tela), peça esclarecimentos:
- "Vejo que você compartilhou uma captura de tela. Você poderia digitar o número (1-3) do vault que gostaria de importar?"
- "Preciso de uma seleção clara. Por favor, digite '1', '2' ou '3' para escolher."

Validação de Caminho do Usuário

Quando um caminho é fornecido pelo usuário, valide:

Verifique se o caminho existe: test -d [caminho]
Verifique se contém uma pasta .obsidian: test -d [caminho]/.obsidian
Se não for um vault válido: "O caminho '[caminho]' não parece ser um vault Obsidian. Deseja tentar novamente ou pular?"
Se o caminho for inválido ou não existir: "Caminho não encontrado. Você verificou a ortografia? Tente novamente ou digite 'pular'."

Lidando com Modo de Pensamento vs Escrita

Modo Pensamento: Claude faz perguntas, explora ideias, desafia suposições
Modo Escrita: Claude ajuda a articular, estruturar e refinar o pensamento em prosa
Pergunte no início: "Como você prefere interagir hoje?

Informações de Configuração do MCP

Gemini Vision MCP:

URL da documentação: https://github.com/anon/obsidian-mcp
Comando de configuração: claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs
Chave de API necessária: GEMINI_API_KEY
Obter chave: https://aistudio.google.com/apikey
Testar com: "Use gemini-vision to analyze [caminho da imagem]"
Nota: O arquivo do servidor MCP está em .claude/mcp-servers/gemini-vision.mjs

Firecrawl MCP:

URL da documentação: https://docs.firecrawl.dev
Scripts: .scripts/firecrawl-scrape.sh e .scripts/firecrawl-batch.sh
Chave de API: Obter em https://firecrawl.dev
Uso: .scripts/firecrawl-scrape.sh https://example.com

Estrutura de Saída

Ao finalizar, a skill deve criar:

vault/
├── CLAUDE.md               # Configuração personalizada
├── .claude/
│   ├── vault-config.json   # Preferências do usuário
│   └── mcp-servers/        # Servidores MCP (se configurados)
├── .gitignore              # Se git foi inicializado
├── README.md               # Visão geral do vault
├── 01_Projects/            # Pastas de projetos (se PARA)
│   ├── Projeto A/
│   │   ├── Research/
│   │   ├── Chats/
│   │   └── Daily Progress/
│   └── Projeto B/
├── 02_Areas/               # Pastas de áreas (se PARA)
├── 03_Resources/           # Pastas de recursos (se PARA)
├── 04_Archive/             # Projetos concluídos
├── 05_Attachments/         # Anexos (se aplicável)
│   └── Organized/
├── OLD_VAULT/              # Vault original preservado
├── WEEKLY_REVIEW.md        # Modelo de revisão (se solicitado)
├── .agents/                # Habilidades do agente
│   └── skills/
├── .scripts/               # Scripts utilitários
└── package.json            # Scripts npm

heyitsnoah/claudesidian

O que é claudesidian?

Perguntar na sua IA favorita

Documentação

Inicializar Configuração Bootstrap

Tarefa

Processo

Exemplo de Saída

Notas de Implementação Importantes

Lidando com Múltiplos Vaults

Validação de Caminho do Usuário

Lidando com Modo de Pensamento vs Escrita

Informações de Configuração do MCP

Estrutura de Saída

Habilidades Relacionadas

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me