Skill: Business Rules to PBI Mapping with Traceability
Mapea reglas de negocio (RN-XXX-NN) a Product Backlog Items, creando una matriz de trazabilidad bidireccional que identifica cobertura de reglas, análisis de brechas y propuestas de PBIs faltantes.
Prerequisitos: ../azure-devops-queries/SKILL.md, ../product-discovery/SKILL.md
Fases
Fase 1: Parsear reglas de negocio
Leer projects/{project}/reglas-negocio.md. Extraer todos los patrones RN-XXX-NN:
grep -oE 'RN-[A-Z0-9]+-[0-9]+' reglas-negocio.md | sort -u
Para cada RN: ID, descripción (párrafo siguiente), tipo (simple/feature).
Fase 2: Consultar PBIs existentes en Azure DevOps
curl -s -u ":$(cat $PAT_FILE)" \
"$AZURE_DEVOPS_ORG_URL/{proyecto}/_apis/wit/wiql?api-version=7.1" \
-d "{'query':'SELECT [System.Id] FROM workitems'}" | jq '.workItems[].id'
Buscar referencias RN en: Title, Description, Tags.
Fase 3: Construir matriz de trazabilidad
| RN-ID | Descripción | PBI-IDs cubriendo | Cobertura |
|---|---|---|---|
| RN-001-01 | ... | [302, 305] | Completa |
| RN-001-02 | ... | [302] | Parcial |
| RN-002-01 | ... | — | Ninguna |
Fase 4: Análisis de brechas
Para cada RN sin cobertura o cobertura parcial:
- Si regla simple → proponer PBI directo (título, descripción, criterios de aceptación)
- Si regla feature → flagear para product-discovery (JTBD + PRD antes de crear PBI)
Fase 5: Propuesta de PBIs
Presentar al PM (sin ejecutar):
Título: {inferido de RN}
Descripción: {de RN}
Criterios de aceptación: {derivados de RN}
Tags: [RN-XXX-NN]
Prioridad: (sugerir basado en dependencias)
Fase 6: Crear en Azure DevOps
Tras confirmación:
curl -X POST -u ":$(cat $PAT_FILE)" \
"$AZURE_DEVOPS_ORG_URL/{proyecto}/_apis/wit/workitems/\$PBI?api-version=7.1" \
-d "fields"
Fase 7: Generar reporte
Guardar matriz a output/YYYYMMDD-traceability-{project}.md con:
- Matriz RN↔PBI
- Estadísticas de cobertura (%)
- Recomendaciones
Referencias
→ Azure DevOps API: docs/azure-devops-api-patterns.md
→ Product Discovery: ../product-discovery/SKILL.md