Workflow de Obsidian a CLAUDE.md con Claude Code

Si tu vault de Obsidian tiene las notas de trabajo pero cada sesión de Claude Code empieza con la misma explicación, hay una brecha entre gestión de conocimiento e implementación. Este flujo convierte notas flexibles en contexto operativo breve para CLAUDE.md.

Quien llega por Obsidian no busca solo integración. Quiere que sus notas mejoren la calidad de implementación. La respuesta no es pasar todo el vault a Claude Code, sino extraer decisiones actuales, restricciones y comandos de prueba.

Lecturas relacionadas: claude-code-obsidian-integration, claude-code-claude-md-starter-template, claude-md-best-practices.

Por qué este patrón va antes de la primera edición

Claude Code funciona mejor cuando la tarea tiene límites. Un buen límite nombra archivos que puede leer, archivos que puede editar, operaciones prohibidas y la prueba que cierra el trabajo. Sin ese límite, un prompt pequeño de principiante puede convertirse en una reescritura amplia, y un cambio de contenido puede romper la ruta a PDF, Gumroad o consulta.

Este patrón también ayuda a revenue porque conecta prueba técnica con prueba para el lector. Una página que builda en local pero manda al lector al producto equivocado no está terminada. Si guardas scope, command, URL pública y CTA, mañana mejoras desde evidencia, no desde memoria.

Flujo práctico de trabajo

1. En Obsidian separa hechos, decisiones, preguntas abiertas y siguientes acciones
2. Una vez por semana extrae solo el contexto que Claude Code debe ver
3. Pon reglas estables en CLAUDE.md y estado temporal en handoff
4. En contenido, incluye decisiones de CTA y reglas de routing de producto
5. Borra decisiones obsoletas para mantener ligero el contexto permanente

Situación	Movimiento seguro	Prueba
Operaciones de contenido	Usa Obsidian para pensar intención de búsqueda, producto y CTA. En CLAUDE.md deja solo reglas repetibles de revenue routing.	build, diff, URL
Ingeniería de equipo	La historia de diseño vive en Obsidian, pero Claude Code recibe reglas actuales y zonas prohibidas.	screenshot, test
Debugging	La historia de hipótesis queda en notas; la sesión siguiente recibe hechos verificados y el próximo comando.	log, command, handoff

La primera pasada debe ser corta. La auditoría debe crear una decisión, no un informe gigante. Si después de 20 minutos la decisión sigue borrosa, el siguiente paso seguro es pedir leer un archivo más, no empezar a editar.

Prompt y código copiables

Lee esta nota de Obsidian y sepárala en reglas para CLAUDE.md, estado temporal de handoff e información obsoleta que no debe copiarse.

const note = {
  title: "Checkout copy bug",
  facts: ["mobile CTA wraps", "Gumroad link still works"],
  decisions: ["keep paid CTA after free PDF"],
  commands: ["npm.cmd run build"],
};

export function toClaudeMdBlock(item) {
  return [
    "## Current operating note",
    `- Topic: ${item.title}`,
    `- Facts: ${item.facts.join("; ")}`,
    `- Decisions: ${item.decisions.join("; ")}`,
    `- Proof command: ${item.commands[0]}`,
  ].join("\n");
}

console.log(toClaudeMdBlock(note));

El código es pequeño a propósito. Convierte una idea operativa en un objeto verificable: existe scope, existen zonas protegidas y existe al menos un comando de prueba. Puedes adaptarlo para publicar artículos, desarrollar apps, depurar o hacer handoff de equipo.

Tres ejemplos reales

Operaciones de contenido

Usa Obsidian para pensar intención de búsqueda, producto y CTA. En CLAUDE.md deja solo reglas repetibles de revenue routing.

Lo importante es la prueba. Deja un comando, una página visible o una nota que demuestre que el trabajo llegó al lector.

Ingeniería de equipo

La historia de diseño vive en Obsidian, pero Claude Code recibe reglas actuales y zonas prohibidas.

Lo importante es la prueba. Deja un comando, una página visible o una nota que demuestre que el trabajo llegó al lector.

Debugging

La historia de hipótesis queda en notas; la sesión siguiente recibe hechos verificados y el próximo comando.

Lo importante es la prueba. Deja un comando, una página visible o una nota que demuestre que el trabajo llegó al lector.

Fallos que conviene evitar

• Pasar todo el vault mezcla decisiones viejas con restricciones actuales.
• Convertir CLAUDE.md en diario oculta las reglas importantes.
• Dejar decisiones de CTA solo en notas separa el cuerpo del artículo de la ruta de producto.

Otro fallo sutil es el drift de localización. El artículo en inglés puede explicar la ruta correcta, mientras otro idioma conserva un CTA viejo. Por eso la revisión pública debe incluir h1, inicio del cuerpo y CTA en cada idioma, no solo frontmatter lang.

Cómo llevar al lector a PDF, Gumroad y consulta

Si el lector aún necesita soltura con comandos, envíalo al cheatsheet gratuito. Si el bloqueo está en setup, permisos, CLAUDE.md, hooks, MCP o CI/CD, la mejor compra es la Setup Guide. Si repite prompts de revisión, debugging y refactor, encaja 50 Prompt Templates. Si el problema es despliegue de equipo, diseño de workflow o ruta de ingresos, usa la consulta. Para comparar opciones, abre products.

No fuerces a todo lector hacia el producto pagado de inmediato. El principiante suele necesitar primero un PDF de baja fricción. Quien repite prompts está más cerca de plantillas. Quien se bloquea en permisos, CLAUDE.md, hooks, MCP o CI/CD está más cerca de Setup Guide. Equipos y operadores con preguntas de proceso están más cerca de consulta.

Qué verificar antes y después de publicar

Verificar este artículo significa revisar h1, inicio del cuerpo, heroImage, enlaces internos, enlaces de Gumroad y ruta de consulta. Un HTTP 200 no basta si el CTA lleva al siguiente paso equivocado.

En publicación multilingüe, revisa japonés, inglés, chino, coreano, español, francés, alemán, portugués, hindi e indonesio por separado. El slug puede coincidir mientras el cuerpo sigue viejo. Las capturas móviles encuentran esto antes porque muestran párrafo inicial y CTA juntos.

Métricas que mirar después

Después mira inicios de PDF, clics Gumroad, visitas a products, visitas a training, origen de búsqueda, mezcla por país y tasa de clic de artículo a CTA. Si suben PV pero no Gumroad, falta mejor encaje de producto. Si suben consultas desde un artículo técnico, el lector probablemente necesita diseño de workflow.