Version: 1.0 · Fecha: 2026-04-20
Antes del Sprint-02 de Contabilidad, las HUs que entregaba consultoría eran inconsistentes: campos sin prototipo, RN implícitas, CAs sin Gherkin, estados heterogéneos. QA diseñó un modelo nuevo (piloto HU-CON-012 V2) que es más robusto pero cuesta ~8 días de trabajo manual producirlo. Replicar eso para cada HU del backlog es inviable económicamente.
Este proceso automatiza la generación de HUs en ese formato V2, reduciendo el tiempo manual a ~1.5 días con un solo gate humano, aplicando además el Manual de Identidad Visual Nebula v1.4 que el piloto QA no aplicaba.
Un documento DOCX con esta estructura canónica:
| Sección | Contenido |
|---|---|
| Cabecera (tabla 4×3) | Código HU, Módulo, Sub-módulo, Versión, Fecha, Responsable, Complejidad, Prioridad |
| Descripción (tabla 4×2) | Como / Quiero / Para |
| Alcance Funcional (opcional) | Precondiciones globales, supuestos, fuera de alcance |
| Por cada ALCANCE N: | |
| · Título (tabla 1×1) | ALCANCE N |
| · Detalle funcional | Tabla con FN-ALCn-## (una por botón/sección/acción) |
| · Wireframe | Imagen PNG del mockup Nebula (embebida) |
| · Especificación de campos | Tabla 6 columnas (Nombre / Tipo / Obligatorio / Formato / Validación / Comportamiento) |
| · Reglas de negocio | Tabla con RN-ALCn-## referenciando la FN que implementan |
| · Criterios de aceptación | Tabla con CA-ALCn-## en Gherkin (Dado / Cuando / Entonces / Y aplica RN / Y aplica INT) |
| Anexos | Referencias a diagramas, casos de prueba, etc. |
Referencia canónica: HU-CON-012 V2 Causación de Cuenta Modelo Privado.docx (piloto QA 2026-04-10).
Cuándo: el equipo funcional / QA / Arquitectura identifica una funcionalidad nueva que necesita documentarse y no existe HU V1 previa.
Entrada: plantilla vacía TEMPLATE_HU_V2_BLANK.yaml (se describe en 01_CONTEXTO_1_HU_DESDE_CERO).
Principio rector: primero se define cada wireframe (layout:), luego se derivan los campos de él, luego las reglas de negocio y los criterios. El wireframe manda.
Tiempo objetivo: 4-8 horas de redacción por HU.
Cuándo: consultoría entregó una HU V1 cruda (caso del Sprint-02) y hay que llevarla al formato V2.
Entrada: PDF V1 + anexos (diagrama de flujo + casos de prueba).
Principio rector: el pipeline de 5 fases (A–E) extrae el contenido del V1, interpreta los wireframes con LLM-vision, mapea narrativa ↔ interfaz, sintetiza el DOCX V2 y valida el resultado. Un único gate humano (Fase C) revisa ambigüedades.
Tiempo objetivo: 1–1.5 días por HU con gate humano de 15–30 min.
El YAML que produce el Contexto 1 es exactamente el mismo formato que consume la Fase D del Contexto 2 (hu_spec.yaml). Por eso:
Esto garantiza que existe un solo generador y un solo validador, sin duplicación.
| Artefacto | Descripción |
|---|---|
HU-<COD>-V2.docx |
DOCX con identidad Nebula v1.4, tablas QA, 1 wireframe PNG por INT |
HU-<COD>-V2.pdf |
PDF exportado desde WPS Office (paso manual de 2 clics hasta que se monte LibreOffice headless en CI) |
hu_spec.yaml |
Fuente estructurada (reutilizable, editable) |
_rendered/*.png |
Los wireframes generados (útiles para reportes y reutilización) |
reporte_validacion.md |
Veredicto Fase E (grafo + cobertura + Gherkin + 7 dimensiones) |
pipeline_run.log |
Log auditable con timestamps, herramientas usadas y checksums |
| Herramienta | Rol | Etapa |
|---|---|---|
pdftotext, pdfimages, pdftoppm (poppler-utils) |
Extracción de PDF | Fase A |
| Python 3.10 + venv | Runtime de scripts | Todas las fases |
python-docx |
Generación del DOCX | Fase D |
WeasyPrint + Jinja2 + Pillow |
Renderizado de wireframes | Fase D |
| Claude Sonnet 4.6 / Opus 4.7 (LLM-vision + texto) | Interpretación de mockups y mapeo | Fases B y C |
| Claude Code (subagentes + skills) | Orquestación automatizada | Todas las fases |
| Claude API / SDK | Integración cuando la empresa compre Claude | Producción |
| WPS Office | Export DOCX → PDF | Post-generación |
| LibreOffice (futuro, CI) | Export automático DOCX → PDF | Producción |
Detalle de la configuración Claude en 05_CONFIGURACION_CLAUDE.
| Métrica | Manual (antes) | Pipeline (ahora) | Mejora |
|---|---|---|---|
| Tiempo total por HU | 8 días | 1–1.5 días | ~80% reducción |
| Tiempo humano (gate) | 8 días | ~30 min | 99% reducción |
| Cobertura funcional V1→V2 | depende de consultor | 100% (10/10 INTs validados) | determinista |
| Aplicación manual visual Nebula v1.4 | 0% | 100% (9/9 tokens) | cumple estándar |
| Idempotencia | No | Sí | garantizada |
| Version | Fecha | Autor | Descripcion |
|---|---|---|---|
| 1.0.0 | 2026-04-20 | Carlos Torres | Overview inicial |