# Rules Traceability

> Skill: Business Rules to PBI Mapping with Traceability

- Skill: `gonzalezpazmonica/rules-traceability` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add gonzalezpazmonica/rules-traceability`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gonzalezpazmonica/rules-traceability/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gonzalezpazmonica (https://skillmd.com/u/gonzalezpazmonica)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gonzalezpazmonica/rules-traceability

---


# 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:

```bash
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

```bash
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:
```bash
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`

