En el panorama actual de la inteligencia artificial, la capacidad de una IA para generar código funcional ya no es sorprendente. Lo que antes nos maravillaba, hoy es el estándar mínimo. Ahora, la verdadera diferencia radica en cómo gestionamos estas herramientas para que no solo produzcan, sino que entreguen resultados pulcros y completos. Hemos descubierto que la clave para mejorar drásticamente la salida de código de una IA como Claude Code no está en su potencia bruta, sino en la forma en que le indicamos cuándo ha terminado su trabajo.

Establece un "checklist" claro para cada tarea

Imagina que te preparas para un examen importante. No te limitarías a hojear tus apuntes y asumir que estás listo. Buscarías una manera concreta de verificar que has cubierto todo lo necesario. De la misma manera, hemos comenzado a tratar a Claude Code. En lugar de permitirle decidir que una tarea está finalizada solo porque la característica principal funciona, le proporcionamos una lista de verificación detallada que debe cumplir antes de considerar el trabajo como concluido. Dependiendo del proyecto, esto puede incluir:

  • Verificar que el proyecto se compile correctamente.
  • Ejecutar las pruebas relevantes.
  • Comprobar si hay errores en la consola.
  • Validar el flujo de usuario real.
  • Revisar el prompt original para asegurar que no se omitió nada.

Esta lista no son instrucciones adicionales que la IA debe seguir durante su trabajo, sino condiciones que debe satisfacer antes de poder detenerse. Por ejemplo, podríamos terminar un prompt con:

"Una vez que hayas terminado, asegúrate de que el proyecto se compile sin errores, todas las pruebas pasen y el flujo de usuario funcione como se espera. Confirma que no hay errores en la consola antes de entregar el resultado final."

Esta adición, aunque simple, cambia el comportamiento de Claude Code de manera significativa. En lugar de detenerse cuando la característica funciona técnicamente, tiene un incentivo para seguir buscando esos pequeños detalles que, de otro modo, habría pasado por alto.

Usa el comando /goal para definir un objetivo final

A veces, una lista de verificación no es suficiente o es demasiado extensa para la tarea en cuestión. No todos los trabajos requieren una larga lista de condiciones. Es aquí donde entra en juego el comando /goal de Claude Code. En lugar de darle una secuencia de pasos y esperar que decida en el momento adecuado que todo está hecho, podemos establecer un objetivo claro, como asegurar que una característica específica funcione de principio a fin, o que un proyecto alcance un cierto estado sin pruebas fallidas.

Claude Code puede entonces trabajar hacia esa condición en lugar de devolvernos el control en cuanto cree que ha hecho lo suficiente. Esto es especialmente útil para tareas en las que no conocemos de antemano todos los pasos que la IA necesitará tomar. Una lista de verificación funciona bien cuando sabemos exactamente qué queremos verificar. Un objetivo funciona mejor cuando sabemos cómo debe ser el resultado final, pero estamos contentos de dejar que Claude Code descubra cómo llegar allí.

Confía, pero haz que la IA verifique

Un consejo que hemos adoptado religiosamente proviene del creador de Claude Code, Boris Cherny: dale a la IA una forma de verificar su propia salida. La idea es que si Claude Code puede ver si lo que acaba de construir funciona, en lugar de solo escribir el código y asumir que todo salió según lo planeado, tiene la oportunidad de detectar sus propios errores y corregirlos antes de entregarte la tarea.

Esto puede manifestarse de diferentes maneras según el proyecto. Si hay pruebas disponibles, le pedimos a Claude Code que las ejecute una vez que haya terminado y que corrija cualquier error. Si estamos construyendo algo con una interfaz de usuario, le pedimos que abra la aplicación en un navegador e interactúe con lo que acaba de crear, en lugar de asumir que, como el código parece correcto, el resultado final también lo es.

También hemos empezado a pedirle explícitamente a Claude Code que revise el prompt original una vez que haya terminado y compare lo que construyó con lo que realmente pedimos. Puede parecer obvio, pero en prompts más largos, hemos notado que los pequeños requisitos tienden a desaparecer en el camino. En última instancia, la verificación es otra forma de quitarle a Claude Code la decisión de cuándo una tarea está terminada, asegurando que tus resultados sean siempre de la más alta calidad.