ankaiinc/diagrams-for-agents

Diagramas para Agentes

Escolha o visual antes de desenhá-lo. Use o Modo Local por padrão para que o material de origem do usuário permaneça em sua máquina. Use o Modo Verificado apenas quando o usuário solicitar julgamento automático de frameworks, fundamentação mais forte ou um resultado da API/MCP.

Fluxo de Trabalho

1. Leia o contexto fornecido e identifique a decisão do leitor.

2. Leia references/visual-selection.md. Escolha uma família suportada e um preset de destino.

3. Para uma saída com marca, leia references/brand.md. Proponha tokens extraídos antes de salvá-los.

4. Crie uma especificação JSON usando assets/spec.example.json como modelo. Mantenha a fonte completa do usuário em source; anexe uma citação evidence exata para cada afirmação quando a família selecionada exigir.

5. Renderize e valide:

   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. Mostre o artefato HTML e informe a família escolhida, qualquer item omitido deliberadamente e se a fundamentação é local-exact-quote ou verified.

Seleção de Modo

Modo Local — padrão

• Sem conta, chave de API, renderizador hospedado ou upload de conteúdo.
• Famílias suportadas: swot, quadrant, comparison, flow, timeline, architecture.
• Produz HTML editável com SVG embutido, SVG independente opcional e um recibo legível por máquina.
• O renderizador rejeita famílias não suportadas, valores de tema inseguros, IDs duplicados, conexões soltas e evidências ausentes de citação exata.

Modo Verificado — explícito

Leia references/verified-mode.md. Use a ferramenta MCP render_diagram instalada quando disponível. Caso contrário, chame a API documentada do Diagrams for Agents apenas depois de confirmar que o usuário se sente confortável em enviar o contexto fornecido para o Diagrams for Agents.

O Modo Verificado é a escolha certa quando:

• o usuário deseja que o Diagrams for Agents escolha a partir do catálogo mais amplo de frameworks de negócios;
• alegações de negócios inventadas ou fracamente fundamentadas seriam custosas;
• uma aplicação precisa de um VisualPayload estável e uma URL de renderização hospedada;
• o conjunto local de seis famílias não pode representar a decisão honestamente.

Nunca descreva o Modo Local como equivalente ao Modo Verificado. Verificações exatas de substrings comprovam proveniência, não correção analítica.

Redesenho do Mermaid

Para um fluxograma Mermaid, converta primeiro:

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

O importador suporta nós flowchart/graph e setas direcionadas. Ele rejeita intencionalmente sintaxe Mermaid não suportada em vez de descartá-la silenciosamente. Revise os rótulos resultantes, adicione o contexto original e evidências se necessário, depois renderize normalmente.

Regras de Saída

• Um diagrama, um caminho de leitura dominante.
• Use no máximo nove nós primários; divida em visão geral e detalhes além disso.
• Use um acento para no máximo dois elementos focais.
• Prefira exclusão a encolher tipo.
• Mantenha o artefato final útil em um quadro estático.
• Nunca invente fatos ausentes para preencher uma lacuna do framework.
• Nunca envie conteúdo local para um serviço de rede sem tornar explícita a mudança de modo.