[wborn]

This pull request adds a new AGENTS.md file to the repository, providing detailed instructions and restrictions specifically for AI agents contributing to the OpenRemote documentation. The document outlines repository structure, versioning, writing guidelines, technical accuracy requirements, and validation steps, and clarifies how these agent-specific rules interact with existing maintenance procedures.

Key additions and guidelines for AI agents:

Agent-specific contribution restrictions:

• Introduces rules that override the general documentation maintenance procedures when there is a conflict, ensuring agents follow stricter guidelines for documentation changes.

Documentation structure and versioning:

• Clearly defines which directories are editable (docs/) and which are read-only (versioned_docs/, api/, etc.), and instructs agents not to propagate changes or create new versions unless explicitly required.

Writing and formatting standards:

• Specifies US English usage, Markdown preferences, technical accuracy, and formatting conventions, including one-sentence-per-line for new content and the use of descriptive headings and code formatting.

Technical and procedural accuracy:

• Requires agents to verify technical details against source repositories, avoid inventing information, and use placeholders for sensitive data, with clear instructions on handling unverifiable details.

Restrictions on generated and configuration files:

• Prohibits agents from modifying generated API documentation

[Ekhorn]

Will approve once the only thread is resolved.