# Checklist para revisar código generado por IA

> Una veintena de comprobaciones, ordenadas de la más barata a la más profunda.
> Si una falla, no sigas: arréglala y vuelve a empezar la lista.
> Recurso de acastell.dev — https://acastell.dev/recursos

---

## 1. ¿Existe todo lo que usa?

- [ ] Cada paquete importado existe en el repositorio oficial, tiene mantenedores y no es de ayer.
- [ ] Cada función, método y opción que llama existe en la versión que tienes instalada (abre la documentación; no te fíes de la memoria del modelo).
- [ ] No hay URLs, rutas ni variables de entorno inventadas.

## 2. ¿Hace lo que pedí? ¿Y solo eso?

- [ ] Resuelve exactamente la petición, sin reescribir cosas que no pedí.
- [ ] No ha tocado archivos fuera del alcance (mira la lista de archivos del diff antes de leer una línea).
- [ ] No ha eliminado comprobaciones, tests o comentarios «para simplificar».

## 3. Seguridad

- [ ] No hay secretos, tokens ni claves en el código, en los logs ni en los ejemplos.
- [ ] Toda entrada externa (formularios, parámetros, ficheros, respuestas de APIs) se valida antes de usarse.
- [ ] Las consultas a base de datos están parametrizadas; no se construyen concatenando texto.
- [ ] Lo que se muestra al usuario está escapado; nada de HTML sin sanear.
- [ ] Los permisos son los mínimos necesarios (no `*`, no «admin» por comodidad).

## 4. Corrección

- [ ] Casos límite: vacío, nulo, un solo elemento, muchos elementos, texto muy largo, caracteres raros, fechas y zonas horarias.
- [ ] Los errores se gestionan y se comunican; no hay `catch` vacíos que se los tragan.
- [ ] Las operaciones que pueden fallar a medias (red, disco, base de datos) no dejan datos a medias.
- [ ] Nada depende de que algo ocurra «siempre en este orden».

## 5. Pruebas

- [ ] Hay tests nuevos que fallarían si el código estuviera mal (cámbialo a propósito y mira si fallan).
- [ ] Los tests existentes siguen pasando y no se han debilitado para que pasen.
- [ ] Lo has ejecutado tú; no basta con que el asistente diga que funciona.

## 6. Mantenimiento

- [ ] Alguien que no ha visto el chat entiende el porqué leyendo el código.
- [ ] No hay código duplicado de algo que ya existía en el proyecto.
- [ ] No añade dependencias grandes para una tarea pequeña.

---

## Antes de fusionar, tres preguntas

1. ¿Qué es lo peor que pasaría si esto falla en producción?
2. ¿Qué parte NO he podido comprobar?
3. ¿Me atrevería a explicar este código en una reunión, línea a línea?

Si la respuesta a la tercera es «no», todavía no es tu código.
