architect-frameworks-hub

Em 16 anos desenhando plataformas sobre AWS, a pergunta que mais consumiu tempo de reunião não foi "qual framework usar?" — foi "o que exatamente esse framework diz sobre o nosso caso?". O Well-Architected tem seis pilares, cada um com dezenas de perguntas de revisão; o TOGAF ADM tem oito fases, de A a H, cada uma com entregáveis próprios; o C4 cabe em quatro níveis, mas metade das reuniões confunde Container do C4 com contêiner Docker. Toda vez que uma decisão exigia comparar dois deles, alguém reabria o PDF de 200 páginas.

Este repositório é a referência que eu queria ter tido: um site estático, rápido, que resume cada framework — fases, pilares, camadas, checklist — com ponteiros para a fonte oficial quando o detalhe importa. Ele não substitui o material original. Substitui o tempo perdido procurando nele.

O que ele não é: não é curso, não é preparatório de certificação e não é ranking de qual framework é "melhor". Framework é ferramenta, não religião. O hub existe para você escolher a ferramenta certa para o contexto e explicar o trade-off a quem decide, sem voltar ao capítulo 12.

O app vive no diretório frontend/: Next.js 16 com App Router, React 19, TypeScript 5 e Tailwind CSS 4. O conteúdo de cada framework é a parte que importa; a stack só precisa entregá-lo rápido e sem custo de operação. Por isso o site é estático, hospedado na Vercel, com DNS no Cloudflare. Não há banco, não há API, não há estado de servidor. O custo mensal de manter isso de pé é zero — e é o custo de manter, não o de construir, que decide se um projeto de referência sobrevive mais de um ano.

Três workflows no GitHub Actions guardam o repositório — CI, Frontend e Security — e os badges no topo do README refletem o estado atual de cada um. A regra que vale para qualquer contribuição: se o npm run build quebra no CI, a mudança não entra, por mais correto que o texto esteja.

Documentação operacional: docs/architecture.md descreve a estrutura do projeto; OPERATIONS.md e SETUP.md cobrem configuração e operação do site (domínio, deploy); CONTRIBUTING.md diz como propor mudança de conteúdo — que é o tipo de contribuição mais útil aqui. Licença MIT.

O valor do hub está em cruzar os frameworks, não em ler cada um isolado. A sequência que sigo quando um problema novo chega:

Classifique com Cynefin antes de escolher método: um pipeline de eventos com regra de negócio conhecida é um domínio complicado — cabe análise e boas práticas. Um produto novo sem usuário ainda é complexo — cabe experimento, não plano de oito fases.

TOGAF ADM quando a mudança atravessa a organização: fases A a H fazem sentido para transformação com várias áreas, patrocínio executivo e horizonte de anos. Para um serviço só, o ADM é peso morto.

C4 para comunicar, ArchiMate para governar: C4 em quatro níveis é o que cabe numa reunião de 30 minutos com engenharia. ArchiMate, com as três camadas, é o que um escritório de arquitetura corporativa consegue manter como repositório vivo.

DDD quando o modelo de domínio é o risco: bounded contexts e linguagem ubíqua resolvem o problema de dois times chamarem "cliente" coisas diferentes. Se o domínio é CRUD, DDD é cerimônia.

Well-Architected e 12-Factor como checklist de revisão: os seis pilares para a carga na AWS, os doze fatores para o serviço que vai para contêiner. São os dois que abro toda vez antes de algo ir para produção.