Skip to content

Add AGENTS.md with project instructions for AI coding agents#232

Merged
zeitlinger merged 2 commits intomainfrom
agents-md
Feb 24, 2026
Merged

Add AGENTS.md with project instructions for AI coding agents#232
zeitlinger merged 2 commits intomainfrom
agents-md

Conversation

@zeitlinger
Copy link
Member

Summary

  • Add AGENTS.md with project-specific instructions (build commands, architecture, code conventions, linting, testing) following the open standard (Linux Foundation / Agentic AI Foundation) supported by Cursor, Copilot, Codex, Gemini CLI, and others
  • Add CLAUDE.md that imports AGENTS.md via @AGENTS.md

Test plan

  • Open repo in Claude Code and verify instructions are loaded
  • Review AGENTS.md content for accuracy

AGENTS.md is the open standard (Linux Foundation / Agentic AI Foundation)
supported by multiple AI coding tools. CLAUDE.md imports it via @AGENTS.md.
Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
Copilot AI review requested due to automatic review settings February 22, 2026 12:29
@zeitlinger zeitlinger requested review from a team, grcevski and rlankfo as code owners February 22, 2026 12:29
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds documentation for AI coding agents following the Linux Foundation / Agentic AI Foundation open standard. The files provide comprehensive project guidance covering build commands, architecture, code conventions, linting, and testing practices.

Changes:

  • Add AGENTS.md with detailed project instructions for AI coding agents
  • Add CLAUDE.md that imports AGENTS.md using the @AGENTS.md syntax

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
AGENTS.md Comprehensive documentation covering project overview, build commands, linting, architecture, CLI usage, code conventions, testing, and CI
CLAUDE.md Simple import file that references AGENTS.md for Claude-specific tooling

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +28 to +30
# Run end-to-end tests
mise run e2e-test

Copy link

Copilot AI Feb 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The mise run e2e-test command is referenced in the CI workflow (.github/workflows/e2e_test.yml:18) but does not exist as a defined task in mise.toml. This command will fail if someone tries to run it based on these instructions.

Suggested change
# Run end-to-end tests
mise run e2e-test

Copilot uses AI. Check for mistakes.
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The e2e-test task does exist — it's defined as a shell script in .mise/tasks/e2e-test.sh. Mise auto-discovers tasks from both mise.toml and the .mise/tasks/ directory. I've added a note to clarify this for future readers.

- Fix prettier formatting in AGENTS.md
- Add markdownlint-disable for CLAUDE.md import directive
Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>
@zeitlinger
Copy link
Member Author

Thanks @Copilot — addressed 2 comment(s). Please have another look!

@zeitlinger zeitlinger merged commit 33b724c into main Feb 24, 2026
11 checks passed
@zeitlinger zeitlinger deleted the agents-md branch February 24, 2026 06:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants