Las reglas de la sesión en AGENTS.md

¿Qué haremos en este paso? ¶

Vas a dar al agente las reglas que valen para toda la sesión. Y vas a conseguir que las guarde en AGENTS.md, no solo en el chat o en su memoria.

¿Qué necesitas? ¶

El proyecto de partida en marcha (paso 01) y una sesión nueva con tu agente.

Acción ¶

1. Las reglas ¶

Antes de empezar, estas son las reglas:
- Conmigo hablas en español, en ETS (español técnico simplificado).
- Lo que escribas (código, documentación, spec, plan, ADR, commits, PR) va en inglés, en ASD-STE100 Simplified Technical English.
- Una rama por funcionalidad, con el prefijo feature/.
- Commits atómicos y pequeños con Conventional Commits, sin firmarlos tú.
- Los documentos de trabajo que no necesitan sobrevivir a la sesión van en la carpeta .scratchpad/, ignorada por git.

Mira dónde guarda el agente las reglas. En el vídeo, Claude Code las guarda en su memoria para las próximas sesiones (con Codex es probable que pase lo mismo). Si tu agente no lo hace, no importa: el paso siguiente lo resuelve.

2. La pregunta ¶

¿Y esto me lo vas a mantener durante toda la sesión o lo vas a poner en el AGENTS.md?

El agente explica dónde están ahora las reglas: en la sesión y en su memoria personal. Y propone llevarlas a AGENTS.md.

3. El cambio, con diff ¶

No crees la rama ni hagas commits todavía. Cambia el AGENTS.md como mejor te parezca y hazme un diff del cambio.

Revisa el diff. Fíjate en qué reglas pone en AGENTS.md y cuáles deja en su memoria.

4. Lo que falta ¶

Si el agente avisa de que .scratchpad/ no está en .gitignore, copia su frase, pon una flecha -> y pídele que lo haga:

{frase del agente} -> Hazlo.

Al terminar debe quedar:

• AGENTS.md con las reglas de la sesión.
• .scratchpad/ en .gitignore.

⚠️ Las reglas pueden ser demasiado explícitas. Con “una rama por funcionalidad”, el agente intentó crear la rama antes de empezar. Por eso el tercer prompt le dice que no cree la rama ni haga commits todavía.

🔑 Pon en AGENTS.md solo las reglas que no están en el código. Si hay un comando para los tests, haz referencia al comando. No le digas cómo hacer los tests.

📂 En la rama feature/admin-panel tienes el AGENTS.md final.