Lo que serás capaz de hacer
- Escribir un requisito que un agente de programación con IA no pueda malinterpretar, en tres partes y sin palabras de código.
- Congelar una lista de requisitos con una línea de aprobación y modificarla solo volviendo a aprobarla.
- Escribir una lista de exclusiones y una lista «Hecho cuando» que den un final al plan.
- Vincular cada pieza del diseño y cada recorrido de prueba a un requisito, y eliminar lo que no se vincula a ninguno.
- Hacer una comprobación al final del plan que separe los huecos que hay que corregir de las decisiones que te corresponden a ti.
Ideas clave
- Escribe primero cada requisito en grande en la iniciativa, uno por cada cosa que necesita una persona, antes de pedirle a un agente que construya nada.
- Divídelo en líneas que puedas comprobar: quién lo hace, qué puede hacer y cómo verías desde fuera que ocurre.
- Congela la lista con tu sí explícito, para que solo tú puedas cambiarla y todos los agentes construyan sobre las mismas líneas.
- Di lo que el plan no hará y cuándo está terminado: una lista de exclusiones y una casilla «Hecho cuando» por requisito.
- Haz que cada paso lea la misma lista: cada pieza del diseño cita un requisito, cada recorrido de prueba cita uno palabra por palabra y la comprobación final repasa «Hecho cuando» frente a lo entregado.
Los requisitos congelados son una lista de requisitos verificables, aprobada por una persona y bloqueada antes de escribir código, que impide que un agente de programación con IA construya más allá del plan. La deriva del alcance de un agente de IA (en inglés, AI agent scope creep) consiste en que el agente construye o cambia cosas que ningún requisito pedía, y empieza cuando los requisitos nunca fueron verificables. Yo no dejo que un agente de IA decida dónde termina un plan. Congelo la lista, y cada paso posterior a mi sí la lee.
Al terminar, tendrás una lista de requisitos congelada para una funcionalidad, una lista de exclusiones, una lista «Hecho cuando» y un plan de pruebas que cita cada línea. Unos 10 minutos de lectura y una tarde para tu primera lista. Así mantenemos a los agentes de programación con IA dentro del alcance en Neomanex.
Todos los ejemplos usan Fernhill Print, una red ficticia de imprentas cuyas tiendas instalan sus propias estaciones de impresión.
| Esto no es | Eso significa | Aquí significa |
|---|---|---|
| La deriva del alcance con los clientes de una agencia | Un cliente añade trabajo a un contrato | Un agente añade trabajo que ningún requisito pedía |
| La acumulación de permisos o herramientas | Un agente obtiene un acceso que no debería tener | Un agente construye más allá del plan |
| Un pip freeze o una congelación de código | Paquetes bloqueados, o nada de fusiones antes de una versión | Requisitos bloqueados, antes de escribir código |
| Un archivo de pruebas de solo lectura o una instantánea del contexto | Un archivo que el agente no puede editar, o el estado guardado de una sesión | Una lista que solo cambia una persona |
Qué son los requisitos congelados, y los nueve pasos
La mayoría de las respuestas dicen «bloquea desde el principio los requisitos y lo que queda fuera». Estoy de acuerdo, pero se quedan cortas: nunca dicen quién los bloquea, cómo los leen los pasos posteriores ni cuándo termina el plan. Nueve pasos responden a las tres cosas.
| Paso | Escribes | Quién | Condiciona |
|---|---|---|---|
| 1. Escríbelo en grande | Una línea por necesidad | El agente redacta, yo leo | La división |
| 2. Divide | Quién, qué, cómo lo verías | El agente redacta, yo leo | La congelación |
| 3. Quita las palabras de código | Líneas en lenguaje llano | El agente redacta, yo leo | La congelación |
| 4. Congela | Un sí con fecha | Yo | Todos los pasos posteriores |
| 5. Exclusiones | Filas con su porqué | El agente redacta, yo apruebo | Los extras |
| 6. Hecho cuando | Una casilla por línea | El agente redacta, yo apruebo | El final |
| 7. Cita | Piezas del diseño que citan líneas | El agente, con revisión | La construcción |
| 8. Recorridos | Pruebas que citan líneas | El agente de pruebas | La aceptación |
| 9. Repasa «Hecho cuando» | Casillas frente a lo entregado | El agente comprueba, yo decido | La fusión |
Las herramientas de desarrollo guiado por especificaciones, como GitHub Spec Kit y Kiro, ponen una especificación antes del código. Este método añade quién la congela, qué cita cada paso y cómo termina el plan. El flujo de trabajo funciona en ConvOps(se abre en una pestaña nueva), como una de las formas en que dirigimos nuestra empresa con agentes de IA.
Por qué los agentes de IA se salen del alcance
La deriva del alcance es un problema de redacción antes que un problema del agente. Antes me llegaba trabajo terminado que no era lo que yo quería. El agente no desobedecía nada: la frase que leía permitía las dos versiones.
Las listas de rutas permitidas, los límites de tamaño del diff y los hooks detectan el síntoma cuando el código ya existe. Nunca dicen qué construir. La deriva del alcance en Claude Code (Claude Code scope creep) es el mismo problema, con cualquier agente de programación.
El verdadero hueco es «terminado». Cuando un agente dice que ha terminado, nadie puede comprobarlo, porque nada escrito dice qué aspecto tiene el trabajo terminado.
Trabajamos así cada funcionalidad y enseñamos cada semana las listas de requisitos, la congelación y las comprobaciones. Mira cómo lo hacemos, desde dentro, en neomanex.com/join.
Paso 1: Escríbelo en grande en la iniciativa
Empiezo en grande a propósito. La iniciativa es la funcionalidad entera, con un requisito por cada cosa que necesita una persona, y cada uno dice para quién es. Fernhill tiene ocho. R-4 es para el encargado de la tienda:
R-4. Un final claro cuando una estación de impresión se cae a mitad de un trabajo, nunca una impresión doble. Si la estación se desconecta o se reinicia por una actualización, el trabajo termina en un máximo de tres minutos con un motivo; una estación que vuelve nunca imprime otra vez ese trabajo; con el reintento activado, el trabajo empieza una vez más.
Esa línea contiene cuatro promesas: es demasiado grande para construirla de una vez y demasiado grande para probarla como una sola.
Paso 2: Divide cada uno en quién, qué y cómo lo verías
La tercera parte, cómo lo verías, es la única que un probador puede dar por fallida, así que ahí dedico mi tiempo. Nombra una pantalla, un mensaje o un estado que puedes consultar. Un plan precisa los requisitos que le corresponden y nunca añade, quita ni reinterpreta la línea grande. R-4 se convierte en cuatro líneas, todas para el encargado de la tienda:
| Línea | Qué | Cómo lo verías |
|---|---|---|
| R-4.1 | Una estación perdida termina el trabajo con claridad | Si la estación se desconecta a mitad del trabajo, el trabajo termina en un máximo de 3 minutos con el motivo «estación perdida» |
| R-4.2 | Una estación reiniciada termina el trabajo con claridad | Si la estación se reinicia por una actualización a mitad del trabajo, el trabajo termina en un máximo de 3 minutos con el motivo «estación reiniciada» |
| R-4.3 | Sin impresión doble | Una estación que vuelve nunca imprime otra vez ese trabajo; el historial del trabajo muestra un solo intento |
| R-4.4 | Reintento, una vez | Con el reintento activado, un trabajo perdido inicia exactamente un intento más; una segunda pérdida lo termina definitivamente |
«Una vez más» pasó a ser «exactamente un intento más». El paso 7 explica por qué.

Mal frente a bien
«El servicio de exportación está implementado» no puede fallar: nadie puede ver cómo ocurre. «Un encargado de tienda puede descargar los trabajos de impresión del mes como un archivo, con una fila por trabajo» sí puede: abres el archivo y cuentas las filas. Ese es un requisito que un agente no puede malinterpretar. Alguien que no programa puede leerlo, y un probador puede darlo por fallido.

Paso 3: Quita las palabras de código
Una palabra de código en un requisito es una decisión de diseño colada antes de que nadie la acepte. Nada de endpoints, ni tablas, ni clases. Si alguien que no programa no puede leer la línea, no está lista.
Un primer borrador de R-4.1 decía «El endpoint de heartbeat marca como fallida la fila del trabajo». Elige un mecanismo y no dice nada que un encargado de tienda pueda ver. Reescrito, es el R-4.1 de arriba.
Paso 4: Congélalo con un sí explícito
La congelación es una frase mía, y pesa más que cualquier barrera de protección. Un agente redacta; yo leo cada línea y tomo las decisiones, y cada una acaba en una línea:
- Un trabajo enviado a una estación con nombre que está desconectada se rechaza, sin alternativa (R-3).
- Las estaciones compartidas son de solo lectura para todos menos para su propietario (R-5).
- Una estación nueva está en línea en un máximo de 60 segundos; un trabajo perdido termina en un máximo de 3 minutos (R-1.3, R-4.1, R-4.2).
Después, mi sí escribe una línea arriba del todo: «Congelado, aprobado el 12 de marzo de 2025». La lista precisada del plan se congela igual antes de que empiece cualquier diseño. A partir de ahí solo yo la cambio, volviendo a aprobarla, y el cambio queda escrito en la propia lista. Congelado no significa que nunca se modifique. Significa que ningún agente la modifica.

Paso 5: Escribe lo que no hará
La lista de exclusiones es donde respondo a las mejores ideas del agente antes de que las tenga. Cada fila dice por qué.
| No se hará | Por qué |
|---|---|
| Estaciones alojadas por Fernhill | Un plan posterior |
| Un mercado de estaciones | Un plan posterior |
| Pasar un trabajo a otra estación a medias | R-4: un trabajo perdido termina |
| Más de un reintento por trabajo perdido | R-4.4 lo limita a uno |
| Imprimir desde el móvil | Un plan posterior |
Si un agente quiere construir alguna de estas cosas, la respuesta ya está escrita.
Paso 6: Escribe la lista «Hecho cuando», el final del plan
Terminado no es una sensación ni un mensaje del agente. Mi definición de terminado para un agente de programación con IA es una casilla breve por requisito, escrita antes de construir.
| Hecho cuando | Durante la construcción |
|---|---|
| R-4.1: una estación perdida termina el trabajo en un máximo de 3 minutos | Vacía |
| R-4.4: el reintento ejecuta exactamente un intento más | Vacía |
| R-2.2: la página del trabajo indica la estación en la que se imprimió | Vacía |
Las casillas siguen vacías durante la construcción, y el plan nunca termina porque lo diga un agente.
Paso 7: Haz que cada pieza del diseño cite un requisito
Una pieza del diseño que no sirve a ningún requisito es deriva del alcance con diagrama incluido. Cada paso posterior a la congelación lee la misma lista, y cada pieza señala la línea a la que sirve.
| Pieza del diseño | Cita |
|---|---|
| La parte que detecta una estación perdida | R-4.1, R-4.2 |
| La aplicación de la estación | R-1.3, R-4.1 |
| Historial de trabajos | R-2.2, R-4.3 |
| Reanudación de trabajos | Nada |
Una pieza que no cita nada, como la reanudación de trabajos, se elimina, o se me pide un requisito nuevo. Antes del código también se enumeran las normas escritas que se aplican, y si falta alguna, la decido yo y se escribe primero.
La comprobación que detectó una palabra
Antes del código, una pasada lee los requisitos y el diseño en paralelo. R-4 decía «una vez más», y el diseño de la funcionalidad nunca decía cuántas veces, así que una estación que se cayera una y otra vez reintentaría para siempre. La comprobación envió eso al plan: cuando el plan dividió R-4, su línea decía «exactamente un intento más», y mi sí la congeló. R-4 sigue diciendo «una vez más»: está congelado, y el plan lo precisa. Toda cantidad imprecisa recibe un número antes del código, y los cambios de redacción son cosa mía.

Paso 8: Escribe un recorrido de prueba por requisito, citado palabra por palabra
Los fallos son lo mejor: una frase lo bastante concreta para fallar es una frase que un agente no puede malinterpretar. Cada requisito que se prueba en vivo tiene un recorrido que lo cita palabra por palabra; las pruebas automatizadas cubren el resto.
El recorrido J-4.1 cita R-4.1: inicia un trabajo en la estación «Back Office 1», apágala a mitad del trabajo y vuelve a encenderla. Pasa si el trabajo terminó en un máximo de 3 minutos como «estación perdida» y el historial muestra un solo intento, lo que también demuestra R-4.3.
El giro: la frase nombraba la página
R-2.2 dice «La página del trabajo indica la estación en la que se imprimió». En la primera ronda de aceptación, J-2.2 abrió el trabajo «Spring flyers» y falló. La página no mostraba ninguna estación, mientras que la respuesta del sistema sí la tenía: Front Counter 2. La frase nombraba la página del trabajo, así que el probador podía darla por fallida. «Muestra la información de la estación» habría pasado.
La línea se quedó como estaba. Se corrigió la página y se volvió a probar hasta que J-2.2 pasó. La lección: di qué verías, en la superficie donde lo verías. Una ronda solo pasa cuando pasan todos los recorridos, y ninguna corrección se certifica a sí misma. Cómo trabajan los agentes de pruebas: pruebas de aceptación con Playwright MCP.

Paso 9: Repasa la lista «Hecho cuando» frente a lo entregado
La última comprobación encuentra huecos, y los que importan vuelven a mí, porque el alcance lo decido yo. Un agente repasa cada casilla frente a la funcionalidad entregada, y cada hueco es de uno de dos tipos.
| Hueco | Línea | Tipo |
|---|---|---|
| La página del trabajo no muestra ninguna etiqueta para el motivo «estación reiniciada» | R-4.2 | Corrección |
| Una estación cambia de nombre a mitad de un trabajo: ¿conserva el historial su nombre anterior? | R-2.2 | Lo decido yo |
La comprobación informa y devuelve; nunca decide el alcance. El plan está terminado cuando cada hueco tiene respuesta: uno, una corrección; el otro, mi decisión, aunque la decisión sea dejarlo para un plan posterior. La fusión espera a mi sí. La misma lista, desde mi sí hasta la última comprobación.
¿Quieres el flujo de trabajo que ejecuta estos nueve pasos, listo para importar? Consíguelo, junto con todos los demás con los que trabajamos, en neomanex.com/join.
Pasos
Escríbelo en grande en la iniciativa
Escribe un requisito por cada cosa que necesita una persona, cada uno con su quién.
Divide cada uno en quién, qué y cómo lo verías
Divide cada requisito en líneas de quién, qué y cómo lo verías desde fuera.
Quita las palabras de código
Elimina endpoints, tablas y clases, para que alguien que no programa pueda leer cada línea.
Congela la lista con un sí explícito
Congela la lista con tu sí explícito; a partir de ahí solo tú la cambias, volviendo a aprobarla.
Escribe la lista de exclusiones
Enumera lo que el plan no hará, con cada fila vinculada al requisito o al plan posterior que lo explica.
Escribe la lista «Hecho cuando»
Escribe una casilla «Hecho cuando» por requisito: el final del plan.
Haz que cada pieza del diseño cite un requisito
Vincula cada pieza del diseño al requisito al que sirve y elimina cualquier pieza que no cite ninguno.
Escribe un recorrido de prueba por requisito
Escribe un recorrido de prueba por cada requisito que se prueba en vivo, citándolo palabra por palabra.
Repasa la lista «Hecho cuando» frente a lo entregado
Repasa cada casilla «Hecho cuando» frente a lo entregado y decide cada hueco que te devuelvan.
Preguntas frecuentes
¿Qué son los requisitos congelados para agentes de programación con IA?
Los requisitos congelados son una lista de requisitos verificables, aprobada por una persona y bloqueada antes de escribir código, que impide que un agente de programación con IA construya más allá del plan. Cada línea dice para quién es, qué puede hacer y cómo lo verías desde fuera. Un sí explícito de una persona congela la lista, y solo una nueva aprobación la cambia. No es un pip freeze ni un archivo de pruebas de solo lectura.
¿Qué ejemplos hay de deriva del alcance en agentes de IA?
La deriva del alcance de un agente de IA se ve cuando el agente añade un modo de reintento que nadie pidió, construye una página de ajustes que nadie solicitó o renombra código que funciona mientras corrige un error. En todos los casos la causa es la misma: ningún requisito verificable describía el trabajo y ninguna fila de exclusiones descartaba el extra. El agente llenó el hueco con su propio criterio.
¿Para quién son los requisitos congelados?
Los requisitos congelados son para desarrolladores y fundadores técnicos que construyen con agentes de programación con IA, Claude Code o cualquier otro, y siguen recibiendo trabajo terminado que no es lo que querían. La lista le da al agente líneas que no puede estirar. A la persona le da un plan con final: una casilla «Hecho cuando» por requisito, repasada frente a lo entregado.
¿Cómo mantengo a un agente de programación con IA dentro del alcance?
Escribe un requisito por cada cosa que necesita una persona, indicando para quién es. Divide cada uno en quién, qué y cómo lo verías, sin palabras de código. Congela la lista con tu sí explícito. Añade una lista de exclusiones y una casilla «Hecho cuando» por requisito. Haz que cada pieza del diseño cite una línea y que cada prueba cite una. Las barreras de protección sobre el diff complementan esto cuando el código ya existe.
¿Cómo evitan los requisitos congelados la deriva del alcance en proyectos de programación con IA?
Los requisitos congelados evitan la deriva del alcance porque dan a cada paso posterior una única lista fija que leer. Cada pieza del diseño debe citar un requisito, y una pieza que no cita ninguno se elimina o vuelve a la persona como petición de una línea nueva. La lista de exclusiones responde a los extras antes de que se construyan. La lista «Hecho cuando» cierra el plan. Un agente no puede ampliar una lista que solo cambia una persona.
¿Qué debe incluir una lista «Hecho cuando» para un agente de programación con IA?
Una lista «Hecho cuando» tiene una casilla por requisito, y cada una es una sola línea que nombra un estado observable, como que una estación perdida termine el trabajo en un máximo de 3 minutos. Las casillas siguen vacías durante la construcción. Al final, un agente repasa cada casilla frente a lo entregado. Cada hueco vuelve como una corrección o como una decisión para la persona responsable del alcance.
¿Puedo cambiar un requisito después de congelarlo?
Sí, un requisito congelado solo cambia con una nueva aprobación. La persona que congeló la lista aprueba el cambio, y el cambio se escribe en la propia lista. Un agente de programación con IA nunca modifica por su cuenta un requisito congelado, ni siquiera cuando la modificación haría pasar una comprobación.
¿En qué se diferencian los requisitos congelados de los criterios de aceptación y del desarrollo guiado por especificaciones?
Los requisitos congelados contienen criterios de aceptación: la parte de cómo lo verías de cada línea es el criterio. En el desarrollo guiado por especificaciones, la especificación es el documento completo a partir del cual construye un agente. Los requisitos congelados añaden cuatro cosas a su alrededor: una congelación humana explícita, una lista de exclusiones, una lista «Hecho cuando» que cierra el plan y una cadena de citas en la que cada pieza del diseño y cada prueba remiten a una línea.
