diff --git a/.ai/tailwindcss/4/core.blade.php b/.ai/tailwindcss/4/core.blade.php
index acef2cf0..21ff2366 100644
--- a/.ai/tailwindcss/4/core.blade.php
+++ b/.ai/tailwindcss/4/core.blade.php
@@ -2,6 +2,13 @@
 
 - Always use Tailwind CSS v4 - do not use the deprecated utilities.
 - `corePlugins` is not supported in Tailwind v4.
+- In Tailwind v4, configuration is CSS-first using the `@theme` directive — no separate `tailwind.config.js` file is needed.
+@verbatim<code-snippet name="Extending Theme in CSS" lang="css">
+@theme {
+  --color-brand: oklch(0.72 0.11 178);
+}
+</code-snippet>
+@endverbatim
 - In Tailwind v4, you import Tailwind using a regular CSS `@import` statement, not using the `@tailwind` directives used in v3:
 @verbatim
 <code-snippet name="Tailwind v4 Import Tailwind Diff" lang="diff">