docs: add AI contribution guidance to CONTRIBUTING and PR template#257
Merged
yonib05 merged 1 commit intoJun 12, 2026
Merged
Conversation
Add a "Using AI Tools" section that welcomes AI-assisted contributions while setting a clear quality bar: contributors must understand the code they submit, keep changes small and incremental, and open an issue first for significant work. Add matching PR-template checklist items so the expectation is visible at submission time.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
Assessment: Approve Clean, focused docs-only change. The new "Using AI Tools" section is well-written, placed logically before "Contributing via Pull Requests," and matches the existing tone and tenet #5 ("accessible to humans and agents"). The two PR-template checklist additions are clear and appropriately scoped. Review Categories
Nice addition — this sets a clear, welcoming bar for AI-assisted contributions. |
1 task
Member
Author
|
Thanks! On the noted overlap with the existing "Contributing via Pull Requests" section (issue-first / keep-changes-focused): that repetition is intentional. The "Using AI Tools" section restates those two points in the specific context of AI-assisted contributions, where they're the most common failure mode, and the existing section keeps them as general PR mechanics. I'd rather the AI guidance stand on its own than send readers hunting for the relevant bullet elsewhere. Happy to add a cross-link if you'd prefer. |
poshinchen
approved these changes
Jun 11, 2026
yonib05
added a commit
to yonib05/evals-1
that referenced
this pull request
Jun 12, 2026
…e anchor The #creating-a-high-quality-pr anchor only resolves once strands-agents#258 lands, and the CONTRIBUTING#using-ai-tools anchor depends on strands-agents#257. Link plain CONTRIBUTING.md, which exists on main today, so the reference never dangles regardless of merge order.
yonib05
added a commit
that referenced
this pull request
Jun 12, 2026
* docs(agents): add community and character guidance to AGENTS.md Add a "Working with the Community" section framing the agent as a guide (not a gatekeeper or substitute author): help contributors produce changes they understand, point them to Discord/Discussions, assume good faith, and talk with people warmly and concisely. Inspired by p5.js's AGENTS.md. * docs(agents): tighten community section, link quality bar Trim the community guidance and replace the duplicated "small change / authorship" sentiment with a link to the Creating a High-Quality PR section. Concise on purpose — this file is loaded into agent context, so avoid restating what lives elsewhere. * docs(agents): point community section at CONTRIBUTING, not a same-file anchor The #creating-a-high-quality-pr anchor only resolves once #258 lands, and the CONTRIBUTING#using-ai-tools anchor depends on #257. Link plain CONTRIBUTING.md, which exists on main today, so the reference never dangles regardless of merge order.
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
We've been seeing more AI-generated PRs, and while we welcome AI-assisted contributions, quality has been inconsistent. This adds friendly-but-clear guidance so contributors know the bar.
Changes
The tone matches our existing voice and tenet #5 ("accessible to humans and agents"): AI is welcome, but the human is the author.
Testing