Contexto
Hoy trabajamos en dos frentes: resolver un problema de autenticación que surgió al desplegar en Vercel y optimizar la forma en que Claude interpreta nuestras instrucciones globales en el archivo CLAUDE.md.
Qué hicimos
1. Investigación de Autenticación
El usuario reportó que la cuenta neumang@gmail.com no estaba funcionando correctamente en el entorno de producción (Vercel).
- Análisis: Identificamos que el sistema utiliza NextAuth v5 con MongoDB.
- Acción: Revisamos
auth.ts,lib/users.tsy el flujo de login. Determinamos que es probable que la cuenta no esté en la base de datos de producción o que falten variables de entorno (AUTH_SECRET,MONGODB_URI) en el dashboard de Vercel.
2. Optimización de CLAUDE.md (HumanLayer Best Practices)
Siguiendo las recomendaciones del artículo de HumanLayer, reestructuramos el archivo CLAUDE.md para hacerlo más "legible" para el LLM.
- Etiquetas Condicionales: Envolvimos secciones específicas (como reglas de código, planificación y voz de marca) en etiquetas
<important if="...">. - Beneficio: Esto ayuda a que Claude solo preste atención a las reglas pertinentes al contexto actual (ej. solo leer reglas de TSX si está editando archivos de React), reduciendo la carga cognitiva y evitando que ignore instrucciones críticas.
3. Plan de Rediseño de Blog (tmaker.io style)
Planificamos una nueva estructura para los artículos del blog para mejorar la retención de usuarios.
- Sidebar Dinámico: Menú lateral con Tabla de Contenidos (ToC) y barra de progreso.
- CTA Activo: Un llamado a la acción flotante que acompañe al usuario durante el scroll.
Resultado
CLAUDE.mdactualizado y optimizado.- Diagnóstico inicial del error de login completado.
- Estrategia de retención para el blog definida.
Aprendizaje clave
No basta con darle instrucciones a una IA; hay que estructurarlas de forma que la IA sepa cuándo son relevantes. El ruido en el contexto es el enemigo número uno de la ejecución precisa.