← Programa Sesión 3 de 6 · Documentar para retomar

Sesión 3 · Trabajar con Claude

Cada chat es
un agente nuevo.

La conversación se termina y la memoria se va con ella. Lo único que sobrevive es lo que quedó escrito. Hoy trabajamos las tres capas de documentación que hacen que cualquier sesión futura pueda seguir donde quedaste.

Espacio ordenado Registro de decisiones Cierre de sesión

De dónde venimos

Lo que quedó de la Sesión 2.

  • ✓
    Un cliente trabajado a fondoElegimos un cliente real y le armamos su propio CLAUDE.md con detalle: estado, historial, documentos, próximos pasos. La profundidad vertical está hecha.
  • ✓
    Tu primera Skill, andandoNos adelantamos al programa: armamos una skill que toma un documento de texto y lo saca en PDF con tu identidad visual aplicada. La corrimos con tu manual de marca y salió bien.
  • Pendiente: el mapa generalLa amplitud horizontal quedó a medias. Falta que el mapa cubra todos tus clientes, y falta ordenar el contexto que se repite en todos: eso lo arrancamos hoy.

Hoy

Cómo viene la mano.

  • 01
    Terminar de ordenar el espacio Completar el mapa general y separar bien qué va en el CLAUDE.md, qué va en las reglas que se cargan siempre, y qué va en la carpeta de cada cliente.
  • 02
    Documentar mientras trabajás El registro de decisiones: qué se decidió, por qué, y qué se descartó. Es lo que evita volver a discutir lo mismo dentro de tres meses.
  • 03
    Cerrar bien una sesión Un ritual de cinco pasos para terminar cualquier conversación de trabajo dejando el proyecto listo para que lo retome otro.
  • 04
    La prueba de fuego Abrimos un chat nuevo, en frío, y le pedimos que nos diga en qué estado está el proyecto. Si acierta, la documentación sirve.
Vas a salir con: tu espacio ordenado en capas, tus reglas propias escritas, y un procedimiento de cierre que podés usar en cada conversación de acá en adelante.

Concepto

Por qué esto no es burocracia.

Cada conversación que abrís arranca de cero. No se acuerda de la de ayer, ni de lo que decidimos la sesión pasada, ni de por qué descartamos algo. Lo que sí puede hacer, y es lo que cambia todo, es leer lo que quedó escrito y arrancar desde ahí.

Visto así, la documentación no es un trámite posterior al trabajo. Es la memoria del proyecto. Un archivo de contexto bien escrito vale más que veinte conversaciones buenas que no dejaron rastro.

Para pensar juntos

¿Cuántas veces tuviste que volver a explicarle el mismo cliente desde cero?

Concepto

Tres momentos, tres tipos de documento.

La mayoría de la gente documenta solo el primero, y ahí es donde se pierde el trabajo.

Antes

El mapa

Lo que Claude ya sabe sin que le digas nada: quién sos, qué clientes tenés, cómo escribís, qué formato usan tus entregables. Se escribe una vez y se corrige cuando cambia.

Durante

El registro

Las decisiones que se van tomando mientras trabajás, con el porqué y con lo que se descartó. Se escribe en el momento, no después: después ya no te acordás del porqué.

Al cerrar

El traspaso

El estado en que quedó todo y cuál es el próximo paso concreto. Es lo que lee el que llega después, seas vos el lunes o cualquier sesión nueva.

Antes · el mapa

Tres lugares distintos, no uno.

El error típico es meter todo en un solo archivo gigante. Se vuelve imposible de mantener y Claude termina leyendo mucho para encontrar poco.

CLAUDE.md raíz

El índice

Corto a propósito. Quién sos, qué clientes y proyectos hay, dónde está cada cosa, y las reglas que no se negocian. Es un cartel indicador, no un manual.

.claude/rules/

Lo que se carga siempre

Lo que se repite en todos tus proyectos: cómo escribís, quiénes son tus clientes y contactos, el formato de tus informes, las normas y unidades con las que trabajás.

CLAUDE.md del cliente

El detalle

Lo que solo aplica a ese cliente: su historial, su estado, sus documentos, sus próximos pasos. Como el que armamos la sesión pasada.

La regla para decidir: si lo tenés que repetir en cada chat, va en un archivo. Si lo repetís en cada proyecto, va en .claude/rules/.

Antes · el mapa

Cómo queda tu carpeta.

espacio-de-trabajo/
├── CLAUDE.md                        ← el índice, corto
├── .claude/
│   └── rules/                       ← se carga siempre, en todo proyecto
│       ├── quien-soy.md             ← trayectoria, especialidad, cómo te presentás
│       ├── como-escribo.md          ← tono, extensión, qué nunca usás
│       ├── clientes-y-contactos.md  ← quién es quién, sin datos sensibles
│       └── formato-entregables.md   ← informes, PDF con tu marca, unidades
├── clientes/
│   ├── cliente-a/CLAUDE.md          ← liviano
│   ├── cliente-b/CLAUDE.md          ← liviano
│   └── cliente-c/                   ← el que trabajamos la sesión pasada
│       ├── CLAUDE.md                ← rico: estado, historial, próximos pasos
│       ├── decisiones.md            ← el registro (lo de hoy)
│       ├── informes/
│       └── historial/
└── skills/
    └── informe-a-pdf/               ← la que armamos la sesión pasada

Nada de esto es obligatorio de golpe. Hoy arrancamos por las reglas, que son las que más te devuelven por el trabajo que cuestan.

Ejercicio · en vivo

Completar el mapa que quedó a medias.

Retomamos lo que no llegamos a terminar la vez pasada: que todos tus clientes existan en el mapa, aunque sea en una línea cada uno.

Prompt de expansión horizontal
Revisá mi CLAUDE.md actual. Hacé una lista de los clientes o
proyectos de los que te hablé en algún momento y que todavía no
figuran en el mapa general. Para cada uno, agregá una línea breve:
quién es, qué tipo de trabajo y estado general. No hace falta
profundidad, solo que queden registrados. No inventes nada: si te
falta información de alguno, decime cuál y te la paso.

Ejercicio · en vivo

Escribir tus reglas propias.

Esto es lo nuevo de hoy. En vez de repetir tus preferencias en cada conversación, las escribimos una vez en archivos que se cargan siempre.

Prompt para armar .claude/rules/
Quiero armar una carpeta .claude/rules/ con el contexto que se
repite en todos mis proyectos, para no tener que explicarlo en cada
conversación. Antes de escribir nada, hacéme las preguntas que te
falten para cubrir cuatro cosas: quién soy profesionalmente, cómo
quiero que se escriba lo que produzco, quiénes son mis clientes y
contactos habituales, y qué formato tienen mis entregables. Después
escribí un archivo corto por tema. Que sean instrucciones concretas,
no descripciones lindas.
Ojo con esto

Las reglas se cargan en cada conversación, así que ocupan lugar. Cortas y concretas. Si una regla no cambia lo que Claude hace, sacala.

Durante · el registro

Una decisión sin el porqué se vuelve a discutir.

Esto es lo que más se pierde y lo que más cuesta recuperar. No es lo que decidiste: es por qué lo decidiste, y sobre todo qué descartaste en el camino. Sin eso, dentro de tres meses alguien, o vos mismo, propone otra vez la opción que ya habías descartado.

## 9 de septiembre de 2026
Decisión: la skill saca el PDF con la identidad visual propia,
no con un formato genérico.
Por qué: el informe va firmado y circula al cliente, así que
tiene que verse como material propio.
Descartado: plantilla genérica de documento. Prolija, pero no
distingue el trabajo de nadie.

Cuatro líneas. Fecha, decisión, porqué, descartado. Eso es todo el formato.

Ejercicio · en vivo

Que registre mientras trabaja.

Lo mejor del registro de decisiones es que no lo tenés que escribir vos. Se lo pedís al arrancar y queda funcionando toda la conversación.

Prompt de registro de decisiones
Mientras trabajamos en este proyecto, cada vez que tomemos una
decisión que vaya a importar más adelante, anotala en decisiones.md
de esta carpeta con este formato: fecha, qué decidimos, por qué, y
qué descartamos. Escribila en el momento, no al final. Si te parece
que algo es una decisión y yo no lo dije así, preguntame antes de
anotarlo.

Al cerrar · el traspaso

Cómo terminar una sesión de trabajo.

Esto es lo más útil de toda la sesión y casi nadie lo hace. Antes de cerrar la conversación, cinco pasos.

  • 01
    Actualizar el estadoEn el CLAUDE.md del proyecto: en qué punto quedó, qué cambió hoy.
  • 02
    Anotar las decisionesCon el porqué, y con lo que se descartó.
  • 03
    Dejar el próximo paso concretoEscrito como una acción, no como un tema. No "ver lo del informe", sino "mandarle a X el informe que está en tal archivo, falta el capítulo de dosificación".
  • 04
    Dejar las preguntas abiertasLo que quedó sin resolver y de quién depende. Es la parte que más se olvida y la que más traba cuando retomás.
  • 05
    Guardar el entregable donde vaNunca dejar el trabajo solamente en el chat. El chat se cierra; la carpeta queda.

Al cerrar · el traspaso

El prompt de cierre.

Los cinco pasos en un solo pedido. Vale la pena tenerlo a mano y usarlo siempre igual, hasta que se te vuelva costumbre.

Prompt de cierre de sesión
Cerremos la sesión. Hacé cinco cosas, en este orden:

1. Actualizá el CLAUDE.md de este proyecto: estado actual y qué
   cambió hoy.
2. Anotá en decisiones.md lo que decidimos, con el porqué y con
   lo que descartamos.
3. Escribí el próximo paso como una acción concreta, con el
   archivo o la persona involucrada.
4. Listá las preguntas que quedaron abiertas y de quién depende
   cada una.
5. Decime si algún entregable de hoy quedó solo en el chat y
   dónde habría que guardarlo.

Si algo de esto no te queda claro, preguntame antes de escribirlo.
No inventes nada ni redondees lo que quedó a medias.

Al cerrar · el traspaso

Cuatro formas de documentar mal.

Todas parecen documentación y ninguna sirve para retomar.

01

Contar el proceso en vez del estado

"Primero probamos esto, después aquello." Al que llega no le importa el recorrido, le importa dónde estamos parados y qué sigue.

02

Documentar solo lo que salió bien

Lo que se descartó y por qué es tan importante como lo que se hizo. Si no está escrito, se vuelve a proponer.

03

Apilar fechas sin corregir lo viejo

Un archivo con seis actualizaciones encimadas y contradictorias es peor que ninguna. Lo que dejó de ser cierto se corrige, no se sepulta.

04

Escribir para vos y no para el que llega

"Seguir con lo de siempre" te sirve hoy y no le sirve a nadie mañana. Los nombres completos y los archivos, escritos.

Verificación

La prueba de fuego: un chat en frío.

Cerramos todo, abrimos una conversación nueva sin decirle nada de lo que hicimos hoy, y le pedimos: "leé el proyecto de este cliente y decime en qué estado está y cuál es el próximo paso".

Funciona

Te describe el estado real, nombra el próximo paso concreto y sabe qué se descartó. La documentación está haciendo su trabajo.

No funciona

Te pregunta cosas que ya trabajaste, o te propone algo que ya habíamos descartado. Ahí no falla el modelo: falta escribirlo. Lo corregimos juntos, en vivo.

Cierre

Compromiso para esta semana.

Usá el prompt de cierre en todas las conversaciones de trabajo que tengas, aunque hayan sido cortas. La primera vez cuesta dos minutos; después se vuelve automático.

Antes de la próxima sesión: abrí un chat en frío sobre algún cliente y fijate si puede retomar solo. Lo que te falte de contexto lo arreglamos arrancando la Sesión 4, donde mejoramos la skill que ya tenés y armamos las que falten.