simplify

Author: mdjastrzebski

docs/README.md

@@ -2,7 +2,7 @@
 
 These markdown files are bundled with the npm package for coding agents. They describe the installed package version.
 
-Start with [LLM Guidelines](./guides/llm-guidelines.md) for quick rules, or use the included page list below to load specific references.
+Start with [LLM Guidelines](./guides/llm-guidelines.md) for the agent setup snippet and quick rules, or use the included page list below to load specific references.
 
 ## Included pages
 

docs/guides/llm-guidelines.md

@@ -2,6 +2,25 @@
 
 Actionable guidelines for writing tests with React Native Testing Library (RNTL) v14.
 
+## Agent docs in the package
+
+RNTL ships package-specific documentation for coding agents in `node_modules/@testing-library/react-native/docs/`.
+Add this snippet to your project's `AGENTS.md` or `CLAUDE.md` file so agents use the docs for the installed package version:
+
+```md
+<!-- BEGIN:react-native-testing-library-agent-rules -->
+
+# React Native Testing Library in this project
+
+This project uses `@testing-library/react-native`. Its APIs and testing conventions can differ from your training data.
+Before writing or changing RNTL tests, read the relevant guide in
+`node_modules/@testing-library/react-native/docs/`, starting with
+`node_modules/@testing-library/react-native/docs/guides/llm-guidelines.md`.
+Prefer those package docs over stale assumptions, and follow deprecation notices.
+
+<!-- END:react-native-testing-library-agent-rules -->
+```
+
 ## Core APIs
 
 ### render

scripts/generate-package-docs.mjs

@@ -285,7 +285,7 @@ function buildReadme(pages) {
 
 These markdown files are bundled with the npm package for coding agents. They describe the installed package version.
 
-Start with [LLM Guidelines](./guides/llm-guidelines.md) for quick rules, or use the included page list below to load specific references.
+Start with [LLM Guidelines](./guides/llm-guidelines.md) for the agent setup snippet and quick rules, or use the included page list below to load specific references.
 
 ## Included pages
 

website/docs/14.x/docs/guides/_meta.json

@@ -1 +1,8 @@
-["how-to-query", "common-mistakes", "troubleshooting", "faq", "community-resources"]
+[
+  "llm-guidelines",
+  "how-to-query",
+  "common-mistakes",
+  "troubleshooting",
+  "faq",
+  "community-resources"
+]

website/docs/14.x/docs/guides/llm-guidelines.mdx

@@ -2,6 +2,25 @@
 
 Actionable guidelines for writing tests with React Native Testing Library (RNTL) v14.
 
+## Agent docs in the package
+
+RNTL ships package-specific documentation for coding agents in `node_modules/@testing-library/react-native/docs/`.
+Add this snippet to your project's `AGENTS.md` or `CLAUDE.md` file so agents use the docs for the installed package version:
+
+```md
+<!-- BEGIN:react-native-testing-library-agent-rules -->
+
+# React Native Testing Library in this project
+
+This project uses `@testing-library/react-native`. Its APIs and testing conventions can differ from your training data.
+Before writing or changing RNTL tests, read the relevant guide in
+`node_modules/@testing-library/react-native/docs/`, starting with
+`node_modules/@testing-library/react-native/docs/guides/llm-guidelines.md`.
+Prefer those package docs over stale assumptions, and follow deprecation notices.
+
+<!-- END:react-native-testing-library-agent-rules -->
+```
+
 ## Core APIs
 
 ### render