Decidir o que barra a entrega e o que só avisa

Uma mudança sem revisão entrou no branch principal (a linha de código que vira o produto) numa sexta à noite. A definição de pronto do time exigia revisão de outra pessoa e testes verdes. A falha não estava no acordo: estava em ele não ter virado regra do repositório.

Portão de qualidade é o travamento automático que impede uma mudança de avançar quando um critério objetivo falha. Definição de pronto é o acordo escrito sobre o que faz uma entrega contar como entrega. Acordo descreve o que deveria acontecer; regra de repositório impede o que não pode acontecer, até na sexta à noite, com pressa.

O portão roda na esteira de verificação e tem um efeito só: passa ou barra. Ele checa o que dá para checar sem opinião, como teste vermelho, erro de tipo e chave de acesso exposta no código.

A definição de pronto é lista humana e cobre o que máquina nenhuma verifica. A mudança tem dono, tem caminho de volta, tem registro do motivo e cabe numa revisão de trinta minutos.

Isso inclui ler o diff (a lista do que mudou) inteiro, e não só o texto que o modelo escreve sobre o próprio trabalho. Inclui também conferir que os testes adicionados falham quando alguém quebra a implementação de propósito.

Nem todo portão precisa barrar. Teste e verificação de tipo barram a entrada no branch principal; a varredura de segurança barra a publicação conforme a gravidade, e a medida de desempenho costuma só alertar. Configure bloqueios automáticos conforme o risco, e dê a quem pode abrir exceção autorização, justificativa e registro: regra de repositório sozinha não garante ausência de atalho.

Na comparação observacional da Faros, tarefas por pessoa cresceram 33,7%, incidentes por pedido de mudança 242,7% e mediana do tempo em revisão 441,5%; os dados não provam causalidade nem representam todas as empresas. Automação e revisão humana se complementam: a primeira repete critérios definidos, a segunda avalia contexto e efeito que o teste pode não cobrir.

Desde junho de 2026, a revisão automática de código do Copilot entra na cobrança por uso. Em repositório privado, o custo de execução também pode incidir. Confira as regras do plano antes de ampliar a execução.

Peça a lista dos portões com o efeito de cada um ao lado e a data da última exceção concedida. Duas exceções no mesmo trimestre, sem conserto do portão, significam que aquele portão virou enfeite.

Na tela da regra do repositório principal precisa estar escrita a exigência de revisão aprovada e verificação verde, e quem tem permissão de contorná-la.

Três meses de registro de exceções bastam para ver o padrão, cada linha com motivo, quem autorizou e a data do conserto. Exceção sem prazo de conserto no mesmo registro vira precedente.

Portão de qualidade barra sozinho quando um critério objetivo falha. Definição de pronto reúne o que o time combinou por escrito. Regra de repositório aplica verificações no local onde o código fica. Fila de merge (junção de mudanças aprovadas) testa mudanças em conjunto, antes de integrá-las. Retrabalho de publicação mede publicações não planejadas motivadas por incidentes.

A decisão que cabe a você é dizer quais critérios barram a entrada e quais apenas avisam. O time decide como implementar cada portão e quanto tempo ele leva para rodar.

Peça por escrito a regra do repositório com revisão e verificação verde, o registro de exceções com prazo de conserto e a definição de pronto assinada pelo time. Se alguma exceção do último trimestre estiver sem data de conserto, o portão ainda não barra de verdade.