docs: rename AGENT.md to AGENTS.md and update references

Rename AGENT.md to AGENTS.md as AGENTS.md is now the standard.
Update all internal references within the renamed file and
cross-references in README.md to maintain documentation integrity.

Signed-off-by: Alejandro Mery <amery@apptly.co>

Author: amery

AGENT.md AGENTS.mdAGENT.md renamed to AGENTS.md

@@ -1,4 +1,4 @@
-# AGENT.md
+# AGENTS.md
 <!-- cspell:ignore linters -->
 
 This file provides guidance to AI agents when working with code in this
@@ -376,7 +376,7 @@ When editing Markdown files, ensure compliance with:
 When creating or editing documentation files:
 
 1. **File Structure**:
-   - Always include a link to related documentation (e.g., AGENT.md should
+   - Always include a link to related documentation (e.g., AGENTS.md should
      link to README.md).
    - Add prerequisites or setup instructions before diving into commands.
    - Include paths to configuration files when mentioning tools (e.g.,
@@ -406,7 +406,7 @@ When creating or editing documentation files:
    - If `make tidy` fails, fix the issues and run it again until it passes
 2. Verify all tests pass with `make test`.
 3. Ensure no linting violations remain.
-4. Update `AGENT.md` to reflect any changes in development workflow or
+4. Update `AGENTS.md` to reflect any changes in development workflow or
    standards.
 5. Update `README.md` to reflect significant changes in functionality or API.
 

README.md

@@ -651,7 +651,7 @@ Context-aware error group with cancellation:
 
 For detailed development setup, build commands, and AI agent guidance:
 
-* [AGENT.md](./AGENT.md) - Development guidelines, build system, and testing
+* [AGENTS.md](./AGENTS.md) - Development guidelines, build system, and testing
   patterns.
 
 ### Quick Start