doc(agents): how to get sinch api docs

Author: kojiromike

.github/copilot-instructions.md

@@ -587,6 +587,14 @@ Before considering work complete:
 
 ---
 
+## Sinch API Documentation
+
+When suggesting code for Sinch API integrations:
+1. **Check `.local/llms.txt` first** - Local cached copy of Sinch API documentation
+2. **Fetch from https://developers.sinch.com/llms.txt** if local copy unavailable
+
+The llms.txt file contains complete API documentation for Sinch Conversations, webhooks, message formats, and authentication.
+
 ## Development Tooling: Taskfile vs Composer Scripts
 
 This module uses **both Taskfile and Composer scripts** with distinct responsibilities:

CLAUDE.md

@@ -678,6 +678,28 @@ private function redirect(Request $request): RedirectResponse
 - This blocks the iframe with: "Firefox will not allow Firefox to display the page if another site has embedded it"
 - Solution: Always use `$request->server->get('SCRIPT_NAME')` for redirects
 
+## Sinch API Documentation
+
+### For AI Agents
+
+When working with Sinch APIs (Conversations, SMS, etc.), reference the official documentation:
+
+1. **Check local copy first**: `.local/llms.txt` (cached copy of Sinch API docs)
+2. **Fetch latest if needed**: https://developers.sinch.com/llms.txt
+
+The `llms.txt` file contains comprehensive API documentation for:
+- Sinch Conversations API
+- Message formats and types
+- Webhook events
+- Authentication
+- Error handling
+
+**When to use:**
+- Implementing API integrations
+- Understanding webhook payloads
+- Debugging API responses
+- Adding new Sinch features
+
 ## Development Tooling: Taskfile vs Composer Scripts
 
 ### Separation of Concerns

Taskfile.yml

@@ -193,6 +193,13 @@ tasks:
     - composer update
     - echo "✅ Composer dependencies updated"
 
+  docs:sinch:
+    desc: Fetch latest Sinch API documentation for AI agents
+    cmds:
+    - mkdir -p .local
+    - curl -fsSL https://developers.sinch.com/llms.txt -o .local/llms.txt
+    - echo "✅ Sinch API docs updated in .local/llms.txt"
+
   openemr:prebuild:
     desc: Pre-build OpenEMR dependencies (speeds up first Docker start)
     cmds: