Diagram Design: explicaciones visuales con evidencia
Adoptar Diagram Design en equipo: revisión del paquete, perfiles y entrega de archivos
Separa la instalación de las herramientas de autoría de la publicación del resultado y evita carreras sobre un estilo compartido.
Qué aprenderás
- Hay dos problemas de despliegue
- Evita elegir marcas mediante estado mutable compartido
- Valida el destino de publicación
Antes de empezar
- Conceptos básicos de HTML y SVG
- Distinguir una relación del sistema de su disposición visual
Elige una representación útil, explica simplificaciones e interpreta hallazgos dentro de su alcance real.
Conclusiones clave
- Instalar herramientas de autoría y publicar archivos son operaciones distintas.
- Los perfiles seleccionados por proyecto evitan carreras sobre estilos compartidos.
- Verifica fuentes, URL y caché en el destino real.
Hay dos problemas de despliegue
El paquete de autoría se usa en un host compatible, mientras que el HTML generado o la imagen exportada se entrega en una web documental, presentación u otro destino. Instalar la habilidad no publica un artículo, y subir un diagrama no instala herramientas para los compañeros. Asigna responsables a ambos flujos.
Registra la revisión del código, no solo una versión legible. El repositorio contiene manifiestos de hosts que apuntan a un directorio de habilidades compartido. Esto reduce instrucciones duplicadas, pero cada host conserva sus mecanismos de instalación, descubrimiento y actualización. Aquí se inspeccionaron metadatos sin instalar desde ningún marketplace.
Evita elegir marcas mediante estado mutable compartido
Las actualizaciones administradas pueden reemplazar modificaciones de la guía de estilo instalada. El diseño documentado guarda perfiles como instantáneas fuera de la instalación y permite que un marcador de proyecto seleccione un nombre validado. La resolución por marcador lee ese perfil directamente, evitando que dos proyectos sobrescriban el mismo archivo para usar marcas distintas.
El marcador y la instantánea deben tener responsables claros. Un perfil ausente, esquema antiguo o cambio de marca sin revisar requiere una decisión explícita, no sustituir silenciosamente los colores por los de otro cliente. El ejemplo siguiente documenta el formato; esta revisión no lo escribió en un directorio de perfiles del usuario.
Valida el destino de publicación
Para artículos, inspecciona la URL real del recurso, la caché y la disponibilidad de fuentes en el sitio desplegado. La exportación PNG documentada añade automatización de navegador y Chromium, una superficie de dependencias distinta de abrir marcado estático. Decide qué archivos y herramientas necesita realmente el entorno de entrega.
La aceptación debería incluir una sesión nueva del host, dos proyectos con marcas diferentes, una figura a la anchura de destino y una reversión de actualización. Ninguna de esas integraciones queda demostrada por los casos geométricos. No se instaló el host, modificaron perfiles, publicó en producción ni completó una exportación.
Pasos de implementación
- 1
Registra revisión y host previsto.
- 2
Asigna responsables a perfiles y marcadores.
- 3
Prueba autoría y entrega como flujos separados.
- 4
Conserva el paquete y archivos aprobados anteriores para revertir.
Ejemplo para copiar
# Contenido de ejemplo del marcador .diagram-design del proyecto
# Requiere un perfil aprobado existente; no se escribió aquí
profile: acme-docsPreguntas frecuentes
¿Instalar el plugin publica el diagrama?
No. Habilita la autoría en un host. Tu proceso de entrega web o documental todavía debe publicar el archivo resultante.
¿Por qué no cambiar la misma guía instalada para cada cliente?
Las actualizaciones pueden reemplazarla y los proyectos paralelos pueden sobrescribirse. El modelo de marcador y perfil separa la selección del proyecto de ese archivo compartido.
Fuentes
- .codex-plugin/plugin.jsonFuente verificada 2026-09-08
- docs/adr/0006-client-profiles-and-marker-first-resolution.mdFuente verificada 2026-09-08
- README.mdFuente verificada 2026-09-08