Feature flags — também chamadas de feature toggles — são interruptores em código que permitem ligar ou desligar uma funcionalidade sem precisar fazer um novo deploy. Em vez de "o deploy é o lançamento", o lançamento vira um evento separado, controlado em tempo real, independente de quando o código chegou em produção.
Essa separação entre deploy e release resolve um dos problemas mais caros de desenvolvimento de produto: o all-or-nothing. Sem feature flags, lançar significa expor a funcionalidade para 100% dos usuários de uma vez — e torcer para que funcione.
Os quatro usos práticos de feature flags
- Release flags — controlam quando uma funcionalidade fica visível, permitindo fazer merge de código incompleto na branch principal sem expor nada ainda.
- Experiment flags (A/B testing) — direcionam porcentagens de usuários para variantes diferentes, permitindo medir impacto real antes de decidir o rollout completo.
- Ops flags (kill switches) — desligam uma funcionalidade instantaneamente se ela causar problemas em produção, sem precisar de rollback de deploy nem esperar um novo build.
- Permission flags — controlam acesso a funcionalidades por plano, empresa ou usuário — a base técnica de qualquer modelo de planos em um SaaS.
Rollout gradual: o padrão que reduz risco de verdade
Em vez de ligar uma flag para todos de uma vez, o padrão recomendado para funcionalidades de risco é um rollout progressivo:
- Internamente primeiro — ative para a própria equipe, validando comportamento em condições reais de produção antes de qualquer usuário externo ver.
- Canary release — libere para 1% a 5% dos usuários reais, monitorando métricas de erro e performance de perto.
- Expansão gradual — 10%, 25%, 50%, 100%, com pontos de checagem entre cada etapa e critério claro de "parar e reverter" se algo sair do esperado.
- Cleanup — depois do rollout completo e estável, remova a flag e o código morto que ela controlava. Flags esquecidas viram dívida técnica silenciosa.
O verdadeiro valor de uma feature flag não é o lançamento — é a capacidade de reverter uma decisão ruim em segundos, sem pânico e sem deploy de emergência.
O que pode dar errado (e como evitar)
Feature flags mal geridas criam seu próprio tipo de dívida técnica: código cheio de condicionais aninhadas, combinações de flags nunca testadas juntas, e comportamento em produção que difere silenciosamente do ambiente de testes. A mitigação passa por três práticas: testar as combinações de flags mais prováveis, não só cada flag isolada; centralizar a gestão em uma ferramenta dedicada (LaunchDarkly, Unleash, GrowthBook ou uma solução própria simples) em vez de variáveis de ambiente espalhadas; e tratar a remoção de flags antigas como parte do processo normal de desenvolvimento, não como um projeto de limpeza eventual.
No Kordis Lab, implementamos feature flags como parte da esteira de deploy desde o início de projetos SaaS — porque a capacidade de lançar com controle, medir impacto real e reverter sem drama vale mais, no longo prazo, do que qualquer aceleração de curto prazo obtida pulando essa etapa.