Principios generales de diseño

Empieza con instrucciones simples

Usa las mínimas instrucciones necesarias para que el agente se comporte como esperas. Añade más solo cuando revises conversaciones reales, y prueba regresiones entre cambio y cambio.

Nombres y descripciones que se entiendan

• Específicos, distintos entre sí y claramente ligados a la tarea.
• Revisa que no se solapen con los de otros subagentes, acciones o variables.
• Lenguaje llano, el que usaría el usuario final, no jerga técnica.
• Consistente: si un recurso habla de «customer», no llames «client» al otro.

Añade determinismo de forma estratégica

Equilibra lenguaje natural y lógica determinista. Los flujos de negocio ganan en previsibilidad cuando se expresan como lógica.

Referencia los recursos en el prompt

Mencionar subagentes, acciones y variables con {!@…} es una señal fuerte para el modelo y aumenta la probabilidad de que use el recurso como pretendías.