Version: 1.0
Fecha: 2026-04-20
Arquitecto: Carlos Alberto Torres Camargo
Definir un proceso único, auditable y replicable para generar Historias de Usuario (HU) con la calidad y el formato aprobado por el equipo de QA (referencia canónica: HU-CON-012 V2), aplicando el Manual de Identidad Visual Nebula ERP v1.4 sobre los wireframes.
El proceso cubre dos contextos y unifica ambos en la misma salida:
| Contexto | Entrada | Se usa cuando |
|---|---|---|
| 1 · HU desde cero | Template TEMPLATE_HU_V2_BLANK.yaml (wireframe-first) |
El equipo funcional/QA necesita redactar una HU nueva |
| 2 · HU existente | PDF V1 + anexos (flujo + casos de prueba) | Ya hay una HU V1 cruda entregada por consultoría |
Ambos caminos producen el mismo artefacto final: HU-<COD>-V2.docx con identidad visual Nebula aplicada → PDF al exportar desde WPS Office.
Regla de flujo: si no hay HU previa (Contexto 1), la salida del template se convierte en la entrada del Contexto 2 para aplicar el pipeline de síntesis + validación. Es decir: el Contexto 2 es siempre el que termina.
| # | Documento | Para quién | Cuándo leerlo |
|---|---|---|---|
| 00 | Overview del proceso | Todos los roles | Primer contacto |
| 01 | Contexto 1 · HU desde cero (wireframe-first) | Consultoría / QA / Arquitectura | Cuando no hay HU V1 previa |
| 02 | Contexto 2 · HU existente (V1 → V2) | Arquitectura | Cuando hay HU V1 cruda |
| 03 | Fases del pipeline (A–E) | Arquitectura / DevOps | Para entender o depurar cada fase |
| 04 | Estándar visual Nebula v1.4 aplicado | Cualquier rol que diseñe wireframes | Para saber qué tokens / componentes usar |
| 05 | Configuración Claude (API / Code / SDK) | DevOps / Arquitectura | Al configurar el entorno corporativo |
| 06 | Scripts y automatización | Arquitectura / DevOps | Operación diaria del pipeline |
| 07 | Validación y auditoría | Arquitectura / QA | Al cerrar cada HU |
| 08 | Guía de replicación (onboarding) | Nuevo miembro | Primer día trabajando en el backlog |
| 09 | Prueba piloto sobre Sprint-02 | Todos | Para ver resultados reales |
┌─────────────────────────────────────────────────────────────────────────┐
│ GENERACIÓN DE HU │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ CONTEXTO 1 · SIN HU PREVIA CONTEXTO 2 · CON HU V1 │
│ ───────────────────────── ────────────────────── │
│ │
│ Equipo funcional / QA Consultoría entrega V1 │
│ │ │ │
│ ▼ ▼ │
│ TEMPLATE_HU_V2_BLANK.yaml PDF V1 + Anexos │
│ (rellenar: wireframe, (texto + mockups) │
│ campos, reglas, CAs) │ │
│ │ ▼ │
│ │ Fase A · Extracción │
│ │ │ │
│ │ ▼ │
│ │ Fase B · Wireframes │
│ │ (LLM-vision) │
│ │ │ │
│ │ ▼ │
│ │ Fase C · Mapeo │
│ │ (LLM + GATE humano) │
│ │ │ │
│ └──────────────────────┬───────────────────┘ │
│ │ │
│ ▼ │
│ hu_spec.yaml unificado │
│ │ │
│ ▼ │
│ Fase D · Síntesis DOCX │
│ (04_generate + 05_render wireframe) │
│ │ │
│ ▼ │
│ HU-<COD>-V2.docx │
│ │ │
│ ▼ │
│ Fase E · Validación │
│ (grafo + cobertura + Gherkin + gate QA) │
│ │ │
│ ▼ │
│ Export PDF (WPS Office) │
│ │ │
│ ▼ │
│ Downstream Pipeline HTU v5.0 │
│ (no forma parte de este proceso) │
└─────────────────────────────────────────────────────────────────────────┘
#0E58A9 como primario, Open Sans como fuente, lucide como iconografía. Cualquier wireframe que no siga el manual es no-conforme.<TIPO>-ALC<N>-<NN> y referencias cruzadas explícitas.| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.0.0 | 2026-04-20 | Carlos Torres | Creacion de la seccion a partir del piloto HU-CON-012 |