Arquitetura — a planta, em aberto
Este site é o argumento. Esta página é a planta — como ele é construído, e como você construiria o seu.
A tese
Para um site de prova de engenharia, o código é o pitch — então o honesto é mostrar a máquina, não só o resultado dela. Esta é a construção inteira, em aberto: a arquitetura abaixo, as decisões que a moldaram (cada uma registrada como um ADR), e a camada reutilizável que te deixa replicar. Eu construo isto do jeito que quero ser contratado pra construir — desenvolvimento AI-native (Claude Code, Kiro, um loop AI-DLC / Loop Engineering) com o rigor de SDLC que a maior parte do trabalho com IA pula. O site é a saída pública desse loop.
O formato
Uma SPA totalmente estática — React + Vite + TypeScript — servida a partir de S3 atrás do CloudFront, com uma pequena CloudFront Function reescrevendo URLs limpas. Sem backend: sem servidor, sem banco, sem auth. Custo quase zero, superfície de ataque mínima, nada rodando às 3 da manhã. (→ ADR-0002 totalmente estático / sem backend · ADR-0013 S3 + CloudFront)
O conteúdo é markdown no repo, resolvido no build
O conteúdo de cada página — o CV, esta página, os artigos — é markdown ou dado tipado no repo. Cada rota é prerenderizada no build (um snapshot headless) pra que as tags de OG/SEO e o HTML rastreável cheguem nos arquivos servidos — sem SSR, sem edge rendering. O PDF do CV para download é impresso a partir do /me ao vivo pela mesma etapa. (→ ADR-0004 render no build · ADR-0005 toda URL OG-completa · ADR-0034 o PDF do CV)
O dev-loop é o produto
A parte interessante não é a stack — é como ele é construído: agent-led verification, human-residual (verificação liderada pelo agente, humano no resíduo). O agente prova o "pronto" com gates mecânicos e evidência real (lint, tipos, testes ≥85%, um build verde, SonarCloud, E2E funcional, um revisor de contexto fresco); o humano fica com as decisões irreversíveis e arquiteturais. Esse loop vive num plugin reutilizável à parte — tadeumendonca-skills — então é uma metodologia que você pode adotar, não algo sob medida só pra este site. (→ ADR-0003 trunk-based single-environment · ADR-0018 os gates de CI)
O registro de decisões É a documentação
Nada de doc de arquitetura separado que descola da realidade. Toda decisão que sustenta peso — e as revertidas, mantidas como histórico — é um Architecture Decision Record, lido através do keystone ADR-0001: enxuto por design, calibrado pela estratégia. O "porquê" de verdade por trás de qualquer coisa acima está lá, datado, com seu trade-off.
Replique para o seu contexto
Está tudo público — dois repos, sem segredos:
- tadeumendonca-io — este site e sua infraestrutura (
iac/: Terraform para S3/CloudFront/OIDC). - tadeumendonca-skills — o plugin reutilizável do dev-loop: os princípios, as personas dos agentes, os guardas de permissão.
A régua: um projeto só entra no portfólio quando passa por docs/catalog-ready.md — o gate de prova de engenharia. Segure o seu próprio trabalho nessa régua.
Comece aqui: faça fork dos dois repos, leia os ADRs (comece no 0001), adote o plugin de skills como seu loop, e depois troque pelo seu próprio conteúdo e posicionamento. A estrutura se sustenta; as palavras são suas.
Uma limitação honesta
Este é um site de autor único, afinado ao posicionamento de uma pessoa — não é um template de propósito geral, e ainda não foi testado no campo por muitas mãos. Pegue o padrão, não os detalhes. O que vem a seguir, adiado de propósito: uma planta visual mais rica e um passo a passo de replicação — esta página é o mapa, ainda não o tour guiado.