Agent Friendly Code

forem/forem

GitHub
https://github.com/forem/forem

For empowering community 🌱

  • community
  • discussion
  • feedback
  • hacktoberfest
  • open-source
  • rails
  • ruby
Stars:
22.8k
Language:
Ruby
Default branch:
main
Last scored:
Overall

At a glance

Rank
#50 of 401
Top 12% · #3 of 10 Ruby repos
Checks passed
10 of 17
Full list below
Best set up for
Claude Code
Score 89.5
Needs most work for
OpenHands
Biggest fix: .openhands/setup.sh (+10.0 pts)

What it has

What it's missing

What to fix first

Pick an AI agent

Showing fixes for Claude Code

  1. 1
    CONTRIBUTING guide
    Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
    +5.3 pts
  2. 2
    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

Score for each AI agent

Each agent weighs the checks by its own docs. Under each score are its top three. How each agent is scored →

Claude Code
#45 of 401
89.5
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Reproducible dev env
Pi
#54 of 401
85.3
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Linter / formatter config
Kimi Code CLI
#60 of 401
85.1
  • ✓AGENTS.md / CLAUDE.md
  • ✓Test suite
  • ✓Dependency manifest
Codex
#65 of 401
84.8
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ✓Test suite
Cursor
#14 of 401
82.5
  • ~Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration
Devin
#55 of 401
81.8
  • ✓Reproducible dev env
  • ✓Dependency manifest
  • ✓Test suite
Aider
#52 of 401
77.2
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ✓Test suite
Gemini CLI
#66 of 401
76.1
  • ✗GEMINI.md
  • ✓README
  • ✓Test suite
OpenHands
#91 of 401
73.4
  • ✓CI configuration
  • ✓Dependency manifest
  • ✓Reproducible dev env

Does forem/forem have agent instructions?

An AGENTS.md (or CLAUDE.md) at the root tells AI coding agents how to build, test and work in the repo. A few agents also read a file of their own.

AGENTS.md / CLAUDE.md
AGENTS.md (new tab) · 9,952 characters
Agent-specific files
.cursorrules (new tab) (the older form)No GEMINI.md, .openhands/setup.sh, .aider.conf.yml or .agents/skills
Repos that have one
6 of 10 Ruby repos · 221 of 401 repos on the leaderboard · See examples →

All 17 checks · 10 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (9,952 characters)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
12 GitHub Actions workflows
.github/workflows
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
Cursor rules (.cursor/rules)· 50% pass
Only the older .cursorrules — Cursor's docs now cover .cursor/rules/*.mdc instead
.cursorrules
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 100% pass
4 env artifacts (.devcontainer/devcontainer.json, Dockerfile)
.devcontainer/devcontainer.json
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE.md
Linter / formatter config· 100% pass
Config detected
.eslintrc.js
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
.husky
README· 100% pass
README detailed (9,243 characters)
README.md
Manageable size· 20% pass
6935 files — very large
Test suite· 100% pass
Found /spec
spec
Type configuration· 100% pass
Type config present
jsconfig.json

How forem/forem compares

vs leaderboard average
14.9 pts above
Average 66.8
vs Ruby average
10.1 pts above
Average 71.6
Stars among Ruby repos
#7 of 10

Missing here, and how many repos have it

  • CONTRIBUTING guide · passed by 86% of leaderboard repos, 80% of Ruby repos
  • Skills (.agents/skills) · passed by 17% of leaderboard repos, 30% of Ruby repos

Passes checks most repos miss

  • Reproducible dev env · only 22% of repos pass it
  • Pre-commit / git hooks · only 29% of repos pass it

One fix for the most agents: CONTRIBUTING guide would raise the score for all 9 agents, by up to 7.0 points.

Similar repos

Same language and host as this repo, closest in overall score.

All Ruby repos →

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/forem/forem
[![Agent Friendly](https://agentfriendlycode.com/api/badge/github/forem/forem.svg)](https://agentfriendlycode.com/repo/github/forem/forem)

Check the score on every pull request

A GitHub Action posts one comment per pull request with how the score changed and why.