docs: add build & test guidance for coding agents to AGENTS.md#6722
Merged
milamberspace merged 2 commits intoJul 8, 2026
Conversation
Document the JMeter build/test essentials so any coding agent knows how to build, run, and test the project — independent of any agent framework: - core gradlew tasks (build, test, check, runGui, createDist, style) - JDK selection for build and tests via -PjdkBuildVersion / -PjdkTestVersion / -PjdkTestVendor (the test-JDK flag), with an example - dependency-checksum refresh, coverage, and RAT tasks - pointer to the CI matrix and the Error Prone job Addresses the dev@ suggestion to give agents JMeter-specific build context (e.g. how to trigger tests under a specific JDK version). Generated-by: Claude Opus 4.8
Apply @vlsi's review on PR #2: keep only JMeter-specific, non-obvious guidance an agent doesn't already know — the --quiet flag, the "run ./gradlew --quiet classes style before handing back" instruction, and the JDK-test build parameters. Drop the generic gradlew build/test/check list, the heading suffix, and the checksums/coverage/RAT/CI section. Generated-by: Claude Opus 4.8
vlsi
approved these changes
Jul 8, 2026
vlsi
left a comment
vlsi
left a comment
Collaborator
There was a problem hiding this comment.
Looks good. Please squash the commits when merging
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a short "Building and testing" section to
AGENTS.mdso any AI codingagent has JMeter's build context up front — how to build and test, how to
format before handing a change back, and how to select a JDK for tests.
Kept deliberately minimal: only JMeter-specific, non-obvious guidance (agents
already know generic Gradle commands). It covers:
./gradlew --quiet …to reduce output; run./gradlew --quiet classes styleand fix any issues before reporting a change as done;
-PjdkTestVersion/-PjdkTestVendor(
jdkTestVersionis enough for most cases);./gradlew parameters.Pure documentation — no code or build changes; it points at the existing
gradle.md/README.mdbuild docs rather than duplicating them.Reviewed on a fork PR by Vladimir Sitnikov (
vlsi), who trimmed the wording to"only what an agent doesn't already know" and noted it looked mergeable for
apache/jmeter.