Agent Friendly Code

apache/paimon

GitHub
https://github.com/apache/paimon

Apache Paimon is a lake format that enables building a Realtime Lakehouse Architecture with Flink and Spark for both streaming and batch operations.

  • big-data
  • data-ingestion
  • flink
  • paimon
  • real-time-analytics
  • spark
  • streaming-datalake
  • table-store
Stars:
3.4k
Language:
Java
Default branch:
master
Last scored:
Overall

At a glance

Rank
#231 of 401
#8 of 28 Java repos
Checks passed
7 of 17
Full list below
Best set up for
Claude Code + 1 more
Score 70.4
Needs most work for
OpenHands
Biggest fix: Reproducible dev env (+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
    Reproducible dev env
    Add a Makefile or devcontainer or Dockerfile so the agent can set up the project in one command.
    +11.8 pts
  2. 2
    CONTRIBUTING guide
    Add CONTRIBUTING.md describing branch naming, commit style, test commands, and the PR process.
    +5.3 pts
  3. 3
    Pre-commit / git hooks
    Set up pre-commit (.pre-commit-config.yaml), husky, or lefthook to run format+lint on every commit.
    +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
#221 of 401
70.4
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✗Reproducible dev env
Pi
#181 of 401
70.4
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Linter / formatter config
Codex
#214 of 401
69.7
  • ✓AGENTS.md / CLAUDE.md
  • ✓README
  • ~Test suite
Kimi Code CLI
#212 of 401
68.4
  • ✓AGENTS.md / CLAUDE.md
  • ~Test suite
  • ✓Dependency manifest
Cursor
#172 of 401
66.6
  • ✗Cursor rules (.cursor/rules)
  • ✓README
  • ✓Type configuration
Aider
#220 of 401
63.4
  • ✗.aider.conf.yml
  • ✓Linter / formatter config
  • ~Test suite
Gemini CLI
#221 of 401
62.8
  • ✗GEMINI.md
  • ✓README
  • ~Test suite
Devin
#288 of 401
61.1
  • ✗Reproducible dev env
  • ✓Dependency manifest
  • ~Test suite
OpenHands
#310 of 401
56.8
  • ✓CI configuration
  • ✓Dependency manifest
  • ✗Reproducible dev env

Does apache/paimon 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) · 3,558 characters
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 →

All 17 checks · 7 passed

Skills (.agents/skills)· 0% pass
No .agents/skills/<name>/SKILL.md
AGENTS.md / CLAUDE.md· 100% pass
Substantive (3,558 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)· 0% pass
No .cursor/rules/*.mdc or .cursorrules
Dependency manifest· 100% pass
Manifest present
pom.xml
Reproducible dev env· 0% pass
No Makefile / devcontainer / Docker / equivalent found
GEMINI.md· 0% pass
No GEMINI.md at repo root
License file· 100% pass
License present
LICENSE
Linter / formatter config· 100% pass
Config detected
.scalafmt.conf
.openhands/setup.sh· 0% pass
No .openhands/setup.sh
Pre-commit / git hooks· 0% pass
No pre-commit / husky / lefthook found
README· 100% pass
README detailed (4,443 characters)
README.md
Manageable size· 50% pass
4016 files — large
Test suite· 70% pass
Test files detected (paimon-python/dev/test_packaging.py)
paimon-python/dev/test_packaging.py
Type configuration· 100% pass
Typed language (Java)

How apache/paimon compares

vs leaderboard average
1.3 pts below
Average 66.8
vs Java average
4.3 pts above
Average 61.2
Stars among Java repos
#27 of 28

Missing here, and how many repos have it

  • CONTRIBUTING guide · passed by 86% of leaderboard repos, 82% of Java repos
  • Pre-commit / git hooks · passed by 29% of leaderboard repos, 4% of Java repos
  • Reproducible dev env · passed by 22% of leaderboard repos, 4% of Java repos

One fix for the most agents: Reproducible dev env would raise the score for all 9 agents, by up to 11.9 points.

Similar repos

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

All Java repos →

Same topics, any language

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

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

Check the score on every pull request

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