Agent Friendly Code
← back to leaderboard

discourse/discourseGitHub

https://github.com/discourse/discourse
Stars:
48k
Language:
Ruby
Default branch:
main
Last scored:
19h ago
Overall

At a glance

Rank
#17 of 371
Top 5% · #1 of 9 Ruby repos
Checks passed
12 of 16
Full list below
Best set up for
Cursor
Score 94.3
Needs most work for
Aider
Biggest fix: .aider.conf.yml (+14.1 pts)

What it has

What it's missing

What to fix first

  1. 1
    Manageable size
    If possible, split into smaller modules or carve out a focused entry path. Document where to start in AGENTS.md.
    +5.3 pts
  2. 2
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +3.6 pts

Score for each AI agent

Each agent looks for different things in a repo, based on its own docs. Under each score are the three checks it cares about most.

Cursor
94.3
Gemini CLI
93.1
Kimi CLI
92.5
GPT-5 Codex
91.9
Pi
91.8
Claude Code
91.2
Devin
89.9
OpenHands
80.6
Aider
79.3

Similar repos

Scored for Claude Code. Same language and host as this repo, scoring near it.

All Ruby repos →

All checks

AGENTS.md / CLAUDE.md· 100% pass
Substantive (5866 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
19 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 100% pass
1 .mdc file in .cursor/rules/
.cursor/rules/ai-agents-always.mdc
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 70% pass
Has .devcontainer/devcontainer.json
.devcontainer/devcontainer.json
GEMINI.md· 100% pass
Substantive GEMINI.md (5866 chars)
GEMINI.md
License file· 100% pass
License present
LICENSE.txt
Linter / formatter config· 100% pass
Config detected
eslint.config.mjs
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
lefthook.yml
README· 100% pass
README detailed (7710 chars)
README.md
Manageable size· 20% pass
10001+ files — very large
Test suite· 100% pass
Found /test
test
Type configuration· 100% pass
Type config present
tsconfig.json

Add a badge to your README

Paste this at the top of the README. It shows the score, and links back to this page.

Agent friendly score for github/discourse/discourse
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/discourse/discourse.svg)](https://agentfriendlycode.com/repo/github/discourse/discourse)

Check the score on every pull request

Add this file to your repo. On each pull request, it posts one comment showing how the score changed and why. It runs in your own CI, with no outside server involved.

# .github/workflows/agent-friendly.yml
name: Agent-friendly score diff

on:
  pull_request:
    branches: [main]

permissions:
  contents: read
  pull-requests: write

jobs:
  score-diff:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - uses: hsnice16/agent-friendly-action@v0
        with:
          agents-badge-token: ${{ secrets.AGENTS_BADGE_TOKEN }}

Add AGENTS_BADGE_TOKENto the repo's secrets to turn the comment on. Without it, the action does nothing. Where do I add it?