# Register Feature Flag

> Register Feature Flag is an Agent Skill for development published in the PrestaShop/PrestaShop repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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 name: `register-feature-flag`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/PrestaShop/PrestaShop/blob/HEAD/.ai/Component/Controller/skills/register-feature-flag/SKILL.md
- Repository: PrestaShop/PrestaShop (9,150 GitHub stars when collected)

## SKILL.md

# 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

---

Source: https://www.openparable.com/skill/development/register-feature-flag (OpenParable). Cite the canonical URL above.
