llms doc for agents (#661)

jhaaaa · web-flow · commit 00fe5cc0dc97 · 2026-02-09T15:41:07.000-08:00
diff --git a/docs/pages/agents/get-started/build-an-agent.mdx b/docs/pages/agents/get-started/build-an-agent.mdx
@@ -117,11 +117,12 @@ XMTP creates local database files in the `dbPath` (default is `'./'`) directory.
 
 ## Vibe coding
 
-See these [Cursor rules](https://github.com/xmtplabs/xmtp-agent-examples/blob/main/.cursor/rules/xmtp.mdc) for vibe coding agents with XMTP using best practices.
+To make it easier for you to build with XMTP using LLMs and coding assistants, we offer two AI-ready solutions:
 
-```bash
-Prompt: lets create an example that gets a number and returns its 2x multiple (use claude max)
-```
+- A docs MCP server
+- Use case-based llms.txt files
+
+To learn more, see [Use XMTP documentation with AI coding assistants](/agents/get-started/build-with-llms).
 
 ## Talk to your agent
 
diff --git a/docs/pages/agents/get-started/build-with-llms.mdx b/docs/pages/agents/get-started/build-with-llms.mdx
@@ -0,0 +1,3 @@
+import BuildWithLlms from '../../../snippets/build-with-llms.mdx';
+
+<BuildWithLlms />
diff --git a/docs/pages/chat-apps/intro/build-with-llms.mdx b/docs/pages/chat-apps/intro/build-with-llms.mdx
@@ -1,41 +1,3 @@
-# Use XMTP documentation with AI coding assistants
+import BuildWithLlms from '../../../snippets/build-with-llms.mdx';
 
-To make it easier for you to build with XMTP using LLMs and coding assistants, we offer two AI-ready solutions. Choose the one that best fits your workflow:
-
-**Use the [documentation MCP (Model Context Protocol) server](#documentation-mcp-server) if:**
-- You're using MCP-compatible tools like Claude Code, Cursor, or Copilot for example
-- You want dynamic, structured documentation querying while writing and debugging code
-- You're comfortable setting up and running a local server process
-
-**Use [llms.txt files](#llmstxt-files) if:**
-- You're using AI tools that don't support MCP
-- You want zero-setup access to documentation
-- You prefer a simple copy-paste or URL reference approach
-
-## Documentation MCP server
-
-You can run a local XMTP documentation MCP server that you can use with Claude Code, Cursor, Copilot, and other MCP-compatible AI coding assistants.
-
-To learn about how it's built and how to use it, see the [xmtp-docs-mcp repo](https://github.com/xmtp/xmtp-docs-mcp).
-
-## llms.txt files
-
-If you're using an AI coding assistant that allows custom context, you can upload or point to the appropriate file to enhance your development experience with XMTP. Using the file focused on your builder use case (chat apps or agents) typically provides better AI performance by narrowing the context.
-
-### For building chat apps
-
-Use `llms-chat-apps.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-chat-apps.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-chat-apps.txt)
-
-Includes: Core messaging, content types, push notifications, user consent, protocol fundamentals, network operations, and funding information.
-
-### For building agents
-
-Use `llms-agents.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-agents.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-agents.txt)
-
-Includes: Agent concepts, building and deploying agents, agent-specific content types, protocol fundamentals, network operations, and funding information.
-
-### For comprehensive coverage
-
-Use `llms-full.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-full.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-full.txt)
-
-Includes: All documentation for chat apps, agents, protocol fundamentals, network operations, and funding information.
+<BuildWithLlms />
diff --git a/docs/pages/chat-apps/intro/get-started.mdx b/docs/pages/chat-apps/intro/get-started.mdx
@@ -18,7 +18,11 @@ To learn more, see [Why build with XMTP?](/chat-apps/intro/why-xmtp).
     <SdkButton href="/chat-apps/sdks/ios">iOS</SdkButton>
   </SdkButtons>
 
-- [Use llms-full.txt](/chat-apps/intro/build-with-llms) to provide the full text of the XMTP developer documentation to an AI coding assistant.
+- To make it easier for you to build with XMTP using LLMs and coding assistants, we offer two AI-ready solutions:
+  - A docs MCP server
+  - Use case-based llms.txt files
+
+  To learn more, see [Use XMTP documentation with AI coding assistants](/chat-apps/intro/build-with-llms).
 
 - [Use xmtp.chat](https://xmtp.chat), the official web chat app for developers, to interact with and test your app
 
diff --git a/docs/snippets/build-with-llms.mdx b/docs/snippets/build-with-llms.mdx
@@ -0,0 +1,41 @@
+# Use XMTP documentation with AI coding assistants
+
+To make it easier for you to build with XMTP using LLMs and coding assistants, we offer two AI-ready solutions. Choose the one that best fits your workflow:
+
+**Use the [documentation MCP (Model Context Protocol) server](#documentation-mcp-server) if:**
+- You're using MCP-compatible tools like Claude Code, Cursor, or Copilot for example
+- You want dynamic, structured documentation querying while writing and debugging code
+- You're comfortable setting up and running a local server process
+
+**Use [llms.txt files](#llmstxt-files) if:**
+- You're using AI tools that don't support MCP
+- You want zero-setup access to documentation
+- You prefer a simple copy-paste or URL reference approach
+
+## Documentation MCP server
+
+You can run a local XMTP documentation MCP server that you can use with Claude Code, Cursor, Copilot, and other MCP-compatible AI coding assistants.
+
+To learn about how it's built and how to use it, see the [xmtp-docs-mcp repo](https://github.com/xmtp/xmtp-docs-mcp).
+
+## llms.txt files
+
+If you're using an AI coding assistant that allows custom context, you can upload or point to the appropriate file to enhance your development experience with XMTP. Using the file focused on your builder use case (chat apps or agents) typically provides better AI performance by narrowing the context.
+
+### For building chat apps
+
+Use `llms-chat-apps.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-chat-apps.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-chat-apps.txt)
+
+Includes: Core messaging, content types, push notifications, user consent, protocol fundamentals, network operations, and funding information.
+
+### For building agents
+
+Use `llms-agents.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-agents.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-agents.txt)
+
+Includes: Agent concepts, building and deploying agents, agent-specific content types, protocol fundamentals, network operations, and funding information.
+
+### For comprehensive coverage
+
+Use `llms-full.txt`: [https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-full.txt](https://raw.githubusercontent.com/xmtp/docs-xmtp-org/main/llms/llms-full.txt)
+
+Includes: All documentation for chat apps, agents, protocol fundamentals, network operations, and funding information.
diff --git a/shared-sidebar.config.ts b/shared-sidebar.config.ts
@@ -16,12 +16,12 @@ export const sidebarConfig = {
           link: "/agents/get-started/build-an-agent",
         },
         {
-          text: "FAQ",
-          link: "/agents/get-started/faq",
+          text: "Build with LLMs",
+          link: "/agents/get-started/build-with-llms",
         },
         {
-          text: "Cursor rules",
-          link: "https://github.com/xmtplabs/xmtp-agent-examples/blob/main/.cursor/rules/xmtp.mdc",
+          text: "FAQ",
+          link: "/agents/get-started/faq",
         },
         { text: 'Join the XMTP Dev Community',
           link: 'https://forms.gle/hesZ55WGMjJnZ7sQA',

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import BuildWithLlms from '../../../snippets/build-with-llms.mdx';`
	`2`	`+`
	`3`	`+<BuildWithLlms />`