Escrevendo um README ou um documento de passagem de bastão, você sempre acaba adicionando um diagrama estrutural ao lado da prosa. Desenhar um não é a parte difícil. A parte difícil é que ele começa a envelhecer no momento em que você o termina: dois módulos são refatorados, uma fila de mensagens aparece, e o diagrama ainda mostra a forma do mês passado — então a próxima pessoa que confia nele aprende o sistema errado.

Archify é uma skill opcional do Hermes voltada exatamente para esse problema. Você entrega a ela uma pequena spec JSON tipada (ou cola o Mermaid que já tinha), e ela produz um diagrama HTML interativo autocontido — depois de rodar uma passagem de validação sobre ele.

O que ela realmente faz

Pense no archify como tratando um diagrama como um artefato governado por schema, em vez de uma figura:

• cinco tipos de diagrama: architecture, workflow, sequence, dataflow e lifecycle (máquina de estados);
• a saída é HTML autocontido: temas escuro e claro, pan e zoom, busca, rastreamento de relacionamentos, movimento de rastro opcional e exportação em PNG / JPEG / WebP / SVG / WebM;
• a entrada pode ser requisitos em linguagem natural, ou Mermaid que você copiou de outro lugar (flowchart, sequenceDiagram, stateDiagram);
• quando o diagrama precisa refletir código real, ela pode ler evidências do repositório em vez de trabalhar apenas a partir da sua descrição.

A diferença importante é o último passo: todo candidato passa por um recibo de validate / deliver com nove verificações. «Este diagrama está certo?» vira algo que você pode checar, não algo que você avalia no olho.

Instalando

hermes skills install official/creative/archify

É uma skill opcional oficial — não faz parte de uma instalação padrão. Ela fica em optional-skills/creative/archify, é de autoria de tt-a1i, licenciada sob MIT, versão 2.17.0.

Um detalhe de design vale saber: do lado do Hermes, esta é uma entrada de catálogo mantida upstream. A skill em si vive em tt-a1i/archify (a CLI Node, os schemas, os renderizadores, os exemplos e as referências estão todos lá), e a instalação puxa a árvore atual ao vivo daquele repositório, em quarentena e escaneada como qualquer instalação do hub. A vantagem é direta: a cópia que você instala não pode envelhecer.

Há exatamente um pré-requisito: Node.js 18+ no PATH. A instalação puxa cerca de 200 arquivos (~8 MB, em sua maioria testes e exemplos upstream) e o fetch é fixado a um único SHA de árvore. Confirme o resultado com:

node bin/archify.mjs doctor

Não é necessário npm install dentro do pacote da skill.

Cinco tipos, um fluxo de trabalho

Para você o fluxo é sempre o mesmo: descreva o que quer, receba um diagrama HTML mais um recibo de validação.

Algumas escolhas economizam tempo na prática:

• «de que o sistema é feito e como as partes se conectam» → architecture;
• «em que ordem uma requisição passa por esses passos» → workflow ou sequence (o primeiro para fluxo com ramificações, o segundo para idas e voltas entre participantes);
• «de onde vêm os dados, o que acontece com eles, onde eles chegam» → dataflow;
• «que estados este objeto tem e quais eventos o movem» → lifecycle.

Se você já tem Mermaid — muitas notas de reunião e issues têm —, colar aquilo e deixar o archify convertê-lo para uma versão interativa é melhor do que redescrever a coisa do zero.

Como ela divide o trabalho com a skill embutida

O Hermes traz uma skill architecture-diagram: zero dependências, e o fallback ao lado do archify (as duas compartilham a mesma linhagem Cocoon AI).

A escolha é simples:

• um diagrama, sem instalação de Node, sem necessidade de interatividade ou exportação → a skill embutida;
• um recibo de validação, conversão de Mermaid, tipos sequence/lifecycle, ou exportações além de um único arquivo HTML → archify.

Duas coisas para ter em mente

1. Sua verificação de atualização apenas imprime um aviso. O passo upstream de «update awareness» roda scripts/check-update.mjs, que lê um manifesto de release do GitHub e apenas imprime um aviso — nunca baixa nem instala nada. Se chamadas de saída não são desejadas no seu ambiente, pule esse passo.
2. Ler seu código tem um requisito de contexto. Quando você pede ao archify para fundamentar um diagrama em evidências do repositório, ela lê o que está no seu diretório de trabalho atual — então invocá-la a partir da raiz do repositório é muito mais útil do que de uma pasta temporária vazia.

A versão curta

O ponto de venda não é «o agent consegue desenhar» — isso deixou de ser novidade há um tempo. É que o archify trata um diagrama como algo com schema, uma passagem de validação e um recibo: cinco tipos que mapeiam para cinco intenções claras, entrada que pode ser JSON tipado ou Mermaid existente, saída que é HTML interativo com múltiplos formatos de exportação, e uma entrada de catálogo mantida upstream para que sua cópia nunca envelheça.

Se você está procurando skills opcionais, a rodada de skills opcionais dá uma visão mais ampla. Para visualização de modo mais geral, veja o post do escritório 3D e o hub de skills do desktop. A superfície completa de comandos para instalar, confiar e gerenciar skills está na referência do hermes skills.