Instrucciones para el agente

Resumen

El agente empieza cada conversación sin saber nada de tu proyecto, salvo lo que lee. Un archivo de instrucciones le dice qué investigas, cómo se trabaja y qué no debe tocar, y vive en el repositorio con todo lo demás. Es el protocolo del proyecto, escrito para alguien que lo lee al pie de la letra.

1. 1

   Lo que el agente sabe

   El agente sabe lo que está en la conversación y lo que lee de tus archivos. No conoce tu pregunta, tus decisiones ni tus razones si no están escritas. Una conversación nueva, o /clear, empieza de cero: lo que importa tiene que quedar en un archivo, no en el chat.

2. 2

   CLAUDE.md

   Claude Code lee el archivo CLAUDE.md de la carpeta del proyecto al empezar cada conversación. Ahí va qué es el proyecto, cómo se organiza, cómo se guarda cada cambio y qué no se toca. /init escribe un primer borrador; tú lo corriges. Se guarda en Git, y sus cambios también quedan fechados.

3. 3

   Plan antes que cambio

   Antes de un cambio grande se pide un plan: qué archivos tocaría el agente, en qué orden y por qué. En el modo de plan de Claude Code, que se activa con Shift+Tab, el agente lee y propone sin modificar nada. Un plan se discute y se corrige; un cambio hecho solo se puede revisar.

Escribes el protocolo de tu proyecto como escribirías uno de investigación: objetivo, procedimiento y criterios éticos.