¿Qué hace diagramas-de-arquitectura-honestos?
Dibuja diagramas honestos de topología de servicios y rutas de solicitudes. Úselo para mapear cómo una solicitud llega a un servicio o para convertir manifiestos/seguimientos en un boceto de arquitectura. Separa la ruta verificada de los acompañantes inferidos; nunca inventa componentes.
Uso
Proporcione un manifiesto, datos de seguimiento o una descripción textual del flujo de la solicitud. La habilidad generará un diagrama Mermaid que muestra:
- Componentes verificados (línea sólida): aquellos confirmados por los datos de entrada (por ejemplo, un Pod de Kubernetes que aparece en un seguimiento o un Deployment definido en un manifiesto).
- Acompañantes inferidos (línea discontinua): aquellos que el sistema infiere que existen basándose en el contexto (por ejemplo, un balanceador de carga o una base de datos no documentada), pero que no están directamente confirmados.
- Ruta de la solicitud: la secuencia exacta de saltos que realiza una solicitud.
Ejemplo
Entrada: Un archivo deployment.yaml de Kubernetes con un Deployment frontend, un Service frontend-svc y un Ingress frontend-ingress. Además, un seguimiento que muestra una solicitud que pasa de frontend a backend.
Salida: Un diagrama Mermaid que muestra frontend-ingress → frontend-svc → frontend (Pod) → backend (Pod), con backend marcado como verificado, y posiblemente un cluster-issuer inferido como acompañante.
Plataformas compatibles
- Claude Code
- Cursor
- Codex
- Otros agentes de IA que admitan la generación de diagramas Mermaid.
Cómo funciona
- Analiza la entrada: Lee manifiestos (YAML/JSON), seguimientos (OpenTelemetry, Jaeger) o descripciones textuales.
- Extrae componentes: Identifica servicios, pods, ingress, etc.
- Clasifica: Divide en componentes verificados (evidencia directa) e inferidos (deducciones contextuales).
- Genera el diagrama: Crea código Mermaid con estilos diferenciados para cada clase.
Limitaciones
- No admite diagramas UML ni de flujo de datos.
- La inferencia de acompañantes puede ser inexacta si los datos de entrada son insuficientes.
- Solo genera diagramas Mermaid en la salida actual (no SVG/PNG directamente).