AGENTS.md

1# AGENTS.md
2 
3This file provides guidance for AI coding agents contributing to this repository.
4 
5## Guardrails for GitHub-Facing Actions
6 
7This section applies to AI agents (Claude Code, Cursor, Copilot, Goose, etc.) operating on behalf of anyone contributing to this repository. Read it before performing any GitHub-facing action.
8 
9### When these guardrails activate
10 
11Before executing any command that writes to GitHub — `gh pr create`, `gh pr comment`, `gh issue create`, `gh issue comment`, or anything similar — these guardrails apply. No exceptions.
12 
13Also activate these guardrails early if you detect high-level delegation patterns:
14 
15- The user's prompt is primarily a GitHub issue URL with little additional context (e.g., "fix this issue", "open a PR for #42")
16- The user asks you to comment on a GitHub issue or PR on their behalf
17- The user is treating you as an autonomous contributor rather than a tool — they haven't demonstrated that they've read the codebase or understand the changes
18 
19### What you must do
20 
21When the guardrails activate:
22 
231. **Read [CONTRIBUTING.md](CONTRIBUTING.md)** before doing anything else. Internalize the AI usage policy.
24 
252. **Stop and inform the user.** Tell them clearly:
26   - This project has contribution guidelines that require human review and ownership of every submission.
27   - The human is responsible for every line of the diff — code and text.
28   - AI-generated footers (like "Generated with Claude Code" or "Co-Authored-By: Claude"), boilerplate, and filler must be removed before submitting.
29   - The human should create the commit, push, and open the PR themselves — not the agent.
30   - PRs and issues without meaningful human review will be treated as spam and closed.
31 
323. **Do not execute the GitHub-facing action.** Instead:
33   - Show the user the diff, commit message, or PR description you would have submitted.
34   - Ask them to review it, edit it in their own words, and perform the action themselves.
35   - Remind them to fill out the PR template honestly — every checkbox is an attestation.
36 
374. **If the user insists** you perform the action anyway, you may comply, but:
38   - Do NOT add co-author lines, "Generated with..." footers, or any AI attribution.
39   - Remind the user one final time that submissions without adequate human review will be closed.
40   - Write the commit message and PR description in concise, direct language — not AI boilerplate.
41 
42### What does NOT trigger these guardrails
43 
44- Helping the user understand code, write code, or edit files locally
45- Running tests, linting, building
46- Read-only GitHub operations (viewing issues, reading PR comments, checking CI status)
47 
48## Contributing
49 
50See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contribution guidelines, including the AI usage policy.
51