convez.ai
SkillDevOps & InfraestruturaIntermediário
tt-a1i

Archify

tt-a1i/archify

Converta descrições em diagramas técnicos lindos com um clique

Ver no GitHub
BomPluginScore · de 0 a 100

Skill Claude que converte descrições textuais em diagramas técnicos profissionais (arquitetura, workflow, sequência, fluxo de dados, ciclo de vida). Suporta temas claro/escuro, exportação em PNG/JPEG/WebP/SVG em alta resolução e cópia para clipboard.

Instalação

$npx convez-ai tt-a1i/archify

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
98 mil
Forks
6,7 mil
Acompanhando
238
Saúde
42%
Último commit
há 22 horas
Versão
v3.2.0
Issues abertas
367
Contribuidores
1

Casos de uso

  • Documentar arquitetura de sistemas e fluxos técnicos
  • Criar diagramas de sequência de API calls e requisições
  • Visualizar pipelines de dados, ETL e fluxos de informação
  • Desenhar máquinas de estado e ciclos de vida de objetos
  • Gerar fluxos de trabalho, CI/CD e runbooks operacionais

Veredito

Ferramenta prática e bem executada para transformar descrições textuais em diagramas técnicos publicáveis sem aprender ferramentas gráficas. Especialmente útil para documentação de arquitetura e comunicação técnica em equipes.

README em português

Archify Hero

Archify

Descreva seu sistema ou fluxo em linguagem simples e gere diagramas de arquitetura, fluxos técnicos, sequências de chamadas, pipelines de dados e ciclos de vida impressionantes. Alternância entre tema escuro / claro com um clique. Exporte imagens 4× nítidas (PNG/JPEG/WebP/SVG) diretamente ou copie para a área de transferência em uma única ação.

Archify é um Claude Skill: você descreve seu sistema ou fluxo no dia a dia e ele transforma sua descrição em um diagrama técnico detalhado — um arquivo HTML único que pode ser aberto no navegador para alternar temas, copiar para a área de transferência e exportar em vários formatos.

  • Não precisa saber desenhar —— Basta dizer ao Claude quais são os componentes e suas conexões
  • Suporta workflow / sequence / data flow / lifecycle —— Fluxos técnicos, cadeias de aprovação, chamadas de ferramentas, CI/CD, rastros de requisições, pipelines de dados, limites PII e máquinas de estados podem ser desenhados
  • Alternância de temas integrada — Escuro / claro com um clique; o navegador lembra suas preferências
  • Copiar para a área de transferência em uma ação —— Cole diretamente no Slack, Lark (Feishu), WeChat, Notion ou issues do GitHub
  • Exportação de imagens ultra-nítidas — PNG/JPEG/WebP são rasterizados nativamente pelo navegador na resolução 4× da fonte (sem pixelização, não é apenas um mapa de bits ampliado) ou exporte SVG para vetores reais
  • SVG segue automaticamente o tema do sistema — Os SVGs exportados embutem duas variáveis + @media (prefers-color-scheme); cole no README do GitHub e os leitores alternam com seu esquema de cores sem precisar de dois PNGs ou tags <picture>
  • Arquivo HTML único — Zero dependências, envie um arquivo para compartilhar
  • Iteração por chat —— "Mova o Redis para a esquerda", "Troque o serviço de autenticação para rosa", "Adicione uma Kafka"

License Claude Version

Prévia

O mesmo diagrama, dois temas, alternância em um clique:

EscuroClaro
Tema escuroTema claro

Menu Export — Copiar para a área de transferência + downloads em quatro formatos:

Menu de exportação

Para testar pessoalmente: clone o repositório e abra examples/web-app.html, pressione T para alternar temas ou E para abrir o menu de exportação. Adicione ?theme=light ou ?openExport=1 à URL para forçar um estado inicial específico.

Tipos de diagrama

O Archify atualmente oferece cinco principais tipos de saída:

TipoIdeal para desenharComo usar
ArchitectureComponentes do sistema, recursos em nuvem, bancos de dados, cache, limites de serviço, grupos de segurançaDescreva diretamente a estrutura do sistema
WorkflowCiclo de vida da requisição, fluxos de aprovação, chamadas de ferramentas, CI/CD, runbooks de operações, resposta a incidentesExplique as partes envolvidas, ordem dos passos e ramificações críticas
SequenceRastros de API, ciclo de vida da requisição, cache back-to-origin, autenticação, traces assíncronos, interações entre serviçosExplica quem chama quem, ordem temporal e caminhos de retorno
Data FlowPipelines de dados, ETL/ELT, telemetria, isolamento PII, sincronização de repositórios, linhagem de dados, consumo downstreamExplique a origem dos dados, estágios de processamento, locais de armazenamento, limites sensíveis e consumidores
LifecycleMáquinas de estados, ciclo de vida de pedidos/tarefas/deploy/runs do Agent, estados pendentes, tentativas repetidas, cancelamentos, timeouts, estado finalExplique quais são os estados dos objetos, eventos que disparam transições e quais são os estados finais

Workflow não é um substituto para fluxogramas genéricos; ele se foca mais em "diagramas de comunicação técnica": possui faixas (lanes), cores semânticas, caminhos principais e rotas assíncronas/aprovação/observação. Por exemplo:

用 archify 画一个 workflow:
用户提交请求 -> Agent 规划 -> 需要审批时进入 Approval Gate -> 调工具 -> 记录 trace -> 返回结果

Este repositório contém um exemplo aberto: examples/workflow-agent-tool-call-rendered.html.

Sequence é usado para explicar ordens de interação mais detalhadas, como:

用 archify 画一个 sequence diagram:
用户打开页面,前端请求 API,API 校验 JWT,读取 Redis,缓存未命中则查 Postgres,返回结果并写入 trace。

Exemplo: examples/sequence-cache-miss-request.html.

Exemplo Sequence

Data Flow é ideal para explicar "como os ativos de dados se movem", por exemplo:

用 archify 画一个 data flow:
Web 和 Mobile 上报埋点,Edge API 收集事件,Consent Gate 过滤 PII,Kafka 承接事件流,
Warehouse 存分析表,Feature Store 做每日特征,Dashboard 和 ML Model 消费下游数据。

Exemplo: examples/dataflow-product-analytics.html.

Exemplo Data Flow

Lifecycle é usado para explicar "como o estado dos objetos muda", como:

用 archify 画一个 lifecycle diagram:
Agent Run 从 Queued 进入 Planning,再进入 Executing 和 Reviewing。需要人工确认时进入
Needs Approval,缺少输入时进入 Blocked;工具失败可以 Failed 后重试,用户取消进入 Cancelled,
超时进入 Expired,成功则进入 Completed。

Exemplo: examples/lifecycle-agent-run.html.

Exemplo Lifecycle

Evolução da versão

O Archify é um fork reescrito do Cocoon-AI/architecture-diagram-generator v1.0 (que apenas gerava saída HTML com tema escuro). 2.0 refatorou o modelo para um sistema temático impulsionado por variáveis CSS e adicionou uma pipeline de exportação do lado do cliente. 2.1 adicionou cópia para área de transferência + navegação via teclado. 2.2 incluiu estilos de impressão e fontes locais como fallback. 2.3 corrigiu um bug antigo de upscaling de mapa de bits; todas as exportações rasterizadas agora são renderizadas nativamente em 4× (também removendo os seletores 1×/2×/4× introduzidos na v2.1 — aquele seletor apenas induzia usuários a escolherem imagens mais borradas). 2.4 atualizou a exportação SVG para uma versão auto-contida de dois temas — o mesmo arquivo .svg colado no README do GitHub alterna automaticamente conforme o leitor muda entre claro e escuro.

Capacidadev1.02.02.12.22.32.4
Tema Escuro✓✓✓✓✓✓
Tema Claro—AlternarAlternarAlternarAlternar + T atalho de tecladoMesmo
Download PNG/JPEG/WebPCaptura manual da telaAmpliação 2× do mapa de bitsSeletor 1×/2×/4× (ainda é ampliado)MesmoRasterização nativa em 4×, sem borrãoMesmo
Download SVG—Vetorial + estilos inline (único tema)MesmoMesmoMesmoAuto-contido de dois temas (@media prefers-color-scheme)
Copiar PNG para área de transferência——✓MesmoMesmo (sempre 4×)Mesmo
Atalhos de teclado——T/E + navegação do menuMesmoMesmoMesmo
Acessibilidade——ARIA + focus-visibleMesmoMesmoMesmo
Estilos para impressão———✓✓ (+ horizontal e 2 colunas de cartões)Mesmo
Fallback local de fontes na exportação———✓✓Mesmo
Modelo de estilofill / stroke inlineVariáveis CSS + classes semânticasMesmoMesmoMesmoMesmo

Começo rápido

1. Instalar o skill

Requer plano Claude Pro/Max/Team/Enterprise ou Claude Code.

Claude.ai:

  1. Baixe archify.zip
  2. Vá para Settings → Capabilities → Skills
  3. Clique em + Add, faça upload do zip
  4. Ative o interruptor

CLI do Claude Code:

# 全局(所有项目可用)
unzip archify.zip -d ~/.claude/skills/

# 或者仅当前项目
unzip archify.zip -d ./.claude/skills/

Claude.ai Projects: Simplesmente faça upload de archify.zip para Project Knowledge.

2. Preparar a descrição do sistema

Qualquer uma das opções abaixo funciona:

Deixe o AI analisar seu repositório de código:

分析这个代码仓库,描述系统架构。包括所有主要组件、它们之间怎么连接、
用了什么技术栈,以及任何云服务或第三方集成。用列表格式,方便画图。

Escreva um trecho você mesmo:

- React 前端调 Node.js API
- PostgreSQL 数据库
- Redis 做缓存
- 部署在 AWS 上,用 CloudFront 做 CDN

Ou peça ao Claude para gerar uma arquitetura típica:

一个典型的 SaaS 应用架构是什么样的?

3. Peça ao Claude para chamar o skill

用 archify skill 帮我生成一张架构图:

[粘贴你上面准备的描述]

Pronto! O Claude gerará um arquivo HTML que pode ser aberto no navegador para visualização. Para fazer alterações, continue conversando: "Adicione uma Redis", "Troque o Postgres por MySQL", "Destaque a rota de autenticação".

Usar o HTML gerado

Ao abrir o arquivo no navegador, dois botões aparecerão no canto superior direito:

  • Botão do tema (Dark / Light) — Alternância em um clique, persistência salva. Atalho T.
  • Menu Export — Cinco ações: copiar para área de transferência + downloads em 4 formatos. Atalho E.

Menu Exportar

AçãoO que faz
Copiar para a área de transferênciaA imagem atual é copiada diretamente para a área de transferência do sistema no formato PNG, pronta para colar em Slack / Notion / Lark (Feishu) / GitHub / Figma
Baixar PNG / JPEG / WebPSalva como raster. JPEG e WebP preenchem com a cor de fundo atual do tema (sem transparência); o PNG mantém a transparência
Baixar SVGExportação vetorial, todos os estilos em linha, auto-contido para ambos os temas. Inclui duas conjuntos de variáveis CSS (dark + light) e regras @media (prefers-color-scheme) — o mesmo arquivo .svg colado no README do GitHub / blog segue a mudança entre modo claro/escuro feita pelo leitor. Pode ser editado em Figma / Illustrator. Escala sem perda de qualidade

Todas as exportações raster (copiar + PNG/JPEG/WebP) são renderizadas nativamente pelo navegador na 4× resolução da fonte — o SVG serializado é definido com tamanho 4 × viewBox, e o navegador rasteriza o vetor diretamente nessa resolução; o canvas desenha no tamanho natural (sem upscaling de bitmap). O resultado é nítido em telas retina, apresentações e saídas de impressão.

Sem seletor de múltiplos — sempre a máxima nitidez, que também é a única opção padrão. Se ocasionalmente precisar de uma imagem menor, use os parâmetros da URL abaixo.

Atalhos de teclado

  • Pressione T em qualquer lugar para alternar o tema
  • Pressione E em qualquer lugar para abrir o menu Exportar
  • No menu: ↑ ↓ — navegação entre opções (para cima/para baixo)
  • Home / End — pula para a primeira ou última opção
  • Enter / Espaço — ativa a opção atual
  • Esc — fecha o menu

Parâmetros da URL

  • ?theme=light ou ?theme=dark — força o tema ao iniciar (cortes determinísticos, links compartilhados, incorporação em documentos)
  • ?openExport=1 — expande automaticamente o menu Exportar ao carregar a página (para demonstrações / cortes de documentação)

Observações importantes

  • Compatibilidade WebP: depende do codificador canvas do navegador. Em versões antigas do Safari que não suportam, os itens do menu ficam cinzas e indisponíveis. PNG e JPEG são universais.
  • Suporte à área de transferência: a cópia da imagem requer ClipboardItem + navigator.clipboard.write (Chromium, Firefox 127+, Safari 16+). Se não suportado, a opção Copiar fica cinza.
  • Exportação de fontes: as imagens raster usarão uma fonte monoespaçada do sistema como fallback (ui-monospace, Menlo, Consolas), pois o contexto de renderização da imagem no sandbox não tem acesso ao Google Fonts. Se você tiver JetBrains Mono instalado localmente, ele será usado automaticamente com consistência pixel a pixel perfeita.

Prompts comuns

Aplicação Web:

用 archify 画一张架构图:
- React 前端
- Node.js/Express API
- PostgreSQL 数据库
- Redis 缓存
- JWT 鉴权

AWS Serverless:

用 archify 画:
- CloudFront CDN
- API Gateway
- Lambda(Node.js)
- DynamoDB
- S3 存静态资源
- Cognito 做鉴权

Microsserviços:

用 archify 画一张微服务架构图:
- React Web + 移动端
- Kong API Gateway
- 用户服务(Go)、订单服务(Java)、商品服务(Python)
- PostgreSQL、MongoDB、Elasticsearch
- Kafka 做事件流
- K8s 做编排

Fluxo de dados / Análise de telemetria:

用 archify 画一个 data flow:
- Web App 和 Mobile SDK 产生 clickstream events
- Edge API 收集事件
- Consent Gate 过滤身份信息和 PII
- Kafka/Event Stream 承接 accepted events
- Warehouse 存 normalized facts
- Feature Store 每日生成 feature vectors
- Dashboards 和 ML Model 消费下游数据

Máquina de estados / Ciclo de vida:

用 archify 画一个 lifecycle diagram:
- 任务从 Queued 开始
- Planning 生成计划
- Executing 调用工具
- Reviewing 做质量检查
- Needs Approval 和 Blocked 是等待态
- Failed 可重试,Cancelled / Expired / Completed 是终态

Paleta semântica

TipoCorUso
FrontendCianoCliente / UI / Dispositivos terminais
BackendVerde-águaServiços / API / Processos de backend
Banco de dadosRoxoBancos de dados / Armazenamento / AI/ML
Cloud / AWSÂmbarNuvem gerenciada / Infraestrutura
SegurançaRosa-champanheAutenticação / Grupos de segurança / Criptografia
Message BusLaranjaKafka / RabbitMQ / SNS / Event bus
ExternoCinzaTerceiros / Sistemas externos genéricos

Cada cor possui valores correspondentes para temas escuros e claros; ao alternar o tema, as cores são atualizadas simultaneamente.

Detalhes da implementação

  • Modelo de estilo: variáveis CSS em :root + [data-theme="light"]; elementos SVG referenciam classes semânticas (c-frontend, t-muted, a-emphasis). Alternar o atributo data-theme no <html> reescreve toda a imagem, incluindo gradientes, grade, setas e máscaras.
  • Pipeline de exportação: clona o SVG, emlinha as tags <style>, resolve as variáveis do tema atual e escrevê-las nas regras :root da cópia; depois serializa com XMLSerializer. Para formatos raster, a largura/altura da cópia são definidas como 4 × viewBox; o navegador rasteriza o vetor nativamente na resolução alvo. O canvas é dimensionado para alinhar à cópia e desenha no tamanho natural (sem upscaling de bitmap); toBlob(mime) gera o arquivo. JPEG preenche explicitamente a cor de fundo (sem alpha). Se a resolução alvo exceder o limite do canvas do navegador, cai automaticamente para 3× ou 2×.
  • Arquivo único: um HTML, uma tag <link> do Google Fonts, SVG em linha e cerca de 3 KB embutidos no JS. Sem etapas de build, sem framework JS e sem servidor backend.
  • Suporte ao navegador: qualquer navegador mainstream (Chrome, Safari, Firefox, Edge). Exportação WebP requer suporte a image/webp no canvas.

Agradecimentos

Archify é uma reescrita do fork Cocoon-AI/architecture-diagram-generator (MIT, v1.0), original de Cocoon AI. A linguagem visual refinada da versão original — paleta de cores, grade de fundo, layout de cartões de resumo e fonte JetBrains Mono — é preservada integralmente. Os créditos pelo design visual pertencem ao autor original.

Contribuições para Archify 2.x:

  • Refatoração dos templates em um sistema de temas baseado em variáveis CSS (escuro + claro)
  • Alternância de tema + persistência no localStorage + padrão prefers-color-scheme
  • Menu embutido de exportação PNG / JPEG / WebP / SVG + cópia para área de transferência
  • Rasterização nativa 4× (corrigindo o desfoque causado pelo upscaling)
  • Exportação SVG auto-contida em ambos os temas (arquivo único segue prefers-color-scheme do hospedeiro)
  • Navegação por teclado e semântica de acessibilidade
  • Folha de estilo para impressão + fallback a fontes locais
  • Novo guia no SKILL.md orientando o Claude a usar um método de desenho classificado e temático

Ambos os projetos estão sob licença MIT.

Roadmap

Ver ROADMAP.md.

O próximo passo é v3.0 — iteração estável do JSON IR: introduzindo um formato intermediário minimalista diagram.json, permitindo que o Claude faça ajustes de coordenadas locais sem deslocar componentes irrelevantes, ao mesmo tempo em que suporta diffs amigáveis no git e evita re-renderização desnecessária de tema/paleta.

Sobre a importação do Mermaid: após testes (auto-layout + CSS archify não é muito mais bonito que o Mermaid nativo), a rota do parser automático do Mermaid foi descartada. O núcleo estético do Archify reside no julgamento de layout do Claude, não em CSS. Usuários ainda podem colar código Mermaid para que o Claude gere um diagrama com estilo Archify do zero — mas via prompt e não via parser.

Os planos originais da v2.4 / v2.5 (?exportScale=N, paleta amigável a daltonismo, links de compartilhamento) também foram descartados. Veja o motivo no parágrafo "Not planned" do ROADMAP.

Licença

MIT — uso livre, modificação e redistribuição permitidos.

Contribuir

Bem-vindos a abrir issues, PRs ou compartilhar os diagramas que você desenhou!

Ver o original no GitHub

Bom para

Relacionados