> ## 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

> Recommended rollout, kill-switch, and migration-flag model.

# Feature Flags

The current repository contains a lightweight inherited flag scaffold.

The recommended target for this platform is stricter:

* typed flag catalog in code
* Supabase-backed runtime values
* workspace-scoped overrides
* explicit kill switches
* migration flags for Charles cutover
* one shared resolver across `app`, `api`, and `worker`

## Why this matters

This repo is not just a frontend product surface.

It needs flags that can safely control:

* compatibility cutover
* provider write paths
* worker dispatch behavior
* per-workspace migration state

## Recommended flag classes

1. `surface.*` for UI exposure
2. `runtime.*` for backend capabilities
3. `kill.*` for emergency stops
4. `migration.*` for workspace cutover control

## Current implementation gap

The docs already assume a stronger operational flag model than the code currently provides.

The next sequence should close that gap before broader rollout work continues.

## Active flags

| Key                            | Default | Env override                                          | Purpose                                                                                                                                                                                             |
| ------------------------------ | ------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inbox.gbAgentHandoffPreview`  | OFF     | `NEXT_PUBLIC_FLAG_INBOX_GB_AGENT_HANDOFF_PREVIEW=1`   | Render the gb-agent handoff preview card for `human_review` drafts. See [Platform → gb-agent Connector](/platform/gb-agent-connector).                                                              |
| `inbox.gbAgentDraftReviewCard` | OFF     | `NEXT_PUBLIC_FLAG_INBOX_GB_AGENT_DRAFT_REVIEW_CARD=1` | Render the legacy green `✨ AI draft` pending-draft review card. When OFF, GB-Agent drafts still seed the composer and the normal Send button accepts the hidden draft through the draft-accept RPC. |

## Read next

* [Next Steps](/platform/next-steps)
* [Operations Runbook](/operations/runbook)
* [Migration Plan](/platform/migration)