Flujos de Trabajo Agénticos
Hábitos independientes de la herramienta para obtener trabajo confiable de cualquier agente de programación.
Escribe primero la especificación
Una especificación corta — qué, por qué, restricciones, tareas — evita que tu agente de código adivine los detalles que no mencionaste.
Tip #020Ajusta El Esfuerzo Al Tamaño De La Tarea
¿Ejecutas varias sesiones de agente a la vez? Ajusta el esfuerzo de razonamiento de cada una según su tarea para que las preguntas rápidas no esperen detrás de las profundas.
Tip #021Bash o MCP
No conectes un servidor MCP para herramientas que tu agente ya puede alcanzar con bash. Una regla de decisión para saber cuándo un servidor realmente vale la pena.
Tip #137Ordena las etapas de CI de la más barata a la más costosa
Deja de esperar diez minutos para atrapar un typo — ordena tu CI para que los chequeos más baratos y con más chance de fallar corran primero y fallen rápido.
Tip #138Nunca conviertas un test intermitente en una compuerta obligatoria
Un test que pasa al reintentar es un defecto, no un tropiezo — ponlo en cuarentena para que la compuerta obligatoria siga significando algo y tu equipo nunca aprenda a solo darle a reintentar.
Tip #141Planea el funeral antes de construir
Cuando diseñes algo nuevo, pregunta cómo lo borrarías en tres años — la respuesta te obliga a interfaces limpias, flags y una superficie pequeña que sigue siendo barata de eliminar.
Tip #142La Ley de Hyrum: con suficientes usuarios, hasta los bugs generan dependencia
Con suficientes usuarios, cada comportamiento observable de tu sistema se vuelve una API de la que alguien depende — por eso una deprecación es una migración que ejecutas, no un memo que envías.
Tip #143Pregunta qué NO tocó tu agente
Haz que cada cambio del agente termine con un resumen de Cambios / No toqué / Dudas, para que el scope creep salga a la luz antes de que lo encuentre tu revisor.
Tip #146Detén a tu agente cada 100 líneas para probar
Nunca dejes que un agente de código escriba más de ~100 líneas antes de probar — las rebanadas verticales delgadas mantienen los errores pequeños, locales y baratos de corregir.
Tip #147Dile a tu agente que anote, no que arregle, los problemas fuera de alcance
Una sola regla en CLAUDE.md evita que un agente de código infle tu pull request — cuando detecta un problema no relacionado, lo anota en lugar de arreglarlo.
Tip #148Haz que tu primera tarea sea una bala trazadora
Tu primera tarea debe ser una bala trazadora: el corte más delgado a través de todas las capas que prueba el camino antes de construir a lo ancho.
Tip #149Si el Título de una Tarea Contiene “y”, Divídela
La palabra “y” en el título de una tarea suele esconder dos tareas. Divide hasta que cada una quepa en ~5 archivos, ≤3 criterios de aceptación y una sesión enfocada del agente.
Tip #150El bug de un PR generado por IA vive en quienes lo llaman
El bug de un PR generado por IA casi nunca está en el diff — está en los llamadores que el diff nunca te muestra. Revisa el radio de impacto, no solo las líneas que cambiaron.
Tip #151Lee las pruebas antes que el código
En un pull request, lee primero las pruebas y después el código: las pruebas codifican la intención del autor, y una ruta riesgosa sin prueba es en sí misma un hallazgo.
Tip #152Haz que tu IA liste sus supuestos antes de escribir código
Una sola instrucción — 'lista cada supuesto y espera mi corrección' — atrapa el malentendido cuando todavía cuesta una frase arreglarlo, en vez de una tarde de retrabajo.
Tip #153Un rollback sin probar no es un rollback
Un plan de rollback que nunca ejecutaste es una esperanza, no un plan. Comprueba que el kill switch apaga la función en segundos, antes del lanzamiento y no durante el incidente.
Tip #184Agrega una línea a cada prompt de investigación con IA
Hazle una pregunta amplia a una IA y te devuelve lo que ya creías. Una sola línea que exija evidencia contraria y escenarios negativos convierte el sesgo de confirmación en un informe de decisión real.
Tip #185Cuando la estructura no llega, sáltate el esquema
Forzar un esquema antes de tener la columna vertebral de un texto arma un esqueleto al que escribes, y se nota. Vuelca cada fragmento en un archivo y deja que la estructura emerja párrafo a párrafo.
Tip #186Prohíbele a la IA simular especificidad
La jugada más letal del cold email con IA es fingir especificidad. Prohíbele al modelo inventar anclas y exige una observación real y verificable por correo, o marca el borrador como no listo.
Tip #188Obliga a las decisiones ambiguas a un informe estricto de 3 líneas
Ante una decisión ambigua, una IA devuelve tres párrafos evasivos que terminan en 'depende'. Obliga un informe de decisión de tres líneas — ELI10, Riesgos, Recomendación — para que deba comprometerse con una.
Tip #189Haz concretos los riesgos: radio de impacto, reversibilidad, costo de tiempo
'Podría causar problemas' no es una evaluación de riesgo. Cuando un agente plantea una decisión, oblígalo a nombrar el radio de impacto, si es reversible y el costo de tiempo de equivocarse.
Tip #190Nunca le pases tu conclusión a un agente revisor
Si le pasas tu conclusión a un revisor de IA, valida tu conclusión. Dale solo el artefacto y el contrato, pídele que encuentre qué está mal, y sacará a la luz los problemas que tú no podías ver.
Tip #191Limita la revisión adversarial a tres ciclos
La autorrevisión adversarial detecta puntos ciegos, pero repetirla sin fin solo se estanca en los mismos hallazgos. Limítala a tres ciclos; si sobreviven problemas reales, eso es información sobre el artefacto, no razón para repetir.
Tip #192Bloquea la primera edición de tu IA
Los agentes editan archivos que nunca leyeron de verdad. Bloquea la primera mutación hasta que el agente liste los importadores, nombre las funciones públicas afectadas y muestre las formas de datos reales. Sin hechos, no hay edición.
Tip #193Haz que tu IA cite tu instrucción textualmente
Los agentes reinterpretan tu pedido en silencio y construyen una versión pulida de algo que nunca pediste. Una línea — cita mi instrucción palabra por palabra antes de tocar código — revela la desviación al instante.