This is an automated email from the ASF dual-hosted git repository.
dsmiley pushed a commit to branch branch_9x
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/branch_9x by this push:
new 642a7bdd61e AGENTS.md for branch_9x
642a7bdd61e is described below
commit 642a7bdd61e8e37d1a97c251657bdd2611018a4d
Author: David Smiley <[email protected]>
AuthorDate: Fri Oct 2 21:55:07 2026 -0400
AGENTS.md for branch_9x
Findings discovered via claude: /checkup prompt-audit
---
AGENTS.md | 13 ++++++-------
1 file changed, 6 insertions(+), 7 deletions(-)
diff --git a/AGENTS.md b/AGENTS.md
index ecfc0cbb8d2..4e8edea19ad 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -6,9 +6,9 @@ While README.md and CONTRIBUTING.md are mainly written for
humans, this file is
- Follow Apache Software Foundation licensing rules, avoid adding a dependency
with a banned license
- Always apply the Apache License to new source files
-- All versions must be delcared in `gradle/libs.versions.toml`, never
build.gradle files
+- All versions must be declared in `versions.props`, never in build.gradle
files
- Try first declaring a dependency without a version (the version might
already be in a BOM); and if fails to resolve _then_ specify a version
-- Always run `gradlew updateLicenses resolveAndLockAll collectJarInfos
--write-locks` after adding or changing a dependency. See
`dev-docs/gradle-help/dependencies.txt` for more info
+- Always run `gradlew updateLicenses collectJarInfos --write-locks` after
adding or changing a dependency. See `dev-docs/gradle-help/dependencies.txt`
for more info
## Build and Development Workflow
@@ -21,7 +21,7 @@ While README.md and CONTRIBUTING.md are mainly written for
humans, this file is
- Be careful to not add non-essential logging! If you add slf4j log calls,
make sure to wrap debug/trace level calls in `logger.isXxxEnabled()` clause
- Validate user input. For file paths, always call
`myCoreContainer.assertPathAllowed(myPath)` before using
- Never use fully-qualified-names when an import statement will resolve
ambiguity.
-- SolrJ & "api" modules should use the latest Java 17 language features as
appropriate. Other modules can use Java 21.
+- Code compiles at the Java 11 language level (`minJavaVersion` in
build.gradle)
## Testing
@@ -52,15 +52,14 @@ Internals:
- `dev-docs/shard-split/shard-split.adoc` — SPLITSHARD: shard/replica states,
tlog buffering during split
- `dev-docs/distributed-update-internals.adoc` — SolrCloud update path:
routing, `_version_`/optimistic concurrency, tlog durability, replication acks,
shard terms (user-facing consistency model: ref-guide page
`solrcloud-update-consistency.adoc`)
- `dev-docs/plugins-modules-packages.adoc` — plugin/module/package concepts
-- `dev-docs/apis.adoc`, `dev-docs/v2-api-conventions.adoc` — API design and v2
conventions
-- `dev-docs/ui/` — new Admin UI architecture, component development, testing
+- `dev-docs/apis.adoc` — API design
Process & tooling:
- `dev-docs/solr-source-code.adoc`, `git.adoc`, `IDEs.adoc`, `jvms.adoc` —
build and dev environment
- `dev-docs/ref-guide/` — ref-guide authoring (AsciiDoc syntax, Antora
templates)
-- `dev-docs/dependency-upgrades.adoc`, `lucene-upgrade.md`,
`working-between-major-versions.adoc` — upgrades and branch management
-- `dev-docs/releasing.adoc`, `changelog.adoc`, `asf-jenkins.adoc` — release
and CI process
+- `dev-docs/lucene-upgrade.md`, `working-between-major-versions.adoc` —
upgrades and branch management
+- `dev-docs/changelog.adoc` — changelog process
## Changelog
