Diego De Granda

Acá va un 🧵 de todos los hilos que he creado para ustedes con recomendaciones y herramientas que les ayudarán como desarrolladores si van comenzando o si ya tienen algo de experiencia. 👇🏼

Si quieres el análisis completo, el ejemplo de 350 tokens listo para adaptar, los anti-patrones más frecuentes y el framework de validación, lo escribí en detalle acá degranda.substack.com/p/por-que-un-s…

Un prompt de producción que funciona no es largo. Es específico. 350 tokens, 8 secciones, ejemplos contrastivos, cero adjetivos subjetivos. La especificidad de tu system prompt determina la consistencia de tu producto.

Antes de ir a producción, tres pruebas: -> Test adversarial: 10 inputs diseñados para romper tus reglas -> Test de consistencia: mismo input × 5, temperature=0 — ¿varía la salida? -> Test de regresión: corre tus evals en cada actualización de modelo, no solo cuando cambias de familia Si falla alguna, el prompt tiene ambigüedad que no habías encontrado.

Un system prompt vago no falla en la demo. Falla en producción, de forma inconsistente. Eso es más difícil de detectar y más difícil de arreglar. Esto es lo que separa un prompt que aguanta producción de uno que no: 🧵

Escribí el análisis completo esta semana: CLAUDE.md funcional de 47 líneas para un repo de pagos en LATAM, tu primera Skill paso a paso, y todos los errores documentados contra fuentes primarias. Si usas Claude Code en equipo, esto es para ti degranda.substack.com/p/tu-claudemd-…

Tres tests para verificar que tu configuración funciona, para hacer hoy: Test 1: el enumerado. En una sesión nueva: "¿Qué reglas estás aplicando en este repo?" Debe listarlas con precisión. Si responde con generalidades, el archivo tiene formulaciones débiles o está muy largo. Test 2: la violación. Escribe código que rompa una regla dura (float donde debe ir Decimal). Pídele a Claude que lo revise. Debe señalar la violación específica sin que se lo pidas. Si no lo hace, la regla está mal formulada o enterrada en el archivo. Test 3: el /init como diagnóstico /init analiza el codebase y genera un CLAUDE.md base automáticamente. Úsalo para arrancar, no como resultado final. Lo que genera son observaciones del código. Lo que tienes que agregar son las reglas que no están en el código. Si usas Claude Code en equipo y nunca has corrido estos tres tests, vale la pena hacerlo esta semana.

Alguien de mi red compartió su CLAUDE.md la semana pasada. 340 líneas. Descripción del producto, lista de endpoints, arquitectura completa, convenciones de testing. Orgulloso del detalle. El problema: Claude probablemente llevaba semanas ignorando la mitad del archivo sin decírselo. Hay un umbral técnico documentado que casi nadie menciona y, si lo superas, tus reglas dejan de funcionar, aunque estén bien escritas. Lo que encontré revisando archivos de mi red, y cómo arreglarlo: 🧵