L02 · Antes de empezar · 5 min
Tú diriges, el agente construye: la ingeniería agéntica en palabras sencillas
En una frase
La ingeniería agéntica es una forma estructurada de crear software real en la que tú defines el objetivo, acuerdas una especificación y un plan por escrito, y diriges a un agente de programación paso a paso mientras revisas y apruebas cada resultado.
Piénsalo así
Imagina dirigir una película: no sostienes cada cámara ni coses cada traje en persona, pero cada escena existe porque aprobaste el guion, el plan de rodaje y el montaje final. Sin tu dirección, el equipo solo grabaría tomas al azar.
Cómo funciona
En febrero de 2026, el investigador de IA Andrej Karpathy propuso el término Definicióningeniería agénticaConstruir software dirigiendo agentes de IA y comprobando su trabajo: tú diriges, el agente construye.Abrir en el glosario → para distinguir la creación seria de software del «pedir y cruzar los dedos» (a menudo llamado *vibe coding*). Un Definiciónexperimento rápidoUna prueba desechable sin especificación. Sirve para probar una idea, nunca para algo que vayas a publicar.Abrir en el glosario → en el que aceptas cualquier cosa sirve para una prueba desechable, pero una app real necesita estructura.
En lugar de pedirle a tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario → que construya toda la app de un salto, sigues el método Definicióndesarrollo guiado por especificaciones (SDD)Acordar qué construir (la especificación) y un plan, y después construir un paso pequeño y comprobado cada vez.Abrir en el glosario →: Idea → Especificación → Plan → Construcción → Comprobación → Publicación. Primero acuerdas qué construir y por qué en una Definiciónespecificación`SPEC.md`: qué vas a construir, para quién, qué entra y qué no, y cómo sabrás que funciona.Abrir en el glosario → sencilla (SPEC.md), y luego la divides en un DefiniciónplanLa especificación dividida en tareas pequeñas, cada una terminada y comprobable por sí sola, en `tasks/plan.md`.Abrir en el glosario → paso a paso (tasks/plan.md).
Durante las fases de Construcción y Comprobación, el agente trabaja en una tarea pequeña cada vez, guarda un DefinicióncommitUn punto de guardado: una foto de lo que cambió, con una nota corta. Puedes volver a cualquier commit.Abrir en el glosario → tras cada paso que funciona y ejecuta comprobaciones automáticas (como un DefinicióntestUn pequeño programa que comprueba que tu app hace lo que debe, para que un arreglo no se rompa sin avisar más adelante.Abrir en el glosario →) para demostrar que nada se rompió. Tú pruebas el resultado en el navegador o en un enlace de Definiciónvista previa (Preview)Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.Abrir en el glosario → antes de avanzar.
Tú sigues al mando porque tomas las decisiones que importan: para quién es la app, qué queda fuera, cómo debe comportarse y cuándo está lista para Definiciónpublicar (desplegar)Poner una versión de tu app en internet.Abrir en el glosario → en Definiciónproducción (Production)La versión publicada de tu app, la que ve todo el mundo. Sale de `main`.Abrir en el glosario →. El agente se ocupa de la sintaxis y de los comandos; tú pones el criterio.
Cómo se ve en tu proyecto
Al empezar cada sesión, tu agente lee SPEC.md y tasks/todo.md y te muestra en qué punto del camino estás: ① Preparación → ② Nuevo proyecto → ③ Especificación → ④ Plan → ⑤ Construcción y vista previa → ⑥ Publicación.
Cuando pidas una función nueva, no se lanzará a escribir código a ciegas. Primero te hará preguntas de una en una para actualizar la especificación y el plan, esperando tu visto bueno en cada etapa.
Copia para tu agente
Lee SPEC.md y tasks/todo.md (si existen), dime en qué punto de las seis etapas estamos y propón el siguiente paso concreto que debemos dar.
Comprobación rápida · 1 pregunta