PETERWIKI — Guía completa del sistema

Todo lo que necesitas para crear y mantener wikis personales con Obsidian + Claude Code. Sin errores.

✓ Actualizado: 2026-04-18 · GitHub activo · 3 libros procesados · sistema completo

Contenido

  1. Estructura global del sistema
  2. Estructura de cada vault
  3. Crear un nuevo vault
  4. Abrir en Obsidian
  5. Usar el wiki con Claude Code
  6. Obsidian Web Clipper
  7. Procesar libros
  8. GitHub — copia de seguridad
  9. Errores comunes — no los repitas
  10. Referencia rápida — mis vaults activos

Parte 1 — Estructura global del sistema

1

TODOS los vaults dentro de WIKI-PETER-GENERAL

La carpeta raíz del sistema es WIKI-PETER-GENERAL dentro de Development/. Todos los vaults viven dentro de ella.

/Users/maykacenteno/Development/
└── WIKI-PETER-GENERAL/ ← raíz del sistema (esta es la que usas con Claude Code)
    ├── .wrapup-config ← ID del notebook NotebookLM del proyecto
    ├── fix-clipper.sh ← script que corrige carpetas con espacios
    ├── .claude/
    │   └── settings.local.json ← hook SessionStart: ejecuta fix-clipper.sh
    ├── PETERWIKI/ ← wiki general / segundo cerebro
    ├── PETERWIKIBOOKS/ ← biblioteca personal de libros
    └── OBSIDIAN WIKI GUIA/ ← esta documentación + configuración
⚠️ LECCIÓN APRENDIDA: No pongas los vaults directamente en Development/. Todos van dentro de WIKI-PETER-GENERAL/. Si los pones fuera, tendrás dos carpetas con el mismo nombre y te confundirás.

Parte 2 — Estructura de cada vault

2

Anatomía de un vault — exactamente así, sin variaciones

PETERWIKI[TEMA]/
├── CLAUDE.md ← Reglas del wiki (Claude las lee al abrir la carpeta)
├── index.md ← Catálogo de TODO el contenido — EN LA RAÍZ
├── log.md ← Registro cronológico de ingestas — EN LA RAÍZ
├── obsidianRAG.MD ← Documento Karpathy. Solo lectura. No modificar.
├── raw/ ← TUS fuentes originales. LA IA NUNCA LAS MODIFICA.
│   ├── assets/
│   ├── articulos/ ← Web Clipper guarda aquí
│   ├── pdfs/
│   ├── notas/
│   └── libros/ ← EPUBs y PDFs de libros
└── wiki/ ← SOLO LA IA ESCRIBE AQUÍ
    ├── overview.md ← Página de inicio del wiki
    ├── fuentes/ ← Resúmenes de libros, artículos
    ├── entidades/ ← Autores, personas, organizaciones
    ├── conceptos/ ← Ideas, frameworks, teorías
    └── temas/ ← Síntesis que cruzan múltiples fuentes
🚫 ERRORES QUE YA COMETISTE (no los repitas):
① index.md y log.md dentro de wiki/ → deben ir en la RAÍZ del vault
② Nombres en inglés (concepts/, entities/) → SIEMPRE en español
③ Carpetas numeradas (01-inbox) → solo los nombres exactos de arriba
④ Falta obsidianRAG.MD → es obligatorio en cada vault

Parte 3 — Crear un nuevo vault

3

Nombre del vault

Usa el formato PETERWIKI + tema en mayúsculas. Un vault = un tema. No mezcles.

PETERWIKI PETERWIKIBOOKS PETERWIKIVIAJES PETERWIKIEMPRESA PETERWIKISALUD
4

Prompt exacto para Claude Code

Abre Claude Code en WIKI-PETER-GENERAL/ y copia esto:

Crea un nuevo vault de Obsidian llamado PETERWIKI[TEMA] dentro de /Users/maykacenteno/Development/WIKI-PETER-GENERAL/ siguiendo exactamente la misma estructura que PETERWIKIBOOKS: carpetas raw/ con subcarpetas (assets, articulos, pdfs, notas, libros), carpeta wiki/ con subcarpetas (overview.md, fuentes/, entidades/, conceptos/, temas/), y archivos CLAUDE.md, index.md, log.md y obsidianRAG.MD en la raíz. El tema de este vault es [DESCRIBE EL TEMA].
⚠️ La instrucción clave: "dentro de WIKI-PETER-GENERAL/" — sin eso, Claude puede crear el vault en el lugar equivocado.

Parte 4 — Abrir en Obsidian

5

Abrir un vault nuevo

En Obsidian → icono de vault abajo a la izquierda → "Abrir carpeta como bóveda" → navega hasta WIKI-PETER-GENERAL/PETERWIKI[TEMA] → selecciona la carpeta.

✓ Obsidian muestra el vault en el panel izquierdo. Verás CLAUDE.md, index.md, log.md, obsidianRAG.MD y las carpetas raw/ y wiki/.
6

Cambiar entre vaults

Icono de vault abajo a la izquierda → lista de bóvedas → clic en la que quieras. Cada vault es completamente independiente (plugins, configuración, tema).

7

Si moviste un vault a otra carpeta

Después de mover una carpeta, Obsidian no la encuentra. Debes re-registrarla:

Icono de vault → "Eliminar de la lista" (la versión antigua) → "Abrir carpeta como bóveda" → selecciona la nueva ruta.

Parte 5 — Usar el wiki con Claude Code

8

Comandos principales

ComandoQué hace
ingesta: [contenido]Procesa texto y crea notas en wiki/
busca: [tema]Consulta el wiki y sintetiza respuesta
conecta: [[A]] y [[B]]Crea conexión entre dos notas
madurar: [[nota]]Expande una nota incompleta
lintRevisión de salud del wiki
estado del wikiEstadísticas del vault
9

Dónde pedir a Claude que trabaje

Claude Code tiene que estar abierto en la carpeta del vault específico (o en WIKI-PETER-GENERAL si trabajas con varios a la vez).

Comprueba la ruta en la barra de título de Claude Code antes de pedir algo.

Parte 6 — Obsidian Web Clipper (extensión Chrome)

10

Instalar Web Clipper

Busca "Obsidian Web Clipper" en la Chrome Web Store. Versión actual: 1.5.0.

!

Bug del espacio en blanco — cómo lo resolviste

El Web Clipper creaba raw/articulos (con espacio al final) en vez de raw/articulos.

Causa: El campo "Ubicación de la nota" tenía un espacio invisible guardado en su configuración.

Solución definitiva:

  • Web Clipper → Ajustes → Exportar todos los ajustes → guarda el JSON
  • Abre el JSON con un editor de texto
  • Busca "path": "raw/articulos " y elimina el espacio → "path": "raw/articulos"
  • Web Clipper → Ajustes → Importar todos los ajustes → importa el JSON corregido
✓ La config corregida está en: OBSIDIAN WIKI GUIA/obsidian-web-clipper-settings.json
También existe fix-clipper.sh + hook automático como red de seguridad. Se ejecuta cada vez que abres Claude Code en WIKI-PETER-GENERAL.
11

Configuración del Web Clipper

CampoValor
BóvedaÚltimo usado (para que vaya al vault activo)
Ubicación de la notaraw/articulos (sin espacios)
Nombre de la nota{{title}}
Contenido{{content}}

Después de clipear un artículo, abre Claude Code y pide: ingesta: el artículo en raw/articulos/nombre-del-articulo.md

Parte 7 — Procesar libros (EPUB y PDF)

12

Cómo meter un libro al wiki

  • Guarda el EPUB o PDF en raw/libros/[CARPETA-DEL-LIBRO]/
  • Puedes tener varios libros en subcarpetas dentro de raw/libros/
  • Dile a Claude Code: ingesta: el libro que está en raw/libros/[CARPETA]/[ARCHIVO]
Claude extrae el texto del EPUB/PDF con Python, sintetiza el contenido y crea automáticamente los archivos en wiki/fuentes/, wiki/entidades/ y wiki/conceptos/.
13

Qué genera Claude para cada libro

Archivo creadoDóndeContenido
nombre-del-libro.mdwiki/fuentes/Resumen completo, capítulos, ideas clave, citas
nombre-del-autor.mdwiki/entidades/Quién es, todas sus obras en el wiki
concepto-clave.mdwiki/conceptos/Un archivo por concepto importante
tema-transversal.mdwiki/temas/Síntesis que conecta varios libros
14

Ver el resultado en Obsidian

  • Vista normal: Panel izquierdo → carpeta wiki/ → navega las notas
  • Vista gráfico: Ctrl+G (o Command+G en Mac) → muestra el mapa de conexiones entre notas
  • Links internos: Los [[dobles corchetes]] funcionan automáticamente como hiperlinks
  • Búsqueda: Ctrl+Shift+F para buscar en todo el vault

Parte 8 — GitHub: copia de seguridad del sistema

15

Un solo repo para todo: WIKI-PETER-GENERAL

No hagas un repo por vault — haz uno solo para WIKI-PETER-GENERAL/. Razones:

  • Un solo git push guarda todo el sistema
  • Las conexiones entre vaults quedan en el mismo historial
  • Más fácil de mantener
16

.gitignore — qué NO subir

Los libros (EPUB/PDF) son muy pesados. Crea un .gitignore en WIKI-PETER-GENERAL/:

# Archivos binarios pesados (libros originales)
**/raw/libros/
**/raw/pdfs/
**/raw/assets/

# Archivos del sistema
.DS_Store
✓ El wiki generado (carpeta wiki/) SÍ se sube. Los libros originales NO. Eso es lo correcto.
17

Inicializar el repo

cd /Users/maykacenteno/Development/WIKI-PETER-GENERAL
git init
git add .
git commit -m "Inicialización sistema PETERWIKI"
# Luego conectar con GitHub:
git remote add origin https://github.com/peterestelaweb/WIKI-PETER-GENERAL-OBSIDIAN.git
git push -u origin main

Parte 9 — Errores comunes ya cometidos — NO los repitas

✕

Errores de estructura

Error cometidoCorrección
Crear vaults directamente en Development/ Todos los vaults van dentro de WIKI-PETER-GENERAL/
Crear index.md y log.md dentro de wiki/ Van en la RAÍZ del vault, no dentro de wiki/
Nombres de carpetas en inglés: concepts/, entities/ Siempre en español: conceptos/, entidades/, fuentes/, temas/
Carpetas numeradas: 01-inbox/, 02-concepts/ Solo los nombres exactos del esquema arriba
No crear obsidianRAG.MD Es obligatorio en cada vault — es el documento fundacional Karpathy
✕

Errores del Web Clipper

ErrorSolución
Clipper crea raw/articulos (con espacio) en vez de raw/articulos Exportar JSON de ajustes → editar el espacio en "path" → reimportar
Intentar cambiar la ruta escribiendo en el campo visual del Clipper No funciona si hay espacios invisibles guardados. Hay que editar el JSON directamente.
Clipper va al vault equivocado Configura la bóveda como "Último usado" para que use siempre el vault activo
✕

Errores de flujo de trabajo

ErrorCorrección
Modificar archivos en raw/ raw/ es INMUTABLE. Solo metes archivos. Nunca los editas desde el wiki.
Mezclar temas en un vault Un vault = un tema claro. Libros va en PETERWIKIBOOKS, no en PETERWIKI.
Intentar sync con iCloud iCloud causa conflictos con Claude Code y Obsidian. Usar GitHub para backup.

Parte 10 — Referencia rápida: mis vaults activos

★

Sistema activo a 2026-04-18

VaultTemaRuta completaEstado
PETERWIKI Wiki general / segundo cerebro WIKI-PETER-GENERAL/PETERWIKI/ Activo
PETERWIKIBOOKS Biblioteca personal de libros WIKI-PETER-GENERAL/PETERWIKIBOOKS/ Activo · 3 libros
OBSIDIAN WIKI GUIA Documentación del sistema WIKI-PETER-GENERAL/OBSIDIAN WIKI GUIA/ Activo
★

Herramientas configuradas

>
HerramientaEstadoNotas
Obsidian✓ Instalado3 vaults activos
Obsidian Web Clipper✓ Configuradov1.5.0 — bug del espacio resuelto
Claude Code✓ ActivoTrabaja desde WIKI-PETER-GENERAL/
fix-clipper.sh✓ ListoHook SessionStart automático
NotebookLM✓ ConfiguradoNotebook ID en .wrapup-config
GitHub repo✓ Activopeterestelaweb/WIKI-PETER-GENERAL-OBSIDIAN · rama main
Obsidian Sync⏳ ValorarCuando el wiki tenga más contenido
★

PETERWIKIBOOKS — libros procesados

LibroAutorAño
Reality Transurfing I — El Espacio de las VariantesVadim Zeland2004
Reality Transurfing II — El Susurro de las Estrellas de MadrugadaVadim Zeland2005
Tu Éxito es InevitableMaïté Issa2022