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 Diseño 3.0 (antes, el Manual de Identidad Visual 1.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 tablas QA y 1 wireframe PNG por INT en el Manual de Diseño 3.0 |
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 |