Add AGENTS.md

[aclark4life]

Changes proposed in this pull request:

• Add AGENTS.md to orient agents with project layout, build/test/lint commands, and six Pillow-specific facts that code review on recent AI-assisted PRs showed it commonly gets wrong.

[hugovk]

Is AGENTS.md vendor neutral?

Which of the major vendors support it? (Links to docs, please.)

[radarhere]

https://github.com/agentsmd/agents.md

A simple, open format for guiding coding agents adopted by more than 60,000 open-source projects and agent frameworks including:
... Cursor ... VSCode ... Copilot

https://agents.md/

[hugovk]

And Claude? Is there one that supports it as well?

[aclark4life]

And Claude? Is there one that supports it as well?

anthropics/claude-code#6235

[radarhere]

https://code.claude.com/docs/en/memory.md

AGENTS.md

Claude Code reads CLAUDE.md, not AGENTS.md. If your repository already uses AGENTS.md for other coding agents, create a CLAUDE.md that imports it so both tools read the same instructions without duplicating them. You can also add Claude-specific instructions below the import. Claude loads the imported file at session start, then appends the rest:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

[aclark4life]

I'm not in a hurry to add CLAUDE.md …

[radarhere]

Ok, sure. It seemed harmless enough to me, considering it can be hidden within .claude.

[aclark4life]

Ok, sure. It seemed harmless enough to me, considering it can be hidden within .claude.

It may be … but I'd like to wait for a more compelling reason to add it. Right now we're adding AGENTS.md because we believe that to be helpful to most agents which I think is more than enough for our purposes here e.g. Copilot should check that file both locally and on CI.

[hugovk]

anthropics/claude-code#6235 3,696 thumbs up! Let's add a few more :)

code.claude.com/docs/en/memory.md

says:

AGENTS.md

Claude Code reads CLAUDE.md, not AGENTS.md. If your repository already uses AGENTS.md for other coding agents, create a CLAUDE.md that imports it so both tools read the same instructions without duplicating them. You can also add Claude-specific instructions below the import. Claude loads the imported file at session start, then appends the rest:

@AGENTS.md

Let's make a .claude/CLAUDE.md containing:

@../AGENTS.md

• Feature Request: Support AGENTS.md. anthropics/claude-code#6235 (comment)
• https://code.claude.com/docs/en/best-practices

[aclark4life]

I'm not sure who or why or what we are adding it for, but I don't feel that strongly about it so @radarhere take it away! 😄

[aclark4life]

I'm not sure who or why or what we are adding it for, but I don't feel that strongly about it so @radarhere take it away! 😄

One reasonable answer is "make repo friendly for AI contributors" and right now that means both files. 🤷