---
type: email
from: Ismail Dayan <notifications@github.com>
subject: [openai/openai-agents-python] Add AgentMD support for AGENTS.md

 validation in CI (PR #2551)
received: 2026-03-06 06:55:59
priority: high
status: awaiting_approval
---

## Email Content
### Summary



Adds [AgentMD](https://agentmd.vercel.app/) to validate `AGENTS.md` in CI so the contributor guide stays parseable and agent-ready, and drift (e.g. renamed Makefile targets or broken code blocks) is caught before merge.



**Changes:**



- **`.github/workflows/agentmd.yml`** � New workflow that runs on push to `main` and on all pull requests. Uses the official AgentMD action with `command: validate` and `path: .` per their docs. Includes a note that the AgentMD GitHub App may need to be installed if the action fails to load (free for 3 repos).

- **`AGENTS.md`** � New &quot;AgentMD&quot; subsection under Pull Request &amp; Commit Guidelines describing use of AgentMD in CI and how to use the CLI or GitHub App for readiness score / local use.



### Test plan



- Confirmed w...

## Suggested Actions
- [ ] Reply
- [ ] Archive
- [ ] Flag for review
