Blog
Para quem já sabe o básico e quer ir fundo. Aqui o assunto é como os modelos funcionam em produção: memória, roteamento, ferramentas, agentes. O lado técnico que pouca gente explica direito.
Escrita escala decisões. 1h escrevendo = 10h de reunião. Staff engineer vira staff escrevendo. Anti-pattern: "ninguém lê". Solução: write like a journalist, inverted pyramid.
TL;DR, context, goals/non-goals, proposed solution, alternatives considered, risks, rollout. Templates Google, Uber, Stripe. Quando precisa design doc.
RFC = Request for Comments. Python PEPs, Rust RFCs, IETF como referência. Diferença vs design doc. Process: draft → discussão → ratify. Templates.
Architecture Decision Records: context, decision, consequences. MADR template. Quando ADR vs design doc. Repositório /docs/adrs como linha do tempo viva.
Summary, timeline, root cause (5 whys), impact, action items. Cultura blameless: Etsy, Google. Errar humano é expected. Templates Atlassian.
Hero paragraph, quickstart, install, exemplos, API overview, contributing. Anti-patterns. Shields.io. Social proof (users). Projetos famosos como referência.
Escrever RFC para mudança arquitetural do próprio projeto (migrar de X pra Y). Entregáveis: RFC completo + thread de discussão simulada + decisão final + ADR.