Feature flag na automação: ligar para um recorte

Feature flag na automação escolhe quem passa pelo fluxo novo. Pode ser uma unidade, um tipo de pedido ou uma fração dos casos. O restante continua na versão que já está estável. A flag não é um interruptor escondido que alguém liga para todo mundo “só para ver”.
Sem recorte escrito, sem dono e sem data para retirar, a flag vira uma segunda configuração permanente. Daqui a um mês ninguém sabe qual caminho está valendo. O desenho inclui o fim da flag, não só a estreia.

Qual recorte justifica a flag?
Um recorte que dá para explicar: uma loja, um tipo de documento, casos abaixo de um valor, uma lista de contas internas. Recorte aleatório só quando a pergunta é de comparação e a medição está pronta. “Ligar para ver” não é recorte.
O caso na fronteira tem regra. Ou entra, ou não. Dois caminhos para o mesmo pedido, dependendo de qual worker pegou, produzem estado duplo. A decisão usa a chave do caso, estável, não o acaso da hora.
O que fica ligado dos dois lados?
A versão nova e a anterior coexistem, as duas empacotadas. A flag só escolhe qual pacote atende aquele caso. Ela não edita o fluxo no meio. Quem olha o caso vê qual caminho ele tomou.
Efeito externo, como e-mail e cobrança, continua com a mesma chave nos dois caminhos. A flag não é desculpa para o retry criar o efeito duas vezes quando o caso muda de caminho no meio. O caso nasce num caminho e termina nele.
| Peça | Função | Não é |
|---|---|---|
| Recorte | Quem entra no fluxo novo | Interruptor de tudo |
| Pacotes | Versão nova e anterior | Edição ao vivo |
| Chave | O caso não muda de caminho | Sorteio a cada passo |
| Prazo | Data de retirar a flag | Configuração eterna |
Como medir se o recorte prestou?
Antes de ampliar, compare o recorte com o restante: erro, retrabalho, tempo até o efeito e reclamação. Se o novo caminho piora, a flag fecha e o pacote anterior segue. Ampliar porque “já ligamos” não é leitura.
A amostra do recorte tem de ser grande o bastante para a falha aparecer. Uma loja minúscula que não tem o caso difícil não autoriza o restante. O recorte seguinte inclui o caso que dói, de propósito.
Quem pode ampliar ou desligar?
Quem responde pelo fluxo, com o mesmo registro da publicação. Ampliar de uma loja para todas é uma publicação, não um clique casual. O horário evita o meio do pico se a volta ainda não foi ensaiada.
Desligar é caminho feliz do desenho, não vergonha. A flag que ninguém pode desligar de noite não deveria estar ligada de noite. O runbook diz como fechar e o que acontece com o caso que já entrou no caminho novo.
Quando a flag sai do código?
Quando o caminho novo é o único, a flag sai. Manter as duas versões para sempre dobra teste, bug e explicação. A data de retirada entra na publicação. Flag vencida aparece numa lista, não fica esquecida num parâmetro.
Se a decisão é não adotar, sai o caminho novo, não a flag com o novo desligado para sempre. Caminho morto dentro do fluxo é onde o próximo incidente se esconde.
Um exemplo de mensagem nova ao cliente
O texto novo de confirmação liga primeiro para pedidos internos. A chave do pedido escolhe o caminho uma vez. O time compara reclamação e erro de uma semana. Se o texto se sustenta, a flag amplia para um tipo de pedido e, na data combinada, vira o único caminho. A versão antiga sai.
No meio da semana, um erro no texto novo faz o plantão fechar a flag. Os pedidos seguintes voltam ao texto anterior. Os que já receberam a mensagem nova ficam listados, não “desenviados”. A flag segurou o alcance.
Checklist prático
A flag está pronta quando dá para dizer quem entra, quem mede e quando ela acaba.
- Recorte escrito, estável pela chave do caso
- Versão nova e anterior empacotadas ao mesmo tempo
- Caso não troca de caminho no meio
- Medição de erro e retrabalho antes de ampliar
- Quem pode ampliar e quem pode fechar, inclusive no turno
- Runbook de como desligar
- Data para retirar a flag
- Lista de flags vencidas, sem caminho morto eterno
Erros comuns
A flag vira configuração secreta quando falta recorte ou prazo.
- Ligar para todos porque o botão estava à mão
- Sortear o caminho de novo a cada passo do mesmo caso
- Ampliar sem olhar erro e retrabalho
- Não ter como desligar de noite
- Deixar a flag para sempre depois que o caminho único já foi escolhido
- Manter o caminho rejeitado desligado dentro do fluxo
- Não registrar qual caso tomou qual caminho
- Achar que fechar a flag desfaz mensagem já enviada
Onde a flag entra na publicação?
Em automações de processos, feature flag é a publicação em recorte. O caminho anterior continua inteiro até a medição autorizar a troca.