Contexto
Qué sabe la IA antes de empezar
Guía
- Contrato del proyecto (
CLAUDE.md) y documentación de arquitectura
- ADRs y comentarios que explican el porqué
- Grafo de código navegable (MCP)
- Memoria persistente de errores aprendidos
Skills
Cómo se hace cada tarea
Guía
- Un único origen, sincronizado a todos los agentes
- Pasos que marcan qué obliga TypeScript y qué hay que cablear a mano
- Errores comunes y verificación honesta
Tipos
Lo que no compila, no existe
Guía + Sensor
- Registros exhaustivos y tipos condicionales
satisfies en vez de switch con default- Comprobación de tipos completa, no solo el build
Linters
La arquitectura como ley
Sensor
- Reglas de arquitectura propias (capas, verticales, features)
- Reglas del contrato convertidas en sensor
- Mensajes de error que traen el arreglo
- Stylelint con trinquete de deuda
Verificación
Nada llega a producción sin pasar la red
Sensor + Humano
- Tests unitarios y e2e
- Revisión cruzada por otras IAs
- Hooks de git y preflight (build, dependencias, legal, assets)
- Humano en el bucle: plan aprobado antes de tocar código