Haz que tu IA liste sus supuestos antes de escribir código
Antes de que tu IA escriba una sola línea de código, haz que liste sus supuestos y diga: "Corrígeme ahora, o procedo." Esa única línea es la corrección de bug más barata que vas a implementar en tu vida.
El modo de falla: las conjeturas silenciosas
La falla más costosa en la programación con agentes rara vez es un error de sintaxis. Es el agente llenando en silencio un hueco que nunca especificaste — la base de datos equivocada, el flujo de auth equivocado, el comportamiento equivocado en un caso borde — y construyendo una tarde de código confiado y errado encima de eso. Te enteras solo en la revisión, cuando el retrabajo ya está horneado.
Los agentes no cuestionan sus propios supuestos ni señalan el contexto faltante a menos que los obligues. Por su cuenta, optimizan para producir una respuesta, no para tener la razón. La salvaguarda es hacer visibles los supuestos antes de que se endurezcan en código.
La única instrucción
Agrega una sola directiva a tu prompt — o incorpórala en tu CLAUDE.md / AGENTS.md / system prompt para que cada tarea la herede:
Before writing any code, list every assumption you're making about
requirements, architecture, and scope. Then stop and wait. I'll say
"correct me" or "proceed."Esa es toda la técnica. Le cuesta segundos al agente y te cuesta una lectura. Tres cosas la hacen funcionar:
- Lista, no solo planifiques. Un plan esconde sus premisas dentro de la prosa. Una lista explícita de supuestos — "Asumo Postgres, no SQLite; asumo que la API es pública; asumo que la paginación está fuera de alcance" — es escaneable, y los elementos equivocados saltan a la vista.
- Luego espera. La pausa es el punto. Sin ella, el agente lista los supuestos y arranca a toda marcha en el mismo turno, así que vuelves a revisar código terminado.
- Cubre requisitos, arquitectura y alcance. Esos son los tres lugares donde se esconden las conjeturas silenciosas. Nombrarlos aleja al agente de listar trivialidades.
Reglas prácticas: qué hacer que exponga
| Categoría | Ejemplo de supuesto a atrapar |
|---|---|
| Requisitos | "Asumo borrado lógico, no borrado físico." |
| Arquitectura | "Asumo un servicio nuevo, no extender el existente." |
| Alcance | "Asumo que las pruebas quedan fuera de alcance en esta pasada." |
| Datos y casos borde | "Asumo que una entrada vacía devuelve [], no un error." |
| Dependencias | "Asumo que puedo agregar una librería nueva." |
Si alguna línea está mal, la arreglas en una frase. Si todas están bien, perdiste diez segundos y ganaste un contrato escrito del cambio.
Nivel avanzado: que sea lo predeterminado, no un ritual
- Promuévelo a un archivo de memoria. Pon la instrucción en
CLAUDE.md,AGENTS.mdo el system prompt de tu agente para no tener que recordarla. Cada tarea empieza con una pasada de supuestos. - Combínalo con el modo de planificación. Los modos de planificación de solo lectura existen justamente para que el agente explore y pregunte antes de tocar archivos — la lista de supuestos es el artefacto que revisas ahí.
- Sáltalo cuando el diff es de una frase. Sobre-planificar un cambio trivial desperdicia tanto tiempo como sub-planificar uno complejo. Si puedes describir el diff exacto tú mismo, deja que lo construya y ya.
- Pídele que califique su confianza. "Marca cualquier supuesto del que estés menos del 80% seguro" expone las conjeturas riesgosas sin ahogarte en las obvias.
Recursos
- Best practices for using AI in VS Code — "Tell the AI to ask clarifying questions" y "Plan first, then implement."
- Codex best practices — OpenAI — pídele al agente que planifique y te entreviste antes de empezar a programar.
- Best practices for Claude Code — plan mode: enuncia los supuestos explícitamente, pregunta antes de implementar.
- Read this article in English
<div class="cta"> ¿Construyes con agentes de código? Yeda AI diseña, audita y lanza flujos de trabajo de IA en producción. <a href="/contact">Hablemos</a> · <a href="/blog">Lee el blog</a> </div>