@primer/primitives 11.4.0-rc.f798df25 → 11.4.1-rc.4e2d1de5

package/dist/styleLint/functional/themes/dark-dimmed-high-contrast.json

@@ -297,6 +297,7 @@
     "key": "{bgColor.accent.emphasis}",
     "$value": "#1b4b91",
     "$type": "color",
+    "$description": "Strong accent background for active states and focused states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -312,6 +313,10 @@
         "dark-dimmed-high-contrast": "#1b4b91",
         "dark-tritanopia-high-contrast": "#0f2d5c",
         "dark-protanopia-deuteranopia-high-contrast": "#0f2d5c"
+      },
+      "org.primer.llm": {
+        "usage": ["active-states", "current", "selected", "active-toggle"],
+        "rules": "MUST use for selected or active states. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -319,6 +324,7 @@
     "original": {
       "$value": "{base.color.blue.7}",
       "$type": "color",
+      "$description": "Strong accent background for active states and focused states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -334,6 +340,10 @@
           "dark-dimmed-high-contrast": "{base.color.blue.7}",
           "dark-tritanopia-high-contrast": "{base.color.blue.9}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.blue.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["active-states", "current", "selected", "active-toggle"],
+          "rules": "MUST use for selected or active states. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.accent.emphasis}"
@@ -346,6 +356,7 @@
     "key": "{bgColor.accent.muted}",
     "$value": "#4184e41a",
     "$type": "color",
+    "$description": "Subtle accent background for informational or selected elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -363,6 +374,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["selected-row", "info-banner", "active-nav-item", "highlight"],
+        "rules": "Use for selected states or informational highlights. Pair with fgColor.accent for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -371,6 +386,7 @@
     "original": {
       "$value": "{base.color.blue.4}",
       "$type": "color",
+      "$description": "Subtle accent background for informational or selected elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -388,6 +404,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["selected-row", "info-banner", "active-nav-item", "highlight"],
+          "rules": "Use for selected states or informational highlights. Pair with fgColor.accent for text."
         }
       },
       "alpha": 0.1,
@@ -401,6 +421,7 @@
     "key": "{bgColor.attention.emphasis}",
     "$value": "#6c4400",
     "$type": "color",
+    "$description": "Strong attention background for prominent warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -415,6 +436,10 @@
         "dark-dimmed-high-contrast": "#6c4400",
         "dark-protanopia-deuteranopia-high-contrast": "#452700",
         "dark-tritanopia-high-contrast": "#452700"
+      },
+      "org.primer.llm": {
+        "usage": ["warning-badge", "caution-label", "attention-indicator"],
+        "rules": "Use for prominent warnings. Consider fgColor.default for text due to yellow contrast."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -422,6 +447,7 @@
     "original": {
       "$value": "{base.color.yellow.7}",
       "$type": "color",
+      "$description": "Strong attention background for prominent warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -436,6 +462,10 @@
           "dark-dimmed-high-contrast": "{base.color.yellow.7}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.yellow.9}",
           "dark-tritanopia-high-contrast": "{base.color.yellow.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["warning-badge", "caution-label", "attention-indicator"],
+          "rules": "Use for prominent warnings. Consider fgColor.default for text due to yellow contrast."
         }
       },
       "key": "{bgColor.attention.emphasis}"
@@ -448,6 +478,7 @@
     "key": "{bgColor.attention.muted}",
     "$value": "#ae7c1426",
     "$type": "color",
+    "$description": "Subtle attention background for warnings and caution states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -465,6 +496,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["warning-banner", "caution-message", "pending-state"],
+        "rules": "Use for warnings that need user attention. Pair with fgColor.attention for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -473,6 +508,7 @@
     "original": {
       "$value": "{base.color.yellow.4}",
       "$type": "color",
+      "$description": "Subtle attention background for warnings and caution states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -490,6 +526,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["warning-banner", "caution-message", "pending-state"],
+          "rules": "Use for warnings that need user attention. Pair with fgColor.attention for text."
         }
       },
       "alpha": 0.15,
@@ -503,6 +543,7 @@
     "key": "{bgColor.black}",
     "$value": "#010409",
     "$type": "color",
+    "$description": "Pure black background",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -511,6 +552,10 @@
       },
       "org.primer.overrides": {
         "dark": "#010409"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw black. Use semantic alternatives: bgColor.emphasis for dark backgrounds, bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -518,6 +563,7 @@
     "original": {
       "$value": "{base.color.neutral.0}",
       "$type": "color",
+      "$description": "Pure black background",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -526,6 +572,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.0}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw black. Use semantic alternatives: bgColor.emphasis for dark backgrounds, bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{bgColor.black}"
@@ -538,6 +588,7 @@
     "key": "{bgColor.closed.emphasis}",
     "$value": "#922323",
     "$type": "color",
+    "$description": "Strong background for closed state badges and labels",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -556,6 +607,10 @@
         "light-protanopia-deuteranopia-high-contrast": "#3d444d",
         "dark-protanopia-deuteranopia": "#3d444d",
         "dark-protanopia-deuteranopia-high-contrast": "#3d444d"
+      },
+      "org.primer.llm": {
+        "usage": ["closed-badge", "closed-label", "declined-status-badge"],
+        "rules": "Use for prominent closed/declined state indicators. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -563,6 +618,7 @@
     "original": {
       "$value": "{bgColor.danger.emphasis}",
       "$type": "color",
+      "$description": "Strong background for closed state badges and labels",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -581,6 +637,10 @@
           "light-protanopia-deuteranopia-high-contrast": "{bgColor.neutral.emphasis}",
           "dark-protanopia-deuteranopia": "{bgColor.neutral.emphasis}",
           "dark-protanopia-deuteranopia-high-contrast": "{bgColor.neutral.emphasis}"
+        },
+        "org.primer.llm": {
+          "usage": ["closed-badge", "closed-label", "declined-status-badge"],
+          "rules": "Use for prominent closed/declined state indicators. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.closed.emphasis}"
@@ -593,6 +653,7 @@
     "key": "{bgColor.closed.muted}",
     "$value": "#e5534b1a",
     "$type": "color",
+    "$description": "Subtle background for closed state indicators (issues, PRs)",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -628,6 +689,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["closed-issue", "closed-pr", "declined-state"],
+        "rules": "Use for closed/declined status indicators. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -635,6 +700,7 @@
     "original": {
       "$value": "{bgColor.danger.muted}",
       "$type": "color",
+      "$description": "Subtle background for closed state indicators (issues, PRs)",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -670,6 +736,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["closed-issue", "closed-pr", "declined-state"],
+          "rules": "Use for closed/declined status indicators. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{bgColor.closed.muted}"
@@ -682,6 +752,7 @@
     "key": "{bgColor.danger.emphasis}",
     "$value": "#922323",
     "$type": "color",
+    "$description": "Emphasized danger background for critical errors and delete confirmations",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -699,6 +770,10 @@
         "dark-high-contrast": "#5d0f12",
         "dark-dimmed-high-contrast": "#922323",
         "dark-tritanopia-high-contrast": "#5d0f12"
+      },
+      "org.primer.llm": {
+        "usage": ["delete-button", "critical-alert", "destructive-confirmation"],
+        "rules": "MUST use for destructive action buttons like delete. Use fgColor.onEmphasis for text on this background."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -706,6 +781,7 @@
     "original": {
       "$value": "{base.color.red.7}",
       "$type": "color",
+      "$description": "Emphasized danger background for critical errors and delete confirmations",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -723,6 +799,10 @@
           "dark-high-contrast": "{base.color.red.9}",
           "dark-dimmed-high-contrast": "{base.color.red.7}",
           "dark-tritanopia-high-contrast": "{base.color.red.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["delete-button", "critical-alert", "destructive-confirmation"],
+          "rules": "MUST use for destructive action buttons like delete. Use fgColor.onEmphasis for text on this background."
         }
       },
       "key": "{bgColor.danger.emphasis}"
@@ -735,6 +815,7 @@
     "key": "{bgColor.danger.muted}",
     "$value": "#e5534b1a",
     "$type": "color",
+    "$description": "Muted danger background for error states and destructive action contexts",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -761,6 +842,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["error-message", "destructive-action", "validation-error"],
+        "rules": "Use for error states and destructive action backgrounds. Pair with fgColor.danger for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -769,6 +854,7 @@
     "original": {
       "$value": "{base.color.red.4}",
       "$type": "color",
+      "$description": "Muted danger background for error states and destructive action contexts",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -795,6 +881,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["error-message", "destructive-action", "validation-error"],
+          "rules": "Use for error states and destructive action backgrounds. Pair with fgColor.danger for text."
         }
       },
       "alpha": 0.1,
@@ -808,6 +898,7 @@
     "key": "{bgColor.default}",
     "$value": "#212830",
     "$type": "color",
+    "$description": "Default background color for pages and main content areas",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -824,6 +915,10 @@
         "dark-high-contrast": "#010409",
         "dark-tritanopia-high-contrast": "#010409",
         "dark-protanopia-deuteranopia-high-contrast": "#010409"
+      },
+      "org.primer.llm": {
+        "usage": ["page-background", "main-content", "card-background"],
+        "rules": "Use as the primary background for pages and content areas. Do NOT use for emphasis or highlighting."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -831,6 +926,7 @@
     "original": {
       "$value": "{base.color.neutral.3}",
       "$type": "color",
+      "$description": "Default background color for pages and main content areas",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -847,6 +943,10 @@
           "dark-high-contrast": "{base.color.neutral.0}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.0}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.0}"
+        },
+        "org.primer.llm": {
+          "usage": ["page-background", "main-content", "card-background"],
+          "rules": "Use as the primary background for pages and content areas. Do NOT use for emphasis or highlighting."
         }
       },
       "key": "{bgColor.default}"
@@ -859,6 +959,7 @@
     "key": "{bgColor.disabled}",
     "$value": "#2a313c",
     "$type": "color",
+    "$description": "Background for disabled interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -875,6 +976,10 @@
         "dark-high-contrast": "#262c36",
         "dark-tritanopia-high-contrast": "#262c36",
         "dark-protanopia-deuteranopia-high-contrast": "#262c36"
+      },
+      "org.primer.llm": {
+        "usage": ["disabled-button", "disabled-input", "inactive-element"],
+        "rules": "MUST use for disabled state backgrounds. Pair with fgColor.disabled for text. Do NOT use for active elements."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -882,6 +987,7 @@
     "original": {
       "$value": "{base.color.neutral.5}",
       "$type": "color",
+      "$description": "Background for disabled interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -898,6 +1004,10 @@
           "dark-high-contrast": "{base.color.neutral.4}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.4}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.4}"
+        },
+        "org.primer.llm": {
+          "usage": ["disabled-button", "disabled-input", "inactive-element"],
+          "rules": "MUST use for disabled state backgrounds. Pair with fgColor.disabled for text. Do NOT use for active elements."
         }
       },
       "key": "{bgColor.disabled}"
@@ -910,6 +1020,7 @@
     "key": "{bgColor.done.emphasis}",
     "$value": "#5936a2",
     "$type": "color",
+    "$description": "Strong background for completed/done state badges and labels",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -924,6 +1035,10 @@
         "dark-dimmed-high-contrast": "#5936a2",
         "dark-tritanopia-high-contrast": "#352160",
         "dark-protanopia-deuteranopia-high-contrast": "#352160"
+      },
+      "org.primer.llm": {
+        "usage": ["done-badge", "merged-label", "completed-indicator"],
+        "rules": "Use for prominent done/completed state indicators. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -931,6 +1046,7 @@
     "original": {
       "$value": "{base.color.purple.7}",
       "$type": "color",
+      "$description": "Strong background for completed/done state badges and labels",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -945,6 +1061,10 @@
           "dark-dimmed-high-contrast": "{base.color.purple.7}",
           "dark-tritanopia-high-contrast": "{base.color.purple.9}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.purple.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["done-badge", "merged-label", "completed-indicator"],
+          "rules": "Use for prominent done/completed state indicators. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.done.emphasis}"
@@ -957,6 +1077,7 @@
     "key": "{bgColor.done.muted}",
     "$value": "#986ee226",
     "$type": "color",
+    "$description": "Subtle background for completed/done state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -974,6 +1095,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["completed-task", "merged-pr", "done-state"],
+        "rules": "Use for completed/done status indicators. Conveys finished or merged state."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -982,6 +1107,7 @@
     "original": {
       "$value": "{base.color.purple.4}",
       "$type": "color",
+      "$description": "Subtle background for completed/done state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -999,6 +1125,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["completed-task", "merged-pr", "done-state"],
+          "rules": "Use for completed/done status indicators. Conveys finished or merged state."
         }
       },
       "alpha": 0.15,
@@ -1012,6 +1142,7 @@
     "key": "{bgColor.draft.emphasis}",
     "$value": "#3d444d",
     "$type": "color",
+    "$description": "Strong background for draft state badges and labels",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1020,6 +1151,10 @@
         "codeSyntax": {
           "web": "var(--bgColor-draft-emphasis)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["draft-badge", "draft-label", "wip-indicator"],
+        "rules": "Use for prominent draft state indicators. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1027,6 +1162,7 @@
     "original": {
       "$value": "{bgColor.neutral.emphasis}",
       "$type": "color",
+      "$description": "Strong background for draft state badges and labels",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1035,6 +1171,10 @@
           "codeSyntax": {
             "web": "var(--bgColor-draft-emphasis)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["draft-badge", "draft-label", "wip-indicator"],
+          "rules": "Use for prominent draft state indicators. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.draft.emphasis}"
@@ -1047,6 +1187,7 @@
     "key": "{bgColor.draft.muted}",
     "$value": "#656c7633",
     "$type": "color",
+    "$description": "Subtle background for draft state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1082,6 +1223,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["draft-pr", "draft-issue", "work-in-progress"],
+        "rules": "Use for draft/WIP status indicators. Conveys incomplete or pending state."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1089,6 +1234,7 @@
     "original": {
       "$value": "{bgColor.neutral.muted}",
       "$type": "color",
+      "$description": "Subtle background for draft state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1124,6 +1270,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["draft-pr", "draft-issue", "work-in-progress"],
+          "rules": "Use for draft/WIP status indicators. Conveys incomplete or pending state."
         }
       },
       "key": "{bgColor.draft.muted}"
@@ -1136,6 +1286,7 @@
     "key": "{bgColor.emphasis}",
     "$value": "#3d444d",
     "$type": "color",
+    "$description": "High-emphasis dark background for strong visual contrast",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1147,6 +1298,10 @@
       },
       "org.primer.overrides": {
         "dark": "#3d444d"
+      },
+      "org.primer.llm": {
+        "usage": ["tooltip", "badge-background", "high-contrast-element"],
+        "rules": "Use for elements needing strong visual emphasis. Pair with fgColor.onEmphasis for text. Do NOT use for large areas."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1154,6 +1309,7 @@
     "original": {
       "$value": "{base.color.neutral.7}",
       "$type": "color",
+      "$description": "High-emphasis dark background for strong visual contrast",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1165,6 +1321,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.7}"
+        },
+        "org.primer.llm": {
+          "usage": ["tooltip", "badge-background", "high-contrast-element"],
+          "rules": "Use for elements needing strong visual emphasis. Pair with fgColor.onEmphasis for text. Do NOT use for large areas."
         }
       },
       "key": "{bgColor.emphasis}"
@@ -1177,6 +1337,7 @@
     "key": "{bgColor.inset}",
     "$value": "#151b23",
     "$type": "color",
+    "$description": "Inset background for recessed content areas like wells or sunken panels",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1193,6 +1354,10 @@
         "light-high-contrast": "#151b23",
         "light-tritanopia-high-contrast": "#151b23",
         "light-protanopia-deuteranopia-high-contrast": "#151b23"
+      },
+      "org.primer.llm": {
+        "usage": ["well", "sunken-panel", "recessed-area", "input-background"],
+        "rules": "Use for visually recessed areas. Creates depth hierarchy. Suitable for input fields and wells."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1200,6 +1365,7 @@
     "original": {
       "$value": "{base.color.neutral.2}",
       "$type": "color",
+      "$description": "Inset background for recessed content areas like wells or sunken panels",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1216,6 +1382,10 @@
           "light-high-contrast": "{base.color.neutral.2}",
           "light-tritanopia-high-contrast": "{base.color.neutral.2}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.neutral.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["well", "sunken-panel", "recessed-area", "input-background"],
+          "rules": "Use for visually recessed areas. Creates depth hierarchy. Suitable for input fields and wells."
         }
       },
       "key": "{bgColor.inset}"
@@ -1228,6 +1398,7 @@
     "key": "{bgColor.inverse}",
     "$value": "#cdd9e5",
     "$type": "color",
+    "$description": "Inverse background that flips between light and dark modes",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1236,6 +1407,10 @@
       },
       "org.primer.overrides": {
         "dark": "#cdd9e5"
+      },
+      "org.primer.llm": {
+        "usage": ["overlay-content", "inverse-theme-element"],
+        "rules": "Use when you need opposite theme background. Pair with fgColor.onInverse for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1243,6 +1418,7 @@
     "original": {
       "$value": "{base.color.neutral.13}",
       "$type": "color",
+      "$description": "Inverse background that flips between light and dark modes",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1251,6 +1427,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.13}"
+        },
+        "org.primer.llm": {
+          "usage": ["overlay-content", "inverse-theme-element"],
+          "rules": "Use when you need opposite theme background. Pair with fgColor.onInverse for text."
         }
       },
       "key": "{bgColor.inverse}"
@@ -1263,6 +1443,7 @@
     "key": "{bgColor.muted}",
     "$value": "#262c36",
     "$type": "color",
+    "$description": "Muted background for secondary content areas and subtle grouping",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1282,6 +1463,10 @@
         "dark-high-contrast": "#151b23",
         "dark-tritanopia-high-contrast": "#151b23",
         "dark-protanopia-deuteranopia-high-contrast": "#151b23"
+      },
+      "org.primer.llm": {
+        "usage": ["secondary-content", "code-block-background", "table-header", "sidebar"],
+        "rules": "Use for secondary content areas or to create visual grouping. Do NOT use for primary page backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1289,6 +1474,7 @@
     "original": {
       "$value": "{base.color.neutral.4}",
       "$type": "color",
+      "$description": "Muted background for secondary content areas and subtle grouping",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1308,6 +1494,10 @@
           "dark-high-contrast": "{base.color.neutral.2}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.2}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["secondary-content", "code-block-background", "table-header", "sidebar"],
+          "rules": "Use for secondary content areas or to create visual grouping. Do NOT use for primary page backgrounds."
         }
       },
       "key": "{bgColor.muted}"
@@ -1320,6 +1510,7 @@
     "key": "{bgColor.neutral.emphasis}",
     "$value": "#3d444d",
     "$type": "color",
+    "$description": "Strong neutral background for prominent neutral elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1336,6 +1527,10 @@
         "dark-high-contrast": "#3d444d",
         "dark-tritanopia-high-contrast": "#3d444d",
         "dark-protanopia-deuteranopia-high-contrast": "#3d444d"
+      },
+      "org.primer.llm": {
+        "usage": ["neutral-button", "secondary-action", "neutral-indicator"],
+        "rules": "Use for emphasized neutral elements. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1343,6 +1538,7 @@
     "original": {
       "$value": "{base.color.neutral.7}",
       "$type": "color",
+      "$description": "Strong neutral background for prominent neutral elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1359,6 +1555,10 @@
           "dark-high-contrast": "{base.color.neutral.7}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.7}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.7}"
+        },
+        "org.primer.llm": {
+          "usage": ["neutral-button", "secondary-action", "neutral-indicator"],
+          "rules": "Use for emphasized neutral elements. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.neutral.emphasis}"
@@ -1371,6 +1571,7 @@
     "key": "{bgColor.neutral.muted}",
     "$value": "#656c7633",
     "$type": "color",
+    "$description": "Subtle neutral background for tags, labels, and secondary UI elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1398,6 +1599,10 @@
         "dark-high-contrast": "#212830",
         "dark-tritanopia-high-contrast": "#212830",
         "dark-protanopia-deuteranopia-high-contrast": "#212830"
+      },
+      "org.primer.llm": {
+        "usage": ["neutral-label", "neutral-badge", "secondary-tag", "counter"],
+        "rules": "Use for neutral semantic meaning. Pair with fgColor.default for text. Do NOT use for status indicators."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1406,6 +1611,7 @@
     "original": {
       "$value": "{base.color.neutral.8}",
       "$type": "color",
+      "$description": "Subtle neutral background for tags, labels, and secondary UI elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1433,6 +1639,10 @@
           "dark-high-contrast": "{base.color.neutral.3}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.3}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.3}"
+        },
+        "org.primer.llm": {
+          "usage": ["neutral-label", "neutral-badge", "secondary-tag", "counter"],
+          "rules": "Use for neutral semantic meaning. Pair with fgColor.default for text. Do NOT use for status indicators."
         }
       },
       "alpha": 0.2,
@@ -1446,6 +1656,7 @@
     "key": "{bgColor.open.emphasis}",
     "$value": "#245829",
     "$type": "color",
+    "$description": "Strong background for open state badges and labels",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1464,6 +1675,10 @@
         "light-protanopia-deuteranopia-high-contrast": "#ae5622",
         "dark-protanopia-deuteranopia": "#ae5622",
         "dark-protanopia-deuteranopia-high-contrast": "#4d210c"
+      },
+      "org.primer.llm": {
+        "usage": ["open-badge", "open-label", "active-status-badge"],
+        "rules": "Use for prominent open/active state indicators. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1471,6 +1686,7 @@
     "original": {
       "$value": "{bgColor.success.emphasis}",
       "$type": "color",
+      "$description": "Strong background for open state badges and labels",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1489,6 +1705,10 @@
           "light-protanopia-deuteranopia-high-contrast": "{base.color.orange.5}",
           "dark-protanopia-deuteranopia": "{base.color.orange.5}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.orange.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["open-badge", "open-label", "active-status-badge"],
+          "rules": "Use for prominent open/active state indicators. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.open.emphasis}"
@@ -1501,6 +1721,7 @@
     "key": "{bgColor.open.muted}",
     "$value": "#46954a26",
     "$type": "color",
+    "$description": "Subtle background for open state indicators (issues, PRs)",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1543,6 +1764,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["open-issue", "open-pr", "active-status"],
+        "rules": "Use for open/active status indicators. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1550,6 +1775,7 @@
     "original": {
       "$value": "{bgColor.success.muted}",
       "$type": "color",
+      "$description": "Subtle background for open state indicators (issues, PRs)",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1592,6 +1818,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["open-issue", "open-pr", "active-status"],
+          "rules": "Use for open/active status indicators. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{bgColor.open.muted}"
@@ -1604,6 +1834,7 @@
     "key": "{bgColor.severe.emphasis}",
     "$value": "#7f3913",
     "$type": "color",
+    "$description": "Strong severe background for prominent high-priority warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1621,6 +1852,10 @@
         "dark-high-contrast": "#4d210c",
         "dark-dimmed-high-contrast": "#7f3913",
         "dark-protanopia-deuteranopia-high-contrast": "#4d210c"
+      },
+      "org.primer.llm": {
+        "usage": ["severe-badge", "urgent-label", "high-priority-indicator"],
+        "rules": "Use for prominent severe warnings. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1628,6 +1863,7 @@
     "original": {
       "$value": "{base.color.orange.7}",
       "$type": "color",
+      "$description": "Strong severe background for prominent high-priority warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1645,6 +1881,10 @@
           "dark-high-contrast": "{base.color.orange.9}",
           "dark-dimmed-high-contrast": "{base.color.orange.7}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.orange.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["severe-badge", "urgent-label", "high-priority-indicator"],
+          "rules": "Use for prominent severe warnings. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.severe.emphasis}"
@@ -1657,6 +1897,7 @@
     "key": "{bgColor.severe.muted}",
     "$value": "#cc6b2c1a",
     "$type": "color",
+    "$description": "Subtle severe background for high-priority warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1683,6 +1924,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["high-priority-warning", "urgent-message", "escalation"],
+        "rules": "Use for severe warnings, less critical than danger. Pair with fgColor.severe for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1691,6 +1936,7 @@
     "original": {
       "$value": "{base.color.orange.4}",
       "$type": "color",
+      "$description": "Subtle severe background for high-priority warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1717,6 +1963,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["high-priority-warning", "urgent-message", "escalation"],
+          "rules": "Use for severe warnings, less critical than danger. Pair with fgColor.severe for text."
         }
       },
       "alpha": 0.1,
@@ -1730,6 +1980,7 @@
     "key": "{bgColor.sponsors.emphasis}",
     "$value": "#7e325a",
     "$type": "color",
+    "$description": "Strong background for prominent GitHub Sponsors elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1744,6 +1995,10 @@
         "dark-dimmed-high-contrast": "#7e325a",
         "dark-tritanopia-high-contrast": "#551639",
         "dark-protanopia-deuteranopia-high-contrast": "#551639"
+      },
+      "org.primer.llm": {
+        "usage": ["sponsor-button", "sponsor-badge", "funding-cta"],
+        "rules": "Use for prominent Sponsors CTAs. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1751,6 +2006,7 @@
     "original": {
       "$value": "{base.color.pink.7}",
       "$type": "color",
+      "$description": "Strong background for prominent GitHub Sponsors elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1765,6 +2021,10 @@
           "dark-dimmed-high-contrast": "{base.color.pink.7}",
           "dark-tritanopia-high-contrast": "{base.color.pink.9}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.pink.9}"
+        },
+        "org.primer.llm": {
+          "usage": ["sponsor-button", "sponsor-badge", "funding-cta"],
+          "rules": "Use for prominent Sponsors CTAs. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.sponsors.emphasis}"
@@ -1777,6 +2037,7 @@
     "key": "{bgColor.sponsors.muted}",
     "$value": "#c961981a",
     "$type": "color",
+    "$description": "Subtle background for GitHub Sponsors content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1801,6 +2062,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["sponsor-card", "sponsor-highlight", "funding-prompt"],
+        "rules": "Use for GitHub Sponsors related content. Do NOT use for general pink-colored elements."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1809,6 +2074,7 @@
     "original": {
       "$value": "{base.color.pink.4}",
       "$type": "color",
+      "$description": "Subtle background for GitHub Sponsors content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1833,6 +2099,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["sponsor-card", "sponsor-highlight", "funding-prompt"],
+          "rules": "Use for GitHub Sponsors related content. Do NOT use for general pink-colored elements."
         }
       },
       "alpha": 0.1,
@@ -1846,6 +2116,7 @@
     "key": "{bgColor.success.emphasis}",
     "$value": "#245829",
     "$type": "color",
+    "$description": "Strong success background for prominent positive actions",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1868,6 +2139,10 @@
         "light-high-contrast": "#347d39",
         "dark-high-contrast": "#113417",
         "dark-dimmed-high-contrast": "#245829"
+      },
+      "org.primer.llm": {
+        "usage": ["merge-button", "confirm-action", "success-badge"],
+        "rules": "Use for positive action buttons like merge or confirm. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1875,6 +2150,7 @@
     "original": {
       "$value": "{base.color.green.7}",
       "$type": "color",
+      "$description": "Strong success background for prominent positive actions",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -1897,6 +2173,10 @@
           "light-high-contrast": "{base.color.green.5}",
           "dark-high-contrast": "{base.color.green.9}",
           "dark-dimmed-high-contrast": "{base.color.green.7}"
+        },
+        "org.primer.llm": {
+          "usage": ["merge-button", "confirm-action", "success-badge"],
+          "rules": "Use for positive action buttons like merge or confirm. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.success.emphasis}"
@@ -1909,6 +2189,7 @@
     "key": "{bgColor.success.muted}",
     "$value": "#46954a26",
     "$type": "color",
+    "$description": "Subtle success background for positive feedback and completed states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -1958,6 +2239,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["success-message", "completed-state", "positive-feedback"],
+        "rules": "Use for success states and positive feedback. Pair with fgColor.success for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -1966,6 +2251,7 @@
     "original": {
       "$value": "{base.color.green.4}",
       "$type": "color",
+      "$description": "Subtle success background for positive feedback and completed states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2015,6 +2301,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["success-message", "completed-state", "positive-feedback"],
+          "rules": "Use for success states and positive feedback. Pair with fgColor.success for text."
         }
       },
       "alpha": 0.15,
@@ -2028,6 +2318,7 @@
     "key": "{bgColor.transparent}",
     "$value": "#00000000",
     "$type": "color",
+    "$description": "Fully transparent background",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2036,6 +2327,10 @@
         "codeSyntax": {
           "web": "var(--bgColor-transparent) /* utility class: .color-bg-transparent */"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["ghost-button", "icon-button", "overlay-trigger"],
+        "rules": "Use for ghost/icon buttons or when element should blend with parent. Ensure sufficient contrast for interactive states."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -2043,6 +2338,7 @@
     "original": {
       "$value": "{base.color.transparent}",
       "$type": "color",
+      "$description": "Fully transparent background",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2051,6 +2347,10 @@
           "codeSyntax": {
             "web": "var(--bgColor-transparent) /* utility class: .color-bg-transparent */"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["ghost-button", "icon-button", "overlay-trigger"],
+          "rules": "Use for ghost/icon buttons or when element should blend with parent. Ensure sufficient contrast for interactive states."
         }
       },
       "key": "{bgColor.transparent}"
@@ -2063,6 +2363,7 @@
     "key": "{bgColor.upsell.emphasis}",
     "$value": "#5936a2",
     "$type": "color",
+    "$description": "Strong background for prominent upsell elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2071,6 +2372,10 @@
         "codeSyntax": {
           "web": "var(--bgColor-upsell-emphasis)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["upgrade-button", "premium-badge", "upsell-cta"],
+        "rules": "Use for prominent upgrade/upsell CTAs. Pair with fgColor.onEmphasis for text."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -2078,6 +2383,7 @@
     "original": {
       "$value": "{bgColor.done.emphasis}",
       "$type": "color",
+      "$description": "Strong background for prominent upsell elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2086,6 +2392,10 @@
           "codeSyntax": {
             "web": "var(--bgColor-upsell-emphasis)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["upgrade-button", "premium-badge", "upsell-cta"],
+          "rules": "Use for prominent upgrade/upsell CTAs. Pair with fgColor.onEmphasis for text."
         }
       },
       "key": "{bgColor.upsell.emphasis}"
@@ -2098,6 +2408,7 @@
     "key": "{bgColor.upsell.muted}",
     "$value": "#986ee226",
     "$type": "color",
+    "$description": "Subtle background for upsell and promotional content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2106,6 +2417,10 @@
         "codeSyntax": {
           "web": "var(--bgColor-upsell-muted)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["upgrade-prompt", "premium-feature", "promotional-banner"],
+        "rules": "Use for upgrade prompts and premium feature highlights. Do NOT use for regular content."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -2113,6 +2428,7 @@
     "original": {
       "$value": "{bgColor.done.muted}",
       "$type": "color",
+      "$description": "Subtle background for upsell and promotional content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2121,6 +2437,10 @@
           "codeSyntax": {
             "web": "var(--bgColor-upsell-muted)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["upgrade-prompt", "premium-feature", "promotional-banner"],
+          "rules": "Use for upgrade prompts and premium feature highlights. Do NOT use for regular content."
         }
       },
       "key": "{bgColor.upsell.muted}"
@@ -2133,6 +2453,7 @@
     "key": "{bgColor.white}",
     "$value": "#cdd9e5",
     "$type": "color",
+    "$description": "Pure white background",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2141,6 +2462,10 @@
       },
       "org.primer.overrides": {
         "dark": "#cdd9e5"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw white. Use semantic alternatives: bgColor.default for standard backgrounds, bgColor.inset for recessed areas, or bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/bgColor.json5",
@@ -2148,6 +2473,7 @@
     "original": {
       "$value": "{base.color.neutral.13}",
       "$type": "color",
+      "$description": "Pure white background",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2156,6 +2482,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.13}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw white. Use semantic alternatives: bgColor.default for standard backgrounds, bgColor.inset for recessed areas, or bgColor.inverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{bgColor.white}"
@@ -2166,7 +2496,7 @@
   },
   "border-accent-emphasis": {
     "key": "{border.accent.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #6cb6ff",
+    "$value": "0.0625rem,1px solid #6cb6ff",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2185,7 +2515,7 @@
   },
   "border-accent-muted": {
     "key": "{border.accent.muted}",
-    "$value": "0.00390625rem,0.0625px solid #6cb6ff",
+    "$value": "0.0625rem,1px solid #6cb6ff",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2204,7 +2534,7 @@
   },
   "border-attention-emphasis": {
     "key": "{border.attention.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #daaa3f",
+    "$value": "0.0625rem,1px solid #daaa3f",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2223,7 +2553,7 @@
   },
   "border-attention-muted": {
     "key": "{border.attention.muted}",
-    "$value": "0.00390625rem,0.0625px solid #daaa3f",
+    "$value": "0.0625rem,1px solid #daaa3f",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2242,7 +2572,7 @@
   },
   "border-closed-emphasis": {
     "key": "{border.closed.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #ff938a",
+    "$value": "0.0625rem,1px solid #ff938a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2257,7 +2587,7 @@
   },
   "border-closed-muted": {
     "key": "{border.closed.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ff938a",
+    "$value": "0.0625rem,1px solid #ff938a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2272,7 +2602,7 @@
   },
   "border-danger-emphasis": {
     "key": "{border.danger.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #ff938a",
+    "$value": "0.0625rem,1px solid #ff938a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2291,7 +2621,7 @@
   },
   "border-danger-muted": {
     "key": "{border.danger.muted}",
-    "$value": "0.00390625rem,0.0625px solid #ff938a",
+    "$value": "0.0625rem,1px solid #ff938a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2310,7 +2640,7 @@
   },
   "border-default": {
     "key": "{border.default}",
-    "$value": "0.00390625rem,0.0625px solid #b7bdc8",
+    "$value": "0.0625rem,1px solid #b7bdc8",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2329,7 +2659,7 @@
   },
   "border-disabled": {
     "key": "{border.disabled}",
-    "$value": "0.00390625rem,0.0625px solid #656c761a",
+    "$value": "0.0625rem,1px solid #656c761a",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2348,7 +2678,7 @@
   },
   "border-done-emphasis": {
     "key": "{border.done.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #dcbdfb",
+    "$value": "0.0625rem,1px solid #dcbdfb",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2367,7 +2697,7 @@
   },
   "border-done-muted": {
     "key": "{border.done.muted}",
-    "$value": "0.00390625rem,0.0625px solid #dcbdfb",
+    "$value": "0.0625rem,1px solid #dcbdfb",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2386,7 +2716,7 @@
   },
   "border-emphasis": {
     "key": "{border.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #b7bdc8",
+    "$value": "0.0625rem,1px solid #b7bdc8",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2405,7 +2735,7 @@
   },
   "border-muted": {
     "key": "{border.muted}",
-    "$value": "0.00390625rem,0.0625px solid #b7bdc8",
+    "$value": "0.0625rem,1px solid #b7bdc8",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2424,7 +2754,7 @@
   },
   "border-neutral-emphasis": {
     "key": "{border.neutral.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #b7bdc8",
+    "$value": "0.0625rem,1px solid #b7bdc8",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2443,7 +2773,7 @@
   },
   "border-neutral-muted": {
     "key": "{border.neutral.muted}",
-    "$value": "0.00390625rem,0.0625px solid #b7bdc8",
+    "$value": "0.0625rem,1px solid #b7bdc8",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2462,7 +2792,7 @@
   },
   "border-open-emphasis": {
     "key": "{border.open.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #6bc46d",
+    "$value": "0.0625rem,1px solid #6bc46d",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2477,7 +2807,7 @@
   },
   "border-open-muted": {
     "key": "{border.open.muted}",
-    "$value": "0.00390625rem,0.0625px solid #6bc46d",
+    "$value": "0.0625rem,1px solid #6bc46d",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2492,7 +2822,7 @@
   },
   "border-severe-emphasis": {
     "key": "{border.severe.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #f69d50",
+    "$value": "0.0625rem,1px solid #f69d50",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2511,7 +2841,7 @@
   },
   "border-severe-muted": {
     "key": "{border.severe.muted}",
-    "$value": "0.00390625rem,0.0625px solid #f69d50",
+    "$value": "0.0625rem,1px solid #f69d50",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2530,7 +2860,7 @@
   },
   "border-sponsors-emphasis": {
     "key": "{border.sponsors.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #e275ad",
+    "$value": "0.0625rem,1px solid #e275ad",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2549,7 +2879,7 @@
   },
   "border-sponsors-muted": {
     "key": "{border.sponsors.muted}",
-    "$value": "0.00390625rem,0.0625px solid #fc8dc7",
+    "$value": "0.0625rem,1px solid #fc8dc7",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2568,7 +2898,7 @@
   },
   "border-success-emphasis": {
     "key": "{border.success.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #6bc46d",
+    "$value": "0.0625rem,1px solid #6bc46d",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2587,7 +2917,7 @@
   },
   "border-success-muted": {
     "key": "{border.success.muted}",
-    "$value": "0.00390625rem,0.0625px solid #6bc46d",
+    "$value": "0.0625rem,1px solid #6bc46d",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2606,7 +2936,7 @@
   },
   "border-transparent": {
     "key": "{border.transparent}",
-    "$value": "0.00390625rem,0.0625px solid #00000000",
+    "$value": "0.0625rem,1px solid #00000000",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2625,7 +2955,7 @@
   },
   "border-upsell-emphasis": {
     "key": "{border.upsell.emphasis}",
-    "$value": "0.00390625rem,0.0625px solid #dcbdfb",
+    "$value": "0.0625rem,1px solid #dcbdfb",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2644,7 +2974,7 @@
   },
   "border-upsell-muted": {
     "key": "{border.upsell.muted}",
-    "$value": "0.00390625rem,0.0625px solid #dcbdfb",
+    "$value": "0.0625rem,1px solid #dcbdfb",
     "$type": "border",
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
@@ -2665,6 +2995,7 @@
     "key": "{borderColor.accent.emphasis}",
     "$value": "#6cb6ff",
     "$type": "color",
+    "$description": "Strong accent border for selected or focused elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2676,6 +3007,10 @@
       },
       "org.primer.overrides": {
         "dark-dimmed-high-contrast": "#6cb6ff"
+      },
+      "org.primer.llm": {
+        "usage": ["accent-emphasis", "selected-border", "focus-border"],
+        "rules": "Use for selected elements and focus states. Strong visual emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -2683,6 +3018,7 @@
     "original": {
       "$value": "{base.color.blue.2}",
       "$type": "color",
+      "$description": "Strong accent border for selected or focused elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2694,6 +3030,10 @@
         },
         "org.primer.overrides": {
           "dark-dimmed-high-contrast": "{base.color.blue.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["accent-emphasis", "selected-border", "focus-border"],
+          "rules": "Use for selected elements and focus states. Strong visual emphasis."
         }
       },
       "key": "{borderColor.accent.emphasis}"
@@ -2706,6 +3046,7 @@
     "key": "{borderColor.accent.muted}",
     "$value": "#6cb6ff",
     "$type": "color",
+    "$description": "Subtle accent border for selected or focused elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2766,6 +3107,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["accent-muted", "selected-muted", "info-muted"],
+        "rules": "Use for accent-colored borders on selected elements. Pair with bgColor.accent.muted."
       }
     },
     "alpha": 1,
@@ -2774,6 +3119,7 @@
     "original": {
       "$value": "{base.color.blue.2}",
       "$type": "color",
+      "$description": "Subtle accent border for selected or focused elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2834,6 +3180,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["accent-muted", "selected-muted", "info-muted"],
+          "rules": "Use for accent-colored borders on selected elements. Pair with bgColor.accent.muted."
         }
       },
       "alpha": 1,
@@ -2847,6 +3197,7 @@
     "key": "{borderColor.attention.emphasis}",
     "$value": "#daaa3f",
     "$type": "color",
+    "$description": "Strong attention border for prominent warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2858,6 +3209,10 @@
       },
       "org.primer.overrides": {
         "dark-dimmed-high-contrast": "#daaa3f"
+      },
+      "org.primer.llm": {
+        "usage": ["attention-emphasis", "warning-emphasis", "caution-emphasis"],
+        "rules": "Use for emphasized warning borders. Pair with bgColor.attention.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -2865,6 +3220,7 @@
     "original": {
       "$value": "{base.color.yellow.2}",
       "$type": "color",
+      "$description": "Strong attention border for prominent warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -2876,6 +3232,10 @@
         },
         "org.primer.overrides": {
           "dark-dimmed-high-contrast": "{base.color.yellow.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["attention-emphasis", "warning-emphasis", "caution-emphasis"],
+          "rules": "Use for emphasized warning borders. Pair with bgColor.attention.emphasis."
         }
       },
       "key": "{borderColor.attention.emphasis}"
@@ -2888,6 +3248,7 @@
     "key": "{borderColor.attention.muted}",
     "$value": "#daaa3f",
     "$type": "color",
+    "$description": "Subtle attention border for warnings and caution states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -2948,6 +3309,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["attention-muted", "warning-muted", "caution-muted"],
+        "rules": "Use for warning state borders. Pair with bgColor.attention.muted."
       }
     },
     "alpha": 1,
@@ -2956,6 +3321,7 @@
     "original": {
       "$value": "{base.color.yellow.2}",
       "$type": "color",
+      "$description": "Subtle attention border for warnings and caution states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3016,6 +3382,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["attention-muted", "warning-muted", "caution-muted"],
+          "rules": "Use for warning state borders. Pair with bgColor.attention.muted."
         }
       },
       "alpha": 1,
@@ -3029,6 +3399,7 @@
     "key": "{borderColor.closed.emphasis}",
     "$value": "#ff938a",
     "$type": "color",
+    "$description": "Strong border for closed state badges",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3047,6 +3418,10 @@
         "dark-tritanopia-high-contrast": "#b7bdc8",
         "light-tritanopia": "#b7bdc8",
         "light-tritanopia-high-contrast": "#b7bdc8"
+      },
+      "org.primer.llm": {
+        "usage": ["closed-emphasis", "closed-status"],
+        "rules": "Use for emphasized closed state borders. Pair with bgColor.closed.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3054,6 +3429,7 @@
     "original": {
       "$value": "{borderColor.danger.emphasis}",
       "$type": "color",
+      "$description": "Strong border for closed state badges",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3072,6 +3448,10 @@
           "dark-tritanopia-high-contrast": "{borderColor.emphasis}",
           "light-tritanopia": "{borderColor.emphasis}",
           "light-tritanopia-high-contrast": "{borderColor.emphasis}"
+        },
+        "org.primer.llm": {
+          "usage": ["closed-emphasis", "closed-status"],
+          "rules": "Use for emphasized closed state borders. Pair with bgColor.closed.emphasis."
         }
       },
       "key": "{borderColor.closed.emphasis}"
@@ -3084,6 +3464,7 @@
     "key": "{borderColor.closed.muted}",
     "$value": "#ff938a",
     "$type": "color",
+    "$description": "Subtle border for closed state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3150,6 +3531,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["closed-muted", "closed-issue", "closed-pr"],
+        "rules": "Use for closed/declined status borders. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3157,6 +3542,7 @@
     "original": {
       "$value": "{borderColor.danger.muted}",
       "$type": "color",
+      "$description": "Subtle border for closed state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3223,6 +3609,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["closed-muted", "closed-issue", "closed-pr"],
+          "rules": "Use for closed/declined status borders. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{borderColor.closed.muted}"
@@ -3235,6 +3625,7 @@
     "key": "{borderColor.danger.emphasis}",
     "$value": "#ff938a",
     "$type": "color",
+    "$description": "Strong danger border for destructive actions and errors",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3270,6 +3661,10 @@
           "$type": "color"
         },
         "dark-dimmed-high-contrast": "#ff938a"
+      },
+      "org.primer.llm": {
+        "usage": ["danger-emphasis", "error-emphasis", "destructive-emphasis"],
+        "rules": "MUST use for destructive action borders. Pair with bgColor.danger.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3277,6 +3672,7 @@
     "original": {
       "$value": "{base.color.red.2}",
       "$type": "color",
+      "$description": "Strong danger border for destructive actions and errors",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3312,6 +3708,10 @@
             "$type": "color"
           },
           "dark-dimmed-high-contrast": "{base.color.red.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["danger-emphasis", "error-emphasis", "destructive-emphasis"],
+          "rules": "MUST use for destructive action borders. Pair with bgColor.danger.emphasis."
         }
       },
       "key": "{borderColor.danger.emphasis}"
@@ -3324,6 +3724,7 @@
     "key": "{borderColor.danger.muted}",
     "$value": "#ff938a",
     "$type": "color",
+    "$description": "Subtle danger border for errors and destructive contexts",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3397,6 +3798,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["danger-muted", "error-muted", "destructive-muted"],
+        "rules": "Use for error state borders. Pair with bgColor.danger.muted."
       }
     },
     "alpha": 1,
@@ -3405,6 +3810,7 @@
     "original": {
       "$value": "{base.color.red.2}",
       "$type": "color",
+      "$description": "Subtle danger border for errors and destructive contexts",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3478,6 +3884,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["danger-muted", "error-muted", "destructive-muted"],
+          "rules": "Use for error state borders. Pair with bgColor.danger.muted."
         }
       },
       "alpha": 1,
@@ -3491,6 +3901,7 @@
     "key": "{borderColor.default}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Default border color for most UI elements",
     "$extensions": {
       "org.primer.overrides": {
         "dark": "#3d444d",
@@ -3510,6 +3921,10 @@
         "codeSyntax": {
           "web": "var(--borderColor-default) /* utility class: .color-border-default */"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["default-border", "card-border", "input-border", "divider"],
+        "rules": "RECOMMENDED default for all borders. Use for cards, inputs, and dividers."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3517,6 +3932,7 @@
     "original": {
       "$value": "{base.color.neutral.10}",
       "$type": "color",
+      "$description": "Default border color for most UI elements",
       "$extensions": {
         "org.primer.overrides": {
           "dark": "{base.color.neutral.7}",
@@ -3536,6 +3952,10 @@
           "codeSyntax": {
             "web": "var(--borderColor-default) /* utility class: .color-border-default */"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["default-border", "card-border", "input-border", "divider"],
+          "rules": "RECOMMENDED default for all borders. Use for cards, inputs, and dividers."
         }
       },
       "key": "{borderColor.default}"
@@ -3548,6 +3968,7 @@
     "key": "{borderColor.disabled}",
     "$value": "#656c761a",
     "$type": "color",
+    "$description": "Border color for disabled interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3590,6 +4011,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["disabled-border", "inactive-border", "unavailable"],
+        "rules": "MUST use for disabled state borders. Pair with bgColor.disabled. Do NOT use for active elements."
       }
     },
     "alpha": 0.1,
@@ -3598,6 +4023,7 @@
     "original": {
       "$value": "{base.color.neutral.8}",
       "$type": "color",
+      "$description": "Border color for disabled interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3640,6 +4066,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["disabled-border", "inactive-border", "unavailable"],
+          "rules": "MUST use for disabled state borders. Pair with bgColor.disabled. Do NOT use for active elements."
         }
       },
       "alpha": 0.1,
@@ -3653,6 +4083,7 @@
     "key": "{borderColor.done.emphasis}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Strong border for completed/done state badges",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3664,6 +4095,10 @@
       },
       "org.primer.overrides": {
         "dark-dimmed-high-contrast": "#dcbdfb"
+      },
+      "org.primer.llm": {
+        "usage": ["done-emphasis", "merged-status"],
+        "rules": "Use for emphasized done state borders. Pair with bgColor.done.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3671,6 +4106,7 @@
     "original": {
       "$value": "{base.color.purple.2}",
       "$type": "color",
+      "$description": "Strong border for completed/done state badges",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3682,6 +4118,10 @@
         },
         "org.primer.overrides": {
           "dark-dimmed-high-contrast": "{base.color.purple.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["done-emphasis", "merged-status"],
+          "rules": "Use for emphasized done state borders. Pair with bgColor.done.emphasis."
         }
       },
       "key": "{borderColor.done.emphasis}"
@@ -3694,6 +4134,7 @@
     "key": "{borderColor.done.muted}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Subtle border for completed/done state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3754,6 +4195,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["done-muted", "merged", "completed"],
+        "rules": "Use for completed/done status borders. Conveys finished or merged state."
       }
     },
     "alpha": 1,
@@ -3762,6 +4207,7 @@
     "original": {
       "$value": "{base.color.purple.2}",
       "$type": "color",
+      "$description": "Subtle border for completed/done state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3822,6 +4268,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["done-muted", "merged", "completed"],
+          "rules": "Use for completed/done status borders. Conveys finished or merged state."
         }
       },
       "alpha": 1,
@@ -3835,6 +4285,7 @@
     "key": "{borderColor.draft.emphasis}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Strong border for draft state badges",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3843,6 +4294,10 @@
         "codeSyntax": {
           "web": "var(--borderColor-draft-emphasis)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["draft-emphasis", "draft-status"],
+        "rules": "Use for emphasized draft state borders. Pair with bgColor.draft.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3850,6 +4305,7 @@
     "original": {
       "$value": "{borderColor.neutral.emphasis}",
       "$type": "color",
+      "$description": "Strong border for draft state badges",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -3858,6 +4314,10 @@
           "codeSyntax": {
             "web": "var(--borderColor-draft-emphasis)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["draft-emphasis", "draft-status"],
+          "rules": "Use for emphasized draft state borders. Pair with bgColor.draft.emphasis."
         }
       },
       "key": "{borderColor.draft.emphasis}"
@@ -3870,6 +4330,7 @@
     "key": "{borderColor.draft.muted}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Subtle border for draft state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -3936,6 +4397,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["draft-muted", "draft-pr", "draft-issue"],
+        "rules": "Use for draft/WIP status borders. Conveys incomplete or pending state."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -3943,6 +4408,7 @@
     "original": {
       "$value": "{borderColor.neutral.muted}",
       "$type": "color",
+      "$description": "Subtle border for draft state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4009,6 +4475,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["draft-muted", "draft-pr", "draft-issue"],
+          "rules": "Use for draft/WIP status borders. Conveys incomplete or pending state."
         }
       },
       "key": "{borderColor.draft.muted}"
@@ -4021,6 +4491,7 @@
     "key": "{borderColor.emphasis}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Strong border for emphasis and visual weight",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4035,6 +4506,10 @@
         "dark-dimmed-high-contrast": "#b7bdc8",
         "dark-tritanopia-high-contrast": "#b7bdc8",
         "dark-protanopia-deuteranopia-high-contrast": "#b7bdc8"
+      },
+      "org.primer.llm": {
+        "usage": ["emphasis-border", "strong-border", "selected-border"],
+        "rules": "Use for borders needing more visual weight. Darker than borderColor.default."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4042,6 +4517,7 @@
     "original": {
       "$value": "{borderColor.default}",
       "$type": "color",
+      "$description": "Strong border for emphasis and visual weight",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4056,6 +4532,10 @@
           "dark-dimmed-high-contrast": "{borderColor.default}",
           "dark-tritanopia-high-contrast": "{borderColor.default}",
           "dark-protanopia-deuteranopia-high-contrast": "{borderColor.default}"
+        },
+        "org.primer.llm": {
+          "usage": ["emphasis-border", "strong-border", "selected-border"],
+          "rules": "Use for borders needing more visual weight. Darker than borderColor.default."
         }
       },
       "key": "{borderColor.emphasis}"
@@ -4068,6 +4548,7 @@
     "key": "{borderColor.muted}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Subtle border for secondary elements and light separators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4134,6 +4615,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["subtle-border", "light-divider", "secondary-border"],
+        "rules": "Use for subtle borders and separators. Less prominent than borderColor.default."
       }
     },
     "alpha": 1,
@@ -4142,6 +4627,7 @@
     "original": {
       "$value": "{borderColor.default}",
       "$type": "color",
+      "$description": "Subtle border for secondary elements and light separators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4208,6 +4694,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["subtle-border", "light-divider", "secondary-border"],
+          "rules": "Use for subtle borders and separators. Less prominent than borderColor.default."
         }
       },
       "alpha": 1,
@@ -4221,6 +4711,7 @@
     "key": "{borderColor.neutral.emphasis}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Strong neutral semantic border",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4229,6 +4720,10 @@
       },
       "org.primer.overrides": {
         "dark": "#b7bdc8"
+      },
+      "org.primer.llm": {
+        "usage": ["neutral-emphasis", "neutral-strong"],
+        "rules": "Use for emphasized neutral semantic borders. Stronger than neutral.muted."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4236,6 +4731,7 @@
     "original": {
       "$value": "{borderColor.emphasis}",
       "$type": "color",
+      "$description": "Strong neutral semantic border",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4244,6 +4740,10 @@
         },
         "org.primer.overrides": {
           "dark": "{borderColor.emphasis}"
+        },
+        "org.primer.llm": {
+          "usage": ["neutral-emphasis", "neutral-strong"],
+          "rules": "Use for emphasized neutral semantic borders. Stronger than neutral.muted."
         }
       },
       "key": "{borderColor.neutral.emphasis}"
@@ -4256,6 +4756,7 @@
     "key": "{borderColor.neutral.muted}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Subtle neutral semantic border",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4277,6 +4778,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["neutral-muted", "neutral-secondary"],
+        "rules": "Use for neutral semantic borders on tags and badges. Prefer borderColor.muted for general use."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4285,6 +4790,7 @@
     "original": {
       "$value": "{borderColor.muted}",
       "$type": "color",
+      "$description": "Subtle neutral semantic border",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4306,6 +4812,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["neutral-muted", "neutral-secondary"],
+          "rules": "Use for neutral semantic borders on tags and badges. Prefer borderColor.muted for general use."
         }
       },
       "alpha": 1,
@@ -4319,6 +4829,7 @@
     "key": "{borderColor.open.emphasis}",
     "$value": "#6bc46d",
     "$type": "color",
+    "$description": "Strong border for open state badges",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4337,6 +4848,10 @@
         "dark-protanopia-deuteranopia-high-contrast": "#ae5622",
         "light-protanopia-deuteranopia": "#ae5622",
         "light-protanopia-deuteranopia-high-contrast": "#ae5622"
+      },
+      "org.primer.llm": {
+        "usage": ["open-emphasis", "open-status"],
+        "rules": "Use for emphasized open state borders. Pair with bgColor.open.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4344,6 +4859,7 @@
     "original": {
       "$value": "{borderColor.success.emphasis}",
       "$type": "color",
+      "$description": "Strong border for open state badges",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4362,6 +4878,10 @@
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.orange.5}",
           "light-protanopia-deuteranopia": "{base.color.orange.5}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.orange.5}"
+        },
+        "org.primer.llm": {
+          "usage": ["open-emphasis", "open-status"],
+          "rules": "Use for emphasized open state borders. Pair with bgColor.open.emphasis."
         }
       },
       "key": "{borderColor.open.emphasis}"
@@ -4374,6 +4894,7 @@
     "key": "{borderColor.open.muted}",
     "$value": "#6bc46d",
     "$type": "color",
+    "$description": "Subtle border for open state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4440,6 +4961,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["open-muted", "open-issue", "open-pr"],
+        "rules": "Use for open/active status borders. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4447,6 +4972,7 @@
     "original": {
       "$value": "{borderColor.success.muted}",
       "$type": "color",
+      "$description": "Subtle border for open state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4513,6 +5039,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["open-muted", "open-issue", "open-pr"],
+          "rules": "Use for open/active status borders. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{borderColor.open.muted}"
@@ -4525,6 +5055,7 @@
     "key": "{borderColor.severe.emphasis}",
     "$value": "#f69d50",
     "$type": "color",
+    "$description": "Strong severe border for prominent high-priority warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4539,6 +5070,10 @@
         "light-tritanopia": "#c93c37",
         "light-tritanopia-high-contrast": "#c93c37",
         "dark-dimmed-high-contrast": "#f69d50"
+      },
+      "org.primer.llm": {
+        "usage": ["severe-emphasis", "urgent-emphasis"],
+        "rules": "Use for emphasized severe borders. Pair with bgColor.severe.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4546,6 +5081,7 @@
     "original": {
       "$value": "{base.color.orange.2}",
       "$type": "color",
+      "$description": "Strong severe border for prominent high-priority warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4560,6 +5096,10 @@
           "light-tritanopia": "{base.color.red.5}",
           "light-tritanopia-high-contrast": "{base.color.red.5}",
           "dark-dimmed-high-contrast": "{base.color.orange.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["severe-emphasis", "urgent-emphasis"],
+          "rules": "Use for emphasized severe borders. Pair with bgColor.severe.emphasis."
         }
       },
       "key": "{borderColor.severe.emphasis}"
@@ -4572,6 +5112,7 @@
     "key": "{borderColor.severe.muted}",
     "$value": "#f69d50",
     "$type": "color",
+    "$description": "Subtle severe border for high-priority warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4627,6 +5168,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["severe-muted", "urgent-muted"],
+        "rules": "Use for severe warning borders. More critical than attention, less than danger."
       }
     },
     "alpha": 1,
@@ -4635,6 +5180,7 @@
     "original": {
       "$value": "{base.color.orange.2}",
       "$type": "color",
+      "$description": "Subtle severe border for high-priority warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4690,6 +5236,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["severe-muted", "urgent-muted"],
+          "rules": "Use for severe warning borders. More critical than attention, less than danger."
         }
       },
       "alpha": 1,
@@ -4703,6 +5253,7 @@
     "key": "{borderColor.sponsors.emphasis}",
     "$value": "#e275ad",
     "$type": "color",
+    "$description": "Strong border for prominent GitHub Sponsors elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4714,6 +5265,10 @@
       },
       "org.primer.overrides": {
         "dark-dimmed-high-contrast": "#e275ad"
+      },
+      "org.primer.llm": {
+        "usage": ["sponsors-emphasis", "funding-emphasis"],
+        "rules": "Use for emphasized Sponsors borders. Pair with bgColor.sponsors.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4721,6 +5276,7 @@
     "original": {
       "$value": "{base.color.pink.3}",
       "$type": "color",
+      "$description": "Strong border for prominent GitHub Sponsors elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4732,6 +5288,10 @@
         },
         "org.primer.overrides": {
           "dark-dimmed-high-contrast": "{base.color.pink.3}"
+        },
+        "org.primer.llm": {
+          "usage": ["sponsors-emphasis", "funding-emphasis"],
+          "rules": "Use for emphasized Sponsors borders. Pair with bgColor.sponsors.emphasis."
         }
       },
       "key": "{borderColor.sponsors.emphasis}"
@@ -4744,6 +5304,7 @@
     "key": "{borderColor.sponsors.muted}",
     "$value": "#fc8dc7",
     "$type": "color",
+    "$description": "Subtle border for GitHub Sponsors content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4804,6 +5365,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["sponsors-muted", "funding-muted"],
+        "rules": "Use for GitHub Sponsors related borders. Do NOT use for general pink-colored elements."
       }
     },
     "alpha": 1,
@@ -4812,6 +5377,7 @@
     "original": {
       "$value": "{base.color.pink.2}",
       "$type": "color",
+      "$description": "Subtle border for GitHub Sponsors content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4872,6 +5438,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["sponsors-muted", "funding-muted"],
+          "rules": "Use for GitHub Sponsors related borders. Do NOT use for general pink-colored elements."
         }
       },
       "alpha": 1,
@@ -4885,6 +5455,7 @@
     "key": "{borderColor.success.emphasis}",
     "$value": "#6bc46d",
     "$type": "color",
+    "$description": "Strong success border for prominent positive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -4904,6 +5475,10 @@
         "light-protanopia-deuteranopia": "#316dca",
         "light-protanopia-deuteranopia-high-contrast": "#316dca",
         "dark-dimmed-high-contrast": "#6bc46d"
+      },
+      "org.primer.llm": {
+        "usage": ["success-emphasis", "confirmed", "positive-emphasis"],
+        "rules": "Use for emphasized success borders. Pair with bgColor.success.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -4911,6 +5486,7 @@
     "original": {
       "$value": "{base.color.green.2}",
       "$type": "color",
+      "$description": "Strong success border for prominent positive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -4930,6 +5506,10 @@
           "light-protanopia-deuteranopia": "{base.color.blue.5}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.blue.5}",
           "dark-dimmed-high-contrast": "{base.color.green.2}"
+        },
+        "org.primer.llm": {
+          "usage": ["success-emphasis", "confirmed", "positive-emphasis"],
+          "rules": "Use for emphasized success borders. Pair with bgColor.success.emphasis."
         }
       },
       "key": "{borderColor.success.emphasis}"
@@ -4942,6 +5522,7 @@
     "key": "{borderColor.success.muted}",
     "$value": "#6bc46d",
     "$type": "color",
+    "$description": "Subtle success border for positive feedback elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -5029,6 +5610,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["success-muted", "valid-muted", "positive-muted"],
+        "rules": "Use for success state borders. Pair with bgColor.success.muted."
       }
     },
     "alpha": 1,
@@ -5037,6 +5622,7 @@
     "original": {
       "$value": "{base.color.green.2}",
       "$type": "color",
+      "$description": "Subtle success border for positive feedback elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -5124,6 +5710,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["success-muted", "valid-muted", "positive-muted"],
+          "rules": "Use for success state borders. Pair with bgColor.success.muted."
         }
       },
       "alpha": 1,
@@ -5137,6 +5727,7 @@
     "key": "{borderColor.translucent}",
     "$value": "#9198a1",
     "$type": "color",
+    "$description": "Semi-transparent border for overlays and layered elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -5193,6 +5784,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["overlay-border", "translucent-border"],
+        "rules": "Use for semi-transparent borders on overlays. Works well with translucent backgrounds."
       }
     },
     "alpha": 1,
@@ -5201,6 +5796,7 @@
     "original": {
       "$value": "{base.color.neutral.9}",
       "$type": "color",
+      "$description": "Semi-transparent border for overlays and layered elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -5257,6 +5853,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["overlay-border", "translucent-border"],
+          "rules": "Use for semi-transparent borders on overlays. Works well with translucent backgrounds."
         }
       },
       "alpha": 1,
@@ -5270,6 +5870,7 @@
     "key": "{borderColor.transparent}",
     "$value": "#00000000",
     "$type": "color",
+    "$description": "Fully transparent border",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -5282,6 +5883,7 @@
     "original": {
       "$value": "{base.color.transparent}",
       "$type": "color",
+      "$description": "Fully transparent border",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -5299,6 +5901,7 @@
     "key": "{borderColor.upsell.emphasis}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Strong border for prominent upsell elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -5307,6 +5910,10 @@
         "codeSyntax": {
           "web": "var(--borderColor-upsell-emphasis)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["upsell-emphasis", "premium-emphasis"],
+        "rules": "Use for emphasized upsell borders. Pair with bgColor.upsell.emphasis."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -5314,6 +5921,7 @@
     "original": {
       "$value": "{borderColor.done.emphasis}",
       "$type": "color",
+      "$description": "Strong border for prominent upsell elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -5322,6 +5930,10 @@
           "codeSyntax": {
             "web": "var(--borderColor-upsell-emphasis)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["upsell-emphasis", "premium-emphasis"],
+          "rules": "Use for emphasized upsell borders. Pair with bgColor.upsell.emphasis."
         }
       },
       "key": "{borderColor.upsell.emphasis}"
@@ -5334,6 +5946,7 @@
     "key": "{borderColor.upsell.muted}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Subtle border for upsell and promotional content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -5342,6 +5955,10 @@
         "codeSyntax": {
           "web": "var(--borderColor-upsell-muted)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["upsell-muted", "premium-muted"],
+        "rules": "Use for upgrade prompts and premium feature borders. Do NOT use for regular content."
       }
     },
     "filePath": "src/tokens/functional/color/borderColor.json5",
@@ -5349,6 +5966,7 @@
     "original": {
       "$value": "{borderColor.done.muted}",
       "$type": "color",
+      "$description": "Subtle border for upsell and promotional content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -5357,6 +5975,10 @@
           "codeSyntax": {
             "web": "var(--borderColor-upsell-muted)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["upsell-muted", "premium-muted"],
+          "rules": "Use for upgrade prompts and premium feature borders. Do NOT use for regular content."
         }
       },
       "key": "{borderColor.upsell.muted}"
@@ -36505,6 +37127,7 @@
     "key": "{fgColor.accent}",
     "$value": "#96d0ff",
     "$type": "color",
+    "$description": "Accent text for links and interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36524,6 +37147,10 @@
         "light-high-contrast": "#255ab2",
         "light-tritanopia-high-contrast": "#255ab2",
         "light-protanopia-deuteranopia-high-contrast": "#255ab2"
+      },
+      "org.primer.llm": {
+        "usage": ["accent-text", "info-text", "accent-icon"],
+        "rules": "Use for accent-colored text and icons. Pair with bgColor.accent.muted for backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36531,6 +37158,7 @@
     "original": {
       "$value": "{base.color.blue.1}",
       "$type": "color",
+      "$description": "Accent text for links and interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36550,6 +37178,10 @@
           "light-high-contrast": "{base.color.blue.6}",
           "light-tritanopia-high-contrast": "{base.color.blue.6}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.blue.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["accent-text", "info-text", "accent-icon"],
+          "rules": "Use for accent-colored text and icons. Pair with bgColor.accent.muted for backgrounds."
         }
       },
       "key": "{fgColor.accent}"
@@ -36562,6 +37194,7 @@
     "key": "{fgColor.attention}",
     "$value": "#eac55f",
     "$type": "color",
+    "$description": "Attention text for warnings and caution states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36577,6 +37210,10 @@
         "light-protanopia-deuteranopia-high-contrast": "#805400",
         "light-tritanopia-high-contrast": "#805400",
         "dark-dimmed-high-contrast": "#eac55f"
+      },
+      "org.primer.llm": {
+        "usage": ["attention-text", "warning-text", "caution-text"],
+        "rules": "Use for warning and caution text. Pair with bgColor.attention.muted for backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36584,6 +37221,7 @@
     "original": {
       "$value": "{base.color.yellow.1}",
       "$type": "color",
+      "$description": "Attention text for warnings and caution states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36599,6 +37237,10 @@
           "light-protanopia-deuteranopia-high-contrast": "{base.color.yellow.6}",
           "light-tritanopia-high-contrast": "{base.color.yellow.6}",
           "dark-dimmed-high-contrast": "{base.color.yellow.1}"
+        },
+        "org.primer.llm": {
+          "usage": ["attention-text", "warning-text", "caution-text"],
+          "rules": "Use for warning and caution text. Pair with bgColor.attention.muted for backgrounds."
         }
       },
       "key": "{fgColor.attention}"
@@ -36611,6 +37253,7 @@
     "key": "{fgColor.black}",
     "$value": "#010409",
     "$type": "color",
+    "$description": "Pure black text",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36619,6 +37262,10 @@
       },
       "org.primer.overrides": {
         "dark": "#010409"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw black. Use semantic alternatives: fgColor.default for standard text, fgColor.muted for secondary text. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36626,6 +37273,7 @@
     "original": {
       "$value": "{base.color.neutral.0}",
       "$type": "color",
+      "$description": "Pure black text",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36634,6 +37282,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.0}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw black. Use semantic alternatives: fgColor.default for standard text, fgColor.muted for secondary text. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{fgColor.black}"
@@ -36646,6 +37298,7 @@
     "key": "{fgColor.closed}",
     "$value": "#ffb8b0",
     "$type": "color",
+    "$description": "Text color for closed state indicators (issues, PRs)",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36664,6 +37317,10 @@
         "dark-tritanopia-high-contrast": "#b7bdc8",
         "light-tritanopia": "#b7bdc8",
         "light-tritanopia-high-contrast": "#b7bdc8"
+      },
+      "org.primer.llm": {
+        "usage": ["closed-text", "closed-issue", "closed-pr"],
+        "rules": "Use for closed/declined status text. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36671,6 +37328,7 @@
     "original": {
       "$value": "{fgColor.danger}",
       "$type": "color",
+      "$description": "Text color for closed state indicators (issues, PRs)",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36689,6 +37347,10 @@
           "dark-tritanopia-high-contrast": "{fgColor.muted}",
           "light-tritanopia": "{fgColor.muted}",
           "light-tritanopia-high-contrast": "{fgColor.muted}"
+        },
+        "org.primer.llm": {
+          "usage": ["closed-text", "closed-issue", "closed-pr"],
+          "rules": "Use for closed/declined status text. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{fgColor.closed}"
@@ -36701,6 +37363,7 @@
     "key": "{fgColor.danger}",
     "$value": "#ffb8b0",
     "$type": "color",
+    "$description": "Danger text for errors and destructive actions",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36721,6 +37384,10 @@
         "dark-tritanopia-high-contrast": "#f47067",
         "light-high-contrast": "#ad2e2c",
         "light-tritanopia-high-contrast": "#ad2e2c"
+      },
+      "org.primer.llm": {
+        "usage": ["danger-text", "error-text", "destructive-text"],
+        "rules": "Use for error messages and destructive action text. Pair with bgColor.danger.muted for backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36728,6 +37395,7 @@
     "original": {
       "$value": "{base.color.red.1}",
       "$type": "color",
+      "$description": "Danger text for errors and destructive actions",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36748,6 +37416,10 @@
           "dark-tritanopia-high-contrast": "{base.color.red.3}",
           "light-high-contrast": "{base.color.red.6}",
           "light-tritanopia-high-contrast": "{base.color.red.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["danger-text", "error-text", "destructive-text"],
+          "rules": "Use for error messages and destructive action text. Pair with bgColor.danger.muted for backgrounds."
         }
       },
       "key": "{fgColor.danger}"
@@ -36760,6 +37432,7 @@
     "key": "{fgColor.default}",
     "$value": "#f0f6fc",
     "$type": "color",
+    "$description": "Default text color for primary content and headings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36774,8 +37447,12 @@
         "dark-high-contrast": "#cdd9e5",
         "dark-tritanopia-high-contrast": "#cdd9e5",
         "dark-protanopia-deuteranopia-high-contrast": "#cdd9e5",
-        "dark-dimmed": "#d1d7e0",
+        "dark-dimmed": "#f0f6fc",
         "dark-dimmed-high-contrast": "#f0f6fc"
+      },
+      "org.primer.llm": {
+        "usage": ["default-text", "heading", "body-text"],
+        "rules": "RECOMMENDED default for all text. Use for headings, body text, and primary labels."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36783,6 +37460,7 @@
     "original": {
       "$value": "{base.color.neutral.12}",
       "$type": "color",
+      "$description": "Default text color for primary content and headings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36797,8 +37475,12 @@
           "dark-high-contrast": "{base.color.neutral.13}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.13}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.13}",
-          "dark-dimmed": "{base.color.neutral.11}",
+          "dark-dimmed": "{base.color.neutral.12}",
           "dark-dimmed-high-contrast": "{base.color.neutral.12}"
+        },
+        "org.primer.llm": {
+          "usage": ["default-text", "heading", "body-text"],
+          "rules": "RECOMMENDED default for all text. Use for headings, body text, and primary labels."
         }
       },
       "key": "{fgColor.default}"
@@ -36811,6 +37493,7 @@
     "key": "{fgColor.disabled}",
     "$value": "#656c76",
     "$type": "color",
+    "$description": "Text color for disabled interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36832,6 +37515,10 @@
         "dark-high-contrast": "#656c76",
         "dark-tritanopia-high-contrast": "#656c76",
         "dark-protanopia-deuteranopia-high-contrast": "#656c76"
+      },
+      "org.primer.llm": {
+        "usage": ["disabled-text", "inactive-text", "unavailable"],
+        "rules": "MUST use for disabled state text. Pair with bgColor.disabled. Do NOT use for active elements."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36839,6 +37526,7 @@
     "original": {
       "$value": "{base.color.neutral.8}",
       "$type": "color",
+      "$description": "Text color for disabled interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36860,6 +37548,10 @@
           "dark-high-contrast": "{base.color.neutral.8}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.8}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.8}"
+        },
+        "org.primer.llm": {
+          "usage": ["disabled-text", "inactive-text", "unavailable"],
+          "rules": "MUST use for disabled state text. Pair with bgColor.disabled. Do NOT use for active elements."
         }
       },
       "key": "{fgColor.disabled}"
@@ -36872,6 +37564,7 @@
     "key": "{fgColor.done}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Text color for completed/done state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36890,6 +37583,10 @@
         "light-high-contrast": "#6b44bc",
         "light-protanopia-deuteranopia-high-contrast": "#6b44bc",
         "light-tritanopia-high-contrast": "#6b44bc"
+      },
+      "org.primer.llm": {
+        "usage": ["done-text", "merged", "completed"],
+        "rules": "Use for completed/done status text. Conveys finished or merged state."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36897,6 +37594,7 @@
     "original": {
       "$value": "{base.color.purple.1}",
       "$type": "color",
+      "$description": "Text color for completed/done state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36915,6 +37613,10 @@
           "light-high-contrast": "{base.color.purple.6}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.purple.6}",
           "light-tritanopia-high-contrast": "{base.color.purple.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["done-text", "merged", "completed"],
+          "rules": "Use for completed/done status text. Conveys finished or merged state."
         }
       },
       "key": "{fgColor.done}"
@@ -36927,6 +37629,7 @@
     "key": "{fgColor.draft}",
     "$value": "#d1d7e0",
     "$type": "color",
+    "$description": "Text color for draft state indicators",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36935,6 +37638,10 @@
         "codeSyntax": {
           "web": "var(--fgColor-draft)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["draft-text", "draft-pr", "draft-issue"],
+        "rules": "Use for draft/WIP status text. Conveys incomplete or pending state."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36942,6 +37649,7 @@
     "original": {
       "$value": "{fgColor.neutral}",
       "$type": "color",
+      "$description": "Text color for draft state indicators",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36950,6 +37658,10 @@
           "codeSyntax": {
             "web": "var(--fgColor-draft)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["draft-text", "draft-pr", "draft-issue"],
+          "rules": "Use for draft/WIP status text. Conveys incomplete or pending state."
         }
       },
       "key": "{fgColor.draft}"
@@ -36962,6 +37674,7 @@
     "key": "{fgColor.link}",
     "$value": "#96d0ff",
     "$type": "color",
+    "$description": "Text color for hyperlinks",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -36970,6 +37683,10 @@
         "codeSyntax": {
           "web": "var(--fgColor-link) /* utility class: .color-fg-accent */"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["link-text", "hyperlink"],
+        "rules": "MUST use for all text links. Provides expected link affordance."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -36977,6 +37694,7 @@
     "original": {
       "$value": "{fgColor.accent}",
       "$type": "color",
+      "$description": "Text color for hyperlinks",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -36985,6 +37703,10 @@
           "codeSyntax": {
             "web": "var(--fgColor-link) /* utility class: .color-fg-accent */"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["link-text", "hyperlink"],
+          "rules": "MUST use for all text links. Provides expected link affordance."
         }
       },
       "key": "{fgColor.link}"
@@ -36997,6 +37719,7 @@
     "key": "{fgColor.muted}",
     "$value": "#b7bdc8",
     "$type": "color",
+    "$description": "Muted text for secondary content and less important information",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37014,6 +37737,10 @@
         "dark-dimmed-high-contrast": "#b7bdc8",
         "dark-tritanopia-high-contrast": "#b7bdc8",
         "dark-protanopia-deuteranopia-high-contrast": "#b7bdc8"
+      },
+      "org.primer.llm": {
+        "usage": ["muted-text", "secondary-text", "helper-text", "placeholder"],
+        "rules": "Use for secondary text like timestamps, metadata, and helper text. Do NOT use for primary content."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37021,6 +37748,7 @@
     "original": {
       "$value": "{base.color.neutral.10}",
       "$type": "color",
+      "$description": "Muted text for secondary content and less important information",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37038,6 +37766,10 @@
           "dark-dimmed-high-contrast": "{base.color.neutral.10}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.10}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.10}"
+        },
+        "org.primer.llm": {
+          "usage": ["muted-text", "secondary-text", "helper-text", "placeholder"],
+          "rules": "Use for secondary text like timestamps, metadata, and helper text. Do NOT use for primary content."
         }
       },
       "key": "{fgColor.muted}"
@@ -37050,6 +37782,7 @@
     "key": "{fgColor.neutral}",
     "$value": "#d1d7e0",
     "$type": "color",
+    "$description": "Neutral semantic text for icons and secondary elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37064,6 +37797,10 @@
         "dark-dimmed-high-contrast": "#d1d7e0",
         "dark-tritanopia-high-contrast": "#d1d7e0",
         "dark-protanopia-deuteranopia-high-contrast": "#d1d7e0"
+      },
+      "org.primer.llm": {
+        "usage": ["neutral-icon", "neutral-text"],
+        "rules": "Use for neutral semantic elements. Prefer fgColor.muted for secondary text."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37071,6 +37808,7 @@
     "original": {
       "$value": "{base.color.neutral.11}",
       "$type": "color",
+      "$description": "Neutral semantic text for icons and secondary elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37085,6 +37823,10 @@
           "dark-dimmed-high-contrast": "{base.color.neutral.11}",
           "dark-tritanopia-high-contrast": "{base.color.neutral.11}",
           "dark-protanopia-deuteranopia-high-contrast": "{base.color.neutral.11}"
+        },
+        "org.primer.llm": {
+          "usage": ["neutral-icon", "neutral-text"],
+          "rules": "Use for neutral semantic elements. Prefer fgColor.muted for secondary text."
         }
       },
       "key": "{fgColor.neutral}"
@@ -37097,6 +37839,7 @@
     "key": "{fgColor.onEmphasis}",
     "$value": "#ffffff",
     "$type": "color",
+    "$description": "Text color for use on emphasis backgrounds",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37110,6 +37853,10 @@
         "dark": "#cdd9e5",
         "dark-dimmed": "#f0f6fc",
         "dark-dimmed-high-contrast": "#ffffff"
+      },
+      "org.primer.llm": {
+        "usage": ["text-on-emphasis", "contrast-text"],
+        "rules": "MUST use for text on any emphasis background (bgColor.*.emphasis). Ensures accessibility contrast."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37117,6 +37864,7 @@
     "original": {
       "$value": "#ffffff",
       "$type": "color",
+      "$description": "Text color for use on emphasis backgrounds",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37130,6 +37878,10 @@
           "dark": "{base.color.neutral.13}",
           "dark-dimmed": "{base.color.neutral.12}",
           "dark-dimmed-high-contrast": "#ffffff"
+        },
+        "org.primer.llm": {
+          "usage": ["text-on-emphasis", "contrast-text"],
+          "rules": "MUST use for text on any emphasis background (bgColor.*.emphasis). Ensures accessibility contrast."
         }
       },
       "key": "{fgColor.onEmphasis}"
@@ -37142,11 +37894,16 @@
     "key": "{fgColor.onInverse}",
     "$value": "#010409",
     "$type": "color",
+    "$description": "Text color for use on inverse backgrounds",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
         "group": "semantic",
         "scopes": ["fgColor"]
+      },
+      "org.primer.llm": {
+        "usage": ["text-on-inverse", "inverse-text"],
+        "rules": "Use for text on bgColor.inverse. Provides appropriate contrast in both themes."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37154,11 +37911,16 @@
     "original": {
       "$value": "{base.color.neutral.0}",
       "$type": "color",
+      "$description": "Text color for use on inverse backgrounds",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
           "group": "semantic",
           "scopes": ["fgColor"]
+        },
+        "org.primer.llm": {
+          "usage": ["text-on-inverse", "inverse-text"],
+          "rules": "Use for text on bgColor.inverse. Provides appropriate contrast in both themes."
         }
       },
       "key": "{fgColor.onInverse}"
@@ -37171,6 +37933,7 @@
     "key": "{fgColor.open}",
     "$value": "#b4f1b4",
     "$type": "color",
+    "$description": "Text color for open state indicators (issues, PRs)",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37189,6 +37952,10 @@
         "dark-tritanopia-high-contrast": "#ff938a",
         "light-tritanopia": "#c93c37",
         "light-tritanopia-high-contrast": "#ad2e2c"
+      },
+      "org.primer.llm": {
+        "usage": ["open-text", "open-issue", "open-pr"],
+        "rules": "Use for open/active status text. Specifically for GitHub issues and PRs."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37196,6 +37963,7 @@
     "original": {
       "$value": "{fgColor.success}",
       "$type": "color",
+      "$description": "Text color for open state indicators (issues, PRs)",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37214,6 +37982,10 @@
           "dark-tritanopia-high-contrast": "{base.color.red.2}",
           "light-tritanopia": "{base.color.red.5}",
           "light-tritanopia-high-contrast": "{base.color.red.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["open-text", "open-issue", "open-pr"],
+          "rules": "Use for open/active status text. Specifically for GitHub issues and PRs."
         }
       },
       "key": "{fgColor.open}"
@@ -37226,6 +37998,7 @@
     "key": "{fgColor.severe}",
     "$value": "#ffbc6f",
     "$type": "color",
+    "$description": "Severe text for high-priority warnings",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37246,6 +38019,10 @@
         "light-tritanopia": "#c93c37",
         "light-tritanopia-high-contrast": "#ad2e2c",
         "light-protanopia-deuteranopia-high-contrast": "#94471b"
+      },
+      "org.primer.llm": {
+        "usage": ["severe-text", "urgent-text", "severe-icon"],
+        "rules": "Use for severe warnings, less critical than danger. Pair with bgColor.severe.muted for backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37253,6 +38030,7 @@
     "original": {
       "$value": "{base.color.orange.1}",
       "$type": "color",
+      "$description": "Severe text for high-priority warnings",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37273,6 +38051,10 @@
           "light-tritanopia": "{base.color.red.5}",
           "light-tritanopia-high-contrast": "{base.color.red.6}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.orange.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["severe-text", "urgent-text", "severe-icon"],
+          "rules": "Use for severe warnings, less critical than danger. Pair with bgColor.severe.muted for backgrounds."
         }
       },
       "key": "{fgColor.severe}"
@@ -37285,6 +38067,7 @@
     "key": "{fgColor.sponsors}",
     "$value": "#ffb3d8",
     "$type": "color",
+    "$description": "Text color for GitHub Sponsors content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37303,6 +38086,10 @@
         "light-high-contrast": "#983b6e",
         "light-protanopia-deuteranopia-high-contrast": "#983b6e",
         "light-tritanopia-high-contrast": "#983b6e"
+      },
+      "org.primer.llm": {
+        "usage": ["sponsors-text", "funding-text", "sponsors-icon"],
+        "rules": "Use for GitHub Sponsors related text. Do NOT use for general pink-colored text."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37310,6 +38097,7 @@
     "original": {
       "$value": "{base.color.pink.1}",
       "$type": "color",
+      "$description": "Text color for GitHub Sponsors content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37328,6 +38116,10 @@
           "light-high-contrast": "{base.color.pink.6}",
           "light-protanopia-deuteranopia-high-contrast": "{base.color.pink.6}",
           "light-tritanopia-high-contrast": "{base.color.pink.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["sponsors-text", "funding-text", "sponsors-icon"],
+          "rules": "Use for GitHub Sponsors related text. Do NOT use for general pink-colored text."
         }
       },
       "key": "{fgColor.sponsors}"
@@ -37340,6 +38132,7 @@
     "key": "{fgColor.success}",
     "$value": "#b4f1b4",
     "$type": "color",
+    "$description": "Success text for positive feedback and completed states",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37362,6 +38155,10 @@
         "dark-tritanopia-high-contrast": "#6cb6ff",
         "light-tritanopia": "#316dca",
         "light-tritanopia-high-contrast": "#255ab2"
+      },
+      "org.primer.llm": {
+        "usage": ["success-text", "positive-text", "success-icon"],
+        "rules": "Use for success states and positive feedback text. Pair with bgColor.success.muted for backgrounds."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37369,6 +38166,7 @@
     "original": {
       "$value": "{base.color.green.0}",
       "$type": "color",
+      "$description": "Success text for positive feedback and completed states",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37391,6 +38189,10 @@
           "dark-tritanopia-high-contrast": "{base.color.blue.2}",
           "light-tritanopia": "{base.color.blue.5}",
           "light-tritanopia-high-contrast": "{base.color.blue.6}"
+        },
+        "org.primer.llm": {
+          "usage": ["success-text", "positive-text", "success-icon"],
+          "rules": "Use for success states and positive feedback text. Pair with bgColor.success.muted for backgrounds."
         }
       },
       "key": "{fgColor.success}"
@@ -37403,6 +38205,7 @@
     "key": "{fgColor.upsell}",
     "$value": "#dcbdfb",
     "$type": "color",
+    "$description": "Text color for upsell and promotional content",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37411,6 +38214,10 @@
         "codeSyntax": {
           "web": "var(--fgColor-upsell)"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["upsell-text", "premium-text", "promotional"],
+        "rules": "Use for upgrade prompts and premium feature text. Do NOT use for regular content."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37418,6 +38225,7 @@
     "original": {
       "$value": "{fgColor.done}",
       "$type": "color",
+      "$description": "Text color for upsell and promotional content",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37426,6 +38234,10 @@
           "codeSyntax": {
             "web": "var(--fgColor-upsell)"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["upsell-text", "premium-text", "promotional"],
+          "rules": "Use for upgrade prompts and premium feature text. Do NOT use for regular content."
         }
       },
       "key": "{fgColor.upsell}"
@@ -37438,6 +38250,7 @@
     "key": "{fgColor.white}",
     "$value": "#cdd9e5",
     "$type": "color",
+    "$description": "Pure white text",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -37446,6 +38259,10 @@
       },
       "org.primer.overrides": {
         "dark": "#cdd9e5"
+      },
+      "org.primer.llm": {
+        "doNotUse": true,
+        "rules": "Avoid using raw white. Use semantic alternatives: fgColor.onEmphasis for text on dark backgrounds, fgColor.onInverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
       }
     },
     "filePath": "src/tokens/functional/color/fgColor.json5",
@@ -37453,6 +38270,7 @@
     "original": {
       "$value": "{base.color.neutral.13}",
       "$type": "color",
+      "$description": "Pure white text",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -37461,6 +38279,10 @@
         },
         "org.primer.overrides": {
           "dark": "{base.color.neutral.13}"
+        },
+        "org.primer.llm": {
+          "doNotUse": true,
+          "rules": "Avoid using raw white. Use semantic alternatives: fgColor.onEmphasis for text on dark backgrounds, fgColor.onInverse for inverted contexts. Raw black/white ignore theme preferences and accessibility settings."
         }
       },
       "key": "{fgColor.white}"
@@ -37473,6 +38295,13 @@
     "key": "{focus.outline}",
     "$value": "2px solid #6cb6ff",
     "$type": "border",
+    "$description": "Focus ring outline for keyboard navigation and accessibility.",
+    "$extensions": {
+      "org.primer.llm": {
+        "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
+        "rules": "Always ensure focus states are visible. Do not override with custom focus styles that reduce visibility. Use for interactive elements like buttons, links, and form controls."
+      }
+    },
     "filePath": "src/tokens/functional/border/border.json5",
     "isSource": true,
     "original": {
@@ -37482,6 +38311,13 @@
         "width": "2px"
       },
       "$type": "border",
+      "$description": "Focus ring outline for keyboard navigation and accessibility.",
+      "$extensions": {
+        "org.primer.llm": {
+          "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
+          "rules": "Always ensure focus states are visible. Do not override with custom focus styles that reduce visibility. Use for interactive elements like buttons, links, and form controls."
+        }
+      },
       "key": "{focus.outline}"
     },
     "name": "focus-outline",
@@ -37492,11 +38328,16 @@
     "key": "{focus.outlineColor}",
     "$value": "#6cb6ff",
     "$type": "color",
+    "$description": "Outline color for focus states on interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
         "group": "component (internal)",
         "scopes": ["borderColor", "effectColor"]
+      },
+      "org.primer.llm": {
+        "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
+        "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
       }
     },
     "filePath": "src/tokens/functional/color/focus.json5",
@@ -37504,11 +38345,16 @@
     "original": {
       "$value": "{borderColor.accent.emphasis}",
       "$type": "color",
+      "$description": "Outline color for focus states on interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
           "group": "component (internal)",
           "scopes": ["borderColor", "effectColor"]
+        },
+        "org.primer.llm": {
+          "usage": ["focus-ring", "keyboard-navigation", "accessibility-indicator"],
+          "rules": "Use for focus outlines on interactive elements like buttons, links, and form controls. MUST be visible for keyboard navigation accessibility. Do NOT use for decorative borders or non-interactive elements."
         }
       },
       "key": "{focus.outlineColor}"
@@ -46564,6 +47410,7 @@
     "key": "{selection.bgColor}",
     "$value": "#1b4b91b3",
     "$type": "color",
+    "$description": "Background color for text selection highlights",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -46578,6 +47425,10 @@
           "isSource": true,
           "$type": "color"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["text-selection", "highlighted-text", "selected-content"],
+        "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
       }
     },
     "alpha": 0.7,
@@ -46586,6 +47437,7 @@
     "original": {
       "$value": "{bgColor.accent.emphasis}",
       "$type": "color",
+      "$description": "Background color for text selection highlights",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -46600,6 +47452,10 @@
             "isSource": true,
             "$type": "color"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["text-selection", "highlighted-text", "selected-content"],
+          "rules": "Use for native text selection (::selection) and programmatic text highlighting. Do NOT use for general emphasis or background colors on containers."
         }
       },
       "alpha": 0.7,
@@ -46613,6 +47469,7 @@
     "key": "{shadow.floating.large}",
     "$value": "0px 0px 0px 1px #b7bdc8, 0px 24px 48px 0px #010409",
     "$type": "shadow",
+    "$description": "Large floating shadow for modals and dialogs",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -46642,6 +47499,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["modal", "dialog", "full-screen-overlay"],
+        "rules": "MUST use for modals and dialogs. Do NOT use for small floating elements."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -46666,6 +47527,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Large floating shadow for modals and dialogs",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -46695,6 +47557,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["modal", "dialog", "full-screen-overlay"],
+          "rules": "MUST use for modals and dialogs. Do NOT use for small floating elements."
         }
       },
       "key": "{shadow.floating.large}"
@@ -46707,6 +47573,7 @@
     "key": "{shadow.floating.legacy}",
     "$value": "0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966",
     "$type": "shadow",
+    "$description": "Legacy floating shadow for backward compatibility",
     "$extensions": {
       "org.primer.figma": {},
       "org.primer.overrides": {
@@ -46733,6 +47600,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["legacy-component", "backward-compatibility"],
+        "rules": "DEPRECATED: Use shadow-floating-small instead. Only use for maintaining backward compatibility with existing implementations."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -46757,6 +47628,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Legacy floating shadow for backward compatibility",
       "$extensions": {
         "org.primer.figma": {},
         "org.primer.overrides": {
@@ -46783,6 +47655,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["legacy-component", "backward-compatibility"],
+          "rules": "DEPRECATED: Use shadow-floating-small instead. Only use for maintaining backward compatibility with existing implementations."
         }
       },
       "key": "{shadow.floating.legacy}"
@@ -46795,6 +47671,7 @@
     "key": "{shadow.floating.medium}",
     "$value": "0px 0px 0px 1px #b7bdc8, 0px 8px 16px -4px #01040966, 0px 4px 32px -4px #01040966, 0px 24px 48px -12px #01040966, 0px 48px 96px -24px #01040966",
     "$type": "shadow",
+    "$description": "Medium floating shadow for popovers and action menus",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -46848,6 +47725,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["popover", "action-menu", "select-panel", "autocomplete"],
+        "rules": "Use for medium-sized floating elements like popovers and action menus. More prominent than small but less than dialogs. Do NOT use for full modals."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -46896,6 +47777,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium floating shadow for popovers and action menus",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -46949,6 +47831,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["popover", "action-menu", "select-panel", "autocomplete"],
+          "rules": "Use for medium-sized floating elements like popovers and action menus. More prominent than small but less than dialogs. Do NOT use for full modals."
         }
       },
       "key": "{shadow.floating.medium}"
@@ -46961,6 +47847,7 @@
     "key": "{shadow.floating.small}",
     "$value": "0px 0px 0px 1px #b7bdc8, 0px 6px 12px -3px #01040966, 0px 6px 18px 0px #01040966",
     "$type": "shadow",
+    "$description": "Small floating shadow for dropdowns, tooltips, and small overlays",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -46998,6 +47885,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["dropdown", "tooltip", "popover", "menu"],
+        "rules": "Use for small floating elements like dropdowns and tooltips. Do NOT use for modals or dialogs."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47030,6 +47921,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Small floating shadow for dropdowns, tooltips, and small overlays",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47067,6 +47959,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["dropdown", "tooltip", "popover", "menu"],
+          "rules": "Use for small floating elements like dropdowns and tooltips. Do NOT use for modals or dialogs."
         }
       },
       "key": "{shadow.floating.small}"
@@ -47079,6 +47975,7 @@
     "key": "{shadow.floating.xlarge}",
     "$value": "0px 0px 0px 1px #b7bdc8, 0px 32px 64px 0px #010409",
     "$type": "shadow",
+    "$description": "Extra large floating shadow for full-screen overlays and sheets",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47108,6 +48005,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["full-screen-overlay", "side-sheet", "drawer", "large-modal"],
+        "rules": "Use for full-screen or near-full-screen overlays like side sheets and drawers. Maximum elevation in the system. Do NOT use for small floating elements."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47132,6 +48033,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Extra large floating shadow for full-screen overlays and sheets",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47161,6 +48063,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["full-screen-overlay", "side-sheet", "drawer", "large-modal"],
+          "rules": "Use for full-screen or near-full-screen overlays like side sheets and drawers. Maximum elevation in the system. Do NOT use for small floating elements."
         }
       },
       "key": "{shadow.floating.xlarge}"
@@ -47173,6 +48079,7 @@
     "key": "{shadow.inset}",
     "$value": "inset 0px 1px 0px 0px #0104093d",
     "$type": "shadow",
+    "$description": "Inset shadow for recessed elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47193,6 +48100,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["input-field", "pressed-button", "recessed-area", "well"],
+        "rules": "Use for elements that appear pressed or inset into the surface. Commonly used for input fields and wells. Do NOT use for floating elements."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47208,6 +48119,7 @@
         "inset": true
       },
       "$type": "shadow",
+      "$description": "Inset shadow for recessed elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47228,6 +48140,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["input-field", "pressed-button", "recessed-area", "well"],
+          "rules": "Use for elements that appear pressed or inset into the surface. Commonly used for input fields and wells. Do NOT use for floating elements."
         }
       },
       "key": "{shadow.inset}"
@@ -47240,6 +48156,7 @@
     "key": "{shadow.resting.medium}",
     "$value": "0px 1px 1px 0px #01040966, 0px 3px 6px 0px #010409cc",
     "$type": "shadow",
+    "$description": "Medium resting shadow for cards and elevated surfaces",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47269,6 +48186,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["card", "panel", "elevated-surface", "elevated-sidebar"],
+        "rules": "Use for cards and content panels that sit above the page surface. Provides moderate elevation without appearing to float. Do NOT use for overlays or modals."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47293,6 +48214,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Medium resting shadow for cards and elevated surfaces",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47322,6 +48244,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["card", "panel", "elevated-surface", "elevated-sidebar"],
+          "rules": "Use for cards and content panels that sit above the page surface. Provides moderate elevation without appearing to float. Do NOT use for overlays or modals."
         }
       },
       "key": "{shadow.resting.medium}"
@@ -47334,6 +48260,7 @@
     "key": "{shadow.resting.small}",
     "$value": "0px 1px 1px 0px #01040999, 0px 1px 3px 0px #01040999",
     "$type": "shadow",
+    "$description": "Small resting shadow for buttons and interactive elements",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47365,6 +48292,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["button", "interactive-card", "clickable-element"],
+        "rules": "Use for buttons and small interactive elements at rest. Provides subtle depth and clickable affordance. RECOMMENDED for default button shadows."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47391,6 +48322,7 @@
         }
       ],
       "$type": "shadow",
+      "$description": "Small resting shadow for buttons and interactive elements",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47422,6 +48354,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["button", "interactive-card", "clickable-element"],
+          "rules": "Use for buttons and small interactive elements at rest. Provides subtle depth and clickable affordance. RECOMMENDED for default button shadows."
         }
       },
       "key": "{shadow.resting.small}"
@@ -47434,6 +48370,7 @@
     "key": "{shadow.resting.xsmall}",
     "$value": "0px 1px 1px 0px #010409cc",
     "$type": "shadow",
+    "$description": "Extra small resting shadow for minimal elevation",
     "$extensions": {
       "org.primer.figma": {
         "collection": "mode",
@@ -47454,6 +48391,10 @@
           "isSource": true,
           "$type": "shadow"
         }
+      },
+      "org.primer.llm": {
+        "usage": ["badge", "chip", "small-card", "subtle-elevation"],
+        "rules": "Use for very subtle elevation on small elements. Provides minimal lift from surface. Do NOT use for interactive elements needing clear affordance."
       }
     },
     "filePath": "src/tokens/functional/shadow/shadow.json5",
@@ -47469,6 +48410,7 @@
         "inset": false
       },
       "$type": "shadow",
+      "$description": "Extra small resting shadow for minimal elevation",
       "$extensions": {
         "org.primer.figma": {
           "collection": "mode",
@@ -47489,6 +48431,10 @@
             "isSource": true,
             "$type": "shadow"
           }
+        },
+        "org.primer.llm": {
+          "usage": ["badge", "chip", "small-card", "subtle-elevation"],
+          "rules": "Use for very subtle elevation on small elements. Provides minimal lift from surface. Do NOT use for interactive elements needing clear affordance."
         }
       },
       "key": "{shadow.resting.xsmall}"