Inicializar Configuración Bootstrap

Este comando te ayuda a crear un archivo de configuración CLAUDE.md personalizado haciendo preguntas sobre tu flujo de trabajo y preferencias en Obsidian.

Tarea

Lee la plantilla CLAUDE-BOOTSTRAP.md y recopila interactivamente información sobre el usuario:

Estructura de bóveda existente (si la hay)
Preferencias de flujo de trabajo
Estilo de toma de notas
Métodos de organización
Requisitos específicos

Luego genera un archivo CLAUDE.md personalizado adaptado a sus necesidades.

Proceso

Configuración inicial del entorno
- Obtener la fecha actual con el comando date para marcas de tiempo
- Verificar el nombre de la carpeta actual y preguntar si desean renombrarla
- En caso afirmativo, guiarlos a través del renombramiento (manejar el movimiento del directorio padre)
- Verificar si hay package.json e instalar dependencias:
  - Intentar pnpm install primero (más rápido, mejor)
  - Recurrir a npm install si pnpm no está disponible
- Verificar que las dependencias principales estén instaladas
- Verificar el estado de git:
  - Si no hay carpeta .git: Inicializar repositorio git
  - Si tiene origen remoto: Preguntar sobre trabajo de desarrollo
    - Bóveda personal: Eliminar origen y carpeta .github
    - Contribución: Mantener origen y flujos de trabajo intactos
  - Si es un repositorio local limpio: Listo
- No crear carpetas aún; esperar hasta después de preguntar sobre el método de organización
Verificar configuración existente
- Buscar un CLAUDE.md existente
- Si existe, preguntar si desean actualizar o empezar de nuevo
- Verificar la plantilla CLAUDE-BOOTSTRAP.md
Recopilar información de la bóveda
- Buscar ubicaciones comunes de bóvedas existentes de Obsidian (carpeta .obsidian)
- Verificar estas rutas con límites de profundidad apropiados:
  - ~/Documents (maxdepth 3) - todas las plataformas
  - ~/Desktop (maxdepth 3) - todas las plataformas
  - ~/Library/Mobile Documents/iCloud~md~obsidian/Documents (maxdepth 5 - solo macOS, bóvedas de iCloud)
  - Directorio home ~/ (maxdepth 2) - todas las plataformas
  - Directorio padre actual (maxdepth 2) - todas las plataformas
- Si se encuentra, preguntar: "Se encontró una bóveda de Obsidian en [ruta]. ¿Es esta la bóveda que deseas importar?"
- Contar archivos correctamente: find [ruta] -type f -name "*.md" | wc -l (sin límite de profundidad)
- Mostrar tamaño de la bóveda: du -sh [ruta]
- Si se confirma, analizar la estructura de la bóveda:
  - Ejecutar tree -L 3 -d [ruta] para ver la jerarquía de carpetas
  - Tomar una muestra de 10-15 notas aleatorias para entender los tipos de contenido
  - Listar 30-50 nombres de archivos recientes para detectar patrones de nombres
  - Verificar la carpeta de notas diarias y su formato
  - Identificar las carpetas más activas por cantidad de archivos
  - Detectar si usan PARA, Zettelkasten, Johnny Decimal o personalizado
- Si no es la correcta o no se encuentra ninguna:
  - Solo en macOS: Preguntar: "¿Tu bóveda está almacenada en iCloud Drive? (sí/no)"
  - En caso afirmativo (macOS): "Por favor, ingresa la ruta completa a tu bóveda (ej., ~~/Library/Mobile Documents/iCloud~~md~obsidian/Documents/TuBoveda)"
  - En caso negativo, o en Linux/Windows: "Por favor, ingresa la ruta a tu bóveda existente, o escribe 'saltar' para empezar de nuevo"
  - Validar rutas proporcionadas por el usuario (ver sección "Validación de Rutas del Usuario" más abajo)
- Si no hay bóveda existente o el usuario la salta, están empezando de nuevo
Hacer preguntas de configuración
- "¿Cuál es tu nombre?" (para personalización)
- "¿Te gustaría que investigue tu trabajo público para entender mejor tu contexto?"
  - En caso afirmativo: Buscar información
  - MOSTRAR SIEMPRE los hallazgos y preguntar "¿Es esto correcto?" para confirmación
  - Si se encuentran múltiples personas, listarlas numeradas para selección
  - Si es la persona equivocada, ofrecer buscar de nuevo o saltar
  - Guardar contexto relevante sobre su trabajo, estilo de escritura, áreas de especialización
- "¿Sigues el método PARA o tienes un sistema de organización diferente?"
- "¿Cuáles son tus principales casos de uso? (investigación, escritura, gestión de proyectos, base de conocimiento, notas diarias)"
Si usan PARA, hacer preguntas de configuración específicas: Método PARA por Tiago Forte
- "¿En qué proyectos activos estás trabajando?" (Crear carpetas en 01_Projects)
- "¿Qué áreas de responsabilidad mantienes?" (ej., Trabajo, Salud, Finanzas, Familia)
- "¿Qué temas investigas con frecuencia?" (Configurar en 03_Resources)
- "¿Algún proyecto que hayas completado recientemente?" (Se puede archivar con resúmenes)
Preferencias generales:
- Verificar .obsidian/community-plugins.json para ver qué complementos usan
- Analizar archivos existentes para detectar la convención de nombres automáticamente
- Verificar la carpeta de archivos adjuntos para ver si trabajan con archivos multimedia
- "¿Usas git para control de versiones?"
- "¿Algún sitio web o recurso específico que consultes a menudo?"
- "¿Tienes preferencias de estilo de escritura específicas?"
- "¿Hay algún flujo de trabajo o patrón que quieras que Claude siga?"
- "¿Te gustaría un ritual de revisión semanal? (ej., revisión de proyectos los jueves)"
- "¿Prefieres el 'modo pensamiento' (preguntas/exploración) vs 'modo escritura'?"
Configuración opcional de herramientas

Gemini Vision (ya incluido)
- Preguntar: "Gemini Vision ya está incluido para analizar imágenes, PDFs y videos. ¿Te gustaría activarlo? (sí/no/más tarde)"
- Explicar: "Solo necesitas una clave API gratuita de Google. Esto permite a Claude analizar cualquier contenido visual en tu bóveda."
- Si es más tarde: "¡No hay problema! Puedes configurarlo en cualquier momento obteniendo una clave API de https://aistudio.google.com/apikey y agregando GEMINI_API_KEY a tu perfil de shell, luego ejecuta claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs."
- En caso afirmativo:
  - Guiar para obtener la clave API de https://aistudio.google.com/apikey (gratis, toma 30 segundos)
  - Ayudar a agregarla al perfil de shell (.zshrc, .bashrc, etc.)
  - Ejecutar claude mcp add --scope project gemini-vision node .claude/mcp-servers/gemini-vision.mjs
  - Configurar .mcp.json con la clave API
  - Probar la conexión con un comando de muestra
Firecrawl (ya incluido)
- Preguntar: "Firecrawl está incluido para investigación web. ¿Te gustaría configurarlo? (sí/no/más tarde)"
- Explicar: "¡Esto cambia las reglas del juego para la investigación! Cuando encuentras un artículo o sitio web, puedes guardarlo directamente en tu bóveda como markdown, preservando el contenido para siempre, haciéndolo buscable y permitiendo que Claude lo analice. Perfecto para construir una biblioteca de investigación."
- Ejemplo: "Solo dile a Claude: 'Guarda este artículo en mi bóveda: [URL]' y ¡listo!"
- Si es más tarde: "Puedes configurarlo en cualquier momento obteniendo una clave API de https://firecrawl.dev y configurando los scripts en .scripts/."
- En caso afirmativo:
  - Guiar para obtener la clave API de https://firecrawl.dev (nivel gratuito disponible)
  - Ayudar a configurar los scripts en .scripts/
  - Mostrar ejemplo de uso: .scripts/firecrawl-scrape.sh https://ejemplo.com

Generar configuración personalizada

Obtener fecha actual: date +"%B %d, %Y" para el encabezado de CLAUDE.md

Guardar preferencias en .claude/vault-config.json:

{
  "user": {
    "name": "Jane Smith",
    "background": {
      "companies": ["Variance", "Percolate"],
      "roles": ["Co-fundadora", "Escritora"],
      "publications": ["Why Is This Interesting?", "every.to"],
      "expertise": [
        "Herramientas para desarrolladores",
        "Marketing tech",
        "Pensamiento sistémico"
      ],
      "interests": ["IA para el pensamiento", "Sistemas de notas", "Creatividad"]
    },
    "profileSources": [
      "https://whyisthisinteresting.com/about",
      "https://every.to/@username"
    ],
    "customContext": "Se enfoca en la IA como aumento del pensamiento, no solo escritura",
    "publicProfile": true
  },
  "vaultPath": "/ruta/a/boveda/existente",
  "fileNamingPattern": "patrón-detectado",
  "organizationMethod": "PARA",
  "primaryUses": ["research", "writing", "projects"],
  "tools": {
    "geminiVision": true,
    "firecrawl": false
  },
  "projects": ["Libro - Productividad", "App SaaS"],
  "areas": ["Boletín", "Salud"],
  "importedAt": "2025-01-13",
  "lastUpdated": "2025-01-13"
}

Comenzar con CLAUDE-BOOTSTRAP.md como base
Agregar secciones específicas del usuario:
- Estructura de carpetas personalizada con sus proyectos/áreas reales
- Flujos de trabajo personales
- Herramientas y scripts preferidos
- Guías específicas
- Configuración de MCP si está configurada
Incluir sus sitios web/recursos si se proporcionaron
Agregar cualquier convención de nombres personalizada
Precargar con sus proyectos y áreas:
- Crear carpetas de proyecto en 01_Projects/
- Crear carpetas de área en 02_Areas/
- Crear temas de recursos en 03_Resources/
- Agregar archivos README explicando cada proyecto/área

Importar bóveda existente (si aplica)
- Si el usuario tiene una bóveda existente:
  - Crear carpeta OLD_VAULT: mkdir OLD_VAULT
  - Copiar toda la bóveda preservando la estructura: cp -r [ruta-boveda]/* ./OLD_VAULT/
  - Copiar configuración de Obsidian: cp -r [ruta-boveda]/.obsidian ./
  - Verificar y copiar otros archivos importantes:
    - .trash/ (papelera de Obsidian)
    - .smart-connections/ (si usan ese complemento)
    - Cualquier archivo de espacio de trabajo: .obsidian.vimrc, etc.
  - Omitir copia de: .git/ (tendrán el suyo propio), .claude/ (usando el nuestro)
  - Mostrar resumen: "Bóveda importada a OLD_VAULT/ (X archivos, Y carpetas)"
  - Explicar: "Tu estructura original se conserva en OLD_VAULT. Puedes migrar archivos gradualmente a las carpetas PARA según sea necesario."
Crear archivos de soporte
- Generar estructura de carpetas inicial si es una bóveda nueva
- Crear archivos README para las carpetas principales
- Para cada carpeta de proyecto, crear subcarpetas:
  - Research/ (materiales fuente)
  - Chats/ (conversaciones con IA)
  - Daily Progress/ (bitácora continua)
- Crear directorio 05_Attachments/Organized/
- Configurar .gitignore si se usa git (incluir .mcp.json, node_modules)
- Crear plantillas iniciales si se solicita
- Crear WEEKLY_REVIEW.md si el usuario quiere un ritual de revisión
- Eliminar archivo de marcador FIRST_RUN si existe
- Hacer commit inicial de git si se inicializó el repositorio
Ejecutar comandos de prueba
- Ejecutar pnpm vault:stats para verificar que los scripts funcionen
- Probar comandos de archivos adjuntos si existen las carpetas
- Probar herramientas MCP si están configuradas
- Verificar que git esté rastreando archivos correctamente
Proporcionar próximos pasos

Resumen de lo que se creó y configuró
Guía de inicio rápido específica para su configuración
Lista de comandos disponibles que pueden usar
Comandos de prueba para verificar que todo funcione
Sugerencias para las primeras tareas según sus casos de uso
Cómo modificar la configuración más adelante

Ejemplo de Salida

# Configuración de tu Bóveda de Obsidian

Generado el: [Ejecutar `date +"%B %d, %Y"` para obtener la fecha actual] Última actualización: [Misma fecha] Basado en tus preferencias para: [casos de uso principales] Configuración completada con: ✅ Dependencias ✅ Estructura de carpetas ✅ Git inicializado

## Tu Estructura de Carpetas Personalizada

[Su estructura específica con explicaciones]

## Tus Flujos de Trabajo

### Rutina Diaria

[Basada en sus respuestas]

### Gestión de Proyectos

[Su enfoque específico]

### Método de Investigación (Estilo Noah Brier)

- Captura todo lo que lees
- Deja que las ideas importantes resurjan naturalmente
- Empieza escribiendo para poner a prueba tu comprensión
- Usa la búsqueda, no etiquetas, para encontrar cosas
- [Aprende más del sistema de Noah](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452)

### Ritual de Revisión Semanal

[Si está habilitado: Todos los jueves a las 4pm, revisar todos los proyectos]

## Tus Preferencias

### Nombres de Archivos

- Patrón: [su convención]
- Ejemplos: [ejemplos específicos]

### Herramientas y Scripts

[Scripts relevantes para su flujo de trabajo]

## Servidores MCP (si están configurados)

### Gemini Vision

- Estado: ✅ Configurado y probado
- Clave API: Configurada en .mcp.json
- Prueba con: `Usa gemini-vision para analizar [ruta de imagen]`

## Comandos Disponibles

### Gestión de la Bóveda

- `pnpm vault:stats` - Mostrar estadísticas de la bóveda
- `pnpm attachments:list` - Listar archivos adjuntos no procesados
- `pnpm attachments:organized` - Contar archivos organizados

### Skills de Claude

Los skills se auto-descubren cuando describes la tarea. Ejemplos:

- "Ayúdame a pensar en X" → `thinking-partner`
- "Resumir mi día" / "revisión diaria" → `daily-review`
- "Procesar mi bandeja de entrada" → `inbox-processor`
- "Volver a ejecutar el asistente de configuración" → `init-bootstrap`

Los skills residen en `.agents/skills/` (canónico) con enlaces simbólicos en `.claude/skills/` y `.pi/skills/`. Funcionan en Claude Code, OpenCode, Codex, Cursor y Pi.

## Inicio Rápido

1. [Primer paso personalizado]
2. [Próxima acción basada en sus objetivos]
3. [Específico para su flujo de trabajo]

## Consejos de Maestros de la Investigación

- **Sé un maximalista de tokens**: Proporciona mucho contexto a Claude
- **La escritura escala**: Documenta todo para referencia futura ([Noah Brier](https://every.to/superorganizers/ceo-by-day-internet-sleuth-by-night-267452))
- **Confía en la emergencia**: Las ideas importantes seguirán surgiendo
- **Empieza escribiendo**: Siempre comienza los proyectos en forma de texto
- **Revisa regularmente**: Dedica tiempo semanalmente para podar y actualizar
- **Método PARA**: Proyectos, Áreas, Recursos, Archivo ([Tiago Forte](https://fortelabs.com/blog/para/))

## Resumen de Configuración

✅ Dependencias instaladas (pnpm/npm) ✅ Estructura de carpetas creada ✅ Repositorio git inicializado y desconectado del original ✅ CLAUDE.md personalizado ✅ Configuración de primera ejecución completada [✅ MCP Gemini Vision configurado - si se configuró] [✅ Primer commit realizado - si se inicializó git]

Notas Importantes de Implementación

Manejo de Múltiples Bóvedas

Cuando se detectan múltiples bóvedas:

Siempre listar todas las bóvedas encontradas con numeración clara y detalles
Exigir selección explícita - no asumir qué bóveda usar
Confirmar la selección antes de proceder con la importación
Manejar respuestas ambiguas - si el usuario proporciona información confusa (como pegar una captura de pantalla), pedir aclaración:
- "Veo que has compartido una captura de pantalla. ¿Podrías escribir el número (1-3) de la bóveda que te gustaría importar?"
- "Necesito una selección clara. Por favor, escribe '1', '2' o '3' para elegir una bóveda."

Manejo de Bóveda Vacía

Si el usuario confirma una bóveda pero no se encuentra ningún archivo .md o la bóveda está vacía:

Informar al usuario: "No se encontraron archivos markdown en esta bóveda. ¿Quieres empezar desde cero o probar una ruta diferente?"
Si quieren probar de nuevo, volver al paso de selección de bóveda
Si quieren empezar desde cero, continuar con la configuración de bóveda vacía (sin importación)

Validación de Rutas del Usuario

Cuando un usuario proporciona una ruta (por ejemplo, para la bóveda de iCloud):

Expandir la tilde: ruta_resuelta = os.path.expanduser(ruta) si ruta.startswith('~')
Verificar si la ruta existe: os.path.exists(ruta_resuelta)
Verificar si contiene una bóveda de Obsidian: os.path.exists(os.path.join(ruta_resuelta, '.obsidian'))
Si falla la validación:
- Informar al usuario: "No se pudo encontrar una bóveda de Obsidian en esa ruta. Asegúrate de que la ruta apunte a la carpeta raíz de tu bóveda."
- Ofrecer reintentar o saltar
Si la validación falla repetidamente (2+ intentos):
- Preguntar: "¿Quieres seguir intentando o prefieres empezar sin importar una bóveda existente?"
- Si continúan teniendo problemas, sugerir: "También puedes arrastrar la carpeta de tu bóveda a la terminal para obtener la ruta correcta."

Manejo de Errores

Permiso denegado: Si find encuentra carpetas sin permiso, ignorarlas silenciosamente y continuar con las accesibles
Comando no encontrado: Si tree no está instalado, intentar con find como alternativa
Problemas de dependencia: Si pnpm install falla, intentar con npm install; si eso también falla, informar al usuario y continuar sin instalar dependencias
Errores de red: Si falla la investigación web o la configuración de herramientas, continuar sin ellas y ofrecer configurarlas más tarde

Manejo de la Estructura de Proyectos

Al crear carpetas de proyecto:

Si el usuario menciona un proyecto como "Libro sobre Productividad", crear la carpeta como 01_Projects/Libro sobre Productividad/
Si el usuario menciona proyectos similares, fusionarlos después de confirmar con el usuario
Siempre crear README.md dentro de cada carpeta de proyecto explicando su propósito

heyitsnoah/claudesidian

¿Qué es claudesidian?

Preguntar en tu IA favorita

Documentación

Inicializar Configuración Bootstrap

Tarea

Proceso

Ejemplo de Salida

Notas Importantes de Implementación

Manejo de Múltiples Bóvedas

Manejo de Bóveda Vacía

Validación de Rutas del Usuario

Manejo de Errores

Manejo de la Estructura de Proyectos

Skills relacionados

steipete/sag

steipete/oracle

steipete/peekaboo

mattpocock/design-an-interface

mattpocock/prototype

mattpocock/grill-me