AndrewJSchofield commented on code in PR #22470:
URL: https://github.com/apache/kafka/pull/22470#discussion_r3387366485
##########
AGENTS.md:
##########
@@ -0,0 +1,131 @@
+# Apache Kafka — Agent Guide
+
+This file provides guidance for AI coding agents working with the Apache Kafka
codebase.
+For human contributors, see [README.md](README.md) and
[CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Project overview
+
+Apache Kafka is a distributed event streaming platform. This repo is a
**Gradle**
+build in **Java** and **Scala 2.13**.
+
+- **Supported JDK**: 11+ for `clients`, `generator`, and `streams`; 17+ for
other modules.
+- **Build/test JDK**: Java 17 and 25.
+- **Build tool**: Gradle, wrapper `./gradlew` is recommended.
+
+## Repository layout (high level)
+
+| Path |
Purpose
|
+|--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
+| `clients/` |
Producer, consumer, admin client APIs and protocol messages
|
+| `core/` |
Broker runtime, log, replication, request handling (gradually being removed
along with Scala code) |
+| `server/`, `server-common/` |
Broker/server components and shared server code
|
+| `metadata/`, `raft/` |
KRaft metadata layer and Raft implementation
|
+| `storage/`, `storage/api/` |
Log segments, checkpoints, tiered storage APIs
|
+| `group-coordinator/`, `share-coordinator/`, `transaction-coordinator/`,
`coordinator-common` | Coordinators
|
Review Comment:
nit: `coordinator-common/` with a trailing '/' please.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
