Improve coding-agent discoverability

agents.md → AGENTS.md

@@ -21,23 +21,23 @@ When working in this repository:
 This repository currently contains **3076** working code examples across **17** categories.
 
 ### Category Details
-- **convert-between-formats** — 135 examples. Guide: [agents.md](./convert-between-formats/agents.md)
-- **convert-thunderbird-mbox-files** — 182 examples. Guide: [agents.md](./convert-thunderbird-mbox-files/agents.md)
-- **programming-email-verification** — 40 examples. Guide: [agents.md](./programming-email-verification/agents.md)
-- **programming-with-gmail** — 142 examples. Guide: [agents.md](./programming-with-gmail/agents.md)
-- **read-and-export-zimbra-tgz-files** — 30 examples. Guide: [agents.md](./read-and-export-zimbra-tgz-files/agents.md)
-- **working-with-amp-html-emails** — 44 examples. Guide: [agents.md](./working-with-amp-html-emails/agents.md)
-- **working-with-exchange-ews-client** — 557 examples. Guide: [agents.md](./working-with-exchange-ews-client/agents.md)
-- **working-with-exchange-webdav-client** — 156 examples. Guide: [agents.md](./working-with-exchange-webdav-client/agents.md)
-- **working-with-ibm-notes** — 64 examples. Guide: [agents.md](./working-with-ibm-notes/agents.md)
-- **working-with-imap-client** — 303 examples. Guide: [agents.md](./working-with-imap-client/agents.md)
-- **working-with-microsoft-graph-client** — 38 examples. Guide: [agents.md](./working-with-microsoft-graph-client/agents.md)
-- **working-with-mime-messages** — 343 examples. Guide: [agents.md](./working-with-mime-messages/agents.md)
-- **working-with-outlook-items** — 511 examples. Guide: [agents.md](./working-with-outlook-items/agents.md)
-- **working-with-outlook-storage-files** — 189 examples. Guide: [agents.md](./working-with-outlook-storage-files/agents.md)
-- **working-with-pop3-client** — 166 examples. Guide: [agents.md](./working-with-pop3-client/agents.md)
-- **working-with-smtp-client** — 167 examples. Guide: [agents.md](./working-with-smtp-client/agents.md)
-- **zimbra** — 9 examples. Guide: [agents.md](./zimbra/agents.md)
+- **convert-between-formats** — 135 examples. Guide: [AGENTS.md](./convert-between-formats/AGENTS.md)
+- **convert-thunderbird-mbox-files** — 182 examples. Guide: [AGENTS.md](./convert-thunderbird-mbox-files/AGENTS.md)
+- **programming-email-verification** — 40 examples. Guide: [AGENTS.md](./programming-email-verification/AGENTS.md)
+- **programming-with-gmail** — 142 examples. Guide: [AGENTS.md](./programming-with-gmail/AGENTS.md)
+- **read-and-export-zimbra-tgz-files** — 30 examples. Guide: [AGENTS.md](./read-and-export-zimbra-tgz-files/AGENTS.md)
+- **working-with-amp-html-emails** — 44 examples. Guide: [AGENTS.md](./working-with-amp-html-emails/AGENTS.md)
+- **working-with-exchange-ews-client** — 557 examples. Guide: [AGENTS.md](./working-with-exchange-ews-client/AGENTS.md)
+- **working-with-exchange-webdav-client** — 156 examples. Guide: [AGENTS.md](./working-with-exchange-webdav-client/AGENTS.md)
+- **working-with-ibm-notes** — 64 examples. Guide: [AGENTS.md](./working-with-ibm-notes/AGENTS.md)
+- **working-with-imap-client** — 303 examples. Guide: [AGENTS.md](./working-with-imap-client/AGENTS.md)
+- **working-with-microsoft-graph-client** — 38 examples. Guide: [AGENTS.md](./working-with-microsoft-graph-client/AGENTS.md)
+- **working-with-mime-messages** — 343 examples. Guide: [AGENTS.md](./working-with-mime-messages/AGENTS.md)
+- **working-with-outlook-items** — 511 examples. Guide: [AGENTS.md](./working-with-outlook-items/AGENTS.md)
+- **working-with-outlook-storage-files** — 189 examples. Guide: [AGENTS.md](./working-with-outlook-storage-files/AGENTS.md)
+- **working-with-pop3-client** — 166 examples. Guide: [AGENTS.md](./working-with-pop3-client/AGENTS.md)
+- **working-with-smtp-client** — 167 examples. Guide: [AGENTS.md](./working-with-smtp-client/AGENTS.md)
+- **zimbra** — 9 examples. Guide: [AGENTS.md](./zimbra/AGENTS.md)
 
 ## Boundaries
 ### ✅ Always
@@ -66,5 +66,5 @@ Success = exit code 0 and no `CS####` compiler errors.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

README.md

@@ -1,9 +1,9 @@
 # Aspose.Email for .NET Examples
 
-AI-friendly repository containing validated C# examples for Aspose.Email for .NET API.
+Build-validated C# examples for Aspose.Email for .NET, organized for developers, AI coding agents, and LLM-based development tools.
 
 ## About
-Agent-generated C# examples for Aspose.Email for .NET — compiled, executed, and validated by an agentic pipeline. Includes an [agents.md](./agents.md) guide for AI coding agents.
+Agent-generated C# examples for Aspose.Email for .NET, compiled, executed, and validated by an agentic pipeline. See [AGENTS.md](./AGENTS.md) for coding-agent instructions and [llms.txt](./llms.txt) for a machine-readable repository map.
 
 [products.aspose.com/email/net/](https://products.aspose.com/email/net/)
 
@@ -89,10 +89,16 @@ catch (Exception ex)
 - [Aspose.Email for .NET Documentation](https://docs.aspose.com/email/net/)
 - [API Reference](https://reference.aspose.com/email/net/)
 - [Aspose Forum](https://forum.aspose.com/c/email/12)
-- [AI Agent Guide](./agents.md) - For AI agents and code generation tools
+- [Coding Agent Guide](./AGENTS.md) - Instructions for AI coding agents and code-generation tools
+- [LLM Repository Map](./llms.txt) - Compact machine-readable navigation
+
+## Related Agentic .NET Example Repositories
+- [Aspose.Words](https://github.com/aspose-words/agentic-net-examples)
+- [Aspose.Slides](https://github.com/aspose-slides/agentic-net-examples)
+- [Aspose.HTML](https://github.com/aspose-html/agentic-net-examples)
 
 ## License
 All examples use Aspose.Email for .NET and require a valid license for production use. See [licensing](https://purchase.aspose.com/).
 
 ---
-*This repository is maintained by automated code generation. For AI-friendly guidance, see [agents.md](./agents.md).*
+*This repository is maintained by automated code generation. For coding-agent guidance, see [AGENTS.md](./AGENTS.md).*

convert-between-formats/agents.md → convert-between-formats/AGENTS.md

@@ -3,15 +3,15 @@ name: convert-between-formats
 description: C# examples for convert-between-formats using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - convert-between-formats
 
 ## Persona
 You are a C# developer working in the **convert-between-formats** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **convert-between-formats**.
@@ -190,5 +190,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

convert-thunderbird-mbox-files/agents.md → convert-thunderbird-mbox-files/AGENTS.md

@@ -3,15 +3,15 @@ name: convert-thunderbird-mbox-files
 description: C# examples for convert-thunderbird-mbox-files using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - convert-thunderbird-mbox-files
 
 ## Persona
 You are a C# developer working in the **convert-thunderbird-mbox-files** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **convert-thunderbird-mbox-files**.
@@ -242,5 +242,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

index.json

@@ -5,7 +5,7 @@
   "package_version": "26.1.0",
   "total_examples": 3076,
   "total_categories": 17,
-  "last_updated": "2026-06-10",
+  "last_updated": "2026-06-14",
   "categories": [
     {
       "name": "convert-between-formats",

llms.txt

@@ -0,0 +1,34 @@
+# Aspose.Email for .NET Examples
+
+> Build-validated, standalone C# examples for Aspose.Email for .NET and .NET 8.
+
+- Examples: 3076
+- Categories: 17
+- Coding-agent instructions: ./AGENTS.md
+- Structured index: ./index.json
+- Product documentation: https://docs.aspose.com/email/net/
+- API reference: https://reference.aspose.com/email/net/
+
+## Categories
+- [convert-between-formats](./convert-between-formats/): 135 standalone examples; instructions in [AGENTS.md](./convert-between-formats/AGENTS.md)
+- [convert-thunderbird-mbox-files](./convert-thunderbird-mbox-files/): 182 standalone examples; instructions in [AGENTS.md](./convert-thunderbird-mbox-files/AGENTS.md)
+- [programming-email-verification](./programming-email-verification/): 40 standalone examples; instructions in [AGENTS.md](./programming-email-verification/AGENTS.md)
+- [programming-with-gmail](./programming-with-gmail/): 142 standalone examples; instructions in [AGENTS.md](./programming-with-gmail/AGENTS.md)
+- [read-and-export-zimbra-tgz-files](./read-and-export-zimbra-tgz-files/): 30 standalone examples; instructions in [AGENTS.md](./read-and-export-zimbra-tgz-files/AGENTS.md)
+- [working-with-amp-html-emails](./working-with-amp-html-emails/): 44 standalone examples; instructions in [AGENTS.md](./working-with-amp-html-emails/AGENTS.md)
+- [working-with-exchange-ews-client](./working-with-exchange-ews-client/): 557 standalone examples; instructions in [AGENTS.md](./working-with-exchange-ews-client/AGENTS.md)
+- [working-with-exchange-webdav-client](./working-with-exchange-webdav-client/): 156 standalone examples; instructions in [AGENTS.md](./working-with-exchange-webdav-client/AGENTS.md)
+- [working-with-ibm-notes](./working-with-ibm-notes/): 64 standalone examples; instructions in [AGENTS.md](./working-with-ibm-notes/AGENTS.md)
+- [working-with-imap-client](./working-with-imap-client/): 303 standalone examples; instructions in [AGENTS.md](./working-with-imap-client/AGENTS.md)
+- [working-with-microsoft-graph-client](./working-with-microsoft-graph-client/): 38 standalone examples; instructions in [AGENTS.md](./working-with-microsoft-graph-client/AGENTS.md)
+- [working-with-mime-messages](./working-with-mime-messages/): 343 standalone examples; instructions in [AGENTS.md](./working-with-mime-messages/AGENTS.md)
+- [working-with-outlook-items](./working-with-outlook-items/): 511 standalone examples; instructions in [AGENTS.md](./working-with-outlook-items/AGENTS.md)
+- [working-with-outlook-storage-files](./working-with-outlook-storage-files/): 189 standalone examples; instructions in [AGENTS.md](./working-with-outlook-storage-files/AGENTS.md)
+- [working-with-pop3-client](./working-with-pop3-client/): 166 standalone examples; instructions in [AGENTS.md](./working-with-pop3-client/AGENTS.md)
+- [working-with-smtp-client](./working-with-smtp-client/): 167 standalone examples; instructions in [AGENTS.md](./working-with-smtp-client/AGENTS.md)
+- [zimbra](./zimbra/): 9 standalone examples; instructions in [AGENTS.md](./zimbra/AGENTS.md)
+
+## Related Agentic .NET Repositories
+- Aspose.Words: https://github.com/aspose-words/agentic-net-examples
+- Aspose.Slides: https://github.com/aspose-slides/agentic-net-examples
+- Aspose.HTML: https://github.com/aspose-html/agentic-net-examples

programming-email-verification/agents.md → programming-email-verification/AGENTS.md

@@ -3,15 +3,15 @@ name: programming-email-verification
 description: C# examples for programming-email-verification using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - programming-email-verification
 
 ## Persona
 You are a C# developer working in the **programming-email-verification** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **programming-email-verification**.
@@ -85,5 +85,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

programming-with-gmail/agents.md → programming-with-gmail/AGENTS.md

@@ -3,15 +3,15 @@ name: programming-with-gmail
 description: C# examples for programming-with-gmail using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - programming-with-gmail
 
 ## Persona
 You are a C# developer working in the **programming-with-gmail** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **programming-with-gmail**.
@@ -208,5 +208,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

read-and-export-zimbra-tgz-files/agents.md → read-and-export-zimbra-tgz-files/AGENTS.md

@@ -3,15 +3,15 @@ name: read-and-export-zimbra-tgz-files
 description: C# examples for read-and-export-zimbra-tgz-files using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - read-and-export-zimbra-tgz-files
 
 ## Persona
 You are a C# developer working in the **read-and-export-zimbra-tgz-files** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **read-and-export-zimbra-tgz-files**.
@@ -81,5 +81,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

working-with-amp-html-emails/agents.md → working-with-amp-html-emails/AGENTS.md

@@ -3,15 +3,15 @@ name: working-with-amp-html-emails
 description: C# examples for working-with-amp-html-emails using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - working-with-amp-html-emails
 
 ## Persona
 You are a C# developer working in the **working-with-amp-html-emails** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **working-with-amp-html-emails**.
@@ -94,5 +94,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->

working-with-exchange-ews-client/agents.md → working-with-exchange-ews-client/AGENTS.md

@@ -3,15 +3,15 @@ name: working-with-exchange-ews-client
 description: C# examples for working-with-exchange-ews-client using Aspose.Email for .NET
 language: csharp
 framework: net8.0
-parent: ../agents.md
+parent: ../AGENTS.md
 ---
 
 # AGENTS - working-with-exchange-ews-client
 
 ## Persona
 You are a C# developer working in the **working-with-exchange-ews-client** category.
 This folder contains standalone C# examples for this category.
-See the root [agents.md](../agents.md) for repository-wide conventions.
+See the root [AGENTS.md](../AGENTS.md) for repository-wide conventions.
 
 ## Scope
 - Examples for **working-with-exchange-ews-client**.
@@ -629,5 +629,5 @@ See the root [agents.md](../agents.md) for repository-wide conventions.
 <!-- AUTOGENERATED:START -->
 | Date | Run ID | Branch/Commit |
 |------|--------|---------------|
-| 2026-06-10 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
-<!-- AUTOGENERATED:END -->
+| 2026-06-14 | `20260610_113049_697459_fa54355f` | [examples/batch-20260610_113049_697459_fa54355f](https://github.com/aspose-email/agentic-net-examples/tree/examples/batch-20260610_113049_697459_fa54355f) |
+<!-- AUTOGENERATED:END -->