Skip to content

Instruct agents to add a "pending human review" comment - #1733

Open
spenserblack wants to merge 3 commits into
o2sh:mainfrom
spenserblack:agents.md
Open

spenserblack wants to merge 3 commits into
o2sh:mainfrom
spenserblack:agents.md

Conversation

@spenserblack

Copy link
Copy Markdown
Collaborator

In the spirit of the new AI policy, this instructs an AI to add a comment that the human reviewer is expected to remove after they've reviewed their ASCII art. I've tested this out with GitHub Copilot and it does as expected. The purpose of the comment is to make it easier to tell if the user has failed manually review.

This helps make it more obvious when a PR author has failed to review
the code that they are submitting.
@spenserblack

spenserblack commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator Author

FWIW I've had a bit of success using a similar AGENTS.md in my own project: spenserblack/steamdown#429

I suspect that a decent amount of our most recent PRs are just AI-generated spam, unfortunately. Including a few that I've approved because I don't want to overzealously enforce the AI policy. I think users are just asking AI agents to look for popular repositories and make PRs, with little to no human oversight, and onefetch is getting hit by that.

@spenserblack

Copy link
Copy Markdown
Collaborator Author

TBH my initial draft was a bit inspired by my annoyance at fully automated PRs. I've rewritten this after chilling out a bit.

CONTRIBUTING.md mostly contains good instructions for LLMs as well as humans. This just adds a little extra for how agents should behave.

@o2sh Anything to add, change, or remove?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant