architect-frameworks-hub

A pergunta que eu mais ouço em revisão de arquitetura não é "qual framework é o certo?", é "qual framework serve para esta conversa?". Um comitê de risco quer ouvir sobre os pilares de segurança e confiabilidade do Well-Architected. Um time de produto discutindo fronteira entre serviços precisa de bounded context, não de fase B do TOGAF. Um diagrama para diretoria pede o nível Context do C4, não o nível Code.

O problema prático é que cada um desses frameworks mora num documento diferente, com dezenas ou centenas de páginas. A especificação do TOGAF passa fácil de 200 páginas em PDF. Quando você precisa lembrar quais são os entregáveis da fase E ou comparar ArchiMate com C4 cinco minutos antes de uma reunião, abrir o PDF original não é opção.

O README resume a premissa numa frase que eu repito bastante: frameworks são ferramentas, não religião. O hub existe para servir de consulta rápida, carregar rápido e ajudar a escolher o framework pelo contexto, e não para substituir a fonte oficial de nenhum deles.

Não tem backend, banco nem API. É um front-end estático de referência, e foi uma escolha deliberada: conteúdo de consulta que muda poucas vezes por ano não justifica nenhuma peça que exija plantão.

Stack: Next.js 16 com React 19, TypeScript 5 e Tailwind CSS 4. A aplicação fica no diretório frontend/ do repositório, que é por isso que o quickstart começa com cd frontend.

Entrega: o deploy é na Vercel e o DNS passa pela Cloudflare. A versão em produção responde em frameworks.moretes.com.

Esteira: o README declara quatro workflows de GitHub Actions: CI, Frontend, Vercel e Security. Na prática, todo push passa por build e checagem de segurança antes de chegar em produção, o mesmo padrão que eu uso nos outros repositórios do portfólio.

Documentação operacional: OPERATIONS.md e SETUP.md descrevem operação e configuração, docs/architecture.md cobre o desenho e CONTRIBUTING.md diz como propor mudança. Se você for fazer fork, comece por esses arquivos, não pelo código.

O custo de manter isso é baixo justamente porque não tem estado: o que envelhece é o conteúdo, não a infraestrutura. Quando a AWS revisar o Well-Architected ou o The Open Group publicar outra edição do TOGAF, a manutenção é editar texto e abrir PR.

O hub não decide nada por você. Ele encurta o caminho até a pergunta certa. Três usos que se repetem:

Antes de uma revisão de workload: abro as perguntas de revisão do Well-Architected do pilar que mais preocupa naquele sistema. Em plataforma financeira quase sempre é segurança e confiabilidade, e ter as perguntas na tela evita que a revisão vire conversa genérica sobre "boas práticas".

Quando o problema ainda não tem forma: começo pelo Cynefin. Se o domínio é complexo, e não só complicado, a resposta é experimentar e medir, e não sair desenhando a arquitetura-alvo com TOGAF. Escolher o framework errado nessa etapa custa semanas de documento que ninguém vai usar.

Na hora de desenhar: C4 para conversa com time técnico e gestão, ArchiMate quando o público é arquitetura corporativa e precisa ligar processo de negócio a aplicação e infraestrutura. DDD entra quando a discussão é fronteira de serviço, e o checklist 12-Factor entra antes de qualquer coisa ir para container.