What problem does it solve?
Feature flag changes in the Vellum Assistant codebase require consistent registry declarations, safe defaults, coordinated platform-side Terraform provisioning, and disciplined rollout practices. This Skill encodes those rules so flag additions, renames, removals, and reviews follow the same checklist every time.
Core Features & Use Cases
- Flag Registry Enforcement: Ensures new flags use kebab-case keys,
scope: "assistant", safe defaults, and declaration in meta/feature-flags/feature-flag-registry.json.
- Rollout Hygiene Rules: Blocks new release-note migrations (the workspace-bulletin mechanism was removed) and restricts permission-controls-v2 from adding new deterministic approval modes.
- Structured Review Workflow: Walks reviewers through registry checks, default behavior, docs leaks, platform Terraform updates, and focused test recommendations.
- Use Case: When reviewing a PR that adds a rollout-gated assistant behavior, use this Skill to verify the flag key format, confirm the companion vellum-assistant-platform PR exists, and produce PR notes covering default state and rollout plan.
Quick Start
Review this pull request that adds a new assistant feature flag and check it against the rollout and registry rules.