Sample code for: How to Write an AGENTS.md File for a Python Project

[lpozo]

Where to put new files:

• New files should go into a top-level subfolder, named after the article slug. For example: my-awesome-article

How to merge your changes:

1. Make sure the CI code style tests all pass (+ run the automatic code formatter if necessary).
2. Find an RP Team member on Slack and ask them to review & approve your PR.
3. Once the PR has one positive ("approved") review, GitHub lets you merge the PR.
4. 🎉

---

Code examples for the How to Write an AGENTS.md File for a Python Project tutorial. Files live in the agents-md/ top-level folder, named after the article slug.

Generated from the tutorial markdown with the post-materials skill, then verified locally before pushing.

Contents:

• original_main.py — the starter FastAPI app
• run1_main.py — the agent's output without an AGENTS.md (the flawed run)
• run2_main.py — the agent's output with the AGENTS.md in place
• test_main.py — tests against run2_main.py (both pass)
• cars.json — the sample dataset
• AGENTS.md — the complete config file built across the tutorial