🧬 La receta de agente en 5 partes (todo agente que construyas)

Lo que te llevarás: una fórmula única y repetible para escribir cualquier agente — dejas de mirar la pantalla preguntándote «¿qué va en el archivo?» y publicas uno en menos de diez minutos. La página más importante de toda la fase — márcala.

Todo agente que merece la pena tiene los mismos cinco ingredientes. Si falta uno, o divaga, o se rompe, o hace en silencio algo que lamentarás.

Las cinco partes (memorízalas en orden)

1. Nombre. Un identificador corto — inbox-triage, code-review-buddy, daily-draft. Minúsculas, guiones, sin monerías. Lo teclearás cien veces: si no puedes decirlo en voz alta sin sonreír, renómbralo.
2. Soul (alma). Una identidad de 2-3 frases: quién es, su voz, qué le importa, qué se niega a hacer. Es el archivo de personalidad — la misma idea SOUL de etapas anteriores. No es decoración: escríbela como si contrataras a un asistente permanente.
3. Job (trabajo). Una misión de UNA frase. Si no cabe en una frase, el agente no está acotado — pártelo. «Lee cada email sin leer, etiquétalo por urgencia, redacta una respuesta de 2 líneas para lo urgente, no envíes nada» es un trabajo. «Ayúdame con mi bandeja» es un deseo.
4. Keys (llaves). Qué herramientas y carpetas puede tocar. ¿Solo lectura? ¿Puede escribir archivos? ¿Ejecutar comandos? ¿Tocar internet? Es el cinturón de seguridad: ceñido por defecto, aflojado a propósito. Un agente de contenido de solo-lectura no pinta nada con las llaves de tu terminal.
5. Stop-condition (condición de parada). ¿Cómo sabe que terminó? Sin ella, los agentes siguen y siguen, queman tokens y se pasan de frenada. Vaga («cuando esté bien») = divagar. Medible («cuando existan 3 archivos en /drafts/[fecha]/») = salida limpia.

Ejemplo trabajado — inbox-triage

Por qué cinco y no siete

Los principiantes quieren añadir campos («arquetipo de personalidad», «enlace a guía de voz», «dashboard de métricas»). Todo eso hincha el archivo y diluye el SOUL. Las cinco de arriba son estructurales — quita una y el agente se rompe de forma predecible (lo nombra la lección de roturas). Añade una sexta y solo hiciste más difícil escribir cada agente futuro.

📌 Imprime las cinco líneas en un pósit. Cada agente que construyas sigue las mismas cinco líneas. ¿Agente nuevo? Pósit nuevo. Cinco líneas. Esa es la plantilla entera, para siempre.