Definition of Done técnico: além de ‘mergeou na main’

Checklist mínimo para considerar entrega completa: testes nos pontos certos, observabilidade, rollback e dono do serviço em produção.

Contexto

Este artigo integra a série Governança & práticas no blog da Barre — pensado para CTOs, arquitetos e líderes de produto que precisam de decisões com critério e continuidade operacional, não de modismos.

Pressão de negócio e restrições

Organizações em crescimento empalmam processo com peso: mais camadas não substituem falta de fonte de verdade e de revisão na cadência de mudança.

Relacionado com o foco anunciado no título: Checklist mínimo para considerar entrega completa: testes nos pontos certos, observabilidade, rollback e dono do serviço em produção.

O contexto costuma ser duplo: negócio quer previsibilidade; equipas querem autonomia — o texto útil resolve esse atrito com limites claros, não com mais reuniões.

Padrões que voltam a aparecer

• Métricas de atividade em vez de impacto (risco, tempo de recuperação, retrabalho).

• Excepções não registadas — cada uma corroê o padrão sem rasto.

• Regras sem dono ou sem revisão na cadência de mudança — ficam obsoletas em semanas.

Decisão em uma frase, aplicada

Decisão útil: fixar onde mora a verdade (repo, ADR, runbook) e recusar duplicatas estéreis em wiki ou Slack.

Quanto mais curto e verificável o compromisso, maior a probabilidade de sobreviver a mudanças de equipa.

Consequências, trade-offs e o que vigilar

Aceitar menos ornamento e mais ligação causal ao sistema em mudança implica dizer não a iniciativas que não atualizam o artefacto na mesma onda que o código.

Trade-offs: velocidade percebida pode baixar no curto prazo; ganho é menos incidente e onboarding mais rápido.

O que vigilar

• Taxa de divergência entre doc e comportamento real em fluxos críticos.

• Tempo médio até um novo membro encontrar resposta útil sem «tradutor».

• Excepções ao padrão: quantidade e tempo em aberto.

Próximos passos (se for prioridade agora)

1. Escolher um fluxo crítico e publicar desenho no mesmo sítio onde o trabalho acontece (repo / diagrama como código), com dono.

2. Definir revisão na cadência de release ou mensal — o que está obsoleto fica listado como risco, não como «pendência».

3. Limitar excepções ao padrão: registo curto (quem, até quando, compensação).

Síntese

Para fechar: tratar Definition of Done técnico como sistema — medir, limitar e rever — evita que cada projeto reinvente o mesmo debate.

---

Resumo: Checklist mínimo para considerar entrega completa: testes nos pontos certos, observabilidade, rollback e dono do serviço em produção.