Agent Friendly Code
← back to leaderboard

gitlab-org/gitlabGitLab

https://gitlab.com/gitlab-org/gitlab
Stars:
6.1k
Default branch:
master
Last scored:
7h ago
Overall

Strengths

  • AGENTS.md / CLAUDE.md
  • CONTRIBUTING guide
  • Dependency manifest
  • Reproducible dev env
  • License file

Gaps

  • .aider.conf.yml
  • Cursor rules (.cursor/rules)
  • GEMINI.md
  • .openhands/setup.sh
  • Type configuration

Suggestions to improve for a specific model

  1. 1
    Type configuration
    Add a type config (tsconfig.json for JS/TS, mypy.ini or pyrightconfig.json for Python). Rust/Go/JVM/Scala/Swift/C#/OCaml/Haskell/Zig are typed by default.
    +6.5 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.
    +6.2 pts
  3. 3
    CI configuration
    Add a CI workflow (e.g. .github/workflows/ci.yml or .gitlab-ci.yml) that runs tests + linter on every PR.
    +0.9 pts

Per-model scores

Kimi CLI
Reads AGENTS.md as its native instruction surface (root or `.kimi-code/AGENTS.md`) per Moonshot's Kimi Code docs, and `/init` generates one — the strictest AGENTS.md-only adherent here, with no CLAUDE.md fallback. Runs shell commands step-by-step under an approval gate rather than a sandbox VM, and dispatches `explore` sub-agents with isolated contexts to map a codebase, so a large tree costs it less than a single-context agent.
86.5
Devin
Operates from a sandboxed Ubuntu VM and runs an 8-step machine setup (deps, secrets, language versions, lint/test commands) per Cognition's repo-setup docs. CI config files alone aren't what the docs ask for — a runnable dev environment is.
86.4
Claude Code
Loads CLAUDE.md at the start of every conversation per Anthropic's memory docs, so AGENTS.md / CLAUDE.md and a fast test loop carry the most weight.
86.2
Pi
Minimal terminal coding harness. Loads `AGENTS.md` (or `CLAUDE.md`) at startup — global, parent dirs, then cwd — per the Pi coding-agent README. Sandboxing is deferred to user-installed extensions.
85.4
GPT-5 Codex
Reads AGENTS.md before doing any work per OpenAI's Codex docs. Hierarchical (per-directory) AGENTS.md and AGENTS.override.md are first-class.
84.4
OpenHands
Runs in a sandboxed container and executes `.openhands/setup.sh` at session start per OpenHands' repo-customization docs. A root AGENTS.md is now the preferred always-on instruction surface; the older `.openhands/microagents/` path has been renamed to Skills (`.agents/skills/`).
77.5
Aider
Auto-lints on every edit by default; runs the configured test command after edits when `--test-cmd` is set (per Aider's lint/test docs). It doesn't natively read AGENTS.md or CONVENTIONS.md — those load only when wired via `.aider.conf.yml`'s `read:` — so the config file, a green linter, and a declared test command are what translate into successful commits.
73.9
Gemini CLI
Reads hierarchical `GEMINI.md` (global → workspace → component-level) at every prompt per Gemini CLI's docs. The long-context advantage favors repos that split context per directory rather than docs-heavy in general.
73.2
Cursor
Per Cursor's Rules docs, reads `.cursor/rules/*.mdc` and AGENTS.md as the canonical repo-side input. Type config and a clean README still aid the codebase index but aren't the docs-cited signal.
71.6

Signal breakdown

AGENTS.md / CLAUDE.md· 100% pass
Substantive (2141 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 90% pass
CI config present
.gitlab-ci.yml
CONTRIBUTING guide· 100% pass
Guide present
CONTRIBUTING.md
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
package.json
Reproducible dev env· 100% pass
2 env artifacts (docker-compose.yml, bin/setup)
docker-compose.yml
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
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 (5868 chars)
README.md
Manageable size· 20% pass
10001+ files — very large
Test suite· 100% pass
Found /spec
spec
Type configuration· 0% pass
No type config found

Embed this badge

Drop the snippet below into the top of this repo's README so visitors can see its agent-friendliness at a glance — clicks land back here.

Agent friendly score for gitlab/gitlab-org/gitlab
[![Agent Friendly](https://agentfriendlycode.com/api/badge/gitlab/gitlab-org/gitlab.svg)](https://agentfriendlycode.com/repo/15059)

Catch score regressions on every PR

Drop the workflow below into your repo and the action will post (or edit) a single comment on each PR with the score delta and the per-signal changes — runs entirely inside your CI, no third-party server in the loop.

# .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@v4
        with:
          fetch-depth: 0
      - uses: hsnice16/agent-friendly-action@v0
        with:
          agents-badge-token: ${{ secrets.AGENTS_BADGE_TOKEN }}

Set AGENTS_BADGE_TOKENin the repo's secrets to enable the comment; leave it unset and the action exits silently. Where do I add it?