@brightspot/ui 6.8.1 → 6.8.2

package/README.md

@@ -122,12 +122,28 @@ import '@brightspot/ui/components/badge/Badge.js'
 
 On a CMS page, the CMS defines only a few of these elements itself. Import every other element your plugin uses, including ones your Java renders through the generated `com.brightspot.ui.dari` classes. [Using these in a plugin](docs/components/README.md#using-these-in-a-plugin) lists which ones the CMS defines.
 
-To browse everything available, run the interactive catalog:
+Browse every component, with live examples, at [ui.brightspot.com](https://ui.brightspot.com). The site shows only the newest release. To browse the version you have installed (6.8.1 or later), serve the copy that ships in the package and open http://localhost:6006:
 
 ```sh
-yarn storybook   # opens http://localhost:6006
+npx http-server node_modules/@brightspot/ui/dist/storybook -p 6006
 ```
 
+Opening its `index.html` straight from disk doesn't work, because browsers block its scripts on `file://`.
+
+### Point your AI coding agent at the docs
+
+The package ships docs written for coding agents, matched to the installed version: `llms.txt` at the package root, one page per component in `docs/components/`, and the Custom Elements Manifest. Agents don't find them on their own, so add this to your project's `AGENTS.md` or `CLAUDE.md`:
+
+```md
+## @brightspot/ui
+
+This project uses `@brightspot/ui` web components (`btu-*` tags). Before writing or changing code that uses them,
+read `node_modules/@brightspot/ui/llms.txt` and the component pages it links to. They match the installed version,
+so prefer them over what you remember about this library.
+```
+
+Without a local install, give the agent `https://ui.brightspot.com/llms.txt`, which describes the newest release.
+
 ---
 
 ## Improve the UI library itself