diff --git a/.changeset/30275-plugin-dev-feature-flags-bullet.md b/.changeset/30275-plugin-dev-feature-flags-bullet.md
new file mode 100644
index 00000000000..86cbf44f4b5
--- /dev/null
+++ b/.changeset/30275-plugin-dev-feature-flags-bullet.md
@@ -0,0 +1,10 @@
+---
+'@objectstack/skills': patch
+---
+
+docs(skills): `objectstack-platform`'s plugin-development reference no longer teaches the removed `feature_flags` settings namespace
+
+Clause-②: no
+Metadata-protocol: none
+
+The "Feature Flags" section listed a `feature_flags` settings manifest with `ai_enabled` / `beta_*` toggles and `OS_FEATURE_FLAGS_*` env overrides. That namespace was removed from `@objectstack/service-settings` (reading it is refused with `SETTINGS_UNKNOWN_NAMESPACE`, and the env vars do nothing). The bullet now gives the live answer: a plugin that needs an org toggle declares its own `SettingsManifest` and registers it on the `settings` service.
diff --git a/skills/objectstack-platform/references/plugin-development.md b/skills/objectstack-platform/references/plugin-development.md
index 0ac5a43223e..4c05f61ecc9 100644
--- a/skills/objectstack-platform/references/plugin-development.md
+++ b/skills/objectstack-platform/references/plugin-development.md
@@ -351,9 +351,8 @@ descriptor) was itself dead: no endpoint ever served it. Runtime capability disc
 
 The live toggle surfaces are runtime configuration, not authored metadata:
 
-- **`feature_flags` settings manifest** (`@objectstack/service-settings`) — org-tunable
-  toggles like `ai_enabled` / `beta_*`, resolvable at runtime and env-overridable via
-  `OS_FEATURE_FLAGS_*` (ADR-0007 settings cascade).
+- **Org toggles** — no shared flags namespace exists; a plugin that needs one declares
+  its own `SettingsManifest` and registers it on the `settings` service (ADR-0007 cascade).
 - **Auth capability gates** — `requiresFeature` on actions/params lowers to the
   `PUBLIC_AUTH_FEATURES` registry (`kernel/public-auth-features.ts`), the fixed
   deployment-level flags plugin-auth advertises to anonymous clients.