Para un hackathon temático de Halloween decidí crear la Línea Directa Psíquica IA, una aplicación web donde el usuario elige un reino, formula una pregunta, el sistema extrae cartas del tarot y una inteligencia artificial genera una fortuna temática que se puede leer y opcionalmente escuchar en una interfaz inspirada en Halloween.
En lugar de lanzarme a programar de forma improvisada, seguí un flujo guiado por especificaciones con Kiro: primero PRD SRS SDD, luego una especificación Kiro y finalmente implementación y controles de calidad. Este enfoque permitió mantener el proyecto estructurado y coherente durante todo el desarrollo del hackathon.
Comencé creando tres documentos clave. El PRD describió los objetivos generales flujos principales usuarios objetivo y restricciones del hackathon. El SRS detalló requisitos funcionales y no funcionales usando el patrón EARS y reglas de calidad al estilo INCOSE. El SDD definió la arquitectura y el diseño con Next.js App Router modelo de datos del tarot integración con LLM rutas API y la estrategia de manejo de errores.
Un ejemplo de requisito EARS del SRS fue WHEN the user submits a valid question THE SYSTEM SHALL generate a new reading by drawing 3–5 tarot cards and calling the LLM to produce a fortune based on the cards and the question, traducido y adaptado para quedar claro y testeable en el especificado.
Al introducir estos documentos en Kiro pedí que los convirtiera en una spec Kiro usando el flujo spec driven. Kiro generó un conjunto de archivos bajo .kiro/specs/ai-psychic-hotline con requirements.md design.md y tasks.md. requirements.md fusionó PRD y SRS en requisitos EARS e historias de usuario cubriendo entrada de preguntas texto opcional STT spreads de tarot por reinos generación de fortunas por LLM TTS opcional recomendaciones estilo película y un medidor del destino junto con diseño de privacidad y manejo de errores.
design.md transformó el SDD en detalles técnicos: arquitectura Next.js App Router un módulo TarotDeck y FortuneService el contrato POST /api/fortune modelos de datos para cartas y lecturas una capa de servicios para la lógica de negocio y consideraciones básicas de seguridad además de ideas para un fondo de niebla 3D tipo Vanta.
tasks.md organizó el trabajo en orden lógico: puesta en marcha del proyecto datos del tarot y tipos TypeScript servicios y endpoints backend componentes UI características de voz opcionales integración de oráculo de películas y pulido visual pruebas y documentación. De esta forma mis documentos iniciales pasaron a una guía accionable que Kiro podía seguir paso a paso.
En la práctica utilicé dos estilos de trabajo con Kiro: implementación estricta guiada por la spec para la lógica central y contratos y un modo mas creativo que llamé vibe coding para la UI microcopy e interacciones. En lo backend me mantuve fiel al diseño pidiendo implementar TarotDeck y tipos Card exactamente como en design.md y crear la ruta POST /api/fortune según el contrato. Kiro generó tipos TypeScript para Card y ReadingResponse un TarotDeck que carga definiciones y extrae una tirada sin duplicados y la ruta API que valida la pregunta construye el prompt para el LLM y devuelve JSON con cards fortune y movieRecommendation opcional.
Para la interfaz y el tono adopté un enfoque conversacional pidiendo componentes React para entrada de preguntas tirada de cartas y vista de fortuna conectados a /api/fortune escribir microcopy temático y añadir animaciones sutiles e integrar un fondo de niebla 3D. Ese estilo permitió iterar rápido en presentación y experiencia manteniendo la estructura que imponía la spec.
Para controlar estilo y comportamiento creé steering docs. Un documento definió colores y tipografías para evitar paletas indeseadas y un pequeño manual indicó no usar tonos que rompieran la identidad visual y preferir serif en títulos y sans en cuerpo. Otro steering doc definió la persona del psíquico reglas de tono y límites como fortunas entre 3 y 6 oraciones mención de las cartas por nombre y prohibición de afirmaciones sobre salud o lotería. Un tercer doc fijó convenciones de ingeniería como mantener la lógica de negocio en servicios y usar TypeScript estrictamente.
También configuré agent hooks para automatizar reacciones ante cambios clave. Al guardar archivos en src/services o módulos del tarot se ejecutaban pruebas y smoke tests que llamaban a /api/fortune con una pregunta de muestra y verificaban que la respuesta incluyera cartas y una fortuna con la forma esperada. No sustituye CI completo pero ayudó a detectar regresiones durante refactorizaciones rápidas del hackathon.
Además añadí comprobaciones de calidad específicas con herramientas MCP. Un validador de mazo tarot comprobaba inconsistencias en tarot.json y un verificador de calidad de fortunas muestreaba textos comprobaba longitud según las pautas detectaba la presencia de nombres de cartas y evaluaba tono por reino. Estas comprobaciones permitieron medir y ajustar prompts y límites de tokens para conseguir fortunas más ajustadas al estilo deseado.
En cuanto a experiencia de usuario pulí detalles para que la aplicación pareciera un espacio de lectura: seleccionar reino antes de preguntar con descripciones cortas de Amor Destino y Sombras pantalla de pregunta con microcopy evocador animaciones de barajar un mensaje de error temático y un medidor del destino que permite aceptar o desafiar la lectura. Detalles pequeños que juntos generaron una experiencia coherente y inmersiva.
Como empresa Q2BSTUDIO aportamos experiencia en desarrollo de aplicaciones y software a medida especialistas en inteligencia artificial y ciberseguridad, y ofrecemos servicios cloud aws y azure y soluciones de inteligencia de negocio con Power BI. Si su proyecto requiere integrar capacidades avanzadas de IA en un producto a medida podemos ayudar desde la especificación hasta la entrega continua y la seguridad operativa. Conozca nuestras soluciones de IA para empresas en servicios de inteligencia artificial y descubra cómo desarrollamos aplicaciones y software a medida en aplicaciones a medida y software a medida.
Conclusiones: usar Kiro en este proyecto fue colaborar con una herramienta que entiende estructura estilo y flujo de trabajo. Mi receta reproducible fue empezar con especificaciones ligeras dejar que Kiro genere una spec y tareas añadir steering docs temprano y luego incorporar hooks y herramientas MCP mientras las funciones principales se consolidaban. El resultado fue un prototipo pulido y temático sin sacrificar velocidad de iteración ideal para hackathons y proyectos de prototipado rápido.
Palabras clave relevantes para este artículo incluyen 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, reflejando la gama de servicios que Q2BSTUDIO ofrece para llevar ideas a producción segura y escalable.
