| name | vellum-feature-flag-rollout |
| description | Guide Vellum Assistant feature flag changes and rollout hygiene. Use when adding, editing, reviewing, or documenting assistant feature flags, rollout-gated behavior, or platform flag follow-up work. |
Vellum Feature Flag Rollout
Flag Rules
Assistant feature flags use simple kebab-case keys and must be declared in:
meta/feature-flags/feature-flag-registry.json
New flags require:
scope: "assistant"- a canonical kebab-case key
- a safe default
- tests or guard coverage when resolver behavior changes
- a companion
vellum-assistant-platform PR to provision the flag in Terraform
Rollout Hygiene
There is no release-note surfacing mechanism — the workspace-bulletin feature was removed and the historical release-note migrations are frozen. Do not add new release-note migrations for any feature (flagged or GA). If a release needs user-facing notes, design an explicit on-demand surfacing mechanism first.
Permission Controls V2
Under permission-controls-v2, do not add new deterministic approval modes for assistant-owned actions beyond the conversation-scoped host computer access gate. Avoid global toggles, persistent trust-rule UI, wildcard scopes, and time-window approvals.
Review Workflow
- Confirm whether the change adds, renames, removes, or consumes a flag.
- Check registry declaration and key format.
- Check default behavior and rollout safety.
- Check docs, release notes, and user-facing copy for flag leaks.
- Check whether the platform repo needs a Terraform update.
- Recommend focused tests for resolver, route, UI, or behavior changes.
PR Notes
Call out:
- flag key
- default state
- rollout plan
- companion platform PR status
- whether release notes are intentionally omitted
