Skill: Diagram Generation — Arquitectura y Flujo
Propósito
Generar diagramas de arquitectura, flujo de datos y secuencia a partir de la infraestructura y código fuente de un proyecto. Exportar a Draw.io, Miro o formato local (Mermaid).
Triggers
- Comando
/diagram-generate — Genera diagrama completo
- Petición directa: "genera el diagrama de arquitectura del proyecto X"
Contexto Requerido
CLAUDE.md (raíz) — Contexto global
projects/{proyecto}/CLAUDE.md — Stack, arquitectura, repos
projects/{proyecto}/infrastructure/ — Terraform, Docker, K8s si existen
docs/rules/domain/diagram-config.md — Constantes y configuración
Fase 1: Detección de Componentes
Analizar el proyecto para identificar componentes arquitectónicos:
Fuentes de detección (prioridad)
- Infraestructura como código —
*.tf, docker-compose.yml, k8s/, helm/
- Código fuente —
*.csproj, package.json, pom.xml, go.mod, etc.
- Documentación existente —
CLAUDE.md del proyecto, architecture.md
- Azure DevOps — Repos, pipelines, service connections
Para tipo orgchart: la fuente de datos es teams/{dept}/ (dept.md + team.md de cada equipo),
NO infraestructura de proyecto. Opcionalmente enriquecer con teams/members/{handle}.md.
Entidades a detectar
Detalle: @references/diagram-entities.md
| Entidad |
Detección |
Icono |
| Microservicio / API |
*.csproj + Dockerfile |
[Nombre] |
| Base de datos |
ConnectionString, DbContext |
[(DB)] |
| Cola / Bus |
ServiceBus, RabbitMQ config |
{{Cola}} |
| API Gateway |
Ocelot, YARP, Kong |
[[Gateway]] |
| Frontend / SPA |
angular.json, next.config |
(Frontend) |
| CDN / Cache |
Redis, CloudFront |
{Cache} |
Fase 2: Generación de Modelo Mermaid
Construir la representación en Mermaid según el tipo de diagrama:
Detalle: @references/mermaid-templates.md
Tipos soportados
- Architecture — C4-style con capas (Frontend, Backend, Data)
- Flow — Data flow entre componentes
- Sequence — Secuencia temporal de interacciones
- Orgchart — Jerarquía organizativa desde datos de
teams/
Fase 3: Exportar a Herramienta MCP
3.1 Draw.io
- Convertir Mermaid → XML Draw.io
- Crear o actualizar diagrama
- Si proyecto tiene
DRAWIO_FOLDER → usar esa carpeta
3.2 Miro
- Verificar token OAuth válido
- Crear frame en board del proyecto
- Convertir entidades a shapes de Miro
3.3 Local (sin MCP)
- Guardar fichero
.mermaid en projects/{p}/diagrams/local/
- Mostrar preview en respuesta
Fase 4: Guardar Metadata
Crear projects/{p}/diagrams/{tool}/{tipo}.meta.json:
{
"tool": "draw-io",
"type": "architecture",
"name": "System Architecture — {proyecto}",
"url": "https://...",
"remote_id": "...",
"local_mermaid": "diagrams/local/architecture.mermaid",
"created": "2026-02-26T...",
"elements": { "services": 4, "databases": 2, "queues": 1 }
}
Fase 5: Presentar Resultado
✅ Diagrama generado: {tipo} — {proyecto}
🔗 URL: {link}
📊 Elementos: {N} servicios, {N} DBs, {N} colas
📁 Metadata: projects/{p}/diagrams/{tool}/{tipo}.meta.json
Referencias
references/mermaid-templates.md — Plantillas por tipo
references/diagram-entities.md — Detección de componentes
references/draw-io-shapes.md — Mapeo entidades → shapes
references/orgchart-shapes.md — Shapes de organigrama
references/orgchart-mermaid-template.md — Plantilla Mermaid para orgchart
1---2name: diagram-generation3description: "Skill: Diagram Generation — Arquitectura y Flujo"4---56# Skill: Diagram Generation — Arquitectura y Flujo78## Propósito910Generar diagramas de arquitectura, flujo de datos y secuencia a partir de la infraestructura y código fuente de un proyecto. Exportar a Draw.io, Miro o formato local (Mermaid).1112## Triggers1314- Comando `/diagram-generate` — Genera diagrama completo15- Petición directa: "genera el diagrama de arquitectura del proyecto X"1617## Contexto Requerido18191. `CLAUDE.md` (raíz) — Contexto global202. `projects/{proyecto}/CLAUDE.md` — Stack, arquitectura, repos213. `projects/{proyecto}/infrastructure/` — Terraform, Docker, K8s si existen224. `docs/rules/domain/diagram-config.md` — Constantes y configuración2324---2526## Fase 1: Detección de Componentes2728Analizar el proyecto para identificar componentes arquitectónicos:2930### Fuentes de detección (prioridad)31321. **Infraestructura como código** — `*.tf`, `docker-compose.yml`, `k8s/`, `helm/`332. **Código fuente** — `*.csproj`, `package.json`, `pom.xml`, `go.mod`, etc.343. **Documentación existente** — `CLAUDE.md` del proyecto, `architecture.md`354. **Azure DevOps** — Repos, pipelines, service connections3637Para tipo orgchart: la fuente de datos es `teams/{dept}/` (dept.md + team.md de cada equipo),38NO infraestructura de proyecto. Opcionalmente enriquecer con `teams/members/{handle}.md`.3940### Entidades a detectar4142> Detalle: @references/diagram-entities.md4344| Entidad | Detección | Icono |45|---|---|---|46| Microservicio / API | `*.csproj` + Dockerfile | `[Nombre]` |47| Base de datos | ConnectionString, DbContext | `[(DB)]` |48| Cola / Bus | ServiceBus, RabbitMQ config | `{{Cola}}` |49| API Gateway | Ocelot, YARP, Kong | `[[Gateway]]` |50| Frontend / SPA | angular.json, next.config | `(Frontend)` |51| CDN / Cache | Redis, CloudFront | `{Cache}` |5253---5455## Fase 2: Generación de Modelo Mermaid5657Construir la representación en Mermaid según el tipo de diagrama:5859> Detalle: @references/mermaid-templates.md6061### Tipos soportados6263- **Architecture** — C4-style con capas (Frontend, Backend, Data)64- **Flow** — Data flow entre componentes65- **Sequence** — Secuencia temporal de interacciones66- **Orgchart** — Jerarquía organizativa desde datos de `teams/`6768---6970## Fase 3: Exportar a Herramienta MCP7172### 3.1 Draw.io731. Convertir Mermaid → XML Draw.io742. Crear o actualizar diagrama753. Si proyecto tiene `DRAWIO_FOLDER` → usar esa carpeta7677### 3.2 Miro781. Verificar token OAuth válido792. Crear frame en board del proyecto803. Convertir entidades a shapes de Miro8182### 3.3 Local (sin MCP)831. Guardar fichero `.mermaid` en `projects/{p}/diagrams/local/`842. Mostrar preview en respuesta8586---8788## Fase 4: Guardar Metadata8990Crear `projects/{p}/diagrams/{tool}/{tipo}.meta.json`:9192```json93{94 "tool": "draw-io",95 "type": "architecture",96 "name": "System Architecture — {proyecto}",97 "url": "https://...",98 "remote_id": "...",99 "local_mermaid": "diagrams/local/architecture.mermaid",100 "created": "2026-02-26T...",101 "elements": { "services": 4, "databases": 2, "queues": 1 }102}103```104105---106107## Fase 5: Presentar Resultado108109```110✅ Diagrama generado: {tipo} — {proyecto}111🔗 URL: {link}112📊 Elementos: {N} servicios, {N} DBs, {N} colas113📁 Metadata: projects/{p}/diagrams/{tool}/{tipo}.meta.json114```115116---117118## Referencias119120- `references/mermaid-templates.md` — Plantillas por tipo121- `references/diagram-entities.md` — Detección de componentes122- `references/draw-io-shapes.md` — Mapeo entidades → shapes123- `references/orgchart-shapes.md` — Shapes de organigrama124- `references/orgchart-mermaid-template.md` — Plantilla Mermaid para orgchart