Product Discovery

---
layer: peripheral
name: product-discovery
description: "Usar antes de descomponer PBIs, cuando se necesita análisis JTBD y PRD del producto."
metadata:
  # --- metadata.savia.* (SE-333) ---
  savia.agent: business-analyst
  savia.maturity: beta
  savia.category: quality
  savia.context: fork
  savia.priority: medium
  savia.summary: "Analisis pre-implementacion: Jobs-to-be-Done y PRD. Cuando: antes de descomponer un PBI en tasks. Output: JTBD document + PRD con requisitos formalizados."
  savia.tags: "discovery, jtbd, prd, product"
---

# Skill: Product Discovery

## Cuándo usar esta skill

Invocar **antes** de descomponer un PBI en tasks técnicas cuando:
- El PBI es de tipo **feature** o **user story** (no bug ni chore)
- Los criterios de aceptación son vagos o inexistentes
- Se necesita formalizar el *por qué* del usuario antes del *cómo* técnico
- El `business-analyst` necesita un workflow estructurado de análisis

## Decision Checklist

Before starting discovery, answer sequentially:

1. Is the PBI type Feature or User Story (not Bug/Chore/Task)? -> If Bug/Chore: skip, go to decomposition
2. Do acceptance criteria exist? -> If NO: discovery is mandatory (start with JTBD)
3. Are acceptance criteria in Given/When/Then format? -> If NO: discovery recommended
4. Has the PO validated with a real user? -> If NO: JTBD interviews recommended
5. Is estimated effort >8 SP? -> If YES: discovery + PRD recommended before decomposition

### Abort Conditions
- No stakeholder identified -> STOP, cannot discover without user context
- Conflicting requirements detected -> STOP, escalate to stakeholder-align

---

## Qué produce

Dos documentos que preceden la descomposición técnica:

1. **JTBD (Jobs to be Done)** — captura el *por qué* del comportamiento del usuario
2. **PRD (Product Requirements Document)** — captura el *qué* del producto

## Flujo completo

```
PBI en Azure DevOps
    ↓
/pbi-jtbd {id}          ← business-analyst genera JTBD
    ↓
/pbi-prd {id}           ← business-analyst genera PRD (lee JTBD)
    ↓
/pbi-decompose {id}     ← flujo existente (architect + spec-writer + ...)
```

## Cuándo NO usar

- PBIs tipo `Bug` → no necesitan discovery, necesitan diagnóstico
- PBIs tipo `Chore` → mantenimiento técnico sin impacto de usuario
- PBIs con criterios de aceptación ya detallados y validados por el PO
- Tasks individuales que ya tienen spec SDD aprobada

## Almacenamiento

Los documentos se guardan en el directorio del proyecto:
```
projects/{proyecto}/discovery/
├── PBI-{id}-jtbd.md
└── PBI-{id}-prd.md
```

Si el directorio `discovery/` no existe, crearlo automáticamente.

## Plantillas

Las plantillas JTBD y PRD están en `references/`:
- `references/jtbd-template.md` — plantilla Jobs to be Done
- `references/prd-template.md` — plantilla Product Requirements Document

## Agente responsable

El agente `business-analyst` es quien ejecuta ambos documentos.
No delegar a `architect` ni a `sdd-spec-writer` — esto es análisis de producto,
no diseño técnico.