# AGENTS.md · Instrucciones para agentes de IA

> Plantilla de MaestrIA (ciertaia.com/maestria). Copia este fichero en la raíz de tu repositorio y rellena lo que está entre corchetes. Lo leen Codex, Cursor, GitHub Copilot, Claude Code (también en CLAUDE.md) y muchos otros agentes. Borra lo que no aplique: mejor corto y cierto que largo y genérico.

## Qué es este proyecto
[Una o dos frases: qué hace, para quién y en qué estado está.]

## Comandos
- Instalar: `[npm install]`
- Arrancar en local: `[npm run dev]`
- Pruebas: `[npm test]` (deben pasar antes de dar un cambio por terminado)
- Formato y lint: `[npm run lint]`

## Estructura
- `[src/]`: [qué hay]
- `[src/dominio/]`: [lógica pura, sin interfaz]
- `[pruebas/]`: [pruebas]
- `[docs/]`: [documentación]

## Cómo trabajamos
1. Antes de cambiar código, lee la especificación en `[specs/]` y propón un plan.
2. Primero la prueba, después el código.
3. Cambios pequeños y revisables; un tema por cambio.
4. Al terminar: pruebas en verde y documentación al día.

## Convenciones
- Idioma de código y comentarios: [español / inglés].
- Nombres: [camelCase para funciones, PascalCase para componentes…].
- [Otras reglas de estilo que no sean obvias.]

## Trampas (lo que parece obvio y rompe algo)
- [Ej.: nunca guardar dentro de un actualizador de estado; calcular fuera.]
- [Ej.: un campo nuevo en los datos guardados necesita migración.]

## No hagas sin preguntar
- Borrar ficheros o datos.
- Añadir dependencias nuevas.
- Cambiar la configuración de despliegue, de CI o de seguridad.
- Hacer push o publicar.

## Dónde está cada cosa (fuente única)
| Qué | Dónde |
|---|---|
| [Configuración] | [ruta] |
| [Textos de la interfaz] | [ruta] |