> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Feature Flags

> Modelo recomendado de rollout, kill-switch e flags de migração.

# Feature Flags

O repositório atual contém um scaffold de flags herdado e leve.

O alvo recomendado para esta plataforma é mais rigoroso:

* catálogo de flags tipado no código
* valores em runtime baseados no Supabase
* overrides com escopo de workspace
* kill switches explícitos
* flags de migração para o cutover do Charles
* um resolver compartilhado entre `app`, `api` e `worker`

## Por que isso importa

Este repositório não é apenas uma superfície de produto frontend.

Ele precisa de flags que possam controlar com segurança:

* cutover de compatibilidade
* caminhos de escrita do provider
* comportamento de dispatch do worker
* estado de migração por workspace

## Classes de flag recomendadas

1. `surface.*` para exposição de UI
2. `runtime.*` para capacidades de backend
3. `kill.*` para paradas de emergência
4. `migration.*` para controle de cutover do workspace

## Lacuna de implementação atual

A documentação já assume um modelo operacional de flags mais forte do que o código atualmente oferece.

A próxima sequência deve fechar essa lacuna antes que o trabalho de rollout mais amplo continue.

## Flags ativas

| Chave                         | Padrão    | Override por env                                    | Finalidade                                                                                                                                                          |
| ----------------------------- | --------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inbox.gbAgentHandoffPreview` | DESLIGADO | `NEXT_PUBLIC_FLAG_INBOX_GB_AGENT_HANDOFF_PREVIEW=1` | Renderiza o card de preview de handoff do gb-agent para rascunhos (drafts) `human_review`. Veja [Platform → Conector gb-agent](/pt-BR/platform/gb-agent-connector). |

## Leia a seguir

* [Próximos Passos](/pt-BR/platform/next-steps)
* [Runbook de Operações](/pt-BR/operations/runbook)
* [Plano de Migração](/pt-BR/platform/migration)