C4 Architecture skill

Você ganha diagramas que mostram quem usa o sistema, que partes ele tem e como elas conversam, salvos em Markdown junto do projeto.

por softaworks

instalações: 4.200
estrelas no GitHub: 2.592
No skills.sh desde: janeiro de 2026
Licença: MIT

Atualizada no GitHub em 5 de março de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

softaworks
c4-architecture
Você ganha diagramas que mostram quem usa o sistema, que partes ele tem e como elas conversam, salvos em Markdown junto do projeto.Auditada4.200 instalações, grátis

O que ela faz

A skill faz o Claude explorar o código do projeto, identificar as partes do sistema e como elas se ligam, e desenhar isso no modelo C4, com diagramas Mermaid. Cada diagrama vai pra um arquivo Markdown na pasta docs/architecture, com um texto explicando o que ele mostra.

O C4 tem níveis. O de contexto mostra o sistema, quem usa e os serviços de fora; o de contêineres mostra o app, o banco e as APIs. A skill sempre faz esses dois e só desce pros componentes internos, pro deploy ou pro caminho de uma requisição quando isso ajuda de verdade.

Ela segue regras pra deixar o desenho legível: no máximo 20 elementos por diagrama, setas num sentido só e com verbo de ação, tecnologia escrita em cada caixa e título sempre. O nível de detalhe muda conforme quem vai ler, do diretor ao pessoal de infraestrutura.

Nas palavras de quem fez

Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize…

softaworks, no SKILL.md

Quando usar

Explicar pra um sócio ou cliente como funciona o sistema que o Claude construiu
Documentar um projeto antes de passar pra outro programador
Entender um código que você herdou e não sabe por onde começar
Mostrar o caminho de um login ou de um pagamento passo a passo
Planejar onde cada parte vai rodar antes de colocar no ar

Depois de instalar, é só pedir assim

Lê este projeto e faz os diagramas de contexto e de contêineres da arquitetura
Desenha o caminho do pagamento, do clique no botão até a confirmação no banco
Faz só o diagrama de contexto, pra eu mostrar pro meu sócio que não é técnico

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

Gen Agent Trust HubPassou
SocketPassou
SnykPassou

Perguntas

Como instalar a C4 Architecture no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a C4 Architecture, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que a c4-architecture precisa pra funcionar?

Não precisa de nada pago nem de chave de API. Ela escreve os diagramas como texto Mermaid dentro de arquivos Markdown. O GitHub já mostra esse texto como desenho; fora dele, você precisa de um visualizador de Mermaid.

Roda no Codex e no Antigravity?

Roda: é uma skill em SKILL.md, só texto, sem script. Qualquer agente que lê skills consegue seguir as regras e gravar os arquivos.

Ela desenha qualquer tipo de diagrama?

Não. Ela faz diagramas de arquitetura de software no modelo C4. Fluxograma de processo, organograma ou mapa mental ficam pra outras skills.

Levar essa skill

1x c4-architectureR$ 0,00

TotalR$ 0,00

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/softaworks/agent-toolkit

Aprenda a usar

O que é o Claude Code (Claude CLI) e como começar
O que é o Claude Code (Claude CLI), pra que serve pra quem não programa, o que ele pede pra rodar e como se compara ao Codex, ao Antigravity e ao Cursor.