apache/beam

At a glance

Rank

#268 of 401

#12 of 28 Java repos

Checks passed

7 of 17

Full list below

Best set up for

Claude Code

Score 66.2

Needs most work for

Aider

Biggest fix: .aider.conf.yml (+14.1 pts)

What to fix first

Showing fixes for Claude Code

1. 1
   AGENTS.md / CLAUDE.md

   Add an AGENTS.md covering project goals, layout, setup commands, and conventions. Aim for 800+ chars of real guidance (not boilerplate).
   +13.2 pts
2. 2
   Linter / formatter config

   Configure a linter/formatter (ESLint+Prettier, Biome, Ruff, rustfmt+clippy, golangci-lint) and commit the config.
   +7.9 pts
3. 3
   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 →

Does apache/beam 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

✗None at the root (no AGENTS.md, CLAUDE.md, AGENT.md, .claude/CLAUDE.md or .claude/AGENTS.md)

Agent-specific files

None: no GEMINI.md, .cursor/rules, .openhands/setup.sh, .aider.conf.yml or .agents/skills

Repos that have one

19 of 28 Java repos · 221 of 401 repos on the leaderboard · See examples →

# AGENTS.md

Guidance for AI coding agents working in apache/beam. Apache Beam is a unified programming model for Batch and Streaming data processing. Written mainly in Java.

## Where things are

- Dependencies are declared in `build.gradle.kts`.
- Test files are spread through the tree, e.g. `.test-infra/pubsub/test_image_looper.py`.
- CI is defined in `.github/workflows`; read it for the exact install, lint and test steps.
- Commit hooks are set up in `.pre-commit-config.yaml`; don't skip them.
- Use the `./gradlew` wrapper, not a system install.
- Follow the conventions in `CONTRIBUTING.md`.

## Commands

<!-- Fill in the exact commands CI runs. -->
- Install: TODO
- Test: TODO
- Lint: TODO

How apache/beam compares

vs leaderboard average

4.8 pts below

Average 66.8

vs Java average

0.8 pts above

Average 61.2

Stars among Java repos

#24 of 28

One fix for the most agents: Linter / formatter config would raise the score for all 9 agents, by up to 14.1 points.

Similar repos

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

• Anuken/Mindustry62.1
  Java · 29.6k ★
• questdb/questdb61.9
  Java · 17.5k ★
• StarRocks/starrocks60.7
  Java · 12.2k ★
• netty/netty60.5
  Java · 35.1k ★
• debezium/debezium60.5
  Java · 13.3k ★
• apache/iceberg60.5
  Java · 9.4k ★

Same topics, any language

Repos tagged with the same GitHub topics, most shared first.

• apache/seatunnel64.4
  Java · batch, streaming
• MaterializeInc/materialize75.6
  Rust · SQL, streaming
• apache/flink74.9
  Java · big data, SQL
• apache/spark73.6
  Scala · big data, SQL
• ClickHouse/ClickHouse67.6
  C++ · big data, SQL
• trinodb/trino58.6
  Java · big data, SQL