Agile Story & Acceptance Criteria Assistant

• 

  Resultado generado por Gemini tras consulta

Inspiration

En entornos de gestión y consultoría ágil, uno de los cuellos de botella más recurrentes ocurre durante el refinamiento de backlog: los requerimientos de negocio llegan con formulaciones vagas, ambiguas o sin criterios medibles, lo que deriva en retrabajo y malentendidos con los equipos de desarrollo. Quería construir una herramienta práctica que permitiera a Product Owners, Scrum Masters y analistas traducir necesidades informales en especificaciones técnicas de calidad inmediata.

What it does

Agile Story & Acceptance Criteria Assistant es una aplicación interactiva que toma una petición de negocio en bruto (con o sin especificación de rol) y genera al instante:

1. Historia de usuario INVEST estructurada en formato estándar ("Como [rol], quiero [acción] para [beneficio]").
2. Criterios de aceptación BDD/Gherkin detallando el camino feliz (Happy path) y escenarios de validación o control de errores (Dado que / Cuando / Entonces).
3. Dependencias técnicas e interrogantes abiertos para anticipar riesgos de integración.
4. Un botón de un solo clic para copiar la especificación completa y pegarla directamente en herramientas como Jira o Azure DevOps.

How we built it

Adoptamos un flujo riguroso plan-first y spec-driven guiado por el paquete oficial Devpost Learn Skill Pack (learn-ai-basics) junto a GitHub Copilot en Visual Studio Code:

• 1-start & 2-scope (scope.md): Entrevista inicial mediante el patrón de interacción inversa (flipped interaction pattern) para acotar el MVP y fijar límites claros (interfaz de pantalla única, sin base de datos pesada).
• 3-prd (prd.md): Definición detallada de requisitos de producto, comportamiento de la interfaz y directrices del prompt del sistema para el rol de Lead Agile Coach.
• 4-spec (spec.md): Arquitectura técnica basada en Streamlit (Python) y el SDK oficial de Google Gemini API (gemini-1.5-flash), asegurando el aislamiento de credenciales mediante .env y .gitignore.
• 5-build: Generación modular del código en app.py, resolución de dependencias en requirements.txt y validación de sintaxis con análisis estático (Pylance).
• 6-ship: Auditoría de seguridad del repositorio, verificación de los artefactos de diseño y publicación automatizada en GitHub.

Challenges we ran into

Durante la puesta en marcha local nos encontramos con un error 404 al invocar la API debido a identificadores de modelo obsoletos en la versión de biblioteca configurada. Guiados por el asistente, actualizamos el modelo canónico a gemini-1.5-flash-latest, implementamos un mecanismo de respaldo automático mediante list_models() para detectar modelos compatibles con generateContent, y configuramos el entorno virtual de Python (.venv) para garantizar ejecuciones reproducibles.

Accomplishments that we're proud of

• Desarrollar un producto completamente funcional y pulido de principio a fin manteniendo el código limpio y libre de deuda técnica (cognitive debt).
• Preservar las mejores prácticas de seguridad, garantizando que ninguna credencial privada quedara expuesta en el repositorio público de GitHub.
• Diseñar una herramienta que aporta valor real en flujos de trabajo de transformación digital y gestión ágil.

What we learned

Comprobamos de primera mano el valor de la planificación antes del código: redactar el alcance, el PRD y la especificación técnica antes de ejecutar la primera línea de programación reduce drásticamente las iteraciones erróneas y las alucinaciones del modelo.

What's next for Agile Story Assistant

• Integración directa mediante API con Jira, Azure DevOps y Notion para exportar tarjetas automáticamente al sprint.
• Compatibilidad multilingüe avanzada y opciones de exportación directa a formato de pruebas automáticas (Cucumber / Behave).

Built With

• copilot
• gemini-api
• github
• google-gemini
• python
• streamlit
• vs-code