Convertir notas de Obsidian en un brief de implementación para Claude Code

Si tu vault de Obsidian tiene la respuesta pero cada sesión de Claude Code empieza con la misma explicación, el problema no son las notas. Es la forma de entrega.

Este artículo crea un formato de issue brief para Claude Code. En lugar de pegar toda la nota, pasa hechos, decisiones, dudas, siguiente acción y pruebas.

Lecturas relacionadas: claude-code-obsidian-integration, claude-code-claude-md-templates, claude-code-session-handoff-template. La base oficial de instalación está en Anthropic Claude Code getting started.

Por qué va antes del primer comando

El centro de este tema es convertir conocimiento de Obsidian en brief de implementación. Claude Code puede avanzar rápido, pero si la primera entrada es demasiado amplia, diffs de poco valor, hipótesis viejas y formato sin impacto en ingresos reciben el mismo peso que el trabajo importante.

Para personas con buenas notas pero handoff pesado a Claude Code, la meta no es hacer que la tarea parezca grande. La meta es definir qué leer, qué no tocar, qué probar primero y a dónde volver si falla. Esto aplica tanto a operaciones de contenido como a producto.

Flujo práctico

1. Separar la nota en hechos, decisiones, dudas y siguiente acción
2. Dejar hipótesis viejas fuera del brief
3. Incluir decisiones de CTA y producto cuando cambia contenido
4. Pedir build y screenshot móvil como prueba final

Este orden cambia la petición de “piensa libremente” a “trabaja dentro de este límite y deja prueba”. Claude Code conserva espacio para razonar, pero las zonas peligrosas se cierran antes de la primera edición.

Situación	Movimiento seguro	Prueba a guardar
Mejora de artículo	Pasar intención de búsqueda y política de CTA sin invitar a reescritura total	build, diff, URL
Bug fix	Separar hechos reproducidos de causas no verificadas	build, diff, URL
Preparar consulta	Convertir notas del cliente en alcance, zonas bloqueadas y preguntas	build, diff, URL

Con esa prueba, Claude Code se evalúa por trabajo observable y no por una frase segura.

Prompt y código para copiar

Convierte esta nota de Obsidian en un brief de implementación para Claude Code. Separa hechos, decisiones, dudas, siguiente acción, zonas bloqueadas y prueba. Pon hipótesis antiguas aparte y no las mezcles con instrucciones.

const note = {
  title: "Checkout CTA wraps on mobile",
  facts: ["375px screenshot shows two-line button", "Gumroad URL is correct"],
  decision: "keep free PDF before paid guide",
  unknowns: ["which component owns the button spacing"],
  nextAction: "find component, make smallest CSS change, verify mobile",
};

function toClaudeBrief(item) {
  return [
    `Goal: ${item.nextAction}`,
    `Facts: ${item.facts.join("; ")}`,
    `Decision: ${item.decision}`,
    `Do not assume: ${item.unknowns.join("; ")}`,
    "Proof: build plus mobile screenshot",
  ].join("\n");
}

console.log(toClaudeBrief(note));

El código es una comprobación pequeña. En un proyecto real, pega la salida en CLAUDE.md, un issue o una nota de handoff para reutilizar el mismo juicio en la siguiente sesión.

Ejemplos reales y fallos

Situación	Movimiento seguro	Prueba a guardar
Mejora de artículo	Pasar intención de búsqueda y política de CTA sin invitar a reescritura total	build, diff, URL
Bug fix	Separar hechos reproducidos de causas no verificadas	build, diff, URL
Preparar consulta	Convertir notas del cliente en alcance, zonas bloqueadas y preguntas	build, diff, URL

• Pegar todo el vault mezcla decisiones viejas con restricciones actuales.
• Pegar solo la decisión oculta la razón del trabajo.
• Omitir CTA puede mejorar texto y debilitar ingresos.

El fallo común no es falta de capacidad de Claude Code. El límite de entrada era demasiado fino. Cuando el límite es fino, el asistente amplía la tarea para ayudar. En artículos monetizados, elegir entre PDF gratuito, Gumroad y consulta también forma parte del límite.

Llevar al lector al PDF, Gumroad y consulta

Si los comandos básicos aún cuestan, empieza con el cheatsheet gratuito. Si el bloqueo está en setup, permisos, CLAUDE.md, MCP o CI, el siguiente paso de pago es la Setup Guide. Si repites prompts de review, debugging o refactor, usa 50 Prompt Templates. Si hay adopción de equipo o ruta de ingresos, pasa a consulta. La comparación de productos empieza en products.

Un CTA no debe vivir solo al final. Cerca de la introducción, el PDF gratuito reduce fricción. Tras ejemplos de implementación, encaja Gumroad. Cuando aparece riesgo de equipo o producción, la consulta es el siguiente paso natural.

Métricas para mirar después de publicar

Después mira clics desde artículos de Obsidian hacia Prompt Templates y Setup Guide.

Después de publicar, separa PV, lectura del inicio, clics internos, registros al PDF gratuito, clics a Gumroad y visitas a consulta. HTTP 200 no basta. h1, canonical, heroImage, CTA y cuerpo localizado deben apuntar a la misma acción.