Guía de Gestión del Backlog

Flujo de trabajo completo para crear y gestionar un backlog SCRUM con Claude-Craft.

---

Visión General

Claude-Craft proporciona un conjunto completo de comandos para gestionar tu product backlog siguiendo la metodología SCRUM:

• 15 comandos slash para operaciones de backlog
• 5 plantillas para estructura consistente
• Vertical slicing obligatorio en todas las capas tecnológicas
• Validación del modelo INVEST para las User Stories

Filosofía

Basada en:

• Principios del Manifiesto Ágil
• Los 12 Principios Ágiles
• Fundamentos de SCRUM
• Vertical slicing (cada US atraviesa todas las capas)

---

Generación Inicial del Backlog

Desde Especificaciones

Coloca las especificaciones de tu proyecto en ./docs/ y luego ejecuta:

/project:generate-backlog symfony+flutter

Estructura Generada

project-management/
├── README.md                    # Visión general del proyecto
├── personas.md                  # Personas de usuario (mín. 3)
├── definition-of-done.md        # Niveles de DoD progresivos
├── dependencies-matrix.md       # Dependencias entre EPICs y US
├── backlog/
│   ├── epics/                   # Archivos EPIC-XXX-nombre.md
│   └── user-stories/            # Archivos US-XXX-nombre.md
└── sprints/
    └── sprint-XXX-objetivo/     # Planes de sprint

---

Estructura SCRUM

Personas

Se requieren mínimo 3 personas, cada una con:

• Identidad: Nombre, rol, datos demográficos
• Objetivos: Lo que quieren lograr
• Frustraciones: Puntos de dolor que resolver

Formato: P-001, P-002, P-003...

EPICs

Funcionalidades grandes que contienen múltiples User Stories:

Campo	Descripción
ID	Identificador único (EPIC-001, EPIC-002...)
MMF	Minimum Marketable Feature
Estado	Draft, Ready, In Progress, Done
Objetivos de Negocio	Por qué este EPIC es importante
Criterios de Éxito	Cómo medir el éxito

User Stories

Siguen el modelo INVEST:

Letra	Significado	Validación
I	Independent (Independiente)	Sin dependencias de otras US
N	Negotiable (Negociable)	Los detalles pueden discutirse
V	Valuable (Valiosa)	Aporta valor al usuario
E	Estimable	Puede dimensionarse en puntos
S	Sized (Dimensionada)	Máx. 8 story points
T	Testable (Verificable)	Tiene criterios de aceptación claros

Las 3 C

1. Card (Tarjeta): Descripción breve
2. Conversation (Conversación): Detalles de la discusión
3. Confirmation (Confirmación): Criterios de aceptación

Criterios de Aceptación (Gherkin)

Cada US requiere:

• 1 escenario nominal (happy path)
• 2 escenarios alternativos
• 2 escenarios de error

Scenario: El usuario inicia sesión correctamente
  Given un usuario registrado con credenciales válidas
  When envía el formulario de inicio de sesión
  Then debería ver su panel de control
  And se debería crear una sesión

Tareas

Elementos de trabajo técnico dentro de una User Story:

Tipo	Descripción	Duración Típica
[DB]	Base de datos (entidades, migraciones)	1-3h
[BE]	Backend (servicios, APIs)	2-4h
[FE-WEB]	Frontend Web (controladores, plantillas)	2-4h
[FE-MOB]	Frontend Móvil (pantallas, blocs)	3-5h
[TEST]	Testing (unitario, integración, E2E)	2-4h
[DOC]	Documentación	0.5-1h
[OPS]	DevOps (CI/CD, despliegue)	1-2h
[REV]	Revisión de código	1-2h

Reglas de estimación:

• Duración de tarea: 0.5h - 8h máx.
• Story points (Fibonacci): 1, 2, 3, 5, 8, 13, 21
• Tamaño máx. de US: 8 puntos (dividir si es mayor)

---

Flujo de Trabajo

Flujo de Estados

┌─────────┐     ┌─────────────┐     ┌──────┐
│  To Do  │ ──→ │ In Progress │ ──→ │ Done │
└─────────┘     └─────────────┘     └──────┘
     │                │
     │                ↓
     └────────→ ┌─────────┐
                │ Blocked │
                └─────────┘
                     │
                     ↓
              ┌─────────────┐
              │ In Progress │
              └─────────────┘

Transiciones prohibidas:

• To Do → Done (debe pasar por In Progress)
• Cualquier estado → To Do (excepto reapertura manual)

---

Referencia de Comandos

Comandos de Creación

Comando	Descripción
/project:generate-backlog [stack]	Generar backlog completo desde specs
/project:add-epic	Crear un nuevo EPIC
/project:add-story	Añadir una User Story a un EPIC
/project:add-task	Crear una tarea técnica para una US

Comandos de Visualización

Comando	Descripción
/project:list-epics	Mostrar todos los EPICs con su estado
/project:list-stories [filtro]	Listar User Stories (por EPIC, Sprint, Estado)
/project:list-tasks [filtro]	Listar tareas (por US, Sprint, Tipo, Estado)
/project:board [sprint]	Mostrar tablero Kanban
/sprint:status [sprint]	Informe detallado de progreso del sprint

Comandos de Actualización

Comando	Descripción
/sprint:transition [id] [estado/sprint]	Cambiar estado de US o asignarla a un sprint
/project:move-task [id] [estado]	Cambiar estado de una tarea
/project:update-epic [id]	Modificar un EPIC existente
/project:update-story [id]	Modificar una User Story existente

Comandos Avanzados

Comando	Descripción
/project:decompose-tasks [sprint]	Descomponer las US del sprint en tareas
/gate:validate-backlog	Auditar la calidad del backlog (conformidad SCRUM)

---

Ejemplo Completo: Proyecto Nuevo

Paso 1: Generar el Backlog Inicial

# Asegúrate de que las specs estén en ./docs/
/project:generate-backlog symfony+flutter

Paso 2: Validar la Calidad

/gate:validate-backlog

Esto genera scrum-validation-report.md con:

• Puntuación de conformidad INVEST
• Verificación de las 3 C
• Análisis de criterios SMART
• Consistencia de estimaciones

Paso 3: Revisar el Sprint 1

/project:board 1

Muestra el tablero Kanban con columnas:

• To Do | In Progress | In Review | Done | Blocked

Paso 4: Descomponer en Tareas

/project:decompose-tasks 1

Crea un desglose detallado de tareas:

• Tareas agrupadas por US
• Grafo de dependencias (Mermaid)
• Estimaciones de tiempo por capa

Paso 5: Empezar a Trabajar

# Mover la primera tarea a en progreso
/project:move-task TASK-001 in-progress

# Después, marcar como hecha
/project:move-task TASK-001 done

# Si está bloqueada
/project:move-task TASK-002 blocked "Esperando specs de la API"

Paso 6: Seguir el Progreso

/sprint:status 1

Paso 7: Configurar Monitoreo Recurrente (Opcional)

Usa /loop (v2.1.71+) para monitorear automáticamente el progreso del sprint:

# Verificar el estado del sprint cada 30 minutos
/loop 30m /sprint:status 1

# Ejecutar verificaciones pre-commit cada 5 minutos durante el desarrollo
/loop 5m /common:pre-commit-check

Alias: /proactive (v2.1.105+).

Muestra:

• Progreso global y burndown
• Métricas por User Story
• Bloqueantes y riesgos
• Acciones recomendadas

---

Plantillas

Claude-Craft proporciona 5 plantillas para una estructura de backlog consistente:

Plantilla	Propósito
epic.md	Estructura de archivo EPIC con metadatos, objetivos y lista de US
user-story.md	Estructura de US con criterios Gherkin y tabla de tareas
task.md	Estructura de tarea con checklist de DoD
board.md	Tablero Kanban con cálculo de métricas
index.md	Índice del backlog con resumen global

---

Reglas SCRUM Aplicadas

Regla	Valor
Duración del sprint	2 semanas (fija)
Velocidad	20-40 puntos/sprint
Tamaño máx. de US	8 puntos (dividir si es mayor)
Escala de estimación	Fibonacci (1, 2, 3, 5, 8, 13, 21)
Duración de tarea	0.5h - 8h máx.

Sprint 1: Walking Skeleton

El primer sprint debe incluir:

• Configuración completa de la infraestructura
• 1 funcionalidad end-to-end (no solo configuración)
• Verificable tanto en Web como en Móvil

Vertical Slicing

Cada User Story DEBE atravesar todas las capas:

UI (Web/Móvil) → API → Lógica de Negocio → Base de Datos

No se permiten User Stories solo de "Backend", solo de "Frontend" o solo de "Móvil".

---

Checklist: Backlog Listo

• [ ] Mínimo 3 personas definidas
• [ ] Los EPICs tienen MMF y criterios de éxito
• [ ] Las User Stories siguen el modelo INVEST
• [ ] Criterios de aceptación en formato Gherkin
• [ ] Historias estimadas en puntos Fibonacci
• [ ] Sprint 1 = Walking Skeleton
• [ ] Definition of Done documentada
• [ ] Backlog validado (/gate:validate-backlog)

---

← Solución de Problemas | Siguiente: Configuración de Proyecto Nuevo →