gonzalezpazmonica/backlog-git-tracker

Skill: BacklogGit Tracker

Regla: @docs/rules/domain/backlog-git-config.md Hub: @docs/rules/domain/savia-hub-config.md

Prerequisitos

• SaviaHub inicializado: [ -d "$SAVIA_HUB_PATH/.git" ]
• Cliente y proyecto existen: [ -d "$SAVIA_HUB_PATH/clients/$CLIENT/projects/$PROJECT" ]
• Si no existe backlog-snapshots/ → crear

Flujo: Snapshot

1. Detectar fuente del backlog (por orden de prioridad):
   • AZURE_DEVOPS_ORG_URL → Azure DevOps (WIQL query)
   • JIRA_BASE_URL → Jira (JQL query)
   • GITLAB_URL → GitLab (Issues API)
   • Directorio backlog/ en proyecto → Savia Flow
   • Ninguno → modo manual (PM dicta items)
2. Extraer items: ID, título, estado, asignado, estimación (horas), prioridad, tags
3. Generar timestamp: date -u +%Y%m%d-%H%M%S
4. Crear directorio si no existe: mkdir -p backlog-snapshots/
5. Escribir snapshot markdown con frontmatter YAML + tabla
6. Calcular resumen: total, por estado, estimación total
7. Commit: [backlog-git] snapshot: $CLIENT/$PROJECT ($TOTAL items)
8. Si remote + no flight-mode → push (delegar a savia-hub-sync)
9. Mostrar banner con resumen

Flujo: Diff

1. Resolver referencias:
   • Sin flags → último vs penúltimo snapshot
   • --from YYYYMMDD → buscar snapshot con prefijo
   • Índice numérico (-1, -2) → contar desde el más reciente
2. Parsear ambos snapshots: extraer frontmatter + tabla → mapa ID→item
3. Calcular deltas:
   • Añadidos: IDs(to) - IDs(from)
   • Eliminados: IDs(from) - IDs(to)
   • Modificados: IDs(from) ∩ IDs(to) con campos diferentes
4. Para cada modificado, registrar: campo, valor anterior, valor nuevo
5. Calcular métricas: scope change %, re-estimación total Δh
6. Mostrar diff formateado con banner 📊

Flujo: Rollback (solo informe)

1. Cargar snapshot referenciado → parsear items
2. Obtener estado actual (último snapshot o query al PM tool)
3. Generar diff inverso: qué acciones serían necesarias
4. Listar acciones en formato checklist:
   • [ ] Restaurar item #{ID}: "{título}"
   • [ ] Revertir estado de #{ID}: {actual} → {original}
   • [ ] Revertir estimación de #{ID}: {actual}h → {original}h
5. NUNCA ejecutar — solo informar al PM
6. Guardar informe en output/ si se solicita

Flujo: Deviation Report

1. Listar todos los snapshots: ls backlog-snapshots/*.md | sort
2. Parsear serie temporal: para cada snapshot, extraer total, por estado, estimación
3. Calcular métricas acumuladas:
   • Scope creep: (items_final - items_inicial) / items_inicial × 100
   • Re-estimación: Σ deltas de estimación
   • Completion trend: closed/total por snapshot
   • Velocity: items cerrados entre snapshots consecutivos
4. Generar gráfico ASCII de evolución (items totales, cerrados, estimación)
5. Guardar en output/YYYYMMDD-deviation-{client}-{project}.md
6. Mostrar resumen con banner 📈

Snapshot manual

Cuando no hay PM tool conectado:

1. Pedir al PM lista de items (puede ser informal)
2. Estructurar en tabla con IDs secuenciales (M001, M002...)
3. Pedir confirmación antes de guardar
4. Mismo flujo de commit/push

Errores

| Error | Acción | |-------|--------| | SaviaHub no existe | Sugerir /savia-hub init | | Cliente no existe | Sugerir /client-create | | Proyecto no existe | Sugerir /client-edit {slug} + añadir proyecto | | Sin snapshots | Sugerir /backlog-git snapshot primero | | PM tool no accesible | Ofrecer snapshot manual |

Seguridad

• Snapshots son append-only: NUNCA modificar uno existente
• NUNCA ejecutar rollback automático — solo informar
• NUNCA incluir tokens o credentials en snapshots
• Confirmar con PM antes de push al remote