Cómo organizo mi conocimiento técnico: un second brain en Obsidian operado con Claude Code

Cómo organizo mi conocimiento técnico: un second brain en Obsidian operado con Claude Code

Entre el trabajo, un máster y proyectos propios, tomo muchas notas: tickets que he resuelto, apuntes de clase, comandos que volveré a necesitar, prompts que funcionaron. Durante mucho tiempo esas notas estaban dispersas y, en la práctica, solo se escribían, nunca se volvían a leer. Lo que cambió eso no fue una aplicación nueva, sino un pequeño conjunto de reglas y un agente de IA que las aplica por mí.

Así funciona el sistema hoy.

Un único principio: capturar primero, procesar después

Todo el vault se apoya en separar capturar de procesar. Cuando estoy en mitad de algo, no decido dónde va una nota. Decidirlo en el momento de capturar es justo lo que mata el hábito. Todo lo nuevo cae en una carpeta de entrada, sin filtro, y se ordena después en una sesión dedicada.

La estructura de carpetas

El vault combina dos ideas conocidas: PARA (proyectos, áreas, recursos, archivo) para los grandes bloques, y notas atómicas al estilo Zettelkasten para el conocimiento. Las carpetas numeradas mantienen el orden estable:

Carpeta	Qué contiene	Regla de entrada
000 Entrada	Todo lo nuevo	Captura en bruto, sin filtro
100 Atomic	Conceptos externos	Una idea por nota, título corto
200 Insights	Conclusiones propias	El título es una afirmación, con prefijo =
300 MOCs	Índices temáticos	Se crean cuando un tema tiene 5 o más notas
400 Procedimientos	SOPs y prompts	Pasos reproducibles
500 Proyectos	Trabajo con fecha de fin	Proyectos de clientes y propios
600 Áreas	Áreas sin fecha de fin	Estudios, trabajo, personal
700 Recursos	Material de consulta	Libros, mazos de tarjetas, diagramas
900 Archivo	Lo terminado	Proyectos y cursos cerrados

La distinción entre 100 y 200 es la que más me importa. Una nota atómica recoge lo que dijo otra persona. Un insight recoge lo que he concluido yo, y su título tiene que ser una afirmación real. Si no soy capaz de formularlo como afirmación, todavía no es un insight.

A diario: diez minutos

• Una nota diaria desde plantilla, con la tarea clave del día.
• Durante el día, cualquier idea, enlace o fragmento suelto va directo a la entrada, sin pensarlo.
• En clase o en el trabajo, los apuntes en bruto van directamente a la carpeta del proyecto o del área. No intento escribir notas atómicas en directo.

Cada semana: el ritual que hace que funcione

Una vez por semana, unos treinta minutos, trabajo sobre un panel de mantenimiento hasta dejar sus listas a cero:

1. Vaciar la entrada. Para cada nota: concepto externo → 100; conclusión propia → 200; procedimiento → 400; material de proyecto → 500; recurso → 700. Lo que no vale nada se borra.
2. La regla de los dos enlaces. Ninguna nota sale de la entrada sin al menos dos enlaces: uno a su índice temático (MOC) y otro a una nota relacionada. Una nota que no enlaza a nada no vale nada.
3. Frontmatter. Toda nota lleva type, area, created y status. El estado pasa de seed (recién creada) a growing (revisada y enlazada) y a evergreen (consolidada).
4. Semillas viejas. Una semilla con más de treinta días o se trabaja o se borra.

Una vez al mes archivo los proyectos terminados y creo un índice para cualquier tema que haya acumulado cinco o más notas sin tenerlo.

Dónde entra Claude Code

El vault tiene en la raíz un archivo CLAUDE.md que describe la estructura, las reglas de cada carpeta y las convenciones de frontmatter. Cualquier sesión de Claude Code abierta en esa carpeta ya sabe cómo funciona el vault, así que nunca tengo que volver a explicárselo.

Además, definí unos cuantos comandos propios para el trabajo recurrente:

Comando	Qué hace	Cuándo
/procesar-inbox	Clasifica cada nota de la entrada, añade frontmatter y enlaces	Ritual semanal
/conectar	Encuentra notas huérfanas y las enlaza con otras afines	Ritual semanal
/destilar <apuntes>	Convierte apuntes de clase en notas atómicas e insights	Después de cada clase

Cada comando es simplemente un archivo Markdown con instrucciones explícitas. Por ejemplo, el de la entrada le indica al agente que busque una nota relacionada existente antes de añadir un enlace, que solo cree un índice cuando un tema llegue a cinco notas y que proponga los borrados en lugar de borrar. El de destilar lee mis apuntes de clase, que usan una sintaxis mínima (Concepto :: definición, => insight, - [?] duda), crea o amplía notas atómicas comprobando antes si ya existen, y al final me lista las dudas pendientes para que las resuelva yo.

Reglas para trabajar con el agente

La parte que considero más importante no es técnica:

1. Yo capturo, la IA estructura. El agente clasifica, enlaza y da formato. No escribe mis insights. Esos los escribo yo, porque escribirlos es justo donde se produce el aprendizaje.
2. La sesión siempre empieza en la raíz del vault, para que se cargue el archivo de instrucciones.
3. Revisar los diffs. El vault está versionado con el plugin Obsidian Git; si el agente hace un cambio grande, reviso git diff antes de darlo por bueno.
4. Los borrados necesitan confirmación. Está escrito en cada comando.

Usar el conocimiento

Un sistema así solo compensa si de verdad vuelvo a él. Unos pocos hábitos lo hacen posible:

• Antes de una tarea que ya he hecho otras veces, abro el índice de procedimientos y reutilizo el SOP en lugar de reinventarlo.
• Antes de estudiar un tema, abro su índice para ver qué sé ya y dónde están los huecos.
• Al terminar un libro o un curso, escribo de tres a cinco insights. Si no soy capaz de escribir ni uno, en realidad no he aprendido nada.
• También puedo pedirle al agente que responda a partir de mis propias notas: "¿qué tengo sobre X?", o "compara cómo implementé este ContentProvider en mis notas de Android con la práctica nueva".

Los plugins que de verdad importan

Tenía muchos más plugins instalados de los que usaba. Los que hacen trabajo real son: Templater (frontmatter automático en las notas nuevas), Note Refactor (extraer un concepto seleccionado a una nota atómica nueva con enlace de vuelta), Omnisearch (comprobar si una nota ya existe antes de crearla), Dataview (alimenta el panel de mantenimiento y las secciones automáticas de los índices), Spaced Repetition (repaso de tarjetas escritas como Pregunta::Respuesta dentro de notas normales) y Obsidian Git (copia de seguridad automática). Mi regla ahora es sencilla: un plugin que no he usado en un mes, se desinstala.

Lo que le diría a alguien que empieza

No empieces por la herramienta. Empieza por dos decisiones: dónde van las capturas en bruto y cuándo las vas a procesar. Todo lo demás, incluido el agente de IA, está para que esa sesión semanal cueste menos. El agente es bueno en la parte mecánica: clasificar, enlazar, dar formato. El pensar sigue siendo tuyo, y es a propósito.