Engineering Playbook
Templates e checklists práticos que uso para trazer governança e clareza ao trabalho de engenharia. Baixe, adapte e use no seu time — sem necessidade de atribuição.
Templates
design.md
Template de documento de design: contexto, escopo, requisitos, arquitetura proposta, decisões, riscos, estratégia de testes, planos de rollout e rollback. A ferramenta mais eficaz para alinhar humanos — e assistentes de IA — antes de escrever código.
Baixar templateADR — Architecture Decision Record
Registro leve de uma decisão de arquitetura: contexto, opções consideradas, decisão e consequências. Torna o "porquê" auditável muito depois de todos esquecerem a reunião.
Baixar templateRFC técnico
Template de proposta para mudanças relevantes: problema, proposta, alternativas, análise de impacto, considerações de segurança e operação, questões em aberto. Feito para decisão assíncrona e por escrito.
Baixar templatePRD — Product Requirements
Template de gestão de produto: evidência do problema, métricas de sucesso, jobs to be done, requisitos com critérios de aceite, planos de lançamento e medição. Alinha produto, engenharia e design antes de qualquer construção.
Baixar templateFluxo de Criação de Produtos Digitais
Fluxo com gates da ideia à operação: enquadramento da oportunidade, discovery, definição, build, lançamento e operação — cada estágio com uma decisão clara de gate (perseverar, pivotar ou parar). O rigor escala com o tamanho da aposta.
Baixar templateARB — Playbook de Architecture Review Board
Modelo operacional de um ARB que serve aos times em vez de bloqueá-los: escopo, composição, pré-leitura de 48h, formato de revisão de 45 minutos, regras de decisão com SLA, ADRs como artefato e os anti-padrões a recusar.
Baixar templateChecklists
Custos cloud (FinOps)
- ✓Visibilidade de custo por workload/serviço — não só por conta
- ✓Revisão de right-sizing: utilização de CPU/memória vs. alocação
- ✓Políticas de ciclo de vida de storage e varredura de recursos órfãos
- ✓Cobertura de capacidade reservada / savings plans para workloads estáveis
- ✓Revisão de arquitetura: um redesenho pode eliminar o custo por completo?
- ✓Alertas de regressão de custo integrados à rotina do time
Rollout e rollback
- ✓Feature flag ou caminho de rollout em estágios definido
- ✓Migrações de banco compatíveis com a versão anterior
- ✓Procedimento de rollback testado — não apenas documentado
- ✓Observabilidade: dashboards e alertas do novo caminho antes do tráfego
- ✓Métricas de sucesso e limiares de abortar acordados antes do deploy
- ✓Plano de comunicação: quem é avisado, quando e por qual canal
Mínimo de observabilidade
- ✓Golden signals (latência, tráfego, erros, saturação) por serviço
- ✓Logs estruturados com correlation IDs de ponta a ponta
- ✓Alertas ligados a impacto no usuário, não a thresholds crus
- ✓Dashboards revisados em simulados de incidente, não criados durante incidentes
- ✓P99 — não médias — como a conversa de latência
Segurança em ambiente financeiro
- ✓Segregação de funções: ninguém sozinho faz deploy e aprova mudanças que movem dinheiro
- ✓Toda mutação financeira atrás de state machine explícita com trilha de auditoria
- ✓PII mascarado em repouso e em logs; acesso por privilégio mínimo com revisão periódica
- ✓Segredos em vault, com rotação; nenhuma credencial em código, config ou logs de CI
- ✓Chaves de idempotência em toda operação de pagamento — retries precisam ser seguros
- ✓Jobs de reconciliação comparando ledger interno vs. extratos dos provedores
- ✓Pen test e scanning de dependências/segredos no CI, não como ritual anual
- ✓Playbook de incidente com impacto financeiro: congelar, avaliar, comunicar, reconciliar