| name | add-option |
| description | Add a new option to an existing sentry-options schema. Use when adding feature flags or tunable parameters to a service already using sentry-options. |
Add an Option to a sentry-options Schema
Guide the user through adding an option (or feature flag) to a service that's already onboarded to sentry-options. The authoritative steps and the full type reference live in the options guide — follow it rather than reproducing details here. This skill defers specifics (type shapes, evolution rules) to the docs so it can't drift.
Options guide: https://github.com/getsentry/sentry-options/blob/main/docs/options.md#adding-an-option
How to run this
-
Confirm the service is onboarded — it should already have sentry-options/schemas/{namespace}/schema.json. If not, use /onboard first.
-
Gather the new option from the user: namespace, name, type (string, integer, number, boolean, array, object, or a feature.-prefixed flag), default, and description.
-
Add it under properties in sentry-options/schemas/{namespace}/schema.json. For the exact shape of each type — arrays (items), structs (properties), dicts (additionalProperties), optional fields, and feature $refs — read the options guide; don't write type rules from memory.
-
Tell the user the workflow: open a PR in the service repo (CI validates the change is additive per the schema-evolution rules), merge it, then optionally set a non-default value in sentry-options-automator. The option uses its schema default until a value is set.
For the schema-evolution rules and how to set values, see the options guide.
