Diseñar tareas para un agente

Cómo convertir una idea en un encargo que el agente pueda ejecutar y tú puedas revisar: objetivo, contexto, límites, resultado esperado y cómo saber que está terminado.

La idea clave: el agente no puede leerte la mente. Antes de pedir algo, decide qué quieres conseguir, qué no debe cambiar y cómo vas a comprobar que está bien. Si no lo sabes tú, el agente tampoco.

El problema

Pide “mejora la utilidad de lectura y añade pruebas” y el agente tendrá que adivinar casi todo: qué significa “mejorar”, qué archivos puede tocar, si puede añadir dependencias o cuántas pruebas bastan. A veces acertará. Otras veces te devolverá algo razonable que resuelve otro problema, modificará más archivos de los necesarios o dirá que ha terminado sin que nadie pueda comprobarlo.

Diseñar la tarea consiste en tomar esas decisiones tú, antes de empezar, en lugar de dejarlas al azar.

Cómo funciona

Un buen encargo responde a cinco preguntas:

Parte Pregunta Ejemplo
Objetivo ¿Qué resultado quiero? “Añade summarizeReading en src/reading.js.”
Contexto ¿Qué necesita leer o saber? “Lee el README y la carpeta src/ antes de editar.”
Límites ¿Qué no debe hacer? “No añadas dependencias ni cambies el README.”
Resultado esperado ¿Qué forma tiene la entrega? “Devuelve wordCount y firstSentence.”
Criterios de aceptación ¿Cómo sé que está bien? “Tres pruebas que pasen con node --test.”

No hace falta usar siempre estos títulos. Lo importante es que ninguna decisión esencial quede escondida en una frase vaga como “hazlo bien”. Si un requisito no se puede comprobar, reescríbelo hasta que se pueda: “que sea rápido” se convierte en “que procese un archivo de 1 MB en menos de un segundo”.

Los criterios de aceptación son la parte más importante y la que más se olvida. Además de ayudarte a revisar, le dan al agente una forma de comprobar su propio trabajo antes de decir que ha terminado.

Ejemplo práctico

Una petición vaga:

Mejora la utilidad de lectura y añade pruebas.

La misma petición convertida en un encargo:

## Objetivo
Añade la función summarizeReading en src/reading.js.

## Contexto
Lee README.md y los archivos de src/ antes de editar.
La función existente countWords debe seguir funcionando igual.

## Límites
No añadas dependencias ni modifiques README.md.

## Resultado esperado
summarizeReading recibe un texto y devuelve { wordCount, firstSentence }.

## Criterios de aceptación
- Al menos tres pruebas que pasen con `node --test`.
- Casos cubiertos: texto vacío, varios espacios seguidos y frases
  que terminan en "!" o "?".
- Antes de terminar, revisa el diff y di qué comprobaciones ejecutaste.

Esto no garantiza que el agente lo haga bien. Pero si falla, sabrás exactamente qué requisito no se cumplió y podrás corregir el encargo o el código con precisión.

Errores comunes

  • Pedir el “cómo” en lugar del “qué”. Describe el resultado y los límites; deja que el agente proponga la implementación, salvo que tengas una razón para imponerla.
  • Olvidar los límites. Si no dices “no toques X”, el agente puede tocar X con la mejor intención.
  • Criterios que no se pueden comprobar. “Que el código sea limpio” no se puede verificar; “que pase el linter sin avisos”, sí.
  • Encargos enormes. Una tarea que abarca diez cambios distintos es difícil de revisar. Divídela en pasos que puedas comprobar uno a uno.
  • Convertir cada pregunta en un formulario. Para una consulta rápida basta una frase. Esta estructura compensa cuando la tarea cambia código o tiene efectos visibles.

Cuándo usarlo

Siempre que pidas una implementación, una revisión o un cambio con efectos. Si te descubres repitiendo el mismo contexto o los mismos límites en cada encargo, es una señal de que esa información debería vivir en un sitio permanente: eso es AGENTS.md.

Siguiente paso

Ya sabes qué pedir. El siguiente paso, Diseño del contexto, trata de qué información necesita el agente para hacerlo, y de cuánta es demasiada.

Fuentes

Consultada el 2026-10-05.

  • Diseño del contexto para agentesTécnica

    Qué información recibe el agente en cada momento, por qué más no siempre es mejor y cómo darle lo justo: lo esencial desde el principio y el resto cuando lo necesite.

    Publicado
  • Verificación y evaluaciónTécnica

    Cómo comprobar que el agente hizo bien el trabajo sin fiarte de su palabra: darle formas de verificarse a sí mismo, revisar el resultado y el proceso, y comparar configuraciones con honestidad.

    Publicado