# Register Feature Flag

> Register the domain's feature flag in `feature_flag.xml`. This entry populates the `ps_feature_flag` table at install/upgrade and enables the flag-based routing between legacy and Symfony controllers.

- Skill: `gabrielmoreira/register-feature-flag` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/register-feature-flag`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/register-feature-flag/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/register-feature-flag

---


# register-feature-flag

## Instructions

1. Open `install-dev/data/xml/feature_flag.xml`.
2. Add inside `<entities>`:
   ```xml
   <feature_flag id="{domain}">
     <stability>beta</stability>
     <state>0</state>
     <label_wording>{Domain} page</label_wording>
     <label_domain>Admin.{Section}.Feature</label_domain>
     <description_wording>Enable the new Symfony-based {domain} management page (beta).</description_wording>
     <description_domain>Admin.{Section}.Feature</description_domain>
   </feature_flag>
   ```
3. The `name` field (which maps to the `id` attribute in XML) must exactly match the `_legacy_feature_flag` values in the routing YAML.
4. Insert a row manually for local dev: `INSERT INTO ps_feature_flag (name, state, stability) VALUES ('{domain}', 0, 'beta');`
5. Enable for development: `UPDATE ps_feature_flag SET state=1 WHERE name='{domain}';`
6. Verify routing: visit legacy URL with flag OFF → legacy page. Enable flag → redirect to Symfony route.

## Rules

Conventions (atomic commit, beta→stable lifecycle) are in [Controller/CONTEXT.md](../../CONTEXT.md). Skill-specific reminder:

- state starts as 0 — contributors enable manually; merchants never see it until GA