Hemos estudiado en profundidad más de 2500 documentos de configuración de agentes y hemos descubierto que los documentos con mejor rendimiento siguen un patrón similar.

Primero, los documentos prácticos colocan los comandos ejecutables directamente en la parte frontal, en lugar de una larga introducción. De esta manera, los desarrolladores pueden comenzar rápidamente, evitando la molestia de buscar. En segundo lugar, los ejemplos de código siempre son más persuasivos que las explicaciones textuales: los fragmentos de código reales permiten entender al instante, mientras que las explicaciones acumuladas pueden tener el efecto contrario.

Los límites de seguridad también son clave. Aquellos documentos que están bien hechos deben marcar claramente reglas estrictas como "nunca envíes información sensible", lo que da tranquilidad a los desarrolladores. Al mismo tiempo, es necesario especificar claramente cuál es el stack tecnológico: los factores de selección deben ser evidentes para poder ser efectivos.

Por último, no se pueden omitir los seis grandes ámbitos que cubren el núcleo. La integridad de estos elementos impacta directamente en el valor práctico del documento y en la experiencia del usuario.