register-feature-flag

name: register-feature-flag description: > 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. needs: [create-admin-routing] produces: "feature_flag.xml entry with stability=beta and state=0"

Instructions

Open install-dev/data/xml/feature_flag.xml.

Add inside <entities>:

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

The name field (which maps to the id attribute in XML) must exactly match the _legacy_feature_flag values in the routing YAML.
Insert a row manually for local dev: INSERT INTO ps_feature_flag (name, state, stability) VALUES ('{domain}', 0, 'beta');
Enable for development: UPDATE ps_feature_flag SET state=1 WHERE name='{domain}';
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. Skill-specific reminder:

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