Agent Friendly Code
← back to leaderboard

apache/airflowGitHub

https://github.com/apache/airflow
Stars:
45.2k
Default branch:
main
Last scored:
5h ago
Overall

Strengths

  • AGENTS.md / CLAUDE.md
  • CI configuration
  • Dependency manifest
  • Reproducible dev env
  • License file

Gaps

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

Suggestions to improve for a specific model

  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
  3. 3
    Test suite
    Add a tests/ (or test/, __tests__/, spec/) directory with runnable tests. Document how to run them in AGENTS.md.
    +3.9 pts

Per-model scores

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.
85.5
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.
78.0
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.
83.8
GPT-5 Codex
Reads AGENTS.md before doing any work per OpenAI's Codex docs — the strictest AGENTS.md adherent of any agent here. Hierarchical (per-directory) AGENTS.md and AGENTS.override.md are first-class.
86.1
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.
76.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). A green linter and a declared test command translate directly into successful commits.
76.8
OpenHands
Runs in a sandboxed container and executes `.openhands/setup.sh` at session start per OpenHands' repo-customization docs. Root AGENTS.md is now the preferred always-on instruction surface (microagents are deprecated in favor of it).
73.6
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.
86.3

Alternatives

Same-language repos scored for Claude Code. Heuristic v1 (same language + same host); cross-language matches are refined in v0.6.0.

Signal breakdown

AGENTS.md / CLAUDE.md· 100% pass
Substantive (23692 chars)
AGENTS.md
.aider.conf.yml· 0% pass
No .aider.conf.yml at repo root
CI configuration· 100% pass
43 GitHub Actions workflow(s)
.github/workflows
CONTRIBUTING guide· 0% pass
No CONTRIBUTING file
Cursor rules (.cursor/rules)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
pyproject.toml
Reproducible dev env· 100% pass
2 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
Linter / formatter config· 100% pass
Configured in pyproject.toml
pyproject.toml
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 100% pass
Hook framework configured
.pre-commit-config.yaml
README· 100% pass
README detailed (38105 chars)
README.md
Manageable size· 20% pass
10001+ files — very large
Test suite· 70% pass
Test files detected (airflow-ctl-tests/tests/airflowctl_tests/test_airflowctl_commands.py)
airflow-ctl-tests/tests/airflowctl_tests/test_airflowctl_commands.py
Type configuration· 100% pass
Configured in pyproject.toml
pyproject.toml

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