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

 validation in CI (Issue #2550)
received: 2026-03-06 06:59:29
priority: high
status: awaiting_approval
---

## Email Content
iedayan created an issue (openai/openai-agents-python#2550)



## Summary



Add [AgentMD](https://agentmd.vercel.app/) to validate `AGENTS.md` in CI so the contributor guide stays parseable and agent-ready.



## Changes



- **New workflow** `.github/workflows/agentmd.yml`: runs on push to `main` and on all pull requests. Uses the official AgentMD action with `command: validate` and `path: .` as in their docs.

- **AGENTS.md**: new "AgentMD" subsection under Pull Request & Commit Guidelines describing that we use AgentMD in CI and how to use the CLI or GitHub App for readiness score / local use.



## Why



- Ensures `AGENTS.md` stays valid and that documented commands (e.g. `make format`, `make tests`) are detectable by AgentMD.

- Catches drift (e.g. renamed Makefile targets or broken...

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