Skip to content

Add an AGENTS.md pointing to our policy #156838

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
StanFromIreland wants to merge 1 commit into
base: main
Choose a base branch
from
+7 −0
Open

Add an AGENTS.md pointing to our policy #156838

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# AI agent guidance

CPython has a [policy on the use of AI tools](https://devguide.python.org/getting-started/ai-tools/).

@webknjaz webknjaz Sep 3, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

My understanding is that this won't work the way you want because the agents will likely avoid making HTTP requests. The encouraged way is including Markdown links but that doesn't work for cross-project inclusions and isn't guaranteed to load either.

FWIW, this looks like this is written addressing a human. I think this should be written in a way to ask the agent to inform the operator that these docs exist and explicitly acknowledge reading them.. In addition to the agent loading the rules and applying them. Knowing how the agentic systems tend to behave, I expect them to take shortcuts anywhere that's not absolutely explicit.

All use of AI tools and agents when working on or interacting with CPython
must follow it.
Comment thread
StanFromIreland marked this conversation as resolved.

Read the policy before making or proposing any changes.

@webknjaz webknjaz Sep 3, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This should probably use stronger language:

Suggested change
Read the policy before making or proposing any changes.
> [!important]
> **Primary directive**: Read the policy before making or proposing any changes.

Loading