«¿Quién ha escrito esto?»
La funcionalidad seguía funcionando y sus tests pasaban. Sin embargo, pocas semanas después de construirla con ayuda de IA, modificarla exigía reconstruir decisiones que nunca se habían registrado.
El problema no era el código generado. Era la falta de conexión entre ese código, sus requisitos, las restricciones que lo condicionaban y la evidencia usada para aceptarlo.
Cada forma de trabajar responde a eso sin decirlo, antes de que nadie se dé cuenta de que era una pregunta. Waterfall escribía el conocimiento al principio y lo dejaba envejecer. Agile lo trasladó a la conversación. DevOps automatizó las partes que un pipeline podía sostener. Este artículo pone AI-first junto a los tres en los mismos ejes, y después dice qué cuesta esa diferencia en planificación y presupuesto. Si lo que buscas es el ciclo en sí, los artefactos y las etapas, eso es el framework de desarrollo AI-first.
Lo que deja fuera el desarrollo asistido por IA
El informe McKinsey 2024 sobre IA generativa en software describe mejoras de productividad en implementación, documentación y refactorización. Esas métricas miden la velocidad de producción, no la facilidad con la que otra persona podrá entender o cambiar el resultado más tarde.
Un estudio de McKinsey de 2023 sobre productividad de desarrolladores con IA generativa también señala que las herramientas generalistas no conocen las necesidades específicas de un proyecto u organización. Ese contexto todavía tiene que aportarlo y revisarlo una persona.
De un proceso lineal a un bucle de feedback
Después de dedicar tres días a modificar esa funcionalidad, el artefacto que faltaba quedó claro: las razones de sus decisiones de diseño no habían viajado con el código.
La asimetría con la que me topo una y otra vez es esta. Las ganancias de productividad se concentran en las tareas sencillas, mientras que el trabajo complejo solo se beneficia cuando su contexto y su intención de diseño sobreviven junto al código. En cuanto eso pasa, el razonamiento detrás de una decisión importa tanto como la decisión.
Es un problema de flujo de trabajo. Si la intención desaparece después de implementar, el siguiente cambio empieza reconstruyéndola. El artículo sobre contexto en el desarrollo asistido por IA explica cómo conservar esas conexiones.
Lo que AI-first retiene y los otros tres sueltan
1. Contexto como creación primaria
Según la Encuesta para Desarrolladores 2023 de Stack Overflow, el 63% de los desarrolladores profesionales declara dedicar más de 30 minutos al día buscando respuestas o soluciones. Registrar el contexto como parte del trabajo reduce lo que habrá que reconstruir después.
En el desarrollo AI-First, el requisito, la decisión y la evidencia de aceptación son artefactos de primer nivel. El código es una implementación de ese contexto, no su único registro.
El cambio al que apunta esto va de «código como producto» a «conocimiento como producto»: las organizaciones que tratan lo que saben, y el porqué, como su activo principal son aquellas cuya inversión en IA se acumula en vez de pudrirse.
2. Arquitectura guiada por intención
El informe 2024 del McKinsey Center for Future Mobility señala que los equipos que usan IA generativa para entender requisitos de negocio y diseñar arquitectura basada en la intención «ayudan a los desarrolladores a capturar y traducir necesidades de negocio en especificaciones técnicas con más precisión, lo que reduce malentendidos».
La arquitectura guiada por intención registra por qué existe un límite, además de cómo funciona. El propósito y las restricciones de un componente siguen disponibles cuando cambia su implementación.
El mismo giro aparece en infraestructura, donde declarar el estado deseado ha sustituido en gran medida a programar los pasos para llegar a él. El principio se traslada. En un sistema que los agentes ayudan a construir y a cambiar, la arquitectura debe diseñarse en torno a intención y propósito, no solo a funcionalidad técnica.
3. Conocimiento como entidad viva
El informe Octoverse 2024 de GitHub midió un crecimiento interanual del 98% en proyectos de IA generativa en la plataforma. La adopción de las herramientas ya está resuelta; lo que distingue a los equipos ahora es si el conocimiento que esas herramientas producen y consumen se mantiene vivo.
El conocimiento del proyecto cambia con el sistema. Por eso la documentación necesita responsables, versiones y enlaces al trabajo que describe, en lugar de vivir como una instantánea separada.
Según el informe McKinsey 2023 sobre el estado de la IA, las organizaciones que han incrustado grafos de conocimiento en sus procesos junto con capacidades de IA muestran sistemáticamente mejor rendimiento. El estudio detecta que los «high-performers» de IA (aquellas empresas que atribuyen al menos un 20% de su EBIT a la IA) tienen «muchas más probabilidades que el resto de afirmar que sus organizaciones han incrustado grafos de conocimiento en al menos un producto o función de negocio», lo que permite mejor contextualización de la información y outputs de IA más precisos.
4. Revisión humana con asistencia de IA
Una investigación del estudio McKinsey 2024 sobre desarrollo de software automotriz detectó que los desarrolladores con formación adecuada en IA «usaban gen AI un 60% más a la semana que cuando no contaban con esos programas. La participación mejoró y, tras la formación, el 95% de los desarrolladores afirmó que la gen AI tiene un impacto positivo en su experiencia como desarrollador».
La IA puede redactar y transformar la implementación, mientras las personas siguen siendo responsables de los requisitos, los trade-offs y la aceptación. El límite útil es la responsabilidad, no quién escribió cada línea.
Los años transcurridos desde entonces lo han confirmado en la práctica: los desarrolladores que más sacan de los agentes no son los que teclean más rápido, sino los que estructuran el contexto, la intención y la verificación alrededor de la colaboración.
5. Arquitectura contextual de decisión
El informe McKinsey 2023 sobre el potencial económico de la IA generativa estima que esta tecnología podría aportar entre 2,6 y 4,4 billones de dólares anuales a la economía global. Capturar cualquier parte de ese valor con el tiempo depende de algo que la cifra esconde: saber, más tarde, por qué los sistemas que construiste son como son.
Los registros de decisión necesitan la razón, las restricciones y las alternativas descartadas, no solo la opción elegida.
Según el análisis 2023 de Harvard Business Review sobre implementación de IA, las organizaciones que documentan no solo qué decisiones se han tomado sino por qué, son significativamente más exitosas manteniendo sistemas de IA a lo largo del tiempo y extrayendo valor sostenido de su inversión en IA.
AI-first al lado de Waterfall, Agile y DevOps
La diferencia práctica está en dónde coloca cada enfoque el contexto y las decisiones:
| Paradigma | Foco principal | Tratamiento del conocimiento | Enfoque de decisión | Output principal |
|---|---|---|---|---|
| Cascada | Proceso secuencial | Documentación estática | Pre-implementación | Corrección del código |
| Ágil | Entrega iterativa | Documentación actualizada | Durante iteraciones | Software funcionando |
| DevOps | Pipeline de integración | Documentación automatizada | Continua | Velocidad de despliegue |
| AI-First | Preservación del contexto | Conocimiento vivo | Guiada por intención | Contexto + código |
El patrón de la tabla es consistente: los paradigmas tradicionales tratan el conocimiento como un subproducto del desarrollo, mientras que AI-First lo trata como el producto principal, con el código como su expresión.
Implicaciones para los equipos de software
El informe McKinsey 2024 sobre el próximo capítulo de la tecnología empresarial describe tres efectos que los equipos deben planificar:
- «A medida que aumenta la productividad del personal, la velocidad a la que IT puede concebir, construir y lanzar capacidades también se espera que aumente, mientras el coste de ese trabajo bajará».
- Sin embargo, «la gen AI puede no reducir el presupuesto de tecnología empresarial de inmediato. En su lugar, impulsará una reasignación estratégica dentro de la cartera, con líderes tecnológicos centrándose cada vez más en proyectos de crecimiento en lugar de mantenimiento rutinario».
- Las organizaciones necesitan «reforzar la planificación y la gestión del riesgo para sostener este ritmo acelerado».
El informe también recomienda revisar el equilibrio entre patrones artesanales e industriales a medida que cambian las prioridades de negocio.
Para los equipos de software, eso significa conservar no solo qué se construyó, sino por qué se tomaron las decisiones y qué evidencia las respaldó.
Qué cambia para un equipo que se mueve
Nada de esto es filosofía. Registrar por qué existe un cambio, mantener los requisitos conectados con la implementación y adjuntar la verificación al mismo contexto. Así se reduce el trabajo de reconstrucción y se ofrece a personas y agentes una base mejor para los cambios futuros. El framework de desarrollo AI-first los convierte en un ciclo de trabajo, con el artefacto que deja cada etapa.
Para los equipos que quieran implementar estos principios en la práctica, el framework PAELLADOC ofrece un sistema integral para preservar contexto a lo largo de todo el ciclo de desarrollo.
Fuentes revisadas por última vez en julio de 2026; las cifras que ya no se pudieron rastrear hasta su estudio original se eliminaron en lugar de mantenerlas por fe.
El artículo de PAELLADOC sobre contexto muestra cómo estos principios se traducen en una estructura de trabajo.
Preguntas frecuentes
¿Por qué el código generado por IA se vuelve inmantenible?
La IA genera código que funciona y pasa los tests, pero rara vez deja registrado por qué se tomó una decisión. Meses después, cambiar ese código obliga a reconstruir una intención que nunca se capturó: las restricciones, las alternativas descartadas, la razón de negocio. El código no es de baja calidad; lo que falta es el contexto a su alrededor. Ese hueco, no la IA, es lo que convierte una función rápida en un laberinto que nadie quiere tocar.
¿El desarrollo AI-first sustituye a Agile?
No. Cambia otra variable. Agile decidió cada cuánto entregas y quién decide qué se construye después, y nada de eso deja de servir. Lo que mueve AI-first es dónde se queda el conocimiento. Agile está pensado para un equipo que lleva el razonamiento en la cabeza entre una conversación y la siguiente, y esa suposición se rompe en cuanto la mayor parte del código la escribe algo que no estuvo en la conversación. Se puede trabajar AI-first en un equipo que conserva sus sprints y sus ceremonias.
¿AI-first cambia cómo se dimensiona o se presupuesta un equipo?
Mueve el dinero, no lo reduce, que es lo que sostiene la sección anterior con los informes que cita. La implementación es la parte que se ha abaratado, así que el papel escaso ya no es quien escribe código más rápido. Es quien sostiene el contrato, pesa los trade-offs y acepta el trabajo con la evidencia adjunta. Los equipos que recortan plantilla con la primera cifra en la mano suelen redescubrirlo en la revisión.
¿El código generado por IA necesita documentación?
Necesita algo mejor que la documentación tradicional: contexto ligado al código y mantenido vivo a medida que el código cambia. Los documentos estáticos en un wiki aparte se pudren y se ignoran. Lo que importa es capturar el razonamiento detrás de las decisiones generadas por IA, requisitos, trade-offs y caminos descartados, cerca del código, para que la siguiente persona, o la siguiente sesión de IA, actúe sobre la intención en lugar de adivinarla.