Desarrollo Guiado por Especificaciones @ Jornadas eComputing 2026

Presentación de mi charla en las Jornadas eComputing celebradas en Vitoria-Gasteiz el 3 de julio de 2026.

El repositorio con el proceso SDD mostrado, con sus comandos y skills, adaptado del repo agent-skills de Andy Osmani para trabajar sobre issues en GitHub en lugar de ficheros markdown, se encuentra aquí: https://github.com/deors/agent-skills

Transcript

1. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 E N L A E R A DE L A IA , ¿Q UÉ EN SE Ñ AM O S? Desarrollo Guiado por Especificaciones Spec-Driven Development (SDD) Y por qué deberíamos enseñarlo en las escuelas Una idea Una especificación Software ¡”Ellos” no piensan! 1 Jorge Hidalgo – Jornadas eComputing 2026 – 3 de julio, Vitoria-Gasteiz
2. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 Director Asociado – Ingeniería del Software – Accenture ATC Responsable de DevOps e Ingeniería de Plataformas Responsable de la Comunidad de Práctica Java Global Java Champion Muy activo en las comunidades: Coorganizador en MálagaJUG / BoquerónSec Coorganizador en OpenSouthCode / OpenSouthKids / OpenSouthRetro Codemotion Ambassador Father of two, husband, whistle player, video gamer, sci-fi *.*, retro-computing, Lego, Raspberry Pi, Star Wars, Star Trek, LOTR, Halo, Destiny, Black Desert… LLAP! @deors.bsky.social in/deors Jorge Hidalgo Copyright © 2026 Jorge Hidalgo – CC BY 4.0 2
3. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 E L PR O B L EM A La IA ya escribe el código Entonces, ¿qué nos queda por aprender? ANTES IMPORTABA • Conocer un lenguaje concreto • Memorizar la sintaxis exacta • Escribir cada línea de código y pruebas • Dominar el “cómo” AHORA IMPORTA • Decidir qué vale la pena construir • Describir bien el problema y su aceptación • Juzgar si el resultado es correcto • Dominar el "qué" y el "porqué" El código es un medio para un fin: gestionar flujos de información (informática, no programática) 3
4. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 QU É E S Desarrollo Guiado por Especificaciones La especificación es la fuente de la verdad; el código es una consecuencia, un subproducto. Primero el QUÉ, luego el CÓMO Defines el problema y el resultado deseado antes de pensar en la solución técnica. La especificación manda Es la única fuente de la verdad. El código, las pruebas y la documentación derivan de ella. Verificable por diseño Cada especificación dice qué significa "bien hecho". Eso se convierte en pruebas y criterios “ejecutables”. 4 No debe verse como un trámite burocrático sino como la clave del éxito a largo plazo.
5. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 E L CI CL O De la idea al producto, paso a paso Seis etapas claras (*); cada una se apoya en la anterior. 1 /spec 2 /plan 3 /build 4 /test 5 /review 6 /ship 5 Cada etapa deja evidencias. “Parece que funciona (en mi máquina)” nunca debió ser suficiente. (*) Basado en Agent Skills de Andy Osmani (https://github.com/addyosmani/agent-skills) – existen otras aproximaciones de SDD igualmente válidas Objetivo Produce Convierte requerimientos en especificaciones La especificación como fichero markdown o una issue en GitHub/GitLab Crea un plan de implementación a partir de la especificación Tareas como ficheros markdown o Issues en GitHub/GitLab Ordena al Agente implementar una tarea (en modo guiado o piloto automático) Código, pruebas unitarias e integradas, documentación, todo en control de versiones Re-ejecuta los tests disponibles (por component o módulo) Verificación adicional durante el desarrollo (típicamente en modo guiado) Pide al Agente revisar el código o la documentación Verificación adicional durante revisiones de pares (típicamente en tiempo de PR/MR) Pide al Agente realizar un análisis previo al paso a producción Informe con las evidencias como comentario en una issue en GitHub/GitLab
6. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 “ NO V IB E S” Improvisar (“vibe-coding”) vs. Especificar Empezar rápido o empezar bien. EMPEZAR A TECLEAR • El objetivo no está claro • Mucho trabajo se rehace por el camino • "No era esto lo que quería" • Difícil de comprobar; no te acuerdas • Vive solo en una cabeza EMPEZAR POR LA ESPECIFICACIÓN • Entendimiento compartido • Se divide en tareas claras • Se sabe qué significa "terminado" • Verificable desde el principio • Cualquiera (humano o IA) puede construir Pensar antes de escribir código, en vez de arreglar después (a veces después de una “sorpresa”). 6
7. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 PO R QU É S UC ED E E ST O A HO R A Los agentes construyen; las personas especifican La inteligencia artificial cambia dónde está el valor del trabajo. LA IA / LOS AGENTES Generan código rápido y barato(*) — pero necesitan una especificación clara para hacer lo correcto. El cuello de botella ya no es escribir código: es saber qué construir y por qué. 7 (*) Es la asunción que se hace generalmente, pero no está claro aún el retorno de la inversión en su totalidad LAS PERSONAS Definen la intención y las prioridades, juzgan si el resultado es bueno y deciden qué se entrega y cuándo.
8. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 CÓ M O NO S PR E PA R AM O S Por qué enseñarlo en las escuelas No es una habilidad solo para futuros programadores. Pensamiento claro Expresar una idea con precisión y sin ambigüedad. Descomposición Partir un problema grande en pasos manejables. Definir "terminado" Saber qué significa que algo está bien hecho. Verificar con evidencias Comprobar los resultados, no suponerlos. Colaboración Un lenguaje común para trabajar en equipo. Pensar antes de hacer Diseñar la solución antes de ejecutarla. 8 Es muchísimo más difícil de lo que parece: https://www.youtube.com/watch?v=j-6N3bLgYyQ
9. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 M ÁS AL LÁ DE L CÓ DI GO Un mismo principio unificador Especificar no es cosa de informáticos: aparece en cualquier tarea. Una receta Ingredientes, pasos y cómo saber que salió bien. Un experimento Hipótesis, método y verificación del resultado. Un ensayo Tesis, estructura y revisión hasta que convence. Un proyecto Objetivo, plan, ejecución y entrega del producto. 9 Saber crear buenas especificaciones es una habilidad para la vida, no solo para la informática.
10. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 CÓ M O EM PE ZA R Empezar es fácil (y sin tecnología cara) No hace falta IA para enseñar SDD; pero te prepara para trabajar con ella. 1 Una plantilla simple Problema · Objetivo · Criterios de "hecho". Tres apartados bastan para empezar. 2 Especificar antes de empezar En cualquier asignatura: definir el qué antes de ponerse a hacer el proyecto. 3 Revisar entre compañeros ¿Está claro? ¿Es verificable? La revisión enseña tanto como escribir. 4 Construir, comprobar, iterar Contrastar el resultado con los criterios y mejorar hasta cumplirlos. 10
11. Copyright © 2026 Jorge Hidalgo – CC BY 4.0 PA R A LL EV AR S E A CA SA Y PE N SA R 1 SDD = primero el qué y el porqué; luego, el cómo. 2 La especificación es la fuente de la verdad; todo lo demás deriva de ella. 3 En la era de la IA, especificar es la habilidad que perdura. 4 Enseña pensamiento claro, descomposición y verificación — para todos. 5 Empezar es barato: una plantilla y pensar antes de hacer (casi cualquier cosa). 11 Cinco ideas para recordar