Share AI agent contribution rules across agents via AGENTS.md#818
Merged
Conversation
The contribution and commit rules for this repository had no single home that every AI coding agent reads. Add AGENTS.md as the canonical source -- the cross-tool standard read natively by Codex, Cursor, the GitHub Copilot coding agent, Gemini CLI and others -- so all agents follow the same rules, above all that every commit is authored by a human. The agents that use a dedicated file load that same single source: - .claude/CLAUDE.md imports it via Claude Code's @ syntax (and keeps the existing note about attributing GitHub comments posted on a maintainer's behalf) - GEMINI.md imports it via Gemini CLI's @ syntax - .github/copilot-instructions.md points to it so there is no second copy to keep in sync. Assisted-by: claude-code:claude-opus-4-8
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The contribution and commit rules for this repository had no single home that every AI coding agent reads. This adds
AGENTS.mdas the canonical source — the cross-tool standard read natively by Codex, Cursor, the GitHub Copilot coding agent, VS Code, Gemini CLI and many others — so all agents follow the same rules, above all that every commit is authored by a human (with anAssisted-by:trailer naming the assisting model).The agents that use a dedicated file load that same single source:
AGENTS.md(new) — the canonical rules, in plain Markdown..claude/CLAUDE.md(new) — imports@../AGENTS.md(Claude Code's import syntax); also keeps a hidapi-specific note about attributing GitHub comments posted on a maintainer's behalf.GEMINI.md(new) — imports@./AGENTS.md(Gemini CLI defaults toGEMINI.md)..github/copilot-instructions.md(new) — points toAGENTS.md; the Copilot coding agent and VS Code readAGENTS.mdnatively.Adapted from libusb/libusb#1842.
Assisted-by: claude-code:claude-opus-4-8