Saltar a contenido

Stories

¿Qué es una story?

Una story es la unidad más pequeña de trabajo entregable en RaiSE — una feature, una mejora, un refactor. No es un ticket de Jira ni una lista de tareas. Es un ciclo estructurado que produce artefactos trazables en cada paso, para que siempre sepas qué se construyó, por qué, y cómo se verificó.

Cada story sigue el mismo ritmo de seis pasos. Esto no es burocracia — es la disciplina que hace confiable el desarrollo asistido por IA. Cada paso alimenta al siguiente, y la review al final alimenta la memoria, que alimenta stories futuras.

Los seis pasos

Paso Skill Qué pasa Artefacto
Scope /rai-story-start Crear branch, definir qué entra y qué no story.md, scope.md
Design /rai-story-design Leer el código (gemba walk), escribir spec con ejemplos design.md
Plan /rai-story-plan Descomponer en tareas atómicas con ciclos TDD plan.md
Build /rai-story-implement RED-GREEN-REFACTOR por tarea, commit después de cada una Código + tests
Review /rai-story-review Retrospectiva, patrones capturados, checklist de arquitectura retrospective.md
Merge /rai-story-close Merge al branch de desarrollo, transición Jira, limpieza Merge commit

¿Por qué esta estructura?

Sin estructura, el desarrollo con IA se ve así: prompt → generar → esperar → arreglar → prompt → generar → acumular deuda técnica. La IA no recuerda lo que aprendió, no sigue tus reglas, y no sabe cuándo parar.

Con stories, cada pieza de trabajo:

  • Empieza con scope — previene el scope creep de "solo una cosa más"
  • Diseña antes de codear — el gemba walk (leer código real) previene componentes duplicados y enfoques incorrectos
  • Planifica antes de construir — tareas atómicas con TDD significan que cada commit está verificado
  • Revisa al final — los patrones se capturan en memoria, así el mismo error nunca pasa dos veces
  • Produce artefactos — cada decisión es trazable. "¿Por qué lo hicimos así?" tiene respuesta en el design doc

Tamaño de stories

Tamaño Story Points Tareas Cuándo usar
XS 1-2 1-2 Cambio de un solo archivo, fix de config
S 3-5 2-3 La mayoría de features y fixes
M 5-8 3-5 Cambios multi-módulo
L 8+ 5-8 Considerar dividir en un epic

Empieza con stories XS o S para aprender el ritmo. Escala una vez que el flujo se sienta natural.

Ejemplo

/rai-story-start RAISE-1234 add-user-greeting e01-my-epic

Rai crea el branch, escribe el scope commit, y estás listo para diseñar.

Siguiente paso