docs: reorder card snippets, add llms.txt page (#2804)

## Summary
- Reordered the adaptive cards "executing actions" page so SubmitData
sits next to its handler examples instead of being buried in the middle
- Added a dedicated llms.txt docs page under Developer Tools

## Test plan
- [ ] Verify the adaptive cards executing actions page reads well
top-to-bottom
- [ ] Verify the new llms.txt page renders correctly with tabs

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: heyitsaamir

teams.md/docs/cli/index.md

@@ -6,7 +6,7 @@ slug: /
 # Teams CLI
 
 :::warning[Preview]
-The Teams CLI v2.1 is currently in **preview**. Commands, options, and behavior may change between releases.
+The Teams CLI v3 is currently in **preview**. Commands, options, and behavior may change between releases.
 :::
 
 CLI for managing Microsoft Teams apps. Create, manage, and configure Teams apps from the command line.

teams.md/docs/main/developer-tools/README.md

@@ -11,4 +11,5 @@ Learn more about the developer tools that come with Teams SDK.
 
 1. [Teams CLI](./cli)
 2. [Agent Skills](./agent-skills) — give AI coding assistants context for Teams development
-3. [DevTools](./devtools)
+3. [llms.txt](./llms-txt) — documentation files optimized for AI coding assistants
+4. [DevTools](./devtools)

teams.md/docs/main/developer-tools/agent-skills.md

@@ -5,7 +5,7 @@ summary: Give AI coding assistants (Claude Code, Cursor, GitHub Copilot) relevan
 
 # Agent Skills
 
-[Agent Skills](https://agentskills.io/what-are-skills) give AI coding assistants relevant context for specific development tasks. The `teams-dev` skill is the go-to agent skill for Teams bot development. It gives AI coding assistants (Claude Code, Cursor, GitHub Copilot, and others) relevant context to assist in developing Teams bots and use the Teams CLI to manage your bot infrastructure. Instead of running CLI commands manually, you describe what you want and your AI assistant handles the rest.
+[Agent Skills](https://aka.ms/teams-agent-skills) give AI coding assistants relevant context for specific development tasks. The `teams-dev` skill is the go-to agent skill for Teams bot development. It gives AI coding assistants (Claude Code, Cursor, GitHub Copilot, and others) relevant context to assist in developing Teams bots and use the Teams CLI to manage your bot infrastructure. Instead of running CLI commands manually, you describe what you want and your AI assistant handles the rest.
 
 :::note Alternative: Use llms.txt directly
 If you'd rather not install a skill, you can provide the same context by pointing your AI tool to the llms.txt URL:

teams.md/docs/main/developer-tools/llms-txt.md

@@ -0,0 +1,69 @@
+---
+sidebar_position: 3
+summary: Documentation files optimized for AI coding assistants to give them context about the Teams SDK.
+---
+
+# llms.txt
+
+The Teams SDK publishes [llms.txt](https://llmstxt.org) files, plain-text versions of the documentation optimized for AI coding assistants. Point your tool at the right file and it gets the context it needs to help you build Teams apps.
+
+## Available files
+
+### Root
+
+High-level SDK overview with links to reference guides.
+
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms.txt
+```
+
+:::tip
+Instead of manually providing URLs, you can install the [`teams-dev` agent skill](./agent-skills) which automatically gives your coding assistant the right context.
+:::
+
+### Per-language
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs>
+<TabItem value="typescript" label="TypeScript">
+
+**Small** — navigation index, the assistant fetches individual pages as needed.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript.txt
+```
+
+**Full** — complete documentation in a single file, best for tools with large context windows.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_typescript_full.txt
+```
+
+</TabItem>
+<TabItem value="python" label="Python">
+
+**Small** — navigation index, the assistant fetches individual pages as needed.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_python.txt
+```
+
+**Full** — complete documentation in a single file, best for tools with large context windows.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_python_full.txt
+```
+
+</TabItem>
+<TabItem value="csharp" label="C#">
+
+**Small** — navigation index, the assistant fetches individual pages as needed.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp.txt
+```
+
+**Full** — complete documentation in a single file, best for tools with large context windows.
+```
+https://microsoft.github.io/teams-sdk/llms_docs/llms_csharp_full.txt
+```
+
+</TabItem>
+</Tabs>

teams.md/src/pages/templates/in-depth-guides/adaptive-cards/executing-actions.mdx

@@ -60,11 +60,25 @@ Input Controls provide ways for you to validate. More details can be found on th
 
 <LanguageInclude section="input-validation-example" />
 
-## Server Handlers
+## Routing & Handlers
 
-### Basic Structure
+### Using SubmitData
 
-Card actions arrive as `card.action` activities in your app. These give you access to the validated input values plus any `data` values you had configured to be sent back to you.
+The SDK provides a `SubmitData` helper that sets the routing key for your action. This is the recommended way to wire up actions to specific handlers:
+
+<LanguageInclude section="submit-data-example" />
+
+### Action-Specific Handlers
+
+Register handlers for specific actions. When you use `SubmitData` to set the action name on the card, the SDK routes directly to the matching handler:
+
+<LanguageInclude section="sub-route-handler-example" />
+
+This is cleaner than a catch-all with a switch statement, and scales better as you add more actions.
+
+### Catch-All Handler
+
+If you need to handle all card actions in one place, you can use the catch-all handler:
 
 <LanguageInclude section="server-handler-example" />