Manifiesto AIDD

El desarrollo de software está experimentando una transformación radical con la llegada de los modelos de IA. Como toda disrupción genera incertidumbres y preocupaciones. En este caso se ha identificado dos muy claras:

• La IA destruye empleos al reemplazar el rol del desarrollador.
• La IA genera soluciones incorrectas, incompletas, o inmantenibles.

Este manifiesto establece dos principios fundamentales para generar confianza en el uso de la IA en el desarrollo de software, que nos lleve a cumplir con los siguientes objetivos:

• El humano es estratega, colaborador y responsable.
• El desarrollo es productivo, mantenible y de calidad.

♻️ Human-In-The-Loop

La IA puede acelerar procesos, sugerir soluciones y detectar errores, pero el rol humano es insustituible. Como desarrollador, tu principal responsabilidad es liderar, colaborar y supervisar. Veamos cómo puedes maximizar este enfoque:

Inicia con Propósito y Objetivos

Antes de utilizar cualquier herramienta de IA, define el “qué” y el “por qué” del proyecto. No basta con pedirle a la IA que “haga algo”; necesitas establecer los cimientos del trabajo.

Tu rol comienza mucho antes de la primera línea de código. Como humano, tienes la capacidad única de:

• Entender las necesidades reales del negocio y los usuarios

• Definir objetivos claros y medibles

• Establecer la visión estratégica del proyecto

• Determinar los requisitos no funcionales críticos

Aporta Contexto a las Peticiones

La IA trabaja mejor cuando entiendes cómo formular tus requerimientos. Describe claramente el problema, proporciona ejemplos y señala las restricciones. Esa atención al detalle y a eliminar la ambigüedad es lo que retiene tu rol de programador.

La IA es poderosa, pero necesita tu contexto para ser verdaderamente efectiva. Cuando interactúas con ella:

• Proporciona información sobre el entorno técnico y de negocio

• Explica las restricciones y limitaciones existentes

• Comparte conocimiento sobre los usuarios finales

• Define los casos de uso específicos

• Reduce la ambigüedad y la incertidumbre

Colabora, Guía y Aprende

Considera a la IA como un compañero de trabajo. Evalúa sus sugerencias, haz preguntas y mejora las respuestas iterativamente. Además, la colaboración con IA te ofrece una oportunidad para aprender nuevas perspectivas y enfoques.

El desarrollo con IA es una comunicación bidireccional. De hecho, se empieza a usar el término Chop: Chat Oriented Programming, para referirnos a esa conversación donde:

• Diriges el proceso iterativo de desarrollo

• Refinas las propuestas de la IA

• Aprendes nuevas técnicas y enfoques

• Compartes tu experiencia y conocimiento domain-specific

Decide con Responsabilidad

La IA no comprende el contexto humano completo, ni las implicaciones éticas o comerciales de sus respuestas. Tú eres quien valida y aprueba el resultado final.

La toma de decisiones final siempre recae en ti, una máquina nunca puede rendir cuentas (IBM dixit). Esto implica:

• Evaluar las alternativas propuestas por la IA

• Considerar las implicaciones éticas y de seguridad

• Asumir la responsabilidad por el código generado

• Mantener el control sobre la dirección del proyecto

Confía pero Comprueba

Aunque las herramientas de IA suelen ser precisas, no son infalibles. Siempre revisa el código generado, las sugerencias o los resultados automáticos. Las revisiones rigurosas aseguran la calidad y evitan errores críticos.

La verificación es esencial, ante el no-determinismo de la IA. Aplica el “Confía pero comprueba” (Trust but verify, by R. Reagan). Tu papel incluye:

• Revisar el código generado por la IA

• Validar que las soluciones cumplan los requisitos

• Realizar pruebas exhaustivas

• Asegurar la calidad del producto final

El humano es estratega, colaborador y responsable.

✅ AI Quality

Los humanos usamos herramientas para acelerar procesos desde el principio de los tiempos. El desarrollo impulsado por IA es otro acelerador. Pero, para aumentar la productividad, no solo debe centrarse en escribir código rápidamente, sino que también sea confiable y escalable. A continuación te desgloso los puntos clave:

Completo y Aplicable a Todo el Ciclo

La IA no solo puede ayudarte en la codificación, sino también en pruebas, documentación y despliegue. Aprovecha su potencial en todas las etapas del ciclo de desarrollo.

El enfoque abarca todo el ciclo de desarrollo:

• Planificación y diseño arquitectónico

• Implementación y coding

• Testing y QA

• Documentación y mantenimiento

• Despliegue y operaciones

Kaizen: Refinamiento Iterativo

Adopta la filosofía de mejora continua. Asumen la imperfección como parte del proceso. Cada interacción con la IA es una oportunidad para refinar el producto. Solicita revisiones, itera sobre soluciones y busca constantemente formas de mejorar.

El refinamiento iterativo es clave:

• Cada iteración mejora la calidad

• Se incorpora el feedback continuamente

• Se optimiza el proceso de desarrollo

• Se aprende de los errores y éxitos

Mantenibilidad: Diseño y Documentación

Cualquier código que hayas escrito hace tiempo, es como si lo hubiera escrito, ¡imagínate si de verdad lo ha escrito otro! Utiliza la IA para generar comentarios, diagramas y guías que hagan tu software comprensible para otros desarrolladores (y para tu “yo” del presente y del futuro).

El código debe ser mantenible desde el primer día, aplica todo el conocimiento sobre diseño y código limpio:

• Arquitectura clara y bien documentada

• Patrones de diseño apropiados

• Código limpio y legible

• Documentación completa y actualizada

Robustez: Control de Errores y Registro

La IA puede sugerir patrones para manejar errores de forma eficaz o configurar sistemas de registro (logging) detallados. Prioriza un diseño que anticipe fallos y mantenga registros claros para facilitar la depuración.

La prevención y gestión de errores es fundamental:

• Manejo exhaustivo de excepciones

• Logging detallado y útil

• Monitorización efectiva

• Recuperación ante fallos

Fiabilidad: Validación con Testing

Nunca asumas que el código generado por IA está listo para producción. Diseña pruebas unitarias, de integración y de rendimiento para garantizar que tu software cumple con los estándares requeridos.

La validación debe ser rigurosa, pero con las herramientas adecuadas, no debe ser tediosa:

• Tests unitarios completos

• Pruebas de integración

• Testing de rendimiento y usabilidad

• Validación de seguridad

El desarrollo es productivo, mantenible y de calidad.

🌿 Conclusión: Un Nuevo Paradigma de Desarrollo

El Manifesto AIDD establece un marco para aprovechar lo mejor de ambos mundos: la creatividad, experiencia y juicio del humano, combinados con la eficiencia y capacidades de la IA.

Como desarrollador, tu papel es más importante que nunca. No eres reemplazado por la IA, sino potenciado por ella. Tu responsabilidad es guiar el proceso, tomar decisiones informadas y asegurar que el resultado final cumpla con los más altos estándares de calidad.

La clave del éxito está en mantener un equilibrio entre la eficiencia que aporta la IA y el control de calidad que solo un humano puede proporcionar. Este manifiesto es tu guía para lograr ese equilibrio y crear software excepcional en la era de la IA.

Aplicando los principios del Manifiesto AI-Driven Development lograrás: