Idea principal

Cuando trabajas sobre un tema largo con Claude Code y dejas que el asistente escriba en un archivo Markdown, la pregunta que acaba surgiendo no es el tamaño del archivo, sino para quién está ordenado.

Un asistente necesita puntos de reanudación: dónde se detuvo el trabajo, qué decisiones se tomaron, dónde encontrar una fuente. Necesita secciones estables, identificadores, estados. Un product manager que relee el mismo archivo busca otra cosa: agregar la información, validarla, volver a dividirla por tema o por nivel de riesgo para arbitrar. No son dos presentaciones de una misma estructura, son dos estructuras.

Sostener ambas en un solo archivo no produce por tanto un compromiso, sino un documento que cada uno de los dos lectores tiene que atravesar ignorando la mitad. Desdoblar el archivo — uno para el asistente, otro para el humano — aplaza el problema sin resolverlo: los dos engordan, y cada uno acaba conteniendo un poco de todo, fuentes, decisiones, hipótesis y directrices mezcladas en el mismo flujo. La división que se sostiene no se hace por destinatario, se hace por naturaleza del contenido.

Por qué es importante

Esto identifica el paso que nos saltamos al pasar del archivo único al sistema de archivos. Primero creemos tener un problema de volumen, luego creemos tener un problema de público; en realidad es un problema de tipos de objetos, y mientras no se vea, multiplicamos archivos que vuelven todos a ser cajones de sastre.

También da un criterio de relectura sencillo para un documento de trabajo compartido con un asistente: preguntar a quién sirve cada sección, y contar cuántas sirven a dos.

Matices y límites

Un documento corto escapa a la regla. Mientras un archivo se lea entero en un minuto, el desorden no cuesta nada, e imponerle una estructura cuesta más de lo que aporta.

Y la separación tiene un precio: dos estructuras que mantener se desincronizan, y una de las dos acaba por no releerse nunca.

Preguntas abiertas

• ¿Cómo comprobar que la versión destinada al humano no se ha quedado atrás respecto a la que el asistente actualiza en cada sesión?