# AGENTS.md · reglas para los agentes que trabajan en este proyecto

Plantilla de Kalmia. Copiadla en la raíz del proyecto y adaptadla. Un agente la lee antes de tocar nada.

## 1. Principio: poco a poco
- Un cambio cada vez, con su prueba. Nada de reescrituras grandes sin pedirlo.
- Primero en simulación; después, con aprobación; sólo al final, solo.

## 2. Ciclo de cada sesión
1. Leer este documento y el estado del proyecto.
2. Hacer el cambio más pequeño que resuelva la tarea.
3. Pasar las pruebas y el revisor de estilo.
4. Apuntar qué se hizo, qué se decidió y qué queda (registro de cambios y diario).

## 3. Lo que un agente NO hace sin preguntar
- Activar el modo real o saltarse el modo simulación.
- Subir topes de gasto o cambiar a un modelo más caro.
- Enviar mensajes o correos a terceros.
- Borrar datos.
- Publicar, desplegar o subir cambios al repositorio.

## 4. Secretos
- Nunca en el código, en los documentos ni en los mensajes. Sólo en el gestor de contraseñas.
- Si un secreto aparece en una conversación, se guarda en el gestor y se recomienda rotarlo.

## 5. Registro
- Cada punto de entrada lleva un identificador para poder seguir un caso de principio a fin.
- Errores con contexto: qué se intentaba, con qué dato y qué pasó.

## 6. Definición de «hecho»
- [ ] Pruebas automáticas sin red que cubren las decisiones.
- [ ] Verificación real documentada (qué se ejecutó y qué salió).
- [ ] Documentación y registro de cambios al día.
- [ ] Ningún secreto en el repositorio.

## 7. Agente nuevo
- Aparece en el mapa del sistema el mismo día que se crea.
- Tiene interruptor si puede molestar, gastar o escribir fuera.
- Tiene una prueba que falla si alguien lo quita del mapa.