Skip to content

Add AGENTS.md#19084

Merged
abhishekrb19 merged 2 commits into
apache:masterfrom
abhishekrb19:agents_md
Mar 10, 2026
Merged

Add AGENTS.md#19084
abhishekrb19 merged 2 commits into
apache:masterfrom
abhishekrb19:agents_md

Conversation

@abhishekrb19

@abhishekrb19 abhishekrb19 commented Mar 4, 2026

Copy link
Copy Markdown
Contributor

Add AGENTS.md that AI tools like Claude and Cursor can leverage. The general recommendation from these tools is to keep the markdown files lightweight but collaborative, so most folks using these tools in the repo for development or otherwise can use it right out of the box.

Other Apache repos like Spark and Superset follow a similar structure as well.

Use https://gist.github.com/gianm/031a578a75b4dc44f3e45661d86bcca9 as a baseline with some minor tweaks.

@gianm

gianm commented Mar 4, 2026

Copy link
Copy Markdown
Contributor

This is the one I use: https://gist.github.com/gianm/031a578a75b4dc44f3e45661d86bcca9

It focuses on the module structure, code style, & Maven commands for running tests, because those were the things I had seen agents having the most trouble with.

@capistrant

capistrant commented Mar 5, 2026

Copy link
Copy Markdown
Contributor

I like Gian's as a reference place to start! In addition to that, I think some thing brief about how to build and test the web-console + generate snapshots would also be useful as that is a bit of a pain point for folks who may once a year have to make a UI change and would be nice if an agent could easily handle.

@abhishekrb19 abhishekrb19 changed the title Placeholder for AGENTS.md Add AGENTS.md Mar 9, 2026
@abhishekrb19

Copy link
Copy Markdown
Contributor Author

This is the one I use: https://gist.github.com/gianm/031a578a75b4dc44f3e45661d86bcca9

It focuses on the module structure, code style, & Maven commands for running tests, because those were the things I had seen agents having the most trouble with.

Thanks, this seems useful. I've updated it to use this as the base template with a few tweaks:

  • Based on @capistrant's suggestion, I added a brief section for web-console development referring to web-console/README.md. If there are additional specific details, I think it'd be better to include them in the web-console's README.
  • Included a small Documentation section after noticing agents updating existing table formatting, which caused unnecessary diffs / spelling errors with not backquoting properties.

@abhishekrb19
abhishekrb19 merged commit 664dd19 into apache:master Mar 10, 2026
7 checks passed
@abhishekrb19
abhishekrb19 deleted the agents_md branch March 10, 2026 01:01
@github-actions github-actions Bot added this to the 37.0.0 milestone Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants