Diagramas para Agentes

¿Qué hace Diagramas para Agentes?

Elige el visual antes de dibujarlo. Por defecto, usa el Modo Local para que el material fuente del usuario permanezca en su máquina. Usa el Modo Verificado solo cuando el usuario solicite un juicio automático del framework, un fundamento más sólido o un resultado de API/MCP.

Flujo de Trabajo

1. Lee el contexto proporcionado e identifica la decisión del lector.

2. Lee references/visual-selection.md. Elige una familia compatible y un ajuste preestablecido de destino.

3. Para una salida con marca, lee references/brand.md. Propón tokens extraídos antes de guardarlos.

4. Crea una especificación JSON usando assets/spec.example.json como plantilla. Mantén la fuente completa del usuario en source; adjunta una cita exacta de evidence a cada afirmación cuando la familia seleccionada lo requiera.

5. Renderiza y valida:

   node <skill-dir>/scripts/render.mjs input.diagrams-for-agents.json output.html --svg output.svg --receipt output.receipt.json
   node <skill-dir>/scripts/validate-artifact.mjs output.html
   

6. Muestra el artefacto HTML e informa la familia elegida, cualquier elemento omitido deliberadamente y si el fundamento es local-exact-quote o verified.

Selección de Modo

Modo Local — predeterminado

• Sin cuenta, clave API, renderizador alojado ni carga de contenido.
• Familias compatibles: swot, quadrant, comparison, flow, timeline, architecture.
• Produce HTML editable con SVG incrustado, SVG independiente opcional y un recibo legible por máquina.
• El renderizador rechaza familias no compatibles, valores de tema inseguros, ID duplicados, conexiones colgantes y evidencia de cita exacta faltante.

Modo Verificado — explícito

Lee references/verified-mode.md. Usa la herramienta MCP render_diagram instalada cuando esté disponible. De lo contrario, llama a la API documentada de Diagramas para Agentes solo después de confirmar que el usuario se siente cómodo enviando el contexto proporcionado a Diagramas para Agentes.

El Modo Verificado es la elección correcta cuando:

• el usuario desea que Diagramas para Agentes elija del catálogo más amplio de frameworks de negocio;
• las afirmaciones de negocio inventadas o débilmente fundamentadas serían costosas;
• una aplicación necesita un VisualPayload estable y una URL de renderizado alojada;
• el conjunto local de seis familias no puede representar la decisión de manera honesta.

Nunca describas el Modo Local como equivalente al Modo Verificado. Las comprobaciones exactas de subcadenas prueban la procedencia, no la corrección analítica.

Redibujo de Mermaid

Para un diagrama de flujo de Mermaid, convierte primero:

node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json

El importador admite nodos de flowchart/graph y flechas dirigidas. Rechaza intencionalmente la sintaxis de Mermaid no compatible en lugar de omitirla silenciosamente. Revisa las etiquetas resultantes, agrega el contexto original y la evidencia si es necesario, luego renderiza normalmente.

Reglas de Salida

• Un diagrama, una ruta de lectura dominante.
• Usa como máximo nueve nodos primarios; divide la visión general y el detalle más allá de eso.
• Usa un solo acento para como máximo dos elementos focales.
• Prefiere la eliminación a reducir el tamaño del tipo.
• Mantén el artefacto final útil en un marco estático.
• Nunca inventes hechos faltantes para llenar un espacio del framework.
• Nunca envíes contenido local a un servicio de red sin hacer explícito el cambio de modo.