Archify
tt-a1i/archify
Converta descrições em diagramas técnicos lindos com um clique
Ver no GitHubSkill 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/archify1 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
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
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"
Prévia
O mesmo diagrama, dois temas, alternância em um clique:
| Escuro | Claro |
|---|---|
![]() | ![]() |
Menu Export — Copiar para a área de transferência + downloads em quatro formatos:

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:
| Tipo | Ideal para desenhar | Como usar |
|---|---|---|
| Architecture | Componentes do sistema, recursos em nuvem, bancos de dados, cache, limites de serviço, grupos de segurança | Descreva diretamente a estrutura do sistema |
| Workflow | Ciclo de vida da requisição, fluxos de aprovação, chamadas de ferramentas, CI/CD, runbooks de operações, resposta a incidentes | Explique as partes envolvidas, ordem dos passos e ramificações críticas |
| Sequence | Rastros de API, ciclo de vida da requisição, cache back-to-origin, autenticação, traces assíncronos, interações entre serviços | Explica quem chama quem, ordem temporal e caminhos de retorno |
| Data Flow | Pipelines de dados, ETL/ELT, telemetria, isolamento PII, sincronização de repositórios, linhagem de dados, consumo downstream | Explique a origem dos dados, estágios de processamento, locais de armazenamento, limites sensíveis e consumidores |
| Lifecycle | Máquinas de estados, ciclo de vida de pedidos/tarefas/deploy/runs do Agent, estados pendentes, tentativas repetidas, cancelamentos, timeouts, estado final | Explique 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.

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.

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.

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.
| Capacidade | v1.0 | 2.0 | 2.1 | 2.2 | 2.3 | 2.4 |
|---|---|---|---|---|---|---|
| Tema Escuro | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Tema Claro | — | Alternar | Alternar | Alternar | Alternar + T atalho de teclado | Mesmo |
| Download PNG/JPEG/WebP | Captura manual da tela | Ampliação 2× do mapa de bits | Seletor 1×/2×/4× (ainda é ampliado) | Mesmo | Rasterização nativa em 4×, sem borrão | Mesmo |
| Download SVG | — | Vetorial + estilos inline (único tema) | Mesmo | Mesmo | Mesmo | Auto-contido de dois temas (@media prefers-color-scheme) |
| Copiar PNG para área de transferência | — | — | ✓ | Mesmo | Mesmo (sempre 4×) | Mesmo |
| Atalhos de teclado | — | — | T/E + navegação do menu | Mesmo | Mesmo | Mesmo |
| Acessibilidade | — | — | ARIA + focus-visible | Mesmo | Mesmo | Mesmo |
| Estilos para impressão | — | — | — | ✓ | ✓ (+ horizontal e 2 colunas de cartões) | Mesmo |
| Fallback local de fontes na exportação | — | — | — | ✓ | ✓ | Mesmo |
| Modelo de estilo | fill / stroke inline | Variáveis CSS + classes semânticas | Mesmo | Mesmo | Mesmo | Mesmo |
Começo rápido
1. Instalar o skill
Requer plano Claude Pro/Max/Team/Enterprise ou Claude Code.
Claude.ai:
- Baixe
archify.zip - Vá para Settings → Capabilities → Skills
- Clique em + Add, faça upload do zip
- 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ção | O que faz |
|---|---|
| Copiar para a área de transferência | A 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 / WebP | Salva 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 SVG | Exportaçã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=lightou?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
| Tipo | Cor | Uso |
|---|---|---|
| Frontend | Ciano | Cliente / UI / Dispositivos terminais |
| Backend | Verde-água | Serviços / API / Processos de backend |
| Banco de dados | Roxo | Bancos de dados / Armazenamento / AI/ML |
| Cloud / AWS | Âmbar | Nuvem gerenciada / Infraestrutura |
| Segurança | Rosa-champanhe | Autenticação / Grupos de segurança / Criptografia |
| Message Bus | Laranja | Kafka / RabbitMQ / SNS / Event bus |
| Externo | Cinza | Terceiros / 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 atributodata-themeno<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:rootda cópia; depois serializa comXMLSerializer. Para formatos raster, a largura/altura da cópia são definidas como4 × 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/webpno 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ãoprefers-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-schemedo hospedeiro) - Navegação por teclado e semântica de acessibilidade
- Folha de estilo para impressão + fallback a fontes locais
- Novo guia no
SKILL.mdorientando 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!

