Ficha · Sesión 10 · Módulo II, La bitácora
«De la pregunta a la herramienta»
¿Qué necesita saber quien trabaja en tu proyecto antes de tocarlo?
Lo mismo que pide un protocolo: objetivo, procedimiento y límites. Escrito en CLAUDE.md, el agente lo lee al empezar; pedirle un plan antes de cada cambio deja ver si lo entendió.
Instrucciones para el agente
El oficio que ya tienes
Antes de que alguien más salga a campo por ti, le das un protocolo por escrito: el objetivo del estudio, cómo se aplica el instrumento, qué datos no se comparten y a quién preguntar si hay dudas. Lo que no está en el protocolo, cada quien lo improvisa. Con el agente pasa igual.
En Marienthal
El CLAUDE.md del proyecto de clase dice el objetivo (saber en qué se va el día, hora por hora, como en Marienthal), el procedimiento (cada cambio al cuestionario en su propia versión, con su razón) y los límites (ninguna pregunta cambia sin que se pida). Antes de agregar una franja nocturna se pide un plan, y se lee como la propuesta de otra persona del equipo.
En tu proyecto
Escribe el CLAUDE.md de tu proyecto: tu pregunta, cómo está organizado, cómo se guarda cada cambio y qué no se toca. Guárdalo en una versión. Luego abre una conversación nueva, pide un plan para el siguiente paso y revisa si el agente entendió lo que dejaste escrito.
Conceptos
- Contexto
- Todo lo que el agente tiene a la vista en una conversación: tus mensajes, sus respuestas y los archivos que leyó.
- CLAUDE.md
- El archivo de instrucciones que Claude Code lee al empezar a trabajar en una carpeta. Es texto plano y se guarda en el repositorio.
- Plan
- La propuesta del agente antes de actuar: qué hará, en qué archivos y en qué orden. Se aprueba o se corrige.
- Límite
- Lo que el agente no debe hacer ni tocar, dicho de forma explícita: una carpeta, un archivo, una acción.
Instrumental
claude- Abrir Claude Code en la carpeta del proyecto, donde encuentra tu CLAUDE.md.
/init- Pedir a Claude Code un primer CLAUDE.md a partir de lo que hay en el proyecto.
/clear- Vaciar la conversación y empezar de cero; CLAUDE.md se sigue leyendo.
git add CLAUDE.md- Preparar el archivo de instrucciones para guardarlo en una versión, como el resto del proyecto.
Para tu bitácora
¿Qué sabes de tu proyecto que nunca pusiste por escrito, y qué haría con ese hueco alguien que no te puede preguntar?