@@ -0,0 +1,14 @@
+---
+'@objectstack/spec': patch
+'@objectstack/platform-objects': patch
+---
+
+Clause-②: no
+
+Six help texts an administrator reads in Setup no longer carry ADR numbers. On the Permission Sets edit form,
+`isDefault`, `managedBy` and `packageId` are rewritten as plain sentences that say what the field does, and
+`adminScope` drops its "(ADR-0090 D12)" prefix. On the Positions edit form, `delegatable` drops "(ADR-0091 D3)".
+The view form's End-user controls description drops "(ADR-0047, Airtable Interface parity)".
+
+The ADR references moved to the comments beside the form rows. The generated metadata-forms translations carry
+the new wording in en, zh-CN, ja-JP and es-ES. No key, type or accept/refuse result changes.
@@ -23,9 +23,11 @@
  *   2. every leaf of the four committed `objects` bundles;
  *   3. the type-level `label` / `description` of the four `metadataForms`
  *      bundles — the sentence a Setup metadata page (Positions, Capabilities,
- *      Permission Sets) shows under its title. Section descriptions and field
- *      `helpText` of those forms are the spec's form copy and are not judged
- *      here;
+ *      Permission Sets) shows under its title, plus the six form leaves named
+ *      in `FORM_HELP_LEAVES` (the Permission Sets and Positions help texts and
+ *      the view form's End-user controls description). The other section
+ *      descriptions and field `helpText` of those forms are the spec's form
+ *      copy and are not judged here;
  *   4. `SETUP_APP` and this package's `SETUP_NAV_CONTRIBUTIONS`, and the
  *      hand-authored `apps.setup` subtree of each locale.
  *
@@ -172,6 +174,55 @@ describe('Setup copy carries no design-record vocabulary', () => {
     expect(offenders(strings)).toEqual([]);
   });
 
+  // The help texts an admin reads on Setup's Permission Sets and Positions edit
+  // forms, and the view form's End-user controls section. Each one carried a
+  // decision-record reference until the spec form source moved it into the
+  // comment beside the row; `en` is regenerated from that source, so judging
+  // the four bundles judges the source too.
+  const FORM_HELP_LEAVES = [
+    ['permission', 'fields', 'isDefault', 'helpText'],
+    ['permission', 'fields', 'managedBy', 'helpText'],
+    ['permission', 'fields', 'packageId', 'helpText'],
+    ['permission', 'fields', 'adminScope', 'helpText'],
+    ['position', 'fields', 'delegatable', 'helpText'],
+    ['view', 'sections', 'end_user_controls', 'description'],
+  ] as const;
+
+  function formHelpLeaves(bundle: unknown, locale: string): Array<[string, string]> {
+    return FORM_HELP_LEAVES.map((path) => {
+      const value = path.reduce<unknown>((node, key) => (node as Record<string, unknown> | undefined)?.[key], bundle);
+      const at = `${locale}.metadataForms.${path.join('.')}`;
+      expect(value, `${at} is in the population`).toBeTypeOf('string');
+      return [at, value as string];
+    });
+  }
+
+  it.each(Object.keys(FORM_BUNDLES))('the Permission Set, Position and view form help texts of the %s metadataForms bundle', (locale) => {
+    const strings = formHelpLeaves(FORM_BUNDLES[locale as keyof typeof FORM_BUNDLES], locale);
+    expect(strings).toHaveLength(FORM_HELP_LEAVES.length);
+    expect(offenders(strings)).toEqual([]);
+  });
+
+  it('the form help-text assertion fires on the prose it replaced', () => {
+    // Dark leg: the same walk over a bundle carrying the replaced wording must
+    // name every leaf, so a walk that reaches nothing cannot pass above.
+    const replaced = {
+      permission: { fields: {
+        isDefault: { helpText: 'App baseline for the everyone position (ADR-0090 D5): an app-level set is auto-bound at boot.' },
+        managedBy: { helpText: 'Record provenance (ADR-0086 D3): who owns this set across upgrades.' },
+        packageId: { helpText: 'Owning package id for a package-shipped set (ADR-0086 D3).' },
+        adminScope: { helpText: 'Delegated administration (ADR-0090 D12): lets holders of this set administer one business-unit subtree.' },
+      } },
+      position: { fields: {
+        delegatable: { helpText: 'Holders may delegate this position themselves, time-boxed and with a reason (ADR-0091 D3).' },
+      } },
+      view: { sections: {
+        end_user_controls: { description: 'What end users can do on this view (ADR-0047, Airtable Interface parity).' },
+      } },
+    };
+    expect(offenders(formHelpLeaves(replaced, 'replaced'))).toHaveLength(FORM_HELP_LEAVES.length);
+  });
+
   it('the Setup app, its nav contributions, and every locale\'s apps.setup translations', () => {
     const strings: Array<[string, string]> = [];
     copyStrings(SETUP_APP, 'SETUP_APP', strings);
 
@@ -1012,7 +1012,7 @@ export const enMetadataForms: NonNullable<TranslationData['metadataForms']> = {
       },
       end_user_controls: {
         label: "End-user controls",
-        description: "What end users can do on this view — quick filters, filter tabs, visualization switching (ADR-0047, Airtable Interface parity)."
+        description: "What end users can do on this view — quick filters, filter tabs, visualization switching."
       },
       navigation_sharing: {
         label: "Navigation & sharing",
@@ -2323,23 +2323,23 @@ export const enMetadataForms: NonNullable<TranslationData['metadataForms']> = {
       },
       isDefault: {
         label: "Is Default",
-        helpText: "App baseline for the everyone position (ADR-0090 D5): an app-level set is auto-bound at boot; a package-level set becomes an install-time suggestion an admin confirms. Default false."
+        helpText: "Gives this set to everyone who signs in, through the built-in everyone position. A set the app itself declares is granted at startup; a set from an installed package becomes a suggestion an admin confirms in Setup. A set with high-privilege permissions is never granted this way. Default false."
       },
       managedBy: {
         label: "Managed By",
-        helpText: "Record provenance (ADR-0086 D3): who owns this set across upgrades."
+        helpText: "Who owns this set: Package means it ships with a package and package upgrades update it; Platform and User mean it was created in this environment and upgrades leave it alone."
       },
       packageId: {
         label: "Package Id",
-        helpText: "Owning package id for a package-shipped set (ADR-0086 D3). Leave empty for an environment-authored set."
+        helpText: "The package that ships this set; a value naming any other package is refused. Leave empty for a set created in this environment."
       },
       systemPermissions: {
         label: "System Permissions",
         helpText: "List of system capability keys"
       },
       adminScope: {
         label: "Admin Scope",
-        helpText: "Delegated administration (ADR-0090 D12): lets holders of this set administer one business-unit subtree. businessUnit is the subtree root (sys_business_unit.name) and is required, non-blank; includeSubtree defaults to true; manageAssignments defaults to false and lets the holder assign people to positions, and grant sets directly, inside that subtree; a delegate may hand out only the sets named in assignablePermissionSets. Leave empty for a set that delegates nothing."
+        helpText: "Delegated administration: lets holders of this set administer one business-unit subtree. businessUnit is the subtree root (sys_business_unit.name) and is required, non-blank; includeSubtree defaults to true; manageAssignments defaults to false and lets the holder assign people to positions, and grant sets directly, inside that subtree; a delegate may hand out only the sets named in assignablePermissionSets. Leave empty for a set that delegates nothing."
       },
       objects: {
         label: "Objects",
@@ -2384,7 +2384,7 @@ export const enMetadataForms: NonNullable<TranslationData['metadataForms']> = {
       },
       delegatable: {
         label: "Delegatable",
-        helpText: "Holders may delegate this position themselves, time-boxed and with a reason (ADR-0091 D3). Default false — delegation is admin-only."
+        helpText: "Holders may delegate this position themselves, time-boxed and with a reason. Default false — delegation is admin-only."
       }
     }
   },