Cuando Kiro presentó por primera vez el desarrollo guiado por especificaciones, el concepto me conectó inmediatamente. Me apunté en la lista de espera, y durante mucho tiempo trabajé en modo intuitivo: codificando de forma interactiva y usando el modo especificación solo cuando una historia de usuario exigía planificación deliberada. En este hackathon cambié el paradigma. Construí una aplicación tipo estudio completa de extremo a extremo totalmente guiada por especificaciones. El objetivo fue sencillo: ofrecer a los usuarios un entorno intuitivo para controlar y gestionar la generación de imágenes sin los prompts repetitivos ni el manejo complejo de nodos que requieren herramientas como ComfyUI.

El estudio permite generar imágenes, editar objetos dentro de ellas y refinar resultados mediante manipulación directa en lugar de depender de prompts constantes. El desarrollo todavía continúa y pronto publicaré el proyecto completo, pero aquí explico el enfoque y las piezas clave que usé: steering docs, hooks y spec prompts.

Steering doc

Comencé con los steering docs del repositorio kiro-best-practices. Proporcionan una base fuerte y muy opinada para conseguir coherencia en el desarrollo. A partir de ahí adapté las normas para que encajaran con mis preferencias y con el estilo del equipo: mantener nombres de carpetas en minúscula, evitar emojis en cualquier salida o comentario, exigir comentarios de código cortos y estructurados, y estandarizar nombres de archivo y la disposición de los módulos. Esos documentos se convirtieron en la constitución del código. Los agentes los siguieron automáticamente y eso minimizó la cantidad de instrucciones que debía incluir en cada especificación.

Hooks

Si los steering docs definen las leyes, los hooks son las herramientas reutilizables. Encapsulan acciones repetibles que el agente puede invocar cuando hace falta. Usé muchos hooks, pero tres resultaron especialmente útiles durante el hackathon. 1 Git Commit Generator Este hook analiza todos los cambios relevantes y genera mensajes de commit estructurados y significativos. 2 Cleanup Unused Files A medida que las specs evolucionan, los agentes reescriben código y se acumulan archivos antiguos. Este hook identifica puntos de entrada en frontend y backend, construye un grafo de dependencias y elimina lo que no está referenciado. 3 Reorganize Hook Las specs pueden generar docenas de archivos en una sola carpeta. El hook de reorganización agrupa archivos por característica y dependencias, lo que hace que la base de código sea más navegable y mantenible.

Specs y flujo de trabajo

Con una formación en UX, el modo especificación encaja naturalmente en mi proceso de diseño. Normalmente empiezo por el flujo de interacción: qué debe poder hacer el usuario, cuáles son sus entradas, qué etapas de procesamiento son necesarias y cuál es la salida esperada. A partir de eso Kiro deriva requisitos, documentos de diseño y tareas; luego el agente las ejecuta. Esto me permitió centrarme en arquitectura, diseño de interacción y en detectar problemas sutiles, mientras el agente se encargaba de la mayor parte de la implementación.

Resultados y discusión

Pude crear una aplicación totalmente funcional desde cero en dos semanas. Los agentes produjeron la mayor parte del código funcional y yo me centré en guiar el diseño, resolver problemas complejos y garantizar coherencia arquitectónica. Aun así aparecieron desafíos de UX interesantes que vale la pena comentar.

Gestión de requisitos, documentos de diseño y tareas

Los documentos estructurados de requisitos y diseño de Kiro son extremadamente útiles hasta que intentas editarlos manualmente. Si elimino un requisito, mi instinto es buscar un botón Guardar. En Kiro la opción es Refine que regenera el documento completo y puede descartar mis ediciones. Eso resulta contraintuitivo y genera incertidumbre sobre si los cambios se preservan. Además, refinar documentos de diseño puede sobreescribir requisitos editados, dependiendo de cómo el sistema resuelva el contexto. Esto rompe el flujo de edición esperado y exige cuidado adicional.

Gestión de contexto en las specs

A veces el agente ignora contexto existente aunque haya leído el código y los requisitos. Por ejemplo, una nueva funcionalidad necesitaba mi módulo de edición de imágenes pero el agente generó un nuevo workspace de imágenes. Asumí que lo reconciliaría durante la ejecución y no lo hizo. Hoy el desarrollador tiene la carga de recordar incluir referencias manuales con el operador numeral. Una gestión de contexto más colaborativa, donde el agente proponga contextos relevantes y pida confirmación, reduciría mucho la carga cognitiva.

Eficiencia de créditos y selección de modelos

Usé alrededor de 1100 créditos en el desarrollo. Mayormente trabajé en Auto mode y cambié a Opus 4.5 para tareas de razonamiento complejo. Auto mode ahorra créditos, pero el proceso de selección de modelos no es muy transparente. Idealmente Kiro permitiría elegir modelos por tarea o por spec, declarar que una funcionalidad use un modelo más potente y auditar qué modelos se usaron en cada tarea. A medida que bajen los costes de inferencia, espero presupuestos de créditos más flexibles.

Observaciones de UX

Destacaron dos problemas de experiencia de usuario. Primero, usar el carácter numeral como operador de referencia se sintió poco natural. En la mayoría de herramientas el operador mental por defecto es arroba y yo tecleaba arroba por inercia. Además las imágenes forman parte del contexto pero requieren una UI separada para añadirlas. Sería útil permitir personalización o un sistema unificado de referencias. Segundo, la navegación de sesiones generadas por specs no es fluida. Las tareas activas están en Task List pero las sesiones históricas exigen pulsar un pequeño botón de restaurar. Hacer clic en toda la fila de sesión sería más rápido y acorde con principios de usabilidad como la Ley de Fitts.

Reflexión final

Este hackathon demostró el potencial del desarrollo guiado por especificaciones. En solo dos semanas envié una aplicación compleja y funcional. Los agentes escalaron la implementación mientras yo me ocupaba de arquitectura, experiencia de usuario y de la lógica que requiere juicio humano. Siguen existiendo huecos de UX, especialmente en la edición de documentos y la gestión de contexto, pero la experiencia de desarrollo global fue impresionante y promete acelerar proyectos de software a gran escala.

En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida que integra prácticas modernas como el desarrollo guiado por especificaciones y agentes IA en el ciclo de desarrollo. Ofrecemos servicios de software a medida, soluciones de Inteligencia Artificial para empresas y consultoría en ciberseguridad, además de servicios cloud AWS y Azure, soluciones de inteligencia de negocio y automatización de procesos. Si buscas potenciar proyectos con agentes IA, potenciar tus informes con Power BI o asegurar tus plataformas con pentesting profesional, podemos ayudarte a diseñar e implementar la mejor solución.

Palabras clave integradas naturalmente para mejorar posicionamiento: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi. Si quieres conocer cómo aplicamos estas tecnologías en casos reales y cómo integrarlas en tu roadmap, contacta con nuestro equipo de Q2BSTUDIO y descubre proyectos que combinan diseño, ingeniería y seguridad a medida.