Agent Friendly Code
← all checks

CONTRIBUTING guides: a workflow AI coding agents can follow

This check looks for a contributing guide: CONTRIBUTING.md, or the .rst or .adoc form, at the repo root, in .github/ or in docs/.

How many repos pass

Of the 371 repos on the leaderboard, 321 pass in full (87%), 0 pass in part (0%) and 50 fail (13%).

Why agents need it

A contributing guide holds the rules a pull request is judged by: branch names, commit style, which checks must pass. An agent that opens pull requests needs those rules as much as a new contributor does.

How we score it

  • Full pass: a contributing guide in one of those three places.
  • Fail: none. We do not read its content.

The methodology has the formula that turns checks into a score.

How to pass

Add a CONTRIBUTING.md that covers branch naming, commit message style, the commands to run before pushing, and how review works. Keep the agent-specific parts in AGENTS.md and link between the two.

Which agents count it most

Pass rate by language

Top-scoring repos that pass

Popular repos that fail it