Using Spec-Driven Development for Agentic Coding

Hola a todos. Mi nombre es Eric Hanton, y estoy emocionado hoy de hablarles sobre el desarrollo impulsado por especificaciones y cómo pueden usarlo en sus IDEs hoy. Ahora, a lo largo de esta presentación, pueden ver este fantasma rebotar hacia arriba y hacia abajo en algunas de mis diapositivas. No se preocupen, voy a hablar más sobre eso en el futuro, pero tiene que ver con cómo funciona este desarrollo impulsado por especificaciones. Así que la primera pregunta que probablemente estén pensando es, ¿qué es el desarrollo impulsado por especificaciones? Ahora, no es spec-der, como algunos de estos fantasmas que ven en mis diapositivas, pero es una forma importante de pensar en una manera de crear especificaciones para sus entornos de desarrollo y mientras están codificando. Así que echemos un vistazo a la definición más formal de ello. Como pueden ver aquí, un enfoque de desarrollo donde se crean especificaciones detalladas y estructuradas antes de que se escriba cualquier código.

Así que no sé ustedes, si están viendo ahora mismo, ¿alguna vez han tenido el problema, han estado por un tiempo, y han oído hablar de waterfall? Así que esa era la idea donde tenían requisitos muy específicos, esto era algo muy específico que hacían con el ciclo de vida del desarrollo de software, y luego sus desarrolladores trabajarían en esos requisitos muy específicos, a veces durante muchas semanas, y hoy en día hemos pasado a metodologías ágiles y sprints, pero tener este documento de requisitos muy detallado es realmente bueno para los IDEs, especialmente para los IDEs de IA, para que pueda entender exactamente lo que están tratando de hacer y no haya ambigüedad. Así que el desarrollo impulsado por especificaciones es realmente sobre tratar de crear eso en su IDE, para que de esa manera su IDE de IA, sus agentes entiendan lo que están tratando de hacer.

Ahora, hay otra definición que solo quiero aclarar es qué son las especificaciones. Ahora, las especificaciones son los requisitos formales, reglas y restricciones que gobiernan la creación y el comportamiento de un sistema. Así que muchas veces los desarrolladores de software, no sé ustedes, pero no tengo tiempo para escribir especificaciones, en realidad tengo otras personas que escriben requisitos, y muchas veces los requisitos que me dan no son muy detallados, pero este desarrollo impulsado por especificaciones en realidad ayuda a resolver ese problema también. Así que no tienen que tener a alguien que escriba documentos de requisitos muy detallados, en realidad podemos hacer que la IA lo haga por nosotros. Así que déjenme mostrarles exactamente cómo funciona eso.

Así que permítanme darles primero una pequeña lección de historia. Entonces, en AWS somos muy orientados a documentos, escribimos muchos documentos cada vez que hacemos algo, tenemos reuniones muy largas y reuniones de elevación de barra sobre cualquier cosa que hacemos, y teníamos este problema donde tenemos mucha y mucha documentación, pero había un problema, ¿cómo se lleva esa documentación a nuestros entornos de codificación? ¿Y cómo usamos nuestros agentes de codificación de IA de manera inteligente? Así que en realidad ideamos algunas formas diferentes, y de hecho tenemos un historial de creación de asistentes de IA. Así que el primero es Amazon Queue. Entonces tenemos Amazon Queue, una versión IDE, tenemos Amazon Queue versión CLI, y esto te permite en la línea de comandos pedirle y solicitarle que haga cosas, y luego puede entrar y hacer cambios en tu código. Y también puedes programar esto, es realmente poderoso, puedes agregar servicios MCP, pero seguíamos escuchando que necesitábamos más formas de tener mejores resultados y resultados. Ahora puedes codificar con estas herramientas como Amazon Queue CLI y Amazon Queue IDE, pero tienes problemas donde simplemente vas y vienes mucho, y muchas veces no es exactamente lo que quieres. Así que vimos este problema y pensamos, ¿qué mejor manera de solucionarlo que con el desarrollo impulsado por especificaciones? Así que déjenme mostrarles lo que sucedió allí. Así que presentamos Qiro. Qiro es un nuevo asistente de codificación IDE de IA, y una de las características principales de él es este desarrollo impulsado por especificaciones, que voy a mostrarles en un momento. Así que queríamos tener esto internamente, pero también obviamente está disponible externamente, y tiene esta linda mascota, este fantasma, lo llamo el fantasma de Qiro, y es diferente a algunos de los otros servicios o productos de Amazon que has visto. De hecho, se llama Qiro, que no es Amazon Qiro o AWS Qiro, es solo Qiro. Y realmente queríamos asegurarnos de que esto estuviera disponible para cualquiera que tuviera los mismos problemas que vimos, que quisiera esta forma más profunda de crear software y que fuera más confiable. Ahora lanzamos un sitio web, qiro.dev, puedes ir allí ahora mismo. Y lo que fue realmente increíble cuando lanzamos esto al público, tuvimos reacciones tan positivas. Creo que esto era algo en lo que muchas personas estaban pensando, como, ¿cómo podemos hacer que nuestros agentes, nuestra IA sean aún más inteligentes? Y tuvimos tantas descargas que tuvimos que establecer una lista de espera, y luego la gente encontró una forma de evitar la lista de espera. Así que hasta el día de hoy, está en lista de espera, y puedes verlo en qiro.dev. Y estamos realmente orgullosos de ello, estamos tomando todos los comentarios de los usuarios, haciendo cambios y actualizaciones. De hecho, tenemos un canal de Discord donde incluso puedes dar tu opinión y hacérnoslo saber. Está basado en Visual Studio Code, del cual soy un gran fan de Visual Studio Code. Lo uso para todo. Así que tiene ese tipo de entorno que tú conoces y amas, especialmente como desarrolladores web, desarrolladores full stack de front-end. Aunque no estás limitado a eso, puedes usar Java, puedes usar lo que más te guste, por supuesto. Así que quiero dar un pequeño reconocimiento de que si no estás usando Qiro, y si no lo estás, me pregunto por qué no. Pero si no lo estás, puedes hacer este desarrollo de espectro incluso sin Qiro en sí. Así que hay algunas formas de juntar esto. Y así hablaré un poco sobre ello. Primero, en realidad solo necesitas ser muy específico para decirle al IDE exactamente lo que quieres. Así que incluirías lo siguiente, le dirías primero, crea un documento de requisitos de usuario y este documento de requisitos de usuario tendría cada cosa que quieres dentro de él. Así que le das una prop y dices crea un documento de requisitos de usuario para la característica XYZ y luego tal vez crearlo como un markdown. Y luego lo crearía.

Y luego tú dirías crear un documento de diseño basado en ese documento de requisitos de usuario. Así que entrarías y dirías que agregarías estos documentos de requisitos en el contexto y luego harías que creara el documento de diseño. Y finalmente harías que creara los detalles de implementación o la lista de tareas a partir de eso. Así que esto se puede hacer básicamente con cualquier IDE de IA que exista. Sin embargo, creo que realmente se presta muy bien a QIRO.

También hay plantillas por ahí que puedes descargar y que puedes usar como puntos de partida. Si buscas, también hay incluso un proyecto de código abierto. Creo que se llama spec. Es un proyecto de código abierto de especificaciones que puedes usar para también agregar estas características o algo similar a esta funcionalidad. Ahora con QIRO está realmente integrado en el propio IDE. Es una de nuestras características principales, pero ciertamente no tienes que usar eso para probar esto.

Ahora probablemente te estés preguntando cómo funciona esto en la práctica. Así que déjame mostrarte cuáles son los pasos y qué necesitas hacer. Así que primero dentro de QIRO, vamos a usar eso para el resto de los ejemplos de este tutorial, pero puedes hacerte una idea si estás usando tu propio IDE. Pero en realidad tienes esta caja que se abre dentro de QIRO y te da dos opciones. Por supuesto, vibe es común y puedes usar eso y funciona muy bien. Puedes ir y venir, pero puedes elegir spec. Y spec es una gran manera, especialmente si estás creando características en profundidad, algo que necesita planificación anticipada, tal vez creando un proyecto completamente nuevo desde cero.

Así que esta es una gran manera de comenzar. Y realmente creo que las pequeñas características, pequeños errores, vibe es bueno, las especificaciones son realmente buenas para características más grandes y más planificación que necesita ser anticipada, algo que necesita un poco más de reflexión antes de comenzar.

Entonces, ¿cómo haría esto? Imaginemos que íbamos a crear un servidor MCP. No sé. MCP es realmente grande. Hablaremos más sobre eso en un segundo. Que extrae mi sitio web local de películas y lo despliega en AWS. Ahora uso el ejemplo de AWS aquí, pero ciertamente puedes usar cualquier proveedor.

Solo pensé que era un ejemplo divertido. Así que haría clic en esa especificación dentro de QIRO y luego lo agregaría en la ventana de chat. Ahora corté la ventana de chat aquí, pero hay una ventana de chat en la parte inferior con la que puedes interactuar y volver y adelante. También admite como multimodalidad. Tienes un par de diferentes...

Y así, después de que ingresé ese aviso en y presioné enter, QIRO comenzaría a trabajar en segundo plano y crearía este documento de requisitos. Y esto tendría la introducción, historias de usuario, básicamente todo lo que necesitas para comenzar. Y en este punto, es donde podrías querer entrar y hablar con tu gerente de producto, obtener los requisitos, actualizar esto. También hay un botón de refinamiento que puedes usar para refinarlo aún más, pero realmente quieres verificar esto antes de pasar al siguiente paso.

Y esta es también la razón por la que no necesitas necesariamente tener este documento ya allí. Si lo tienes, genial. Puedes agregarlo aquí, pero si no, QIRO es lo suficientemente inteligente como para crear un documento bastante detallado. Va a crear un documento de diseño.

Así que después de los requisitos, te va a preguntar, ¿esto se ve bien? Dices que sí. Crea un documento de diseño. Podría usar este arte ASCII para dar una vista de alto nivel sobre ello.

sobre ello. También puede usar diagramas de mermaid, lo cual es realmente agradable. Incluso te da otro conjunto de explicaciones de lo que va a hacer. Eso es algo que es realmente agradable sobre el desarrollo impulsado por especificaciones.

Siempre estás como verificando y revisando si lo que el IDE piensa, lo que la IA piensa, es lo que realmente quieres. Y puedes ir y venir aquí. Ahora pondré este aviso aquí para revisión. Siempre que trabajes con cualquier tipo de IDE y agentes o IA, siempre querrás comprometer temprano, comprometer a menudo, fusionar de nuevo a tu rama. Solo asegúrate de mantener esto en ramas separadas.

De esa manera, puedes revertir fácilmente. Ahora puedes revertir, por supuesto, en QIRO, pero creo que es más fácil si mantienes todo esto aislado y tienes tu sistema de control de versiones para jugar con esto. Por supuesto, querrás verificar algunas cosas obvias, inconsistencias, alucinaciones, errores, cualquier cosa de ese tipo porque aún puede suceder. Ahora finalmente pasa a esta fase de implementación, que realmente me gusta, que muestra cada tarea individual. En este punto, todavía tienes tiempo para volver a los requisitos y diseño, hacer cambios adicionales, luego hacer clic en el botón de actualizar tarea y actualizará la tarea.

También me gusta en este punto tal vez reducir el número de tareas. QIRO, como muchos otros AI IDEs, es como un becario entusiasta. Quiere hacer todo por ti y crear un millón de tareas. Me encanta eso. Me encanta eso, pero a veces podría decir, no tienes que hacer esto. Podría eliminar un paso, podría cambiar cosas, pero obtengo esa flexibilidad en este punto, lo cual es realmente increíble.

Ahora quiero dar un reconocimiento a MCP porque probablemente durante esta conferencia hayas visto alguna otra información de MCP, pero MCP, por supuesto, es una forma de conectar tus agentes a diferentes herramientas y un estándar para hacerlo que vino de nuestros amigos en Anthropic. Algunas personas lo llaman el USB-C de los protocolos, lo cual es agradable. Puedes usar eso con QIRO.

Déjame darte un ejemplo rápido de cómo funciona esto. Tienes agentes en el lado izquierdo, tienes el MCP, y luego tienes las herramientas. Esto realmente abre muchas posibilidades porque aunque los modelos que usamos en QIRO o cualquier IDE que estés usando están bastante actualizados, siempre falta algo. Puede que no tenga la última versión del software. Puedes usar servidores MCP para ponerte al día con eso. Para que tenga la información más reciente que deseas.

QIRO, por supuesto, admite MCP, así que no es un problema agregar cualquiera de esos servidores MCP allí. ¿Qué tiene que ver esto con el desarrollo dirigido por especificaciones? Puedes usar servidores MCP durante tu desarrollo dirigido por especificaciones para hacerlo aún más inteligente. La forma en que pienso sobre esto es que puedes crear lo que llamamos documentos de dirección o archivos de reglas, y los archivos de reglas podrían decir cada vez que vayas y crees una nueva especificación, asegúrate de verificar este servidor MCP para la información más reciente. Un ejemplo de eso es tal vez usar algo como Context 7, de esa manera tiene la documentación más reciente. Context 7 es un servidor MCP que se conecta a muchos sitios de documentación diferentes y tiene toda esa información.

También puedes incluso extraerlo a tu usuario, tu sistema de gestión, como tu JIRA o algo que tengas para tus tareas, tu sistema de gestión de proyectos. Que tal vez pueda extraer la información directamente de tu sistema de gestión de proyectos mientras está creando los requisitos y mientras está creando el documento de diseño. Eso podría ser incluso una característica realmente agradable para ello. Por supuesto, sí, toma detalles técnicos según lo necesites. Incluso puedes establecer reglas adicionales en tus archivos de dirección, así que puedes hacer que extraiga a veces o solo en ciertas circunstancias. Realmente puedes moldear eso de la manera que desees.

Siempre uso archivos de dirección o archivos de reglas todo el tiempo en cualquier tipo de proyecto que uso porque tengo una forma muy particular en la que me gusta codificar, y es agradable tener eso allí. Déjame mostrarte una demostración rápida de cómo se ve esto. Aquí hay una aplicación, solo una aplicación de muestra que creé anteriormente. Está usando algo llamado AgentCore, que es un servicio que AWS tiene para ayudarte a desplegar agentes, pero quería mostrarte cómo se ve JIRA aquí. En el lado derecho está esta sesión. Puedo abrir sesiones adicionales si quiero, y luego tengo vibe, y tengo spec. También tengo algunas otras características de JIRA. Primero, comencemos y veamos cómo se ve. Vamos a crear un agente que raspe mi sitio web local de películas y las últimas películas. Puedo venir aquí, hacer clic aquí, y lo que va a hacer es comenzar a crear esas especificaciones.

y lo que va a hacer es comenzar a crear esas especificaciones. También puedo... Aquí están los archivos de dirección de agentes, que se utilizan para dar contexto adicional a JIRA sobre lo que quieres hacer. De hecho, puedes tener esto creado automáticamente. Si no tienes ningún archivo de dirección, habrá un botón allí para hacer clic y crear los archivos de dirección. Lo hice de antemano. También agrego algunas reglas generales para usar el contexto de un servidor MCP cuando sea necesario.

Parece que ya creó el documento de requisitos, y aquí está. Voy a decir que pase a la fase de diseño. Solo quiero mostrarte rápidamente que a medida que pasa a la fase de diseño, va a usar ese servidor MCP para asegurarse de que tiene toda la información correcta que necesita mientras crea ese diseño. Si esto fuera en la vida real, probablemente entraría, o en producción, probablemente entraría y leería todo esto, lo verificaría dos veces y me aseguraría de que tiene sentido. Tiene ese formato de criterios de aceptación de historia de usuario. Puedes ver aquí que está llamando a la herramienta MCP mientras hago esto, lo cual es realmente agradable. Sé con certeza que lo está usando. Tengo todos mis servidores MCP aquí.

Los tengo mayormente deshabilitados en este momento, pero puedes usar esos. Tengo el contexto 71 allí, pero puedo agregar múltiples servidores MCP. Muy bien, gracias por ver mi demostración. Si quieres saber más sobre Qiro o el desarrollo dirigido por especificaciones, solo ve a qiro.dev. También puedes unirte a nuestro Discord en discord.gg slash qiro.