@se-studio/skills 1.9.10 → 1.9.11

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/skills
 
+## 1.9.11
+
+### Patch Changes
+
+- 3ecda13: Document that different UI/behaviour needs distinct `componentType` / `collectionType`; `cmsLabel` is for authors (+ trackingLocation), never a runtime layout/renderer switch. Update create-component, create-collection, and contentful-cms-core (synced into contentful-cms bundled `core` skill).
+
 ## 1.9.10
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/skills",
-  "version": "1.9.10",
+  "version": "1.9.11",
   "description": "SE Studio agent skills for marketing site development with Contentful CMS",
   "repository": {
     "type": "git",

package/skills/contentful-cms-core/SKILL.md

@@ -218,8 +218,8 @@ Based on the SE Studio content model:
 ### Component fields
 | Field | Type | Notes |
 |-------|------|-------|
-| `cmsLabel` | string | Internal name (required) |
-| `componentType` | string | Type discriminator (e.g. `HeroSimple`) |
+| `cmsLabel` | string | Internal name for authors in Contentful (required). Not a runtime layout/renderer switch — never branch code on it. |
+| `componentType` | string | Type discriminator for renderer lookup (e.g. `HeroSimple`). Different UI/behaviour needs a distinct value. |
 | `heading` | string | Main heading (only shown when `showHeading` is true) |
 | `showHeading` | boolean | Whether to display the heading |
 | `preHeading` | string | Text above the heading |
@@ -234,7 +234,7 @@ Based on the SE Studio content model:
 Same as Component plus:
 | Field | Type | Notes |
 |-------|------|-------|
-| `collectionType` | string | Type discriminator (e.g. `CardGrid`) |
+| `collectionType` | string | Type discriminator for renderer lookup (e.g. `CardGrid`). Different UI/behaviour needs a distinct value; do not switch on `cmsLabel`. |
 
 ### Page fields
 | Field | Type | Notes |

package/skills/se-marketing-sites-create-collection/SKILL.md

@@ -289,3 +289,7 @@ export const MyCollectionRegistration = defineCollection({
     *   Pass server-rendered cards as `children` to the client wrapper.
 7.  **Register**:
     *   Add to `collectionRegistrationsList` in `src/lib/registrations.ts`. The `name` is defined only in your `defineCollection(...)` call.
+8.  **Type vs label (hard rule)**:
+    *   New UI or behaviour → new Contentful `collectionType` enum value + registration. Never `if (cmsLabel)` / parse labels for layout or renderer choice.
+    *   `cmsLabel` is for authors (and may pass to `trackingLocation`); it is not a runtime discriminator.
+    *   Position/variant-only differences may share one Core under multiple `defineCollection` registrations; drive layout from `collectionType`.

package/skills/se-marketing-sites-create-component/SKILL.md

@@ -244,3 +244,7 @@ export const MyNewRegistration = defineComponent({
     *   Provide mock data for showcase.
 8.  **Register Component**:
     *   Add to `componentRegistrationsList` in `src/lib/registrations.ts`. The `name` is defined only in your `defineComponent(...)` call; do not duplicate it as a Record key.
+9.  **Type vs label (hard rule)**:
+    *   New UI or behaviour → new Contentful `componentType` enum value + registration. Never `if (cmsLabel)` / parse labels for layout or renderer choice.
+    *   `cmsLabel` is for authors (and may pass to `trackingLocation`); it is not a runtime discriminator.
+    *   Position/variant-only differences may share one Core under multiple `defineComponent` registrations; drive layout from `componentType`.