Skill: Diagram Import — Parsing, Validación y Generación de Work Items
Importa diagramas de arquitectura (Draw.io, Miro, Mermaid local), extrae entidades y relaciones, valida reglas de negocio y genera Features/PBIs/Tasks en Azure DevOps.
Principio fundamental: NO se crean PBIs sin información de reglas de negocio.
Triggers
- Comando
/diagram-import— Importación completa - Petición: "importa el diagrama y crea los PBIs"
Contexto Requerido
CLAUDE.md(raíz) — Contexto global, Azure DevOpsprojects/{proyecto}/CLAUDE.md— Stack, arquitecturaprojects/{proyecto}/reglas-negocio.md— CRÍTICOprojects/{proyecto}/equipo.md— Perfiles para asignacióndocs/rules/domain/diagram-config.md— Constantesdocs/politica-estimacion.md— Rangos de estimación
Fase 1: Obtener y Parsear
1.1 Fuentes soportadas
| Fuente | Detección | Método |
|---|---|---|
| Draw.io | draw.io/ en URL |
MCP draw-io → XML |
| Miro | miro.com/app/board/ |
MCP miro → JSON |
Local .drawio |
Extensión | Leer XML directo |
Local .mermaid |
Extensión | Parsear Mermaid |
| Meta existente | diagrams/*.meta.json |
Leer meta |
1.2 Modelo normalizado
{
"entities": [{"id": "svc-users", "type": "microservice", "name": "User Service"}],
"relationships": [{"from": "api-gateway", "to": "svc-users", "type": "http-sync"}]
}
1.3 Reconocimiento de shapes
Rectángulos→servicios, Cilindros→DBs, Hexágonos→colas, Rombos→decisiones, Redondeados→frontends, Grises/dashed→externos.
Fase 2: Validación Arquitectónica
Invocar diagram-architect para:
- Detectar ciclos de dependencias
- Validar layering correcto
- Identificar antipatrones
- Evaluar completitud
Si problemas ❌ → informar al PM.
Fase 3: Validación de Reglas de Negocio (CRÍTICO)
3.1 Cargar reglas
Leer projects/{proyecto}/reglas-negocio.md. Si no existe:
❌ Falta reglas-negocio.md
Necesito: projects/{proyecto}/reglas-negocio.md
¿Genero plantilla para completar?
3.2 Verificar por entidad
Checklist por tipo: references/templates-and-examples.md
| Tipo | Campos |
|---|---|
| Microservicio | Interfaz, schema DB, entorno, escalado |
| API | Método, path, auth, rate limit, validaciones |
| BD | Tecnología, schema, backup, escalado, retención |
| Frontend | User stories, accesibilidad, responsive |
| Cola | Formato, reintentos, DLQ, orden |
| Integración | Proveedor, SLA, fallback, credenciales, formato |
3.3 Opciones si falta info
Ver references/templates-and-examples.md — "Manejo de Información Faltante"
Fases 4-7: Generación y Creación
Detalles sobre agrupación en Features, generación de PBIs, presentación, y creación en Azure DevOps.
Ver: references/templates-and-examples.md
- Fase 4: Agrupación, generación PBIs, estimación
- Fase 5: Presentar propuesta al PM
- Fase 6: Crear en Azure DevOps
- Fase 7: Resumen final
Referencias
→ Templates & ejemplos: references/templates-and-examples.md
→ Domain mapping: references/diagram-to-domain-mapping.md
→ Business rules: references/business-rules-validation.md
→ Config: @docs/rules/domain/diagram-config.md