diff --git a/PRODUCCION.md b/PRODUCCION.md
index efedfc9..2e9f19d 100644
--- a/PRODUCCION.md
+++ b/PRODUCCION.md
@@ -85,8 +85,36 @@ python3 -c "import zipfile,shutil,os; ..."
 # Desde el servidor de producción:
 curl -s -o /dev/null -w "HTTP %{http_code}" http://127.0.0.1:8081/
 curl -sI http://127.0.0.1:8081/?cv_pdf=1 | grep Content-Type
+curl -s -o /dev/null -w "favicon: HTTP %{http_code}\n" http://127.0.0.1:8081/favicon.ico
 ```
 
+## Problemas conocidos y soluciones
+
+### 502 Bad Gateway general
+El servicio escucha en `0.0.0.0:8081`. Si queda en `127.0.0.1` NPM no puede alcanzarlo.
+
+### 502 en recursos estáticos (CSS, JS, favicon) con NPM Cache Assets activado
+NPM cachéa respuestas de error (502/404). Si un recurso faltaba antes y ahora existe,
+NPM sigue sirviendo la respuesta vieja desde caché.
+**Solución:** en NPM, desactivar **Cache Assets** → guardar → reactivar → guardar.
+Para un sitio CV, **Cache Assets puede quedarse desactivado** sin impacto notable.
+
+### CSS/JS con 404 tras clonar el repo en un servidor nuevo
+Los symlinks `persona-cv`, `lumina` y `cvolio` en `wp-content/themes/` usan **rutas relativas**
+(`../../../../frontend/...`). Si al clonar quedan rotos, recrearlos:
+```bash
+THEMES='/opt/apps/pflores.linkedcorp.net/backend/wordpress/wp-content/themes'
+FRONTEND='/opt/apps/pflores.linkedcorp.net/frontend'
+rm -f $THEMES/persona-cv $THEMES/lumina $THEMES/cvolio
+ln -s $FRONTEND/persona-cv-theme $THEMES/persona-cv
+ln -s $FRONTEND/lumina-cv-theme  $THEMES/lumina
+ln -s $FRONTEND/cvfolio-theme    $THEMES/cvolio
+```
+
+### favicon.ico
+El archivo `backend/wordpress/favicon.ico` está en git (foto de Patricia, 16/32/48px).
+No hace falta recrearlo manualmente.
+
 ## Pendientes
 
 - [ ] Configurar SMTP en WP Mail SMTP
diff --git a/PROMPT_IA.md b/PROMPT_IA.md
index 1db723a..70dce99 100644
--- a/PROMPT_IA.md
+++ b/PROMPT_IA.md
@@ -664,6 +664,8 @@ php -l /ruta/al/tema/functions.php
 | CMB2 / plugin no carga | Serialización incorrecta en `active_plugins` | Regenerar con `php -r "echo serialize([...]);"` |
 | `pflores_get_cv_data()` retorna vacío | Datos no guardados en BD | Re-ejecutar `populate-data.php?key=pflores2024` + limpiar caché |
 | Apex-cv vacío o sin archivos | Tema apex-cv depende de directorio real, no symlink | Los archivos van en `wp-content/themes/apex-cv/`, no en `frontend/` |
+| CSS/JS con 404 tras clonar en servidor nuevo | Symlinks de temas usan ruta absoluta del equipo de dev | Recrear symlinks con ruta absoluta del servidor real (ver `PRODUCCION.md` → Problemas conocidos) |
+| 502 persistente en favicon u otros estáticos tras haberlo corregido | NPM **Cache Assets** cachéo la respuesta 502/404 anterior | En NPM: desactivar Cache Assets → guardar → reactivar → guardar. Para CV puede quedar desactivado. |
 | PDF vacío o error 500 | Chromium no encontrado o falla | `which chromium chromium-browser google-chrome` |
 | `update_option` no guarda | Caché de WordPress | Limpiar transients (ver sección 17) |