chore: rename CLAUDE.md to AGENTS.md#51
Conversation
Move AI coding agent instructions to AGENTS.md, the open standard (Linux Foundation / Agentic AI Foundation) supported by multiple AI coding tools. CLAUDE.md now imports AGENTS.md via @AGENTS.md. Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
There was a problem hiding this comment.
Pull request overview
This PR migrates AI coding agent instructions from CLAUDE.md to AGENTS.md to adopt the AGENTS.md convention, which is claimed to be supported by multiple AI coding tools. The original CLAUDE.md is replaced with a single line @AGENTS.md that is intended to import the new file, allowing Claude Code to continue working.
Changes:
- Renamed CLAUDE.md to AGENTS.md with generalized language (changing "Claude Code" to "AI coding agents")
- Replaced CLAUDE.md content with
@AGENTS.mdimport syntax
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| CLAUDE.md | Replaced entire content with @AGENTS.md import reference |
| AGENTS.md | New file containing the migrated content from CLAUDE.md with generalized agent language |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -0,0 +1,100 @@ | |||
| # AGENTS.md | |||
|
|
|||
| This file provides guidance to AI coding agents when working with code in this repository. | |||
There was a problem hiding this comment.
The PR description claims "Verify AGENTS.md content matches the original CLAUDE.md", but this line differs from the original. The original CLAUDE.md said "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository." while this line says "AI coding agents". While this change is likely intentional and appropriate for a more generic file, it contradicts the test plan item about verifying content matches.
There was a problem hiding this comment.
Good catch. The wording change from 'Claude Code (claude.ai/code)' to 'AI coding agents' is intentional — AGENTS.md is designed as a generic standard for multiple AI coding tools (Cursor, Copilot, etc.), not just Claude Code. I'll update the test plan to clarify that content was adapted for generic use rather than copied verbatim.
| - Python scripts check for `MISE_PROJECT_ROOT` and exit with clear error if missing | ||
| - Use `# shellcheck disable=` with justification when intentionally violating shellcheck rules | ||
| - Python scripts use `sys.exit(1)` on errors, print errors to stderr | ||
| @AGENTS.md |
There was a problem hiding this comment.
The PR description claims AGENTS.md is "the open standard (Linux Foundation / Agentic AI Foundation)" but the linked repository is under the Anthropic GitHub organization, not the Linux Foundation. If this is indeed a Linux Foundation standard, please clarify the connection. If not, the description should be updated to accurately reflect the standard's origin and governance.
There was a problem hiding this comment.
AGENTS.md is indeed stewarded by the Agentic AI Foundation (AAIF), a directed fund under the Linux Foundation co-founded by Anthropic, Block, and OpenAI. The GitHub repo being hosted under the anthropics org doesn't change its governance.
That said, the link was confusing — I've updated the PR description to link to the official AGENTS.md site instead of the GitHub repo.
| - Python scripts check for `MISE_PROJECT_ROOT` and exit with clear error if missing | ||
| - Use `# shellcheck disable=` with justification when intentionally violating shellcheck rules | ||
| - Python scripts use `sys.exit(1)` on errors, print errors to stderr | ||
| @AGENTS.md |
There was a problem hiding this comment.
The @AGENTS.md import syntax needs verification. While the PR description states "CLAUDE.md now imports AGENTS.md via @AGENTS.md so Claude Code continues to work," there is no evidence in the codebase or test plan demonstrating that this syntax is actually supported by Claude Code. Please verify that Claude Code recognizes and properly imports AGENTS.md when CLAUDE.md contains only this reference, or provide documentation supporting this syntax.
| @AGENTS.md | |
| # Claude configuration | |
| This project’s Claude/agent configuration is defined in [`AGENTS.md`](AGENTS.md). | |
| Open or reference `AGENTS.md` directly when configuring or using Claude Code. |
- Wrap lines to 100 characters - Add markdownlint-disable for CLAUDE.md import directive Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Replace "repo" with "repository" per textlint terminology rule. Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
|
Thanks @Copilot — addressed 1 comment(s). Please have another look! |
Summary
@AGENTS.mdso Claude Code continues to workTest plan