docs(contrib): add AGENTS.md and CLAUDE.md for AI-agent contributors#1992
Merged
Conversation
Contributor
|
https://github.com/runbox/runbox7/pull/1756/changes - changelog bit done.. does your branch need rebasing ? |
Contributor
Author
No, just |
fleetfootmike
force-pushed
the
mikew/add-agents-md-drop-changelog-step
branch
from
945c249 to
d1f0877
Compare
AGENTS.md distills the contribution rules for AI agents and their human partners, drawn from CONTRIBUTING.md and the bounty program. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add a CLAUDE.md that redirects to AGENTS.md as the single guidance entry point for Claude Code and other agents. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Per review: the agent does the work; the human partner opens the PR, decides it is ready, and assents to the license. Reword so instructions addressed to "you" (the agent) no longer claim actions only the human takes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
fleetfootmike
force-pushed
the
mikew/add-agents-md-drop-changelog-step
branch
from
d1f0877 to
6c1625d
Compare
fleetfootmike
changed the title
Missing space: "was.C heck" -> "was. Check". Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Drop the reward tiers and tables per review — the "bounty"/"good first issue" framing draws spray-and-pray bots. Keep the security testing rules (promoted to a top-level section), drop the intro's bounty reference, and retitle the security report email subject. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Drop "all public API methods must be documented" from AGENTS.md and CONTRIBUTING.md per review — "public API" is ambiguous in an Angular/TS frontend. Replace with a rule to comment the why/what of a new section, not the how, at most two lines per section. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
3 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.
What & why
Adds
AGENTS.md— a distilled guide to the contribution rules for AI agents and their humanpartners, drawn from
CONTRIBUTING.md— and makes it the single guidance entry point.Changes
AGENTS.md(new): contribution rules for AI agents — issue/duplicate checks, mandatorycherry-pickable tests, AI-use disclosure, strict commit format, one-problem-per-PR, and
security-testing rules. Written so the agent's instructions cover the work, while the
human partner does the outward/legal actions — opening the PR, deciding it is ready, assenting
to the license (per review feedback).
CLAUDE.md(new): a thin pointer toAGENTS.mdso Claude Code and other agents read the sameguidance.
(The changelog-step cleanup this branch originally carried is already on master via #1756, so
CONTRIBUTING.mdis untouched here.)AI-use disclosure
superpowers6.1.0→6.1.1,paad1.11.0AGENTS.mdandCLAUDE.mdwere drafted with AI assistance and reviewed/approved bythe maintainer before commit.
🤖 Generated with Claude Code