# Documentación

Qué hay, para qué sirve y cuándo leerlo. Si creas, mueves o borras un
documento, actualiza esta tabla.

## En este repo

| Documento | Qué contiene | Cuándo leerlo |
|---|---|---|
| [AGENTS.md](../AGENTS.md) | Instrucciones de trabajo: stack, comandos, arquitectura, convenciones y reglas de documentación | Siempre. Claude Code lo carga solo, a través de `CLAUDE.md` |
| [README.md](../README.md) | Qué es la aplicación y cómo arrancarla en local | La primera vez |
| [status.md](status.md) | Qué hay en producción, pendientes y decisiones abiertas | Al empezar cualquier tarea |
| [CHANGELOG.md](../CHANGELOG.md) | Qué cambió y cuándo, con su commit | Para saber desde cuándo algo funciona así |
| [decisions.md](decisions.md) | Por qué la aplicación es como es | Antes de cambiar algo que parezca raro |
| [features/quotas.md](features/quotas.md) | Cuota del alumno y tiempo del bot | Antes de tocar cuotas, temporizadores o el corte de llamadas |
| [features/conversations.md](features/conversations.md) | La llamada de voz, el WebSocket, subtítulos, feedback y traducciones; configuración de los agentes en ElevenLabs | Antes de tocar el chat o la integración con ElevenLabs u OpenAI |
| [operations.md](operations.md) | Despliegue, actualización, backups y problemas conocidos | Para desplegar o resolver algo en producción |
| [branding.md](branding.md) | Nombre, colores, logos y reglas de estilos | Para cambiar la marca o maquetar |
| [specs/README.md](../specs/README.md) | Cómo se escribe una spec, con plantillas | Antes de empezar trabajo nuevo no trivial |
| [test/README-BOT-CRUD-TESTS.md](../test/README-BOT-CRUD-TESTS.md) | Scripts de prueba del CRUD de bots | Al ejecutar esos scripts |

## Fuera del repo

Carpeta local de Carla, junto al repo. No está en GitHub. Rutas relativas a la
raíz del repo:

| Ruta | Qué contiene |
|---|---|
| `../encargos/` | Una carpeta por encargo de EWC: propuestas, precios y material de trabajo |
| `../documentacion/` | Guías de usuario entregadas a EWC: tutorial y guías de admin, profesor y alumno |
| `../DOCUMENTACION-TRASPASO.md` | Traspaso entregado a EWC, con los accesos al servidor. No se toca |