La velocidad cambió, el entendimiento no
El desarrollo de software ha cambiado drásticamente en algunos aspectos, pero no en otros. La velocidad de desarrollo es lo que más ha cambiado, al menos para cierto tipo de trabajo: con los asistentes de código se puede hacer más con menos personas y en una fracción del tiempo. Algo que antes le tomaba a un equipo un sprint completo, hoy una sola persona lo puede prototipar en una tarde.
La aceleración es real, pero no es universal. En un estudio aleatorizado de METR, desarrolladores con experiencia trabajando en bases de código grandes que conocían bien fueron en realidad un 19% más lentos con herramientas de IA, mientras creían que eran cerca de un 20% más rápidos. El reporte DORA 2025 de Google es más positivo y relaciona la adopción de IA con un mayor rendimiento de entrega, pero solo los equipos con sistemas poco acoplados y ciclos de retroalimentación rápidos ven las ganancias. En mi experiencia, la velocidad se nota más en proyectos nuevos, prototipos y sistemas pequeños, que es justamente donde la uso.
Los requerimientos siguen siendo la parte difícil
Lo que no ha cambiado es la necesidad de entender de verdad los requerimientos del sistema que se está construyendo, a corto y a largo plazo. Ese siempre ha sido el verdadero reto del desarrollo de software, y escribir código más rápido no lo resuelve.
No es una idea nueva. Fred Brooks argumentó en 1986, en "No Silver Bullet", que las herramientas pueden eliminar la complejidad accidental del software, pero no la complejidad esencial de descubrir qué construir. Los agentes de IA son una herramienta muy poderosa para la parte accidental. La industria está llegando a la misma conclusión: el desarrollo guiado por especificaciones (spec-driven development), con Spec Kit de GitHub, Kiro de AWS y otros, trata la especificación como lo que decide si la IA acelera la entrega o solo acelera el retrabajo. Incluso Andrej Karpathy, quien acuñó el término "vibe coding", ahora habla de ingeniería agéntica: agentes trabajando contra especificaciones detalladas, con humanos en el ciclo.
Lo bueno es que ahora podemos iterar rápido. Pero algunos cambios siguen siendo caros de corregir, incluso con agentes de IA, una vez que hay datos reales de producción y usuarios reales que dependen de ellos. Un agente puede reescribir una pantalla en segundos; no puede deshacer un mal modelo de datos que ya tiene un año de registros y algunas integraciones construidas encima. Renombrar un campo, dividir una tabla o convertir una relación uno a muchos en muchos a muchos implica migraciones, backfills y coordinar con todo lo que lee esos datos.
¿No puede el agente recopilar los requerimientos también?
Para ser justo con el otro lado de mi propio argumento: sí, en parte. Dale a un agente los correos, chats, notas de reuniones y tickets de un proyecto, y en minutos puede redactar historias de usuario, un glosario e incluso un primer modelo de datos. También puede detectar contradicciones ("en marzo dijeron que las facturas son mensuales, en junio hablan de semanales"), listar preguntas abiertas y sugerir casos borde que nadie mencionó. Leer 300 correos siempre fue lento y propenso a errores para los humanos; esa parte de verdad es más rápida ahora.
Donde falla:
- Los documentos registran lo que la gente dijo, no lo que es cierto o necesario. Mucho de lo que importa es tácito: el workaround que todos hacen cada día, la regla que todos "simplemente saben". Un agente no puede extraer lo que nunca se escribió.
- Los agentes resuelven las contradicciones en lugar de señalarlas. Cuando dos correos no coinciden, el agente tiende a escoger uno y escribirlo con confianza en la especificación. No sabe que el segundo vino de la persona que realmente decide, ni que el primero era una lluvia de ideas.
- Los requerimientos son decisiones, no solo hechos. Elegir entre rápido y auditable, o decidir qué funcionalidad espera, necesita a alguien responsable. Un agente puede presentar las opciones; no puede hacerse cargo del trade-off.
- El historial describe el pasado. Los requerimientos a largo plazo tienen que ver con hacia dónde va el negocio, y eso rara vez está en la bandeja de entrada de alguien.
- La experiencia sigue importando. Una investigación sobre la elicitación de requerimientos asistida por LLMs encontró que las personas con conocimiento del dominio le sacaban más provecho a las herramientas. El agente amplifica a quien lo esté guiando.
Así que los agentes aceleran los requerimientos de la misma forma en que aceleran el código: la parte mecánica se vuelve más rápida y el cuello de botella se mueve a la validación. El flujo que me gusta es hacer que el agente lea todo y redacte los requerimientos junto con una lista de conflictos y preguntas abiertas, luego resolver esas preguntas con las personas que realmente deciden, y solo entonces convertir el resultado en la especificación o el modelo contra el cual construyen los agentes. Muchas veces el resultado más valioso es la lista de preguntas, no la especificación, porque te muestra lo que todavía no entiendes.
Una nota práctica: darle a un agente correos de clientes y chats privados plantea preguntas de privacidad y permisos. Asegúrate de que tienes permiso de compartir esos datos antes de hacerlo.
Itera rápido, pero en pequeño
Siempre ha existido una urgencia por liberar código y obtener retroalimentación de los usuarios. En algunos casos eso es posible y factible; en otros es bastante caro, por ejemplo en sistemas que manejan pagos, expedientes médicos o cualquier cosa donde una respuesta equivocada tiene consecuencias reales.
Creo que, como hoy podemos movernos más rápido, deberíamos iterar rápido con un número limitado de usuarios de prueba y volver a iterar tanto como sea necesario, cuando sea posible. El costo de tirar una versión ha bajado mucho, así que el objetivo es cometer los errores mientras el radio de impacto es pequeño: un puñado de usuarios, datos de prueba y sin promesas de compatibilidad hacia atrás todavía.
Deja que los stakeholders prototipen
Otro enfoque es que los stakeholders jueguen con agentes de IA y construyan prototipos hasta que sientan que se ajustan a sus necesidades. Como son quienes tienen más contexto, de esta forma podrían capturar muchos de los requerimientos, a menudo cosas que nunca pensarían en escribir en una especificación pero que aparecen de inmediato cuando hacen clic en algo que funciona.
No cubre todo, claro. Un prototipo normalmente se salta las partes aburridas: permisos, casos borde, validación de datos, qué pasa cuando dos personas editan lo mismo. También agrega el riesgo de que piensen que el sistema ya está listo, o que lo pueden hacer ellos mismos. El prototipo es un excelente documento de requerimientos; no es el producto.
El propio Karpathy limitó el vibe coding a proyectos desechables de fin de semana desde el primer día; esa parte se perdió a medida que el término se popularizó. Y la brecha entre un demo y producción es donde está la mayor parte del trabajo: muchos prototipos hechos con vibe coding se estancan antes del despliegue o necesitan reescribirse por completo. Eso está bien, siempre que todos sepan que el prototipo está ahí para descubrir requerimientos, no para salir a producción.
Construir es solo la mitad de la ecuación
Dicho esto, construir siempre ha sido solo la mitad de la ecuación. Los sistemas son como seres vivos; necesitan mantenimiento y cambios a medida que los requerimientos evolucionan. Por eso la documentación es vital, para humanos y para agentes de IA.
Un agente de IA que inicia una nueva sesión no sabe nada sobre por qué se tomó una decisión. Si ese contexto solo vive en la cabeza de alguien o en un chat viejo, el agente va a adivinar, y va a adivinar con confianza. Una documentación clara del modelo de datos, sus restricciones y el razonamiento detrás de ellas es lo que permite que el siguiente cambio, hecho por una persona o por un agente, respete la intención original.
Pero más documentación no es automáticamente mejor. Un estudio de ETH Zurich sobre los archivos AGENTS.md y CLAUDE.md encontró que estos archivos de contexto tendían a reducir la tasa de éxito de los agentes mientras aumentaban el costo de inferencia en más de un 20%. La cobertura del paper agrega que los archivos escritos por los desarrolladores ayudaban un poco, los autogenerados perjudicaban, y las descripciones generales del código no ayudaban a los agentes a encontrar los archivos correctos. La lección que me llevo: lo que ayuda a un agente es información precisa, estructurada y que no sea obvia a partir del código. Una descripción en prosa del sistema es fácil de escribir y fácil de ignorar; una definición formal del modelo de datos no es ninguna de las dos.
Lo que me enseñó r/golang
Hace un tiempo publiqué en r/golang sobre exactamente este enfoque: hacer del esquema de la base de datos la fuente de verdad y generar todo a partir de él (modelar el esquema, generar el proto, luego generar el código Go y sqlc). El único detalle que había encontrado era que, una vez en producción, los campos nuevos siempre tienen que agregarse al final para que nada se rompa. Pregunté qué más me estaba perdiendo, y las respuestas hicieron la idea más fuerte.
- El verdadero peligro son los renombres y las eliminaciones. Un comentarista, que mantiene sus propias herramientas de esquema a código, señaló que con migraciones solo hacia adelante solo rompes cosas cuando renombras o eliminas un campo, muchas veces por un error de tipeo o porque tu forma de nombrar mejoró. Ese es el punto de "caro de corregir una vez que hay datos de producción" de antes, en su forma más concreta. Un agente puede escribir la migración en segundos; decidir cómo deprecar una columna de la que dependen usuarios reales sigue siendo una decisión humana.
- No ates tu contrato de API a tus tablas. Otra respuesta planteó la preocupación del acoplamiento: el esquema de la base de datos y la API pública no siempre deberían reflejarse uno al otro. Estoy de acuerdo. La forma en que lo manejo es un núcleo generado y un borde escrito a mano: la capa generada cubre las partes aburridas y predecibles, y la lógica de negocio y el contrato público viven en código que el generador nunca toca. Regenerar después de un cambio en el modelo nunca sobrescribe una decisión que un humano (o un agente) tomó a propósito.
- La documentación va junto al modelo. Las herramientas del mismo comentarista tienen un linter que exige comentarios en cada tabla y campo. Ese es el argumento de la documentación de arriba, aplicado a nivel de esquema, justo donde tanto humanos como agentes van a mirar primero.
Por qué construí nuzur
Construí nuzur para desarrollar mis propios sistemas con agentes de IA. Me da la velocidad, pero también conservo el control sobre el modelo del sistema, que es el núcleo de la arquitectura. (Estoy pensando en sistemas pequeños, no en grandes sistemas empresariales con muchos subsistemas.)
Entender la estructura de datos es importante para seguir construyendo de forma limpia y preparada para el futuro. En nuzur el modelo es la fuente de verdad: las entidades, campos, relaciones y enums se definen primero, y el código se genera a partir de ellos. Cuando le pido a un agente que agregue una funcionalidad, trabaja contra ese modelo en lugar de inventar tablas sobre la marcha.
Birgitta Böckeler, de Thoughtworks, describe el desarrollo guiado por especificaciones como una escalera de ambición: spec-first (la especificación guía una tarea y puede desecharse), spec-anchored (la especificación vive junto al código) y spec-as-source (la especificación es lo principal que editan los humanos). nuzur está cerca de ese último escalón, pero solo para la capa de datos: el modelo es lo que edito, y el código se deriva de él. Creo que ese es el nivel correcto de ambición para la mayoría de los sistemas pequeños, porque el modelo de datos es la parte más difícil de cambiar después.
El modelo es igual de relevante para los propios agentes de IA. Acelera el desarrollo porque el agente no necesita redescubrir la estructura en cada sesión, y agrega límites al modificar el modelo o agregar datos a la base de datos: los cambios pasan por un borrador y un paso de revisión en lugar de llegar directamente a producción.
También cierra el ciclo con la recopilación de requerimientos. Un agente puede proponer un modelo de datos a partir de un montón de documentos, y nuzur me da un lugar para revisar y corregir ese modelo antes de que se convierta en código y en datos de producción.
Más rápido, no más fácil
La IA hizo que construir sea más rápido, no más fácil de hacer bien. La velocidad es real, y deberíamos usarla para iterar más, probar más y desechar más. Pero las cosas que antes eran difíciles, entender el problema, acertar con el modelo de datos y mantener un sistema sano con el tiempo, siguen siendo difíciles. Si acaso, las herramientas que ayudan con esas partes importan más ahora que antes. La velocidad cambió; el entendimiento no.
Fuentes
- AI coding tools make developers slower but they think they're faster, The Register, sobre el estudio de METR
- Announcing the 2025 DORA Report, Google Cloud
- What Is Spec-Driven Development?, Allstacks
- Spec-Driven Development for AI Agents, Done Right, TrueFoundry
- From LLMs to LLM-based Agents for Software Engineering: A Survey, arXiv
- The vibe coding moment, Uxcel
- Why prototypes rarely survive contact with prod, SD Times
- Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents?, ETH Zurich y LogicStar.ai, arXiv
- Every serious developer had an AGENTS.md file. Now there's a study, Medium