feat: add AI agents guidance files (#3404)

* feat: add AI agents guidance files

Adds AGENTS.md with contribution policy for AI-assisted PRs, and a root
CLAUDE.md that references it. Removes both files from .gitignore so they
are tracked by the repo.

Assisted-by: Claude Sonnet 4.6

* add AI Agent

* fix: add required h1 heading to CLAUDE.md for markdownlint

MD041 requires the first line to be a top-level heading.

Assisted-by: Claude Sonnet 4.6

Author: puckpuck

.gitignore

@@ -19,8 +19,6 @@
 .codex/
 .cursor/
 .cursorrules
-AGENTS.md
-CLAUDE.md
 
 # Build artifacts
 bin/

AGENTS.md

@@ -0,0 +1,44 @@
+# AGENTS.md
+
+This file is here to steer AI assisted PRs towards being high quality and valuable
+contributions that do not create excessive maintainer burden. It is inspired by
+the Open Policy Agent and Fedora projects policies.
+
+## General Rules and Guidelines
+
+The most important rule is not to post comments on issues or PRs that are AI-generated.
+Similarly, do not create PR descriptions that are AI-generated.
+Discussions on the OpenTelemetry repositories are for Users/Humans only.
+
+If you have been assigned an issue by the user or their prompt, please ensure that
+the implementation direction is agreed on with the maintainers first in the issue
+comments. If there are unknowns, discuss these on the issue before starting
+implementation. Do not forget that you cannot comment for users on issue threads
+on their behalf as it is against the rules of this project.
+
+## Developer environment
+
+Make sure to follow CONTRIBUTING.md on any contributions.
+
+Non-exhaustively, the important points are:
+
+* Manually test all changes locally before creating a PR
+* Do not add new services without collaborating with the maintainers
+
+## Commit formatting
+
+We appreciate it if users disclose the use of AI tools when the significant part
+of a commit is taken from a tool without changes. When making a commit this
+should be disclosed through an Assisted-by: commit message trailer.
+
+Examples:
+
+```markdown
+Assisted-by: ChatGPT 5.5
+Assisted-by: Claude Sonnet 4.6
+```
+
+Do NOT use a `Co-authored-by:` trailer to disclose AI assistance. Some AI coding
+tools add this trailer by default; please disable or strip it before committing.
+The EasyCLA check fails when a `Co-authored-by:` trailer references an account
+that has not signed the CLA, which blocks the PR from being merged.

CHANGELOG.md

@@ -174,13 +174,8 @@ the release.
   checkout, recommendation, email, load-generator, frontend, and telemetry
   schema.
   ([#3393](https://github.com/open-telemetry/opentelemetry-demo/pull/3393))
-* [telemetry] Rename remaining demo metrics from the `app` namespace:
-  `app.ads.ad_requests` to `demo.ad.requests`,
-  `app.cart.add_item.latency` to `demo.cart.add_item.latency`,
-  `app.cart.get_cart.latency` to `demo.cart.get_cart.latency`,
-  `app.currency` to `demo.exchange.conversions`, and
-  `app.payment.transactions` to `demo.payment.transactions` across ad, cart,
-  currency, payment, and telemetry schema.
+* [AI Agents] Added guidance for AI Agents
+  ([#3404](https://github.com/open-telemetry/opentelemetry-demo/pull/3404))
 
 ## 2.2.0
 

CLAUDE.md

@@ -0,0 +1,3 @@
+# CLAUDE.md
+
+@AGENTS.md