As três categorias de ferramenta de diagrama
1. Ferramentas visuais generalistas (Luc…, Dr…, Miro)
Arrastar-e-soltar, muito bom para brainstorm em quadro branco compartilhado. Zero acoplamento com o código. Excelente para fluxograma de processo, mapa mental, workshop de discovery.
Falha em: arquitetura de software que muda toda semana. O diagrama vira artefato de "documentação oficial" que ninguém atualiza depois de 3 meses.
2. Diagram-as-code textual (Mermaid, PlantUML, Structurizr)
Você escreve texto, ferramenta gera diagrama. Excelente para versionar no Git. Bom para diagramas embutidos em README ou em documentação técnica escrita.
Falha em: edição visual colaborativa. Quando o time quer discutir a arquitetura em tempo real olhando pro canvas, ninguém quer ficar editando YAML.
3. Plataforma híbrida (Excahub)
Junta os dois mundos: você tem canvas visual editável (para o time discutir junto) e arquivo declarativo versionado (para o Git rastrear). Toda edição no canvas atualiza o código, e vice-versa. Cada commit é uma versão auditável.
É a categoria que resolve o problema real: arquitetura viva, sem escolher entre visual e versionado.
Comparativo direto
| Critério | Visual (Luc…, Dr…) | Diagram-as-code puro | Excahub |
|---|---|---|---|
| Edição visual colaborativa | Sim | Não | Sim |
| Versionamento no Git | Não (binário) | Sim | Sim |
| Diff visual entre versões | Não | Parcial | Sim |
| Zero drift com produção | Não | Depende | Sim |
| Gera README / doc automático | Não | Não | Sim |
| IA para propor arquitetura | Não | Não | Sim |
| Preço para 5 devs (BRL/mês) | R$ 500+ | R$ 0 (self-host) | R$ 335 (Team) |
Quando trocar de ferramenta visual para diagrama como código
- Seu diagrama de arquitetura está desatualizado há mais de 3 meses.
- Onboarding de novo dev exige "reunião pra explicar o desenho".
- Auditoria pediu evidência de mudança arquitetural e você entregou print.
- Você paga assento por assento em ferramenta visual e ninguém abre.
- Time discute mudança em reunião e ninguém sabe qual foi a decisão final.
Se dois desses batem, a próxima ferramenta que você adotar deveria estar no Git. Excahub é a versão brasileira dessa ideia - com IA embutida, colaboração em tempo real para times e cobrança em real.