Convierte tus notas viejas de Obsidian en instrucciones para Claude Code en 10 minutos

El martes por la mañana pegué en Claude Code, tal cual, mi nota de Obsidian llamada “Reescritura de artículos”. Tres semanas de apuntes, unas 2000 palabras. ¿Qué me devolvió? Una propuesta para “arreglar” el texto del botón de llamada a la acción que yo ya había corregido la semana pasada.

¿Por qué pasó esto? Porque en esa nota convivían, en la misma lista plana de viñetas, una hipótesis de hace tres semanas (“quizás el PDF gratuito sea flojo”) y una decisión de la semana pasada (“confirmado: el PDF gratuito será el canal principal”). Para la IA, ambas eran “información del mismo peso anotada en la nota”. Por eso volvió a cuestionar la decisión y a proponer un trabajo que ya estaba terminado.

No es que falte información en las notas. El problema era que estaba entregando hipótesis viejas y decisiones cerradas todas mezcladas. Hoy te cuento la rutina que uso para arreglar esto en 10 minutos por la mañana.

Puntos clave

• Si pegas una nota larga de Obsidian tal cual, la IA trata las hipótesis viejas y los hechos cerrados con el mismo peso, y resucita trabajo ya terminado.
• Si separas la nota en cinco casillas (“hechos que siguen siendo ciertos hoy / decisiones tomadas / lo que aún no sé / el siguiente paso / cómo lo verifico”), entregas menos información y mejora la calidad de las respuestas.
• La clasificación se hace en 10 minutos. Más abajo tienes un script de Node.js que funciona copiándolo y pegándolo.
• Decidir “¿esto es un hecho o una hipótesis?” es trabajo del humano. Redactar el texto es trabajo de la IA. Mezclar ambas cosas provoca accidentes.
• Para un artículo de iniciación, el destino es el material de aprendizaje gratuito; para una mejora de procesos en la empresa, una consulta. Elige una sola salida según en qué etapa esté el lector.

Por qué “pegar la nota tal cual” provoca accidentes

La virtud de Obsidian es que puedes ir añadiendo información sin parar. Pero al entregársela a la IA, esa virtud se vuelve en contra.

Cuando un humano lee una nota, pondera de forma inconsciente: “esto es viejo, esto es lo más reciente”. A partir de las fechas y del contexto, descarta y selecciona sin darse cuenta. La IA no hace eso por ti. La tercera línea de la lista y la línea treinta las recibe igual, como “información del presente”.

Por eso un “quizás…” de hace tres semanas se trata hoy como un hecho cerrado en tu encargo. Y al revés: algo que se confirmó la semana pasada queda degradado a simple propuesta. Mi accidente del principio fue justo eso. Cuantas más notas tengas, más necesario es clasificarlas antes de entregarlas.

La rutina de clasificación que hago en 10 minutos

Cada mañana, o antes de empezar a trabajar, divido la nota objetivo en estas cinco casillas. Diez minutos como mucho. Si te lleva más, probablemente estás metiendo demasiado en las casillas.

1. Hechos que siguen siendo ciertos hoy: deja solo tres. Verificados y que se cumplen también hoy.
2. Decisiones ya tomadas: escribe dos. Por ejemplo “el PDF gratuito será el canal principal”, una directriz que ya no vas a mover.
3. Lo que aún no sé: escribe solo uno. Lo que quieres averiguar con el encargo de hoy a la IA.
4. El siguiente paso: una sola frase. Un paso concreto que termine en verbo, como “reescribir un párrafo de la llamada a la acción y comprobar que la URL pública abre bien”.
5. Cómo lo verifico: qué tiene que cumplirse para poder decir “hecho”. Ejecutar pruebas, revisar la visualización, comprobar enlaces rotos, etc.

El número de casillas está fijado a propósito. Tres hechos, dos decisiones, una duda. Si dejas que crezcan más, vuelves al “lo entrego todo” de antes. El límite de las casillas te obliga a tener el valor de descartar.

Cuando reescribes la nota con estas cinco casillas, Obsidian deja de ser un “almacén donde tiras cualquier cosa” y se convierte en la “mesa de trabajo de hoy”.

Qué dejas en manos de la IA y qué decides tú

Mezclar esto provoca accidentes. Dejemos claras las fronteras.

Etapa	Responsable	Motivo
Determinar si es hecho o hipótesis	Humano	La IA tiende a tratar hipótesis pasadas como hechos
Qué decisión sigue vigente hoy	Humano	Solo el humano sabe cuál es la directriz más reciente
Reordenar y resumir en las cinco casillas	IA (borrador)	La organización mecánica es rápida
Redactar las instrucciones	IA	Generar texto es su fuerte
Decisión final de publicar o pasar a producción	Humano	Las operaciones irreversibles las frena el humano

El truco está en que el botón de “esto es un hecho” lo pulse solo el humano. Deja que la IA prepare el borrador, pero no sueltes el juicio final de la clasificación. Solo con esto desaparecen casi por completo los accidentes en los que se resucita una decisión cerrada.

Si la gestión de las notas en sí te genera dudas, lee primero los fundamentos de la integración con Obsidian y cómo convertir una nota de Obsidian en instrucciones para Claude Code; con eso, esta rutina te entrará sola.

Plantilla de prompt lista para copiar y pegar

Si quieres que la IA prepare el borrador de la clasificación, usa este texto de encargo tal cual. Solo tienes que pegar el cuerpo de tu nota de Obsidian al final.

Organiza la siguiente nota en cinco casillas. Respeta siempre el límite de cada casilla.

- Hechos que siguen siendo ciertos hoy: hasta 3 (solo lo verificado y que se cumple también hoy)
- Decisiones ya tomadas: hasta 2 (directrices que ya no se mueven)
- Lo que aún no sé: solo 1 (lo que quiero averiguar hoy)
- El siguiente paso: una frase (una acción concreta que termine en verbo)
- Cómo lo verifico: condiciones para poder decir "hecho" (pruebas, revisión visual, etc.)

Reglas:
- Los "quizás..." o "es posible que..." no entran en hechos; van a "lo que aún no sé".
- Si una decisión vieja y una nueva se contradicen, adopta la nueva y descarta la vieja.
- La información que no quepa en las casillas, no la conserves a la fuerza: bórrala.

Cuerpo de la nota:
(pega aquí tu nota de Obsidian)

La clave es escribir de forma explícita “respeta el límite”. Si no lo pones, la IA, por amabilidad, intenta conservarlo todo. Deja claro dentro del encargo que el trabajo es descartar, no conservar.

Script de conversión que funciona al copiar y pegar

Este script convierte el resultado de la clasificación en un texto que puedes pegar directamente como primer encargo a Claude Code. Funciona con Node.js 18 o superior, sin instalar nada extra. Guárdalo como instrucciones.mjs y ejecútalo con node instrucciones.mjs.

// Convierte una nota clasificada en cinco casillas en el texto de instrucciones para Claude Code
const note = {
  facts: [
    "En la vista móvil, la CTA cabe sin saltar de línea",
    "La URL del producto en Gumroad ya está actualizada a la última versión",
    "Los artículos más visitados responden a la intención de búsqueda de principiantes",
  ],
  decisions: [
    "El PDF gratuito será el canal principal",
    "Solo a los lectores atascados con configuración o permisos los enviamos a la guía de ajustes de pago",
  ],
  unknowns: [
    "Qué versión de idioma tiene la tasa de clic más baja en la CTA",
  ],
  nextAction: "Reescribir un párrafo de la CTA y comprobar que la URL pública abre correctamente",
  checks: [
    "El cuerpo del texto cumple el recuento de caracteres exigido",
    "Tomar una captura de pantalla de la vista móvil",
    "Comprobar que el h1 y la URL canónica de la página publicada son los esperados",
  ],
};

// Comprueba de forma mecánica si se supera el límite (autorrevisión de la clasificación)
function validate(n) {
  const errors = [];
  if (n.facts.length > 3) errors.push("Demasiados hechos (máximo 3)");
  if (n.decisions.length > 2) errors.push("Demasiadas decisiones (máximo 2)");
  if (n.unknowns.length > 1) errors.push("Demasiadas dudas (solo 1)");
  if (!n.nextAction || !n.nextAction.trim()) errors.push("El siguiente paso está vacío");
  return errors;
}

function toBrief(n) {
  return [
    "[Hechos de hoy] " + n.facts.join(" / "),
    "[Decisiones tomadas] " + n.decisions.join(" / "),
    "[Aun no se] " + n.unknowns.join(" / "),
    "[Siguiente paso] " + n.nextAction,
    "[Como verificar] " + n.checks.join(" / "),
  ].join("\n");
}

const errors = validate(note);
if (errors.length > 0) {
  console.error("La clasificacion supera el limite:");
  errors.forEach((e) => console.error("  - " + e));
  process.exit(1);
}

console.log(toBrief(note));

Lo importante es haber metido validate. Esa función atrapa por mí el error de escribir cuatro hechos sin darme cuenta y entregarlos igual. Pega las cinco líneas de salida como primer encargo a Claude Code. Así fijas la rutina: no entregar todas las ideas viejas, sino solo los hechos que sirven para la decisión de hoy.

Tres usos según el tipo de trabajo

El significado de las casillas es el mismo, pero el contenido cambia según el trabajo. Te doy tres ejemplos.

1. Gestión de artículos y contenido Separa la intención de búsqueda de tu artículo popular, el destino actual de la CTA y el siguiente material que quieres vender. Si es un artículo de iniciación, pon delante el PDF gratuito y envía a la guía de ajustes de pago solo a quien se atasca con la configuración: escribe eso en “el siguiente paso”. Así las propuestas dejan de bambolearse cada vez.

2. Traspaso de tareas de desarrollo Separa el hecho de un bug que sí pudiste reproducir, las decisiones de diseño recientes y la causa que aún no conoces. Si aquí metes una “hipótesis” sobre la causa en la casilla de hechos, la IA corre a toda velocidad en la dirección equivocada. Si la causa no está confirmada, va sin dudar a “lo que aún no sé”.

3. Preparar una consulta o reunión de adopción Separa lo que dijo el cliente, el alcance de trabajo acordado y las preguntas para la próxima vez. Si en “el siguiente paso” anotas incluso el entregable de la reunión, tus propuestas se vuelven concretas.

Trampas frecuentes y cómo arreglarlas

Al principio caí en tres errores. Te los cuento con su solución.

El primero, pegar una página larga entera. Mucha cantidad de información, pero un juicio pobre. La solución es simple: recorta a cinco casillas antes de pegar. No entregues el almacén, entrega la mesa de trabajo.

El segundo, mezclar decisiones con lo no confirmado. Si pegas juntos “quizás el PDF gratuito sea flojo” y “confirmado: el PDF gratuito será el canal principal”, la IA empieza a dudar del hecho cerrado. Mueve siempre los “quizás…” a la casilla de “lo que aún no sé”. Solo con eso se detiene la resurrección de trabajo viejo.

El tercero, no escribir cómo verificar. Si solo dices “avísame cuando esté”, la IA dirá “hecho” según su propio criterio. Entrega de antemano condiciones que una máquina pueda juzgar: ejecutar pruebas, revisar la visualización, comprobar enlaces rotos. El truco es que la definición de “terminado” la sostenga el humano.

Preguntas frecuentes

P. ¿Sirve también con apps de notas que no sean Obsidian? R. Sí. Sea Notion o la app de Notas de Apple, la idea de separar en cinco casillas es la misma. Al script le da igual el origen mientras puedas extraer el texto.

P. No tengo 10 minutos para clasificar cada vez. R. No hace falta hacerlo con todas las notas. Basta con clasificar la única nota que vas a entregar hoy a Claude Code. Con la práctica se hace en 3 o 4 minutos.

P. ¿No puedo dejarle a la IA toda la clasificación? R. Hasta el borrador, sin problema. Pero el juicio final de confirmar “esto es un hecho”, “esto es una decisión” lo tiene que sostener el humano. Si sueltas eso, vuelve el accidente de resucitar trabajo del que hablaba al principio.

P. ¿En qué se diferencia escribir en CLAUDE.md de pegar instrucciones cada vez? R. Las directrices que no cambian van a CLAUDE.md; los hechos de solo ese día y el siguiente paso, a las instrucciones. El papel de CLAUDE.md está bien explicado en la documentación oficial de Anthropic. Para la forma de escribirlo, consulta también cómo escribir CLAUDE.md y recetas de configuración de permisos.

P. Quiero mejorar más la precisión de mis prompts. R. En cómo construir prompts tienes medidas concretas para estabilizar el texto del encargo. Combinado con la rutina de clasificación, se nota el efecto.

Lo que comprobé al probarlo de verdad

Tras el accidente del principio, probé a clasificar la misma nota en cinco casillas antes de entregarla. Comprobé dos cosas.

La primera, si desaparecían las respuestas que volvían a cuestionar la decisión. Con solo poner “confirmado: el PDF gratuito será el canal principal” en una línea dentro de la casilla [Decisiones tomadas], la IA actuó dando por sentada esa directriz y ya no resucitó nada. El tiempo que dediqué a clasificar fue, medido de verdad, unos 4 minutos.

La segunda, si validate atrapaba de verdad el error. Escribí a propósito cuatro hechos y al ejecutar se detuvo, como esperaba, con “Demasiados hechos”. Con esto, ni yo recién levantado puedo saltarme el límite. Tener una rutina para recortar antes de entregar resulta, al final, más rápido que devanarse los sesos pensando un texto ingenioso. Eso es lo que siento ahora.

Si quieres extender esta rutina hasta la mejora de procesos de tu equipo, en formación y consultoría la bajamos a tu operación real.