docs: agent setup instructions

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 the agent setup snippet and quick rules, or use the included page list below to load specific references.
+Start with [LLM Guidelines](./guides/llm-guidelines.md) for rules overview, or use the included page list below to load specific references.
 
 ## Included pages
 

docs/guides/llm-guidelines.md

@@ -2,25 +2,6 @@
 
 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

docs/guides/migration-v14.md

@@ -46,6 +46,8 @@ command={{
 
 After running the codemods, review the changes and run your tests.
 
+If your project uses coding agents, add the RNTL package-docs instruction snippet from the [Quick Start](./quick-start.md#agent-docs-in-the-package) so agents read the docs that match your installed package version.
+
 ## Breaking Changes
 
 ### Supported React, React Native, and Node.js versions

docs/guides/quick-start.md

@@ -28,6 +28,21 @@ command={{
 
 Test Renderer has better compatibility with React 19 and improved type safety compared to the deprecated [React Test Renderer](https://reactjs.org/docs/test-renderer.html).
 
+## 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
+# 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.
+```
+
 ### Jest matchers
 
 RNTL automatically extends Jest with React Native-specific matchers. The only thing you need to do is to import anything from `@testing-library/react-native` which you already need to do to access the `render` function.

scripts/generate-package-docs.mjs

@@ -258,6 +258,8 @@ function rewriteInternalLinks(markdown, output) {
     ['docs/guides/common-mistakes', 'guides/common-mistakes.md'],
     ['docs/guides/troubleshooting', 'guides/troubleshooting.md'],
     ['docs/guides/llm-guidelines', 'guides/llm-guidelines.md'],
+    ['docs/start/quick-start', 'guides/quick-start.md'],
+    ['docs/start/migration-v14', 'guides/migration-v14.md'],
     ['docs/advanced/testing-env', 'guides/testing-environment.md'],
     ['docs/advanced/understanding-act', 'guides/understanding-act.md'],
     ['cookbook/basics/custom-render', 'cookbook/custom-render.md'],
@@ -285,7 +287,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 the agent setup snippet and quick rules, or use the included page list below to load specific references.
+Start with [LLM Guidelines](./guides/llm-guidelines.md) for rules overview, or use the included page list below to load specific references.
 
 ## Included pages
 

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

@@ -2,25 +2,6 @@
 
 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

website/docs/14.x/docs/start/migration-v14.mdx

@@ -49,6 +49,8 @@ We provide codemods to automate most of the migration:
 
 After running the codemods, review the changes and run your tests.
 
+If your project uses coding agents, add the RNTL package-docs instruction snippet from the [Quick Start](/docs/start/quick-start#agent-docs-in-the-package) so agents read the docs that match your installed package version.
+
 ## Breaking Changes
 
 ### Supported React, React Native, and Node.js versions

website/docs/14.x/docs/start/quick-start.mdx

@@ -28,6 +28,21 @@ This library has a peer dependency on [Test Renderer](https://github.com/mdjastr
 
 Test Renderer has better compatibility with React 19 and improved type safety compared to the deprecated [React Test Renderer](https://reactjs.org/docs/test-renderer.html).
 
+## 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
+# 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.
+```
+
 ### Jest matchers
 
 RNTL automatically extends Jest with React Native-specific matchers. The only thing you need to do is to import anything from `@testing-library/react-native` which you already need to do to access the `render` function.