Depurador de Diff de Entorno

El Problema

“Funciona en mi maquina.” Cinco palabras que persiguen a cada equipo de desarrollo. El codigo es identico, los tests pasan localmente, pero produccion se comporta diferente. La diferencia se esconde en variables de entorno, versiones de OS, versiones de Node.js, librerias del sistema instaladas, permisos de archivos, configuracion de zona horaria, o una docena de otros factores invisibles.

El Prompt

Eres un especialista forense de entornos. Encuentra la diferencia oculta entre dos entornos:

ENTORNO A (funciona): [ej. desarrollo local, macOS, Node 20.11]
ENTORNO B (roto): [ej. produccion, Linux, Node 20.9]

SINTOMA EN ENTORNO B: [que sale mal]
FACTORES IDENTICOS: [que ya confirmaste que coincide]

Ejecuta diagnostico diferencial de entorno:
1. **Diff de Version de Runtime**: Compara versiones exactas de runtime. Hasta las versiones patch importan.
2. **Diff de OS y Sistema**: Compara OS, arquitectura (arm64 vs x86_64), librerias del sistema, case sensitivity del filesystem.
3. **Auditoria de Variables de Entorno**: Lista cada env var que la aplicacion lee. Compara valores. Busca variables FALTANTES que caen a defaults.
4. **Diff de Arbol de Dependencias**: Compara package-lock.json, builds de modulos nativos e instalacion de dependencias opcionales.
5. **Diff de Red y DNS**: Compara resolucion DNS, configuracion de proxy, reglas de firewall y stores de certificados SSL.
6. **Diff de Filesystem y Permisos**: Verifica permisos de archivos, propietario, case sensitivity y manejo de symlinks.
7. **El Culpable Probable**: Basado en el sintoma, cual categoria de diferencia es mas probable? Rankea top 3.

Ejemplo de Salida

Runtime: Node 20.11.1 (local) vs 20.9.0 (prod) — breaking change en parseo de URLs entre estas versiones
Env vars: DATABASE_URL presente localmente (de .env), faltante en produccion (olvidaron agregarla al dashboard de Vercel)
Dependencia: sharp@0.33 construye modulo nativo diferente en macOS arm64 vs Linux x86_64
Culpable probable: #1 DATABASE_URL faltante (90%) — la app usa SQLite como fallback cuando la variable falta

Cuando Usar

Usa este skill cuando el codigo funciona en un entorno pero falla en otro. Esencial para depurar fallos de deployment, problemas de pipeline CI/CD, bugs cross-platform y la clasica discrepancia local-vs-produccion.

Tips Pro

• Usa env o printenv para volcar TODAS las variables de entorno — luego haz diff de las salidas. Variables de proxy ocultas y variables de locale frecuentemente causan diferencias sutiles.
• Docker no garantiza entornos identicos — diferentes OS host, versiones de kernel y versiones de Docker Engine pueden afectar el comportamiento dentro de contenedores.
• Revisa la zona horaria — la variable de entorno TZ o la zona horaria del sistema afecta cada operacion de fecha.