diff --git a/@packages/@config/src/tier-styles/index.ts b/@packages/@config/src/tier-styles/index.ts
index 5e6283117..b20b73fb7 100644
--- a/@packages/@config/src/tier-styles/index.ts
+++ b/@packages/@config/src/tier-styles/index.ts
@@ -3,13 +3,13 @@ export type { TierButtonStyle, TierColumnStyle, TierPreset, TierStyles } from '@
 
 /**
  * Platform-specific subscription tier slugs.
- * This is the ONLY place business tier names are defined.
+ * 6 tiers: FREE (0) → IRIDIUM (5)
+ * Note: Iridium replaced Diamond. Uses the diamond visual preset from ui-style-effects.
  */
 export type PlatformTierSlug = 'free' | 'bronze' | 'silver' | 'gold' | 'platinum' | 'iridium';
 
 /**
  * Platform tier → visual style mapping.
- * Iridium uses the diamond visual preset.
  */
 export const tierStyles = createTierStyles<PlatformTierSlug>({
   free: presets.default,