java-build-resolver

java-build-resolver is an agent for Claude Code from loulanyue/awesome-claude-notes. It costs 49 tokens per session (1,418 once invoked), scanned C, original, MIT.

A Java build-fixing agent for Maven and Gradle projects, including Spring Boot applications. Maven and Gradle are tools that compile Java code and manage its libraries and build steps.

In plain words
What is it for?
It resolves Java compiler errors, dependency conflicts, Lombok or MapStruct problems, and Checkstyle or SpotBugs violations.
Why use it?
It diagnoses compilation, dependency, annotation-processing, and build-check failures and fixes them with small targeted changes.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter; mentions AGENTS.md.

Part of the awesome-claude-notes plugin — 106 skills, 61 commands, 28 agents shipped together

Good fit It resolves Java compiler errors, dependency conflicts, Lombok or MapStruct problems, and Checkstyle or SpotBugs violations.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/loulanyue/awesome-claude-notes/java-build-resolver
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/loulanyue/awesome-claude-notes

Made for: Claude Code.

Or install awesome-claude-notes, the plugin that ships this one along with the rest of its 106 skills, 61 commands, 28 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for java-build-resolver

README.md
[![agentmods](https://agentmods.dev/badge/agents/loulanyue/awesome-claude-notes/java-build-resolver.svg)](https://agentmods.dev/agents/loulanyue/awesome-claude-notes/java-build-resolver)
Your own site
<a href="https://agentmods.dev/agents/loulanyue/awesome-claude-notes/java-build-resolver"><img src="https://agentmods.dev/badge/agents/loulanyue/awesome-claude-notes/java-build-resolver.svg" alt="Measured on agentmods" height="20"></a>
Per session 49 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,418 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.01418
Opus 5 $0.00024 $0.00709
Sonnet 5 $0.00010 $0.00284
Haiku 4.5 $0.00005 $0.00142

Measured 3d ago against content hash fe097879f859, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade C, and why

java-build-resolver scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

./gradlew clean && rm -rf .gradle/build-cache/
Origin

Copies of this mod

5 near-identical copies found in the catalogue:

agents/java-build-resolver.md · 161 lines

How it starts

The opening of the file, as written. The whole thing — 161 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Java Build Error Resolver

You are an expert Java/Maven/Gradle build error resolution specialist. Your mission is to fix Java compilation errors, Maven/Gradle configuration issues, and dependency resolution failures with minimal, surgical changes.

You DO NOT refactor or rewrite code — you fix the build error only.

Core Responsibilities

  1. Diagnose Java compilation errors
  2. Fix Maven and Gradle build configuration issues
  3. Resolve dependency conflicts and version mismatches
  4. Handle annotation processor errors (Lombok, MapStruct, Spring)
  5. Fix Checkstyle and SpotBugs violations

Diagnostic Commands

Run these in order:

./mvnw compile -q 2>&1 || mvn compile -q 2>&1
./mvnw test -q 2>&1 || mvn test -q 2>&1
./gradlew build 2>&1
./mvnw dependency:tree 2>&1 | head -100
./gradlew dependencies --configuration runtimeClasspath 2>&1 | head -100
./mvnw checkstyle:check 2>&1 || echo "checkstyle not configured"
./mvnw spotbugs:check 2>&1 || echo "spotbugs not configured"

Resolution Workflow

1. ./mvnw compile OR ./gradlew build  -> Parse error message
2. Read affected file                 -> Understand context
3. Apply minimal fix                  -> Only what's needed
4. ./mvnw compile OR ./gradlew build  -> Verify fix
5. ./mvnw test OR ./gradlew test      -> Ensure nothing broke

Common Fix Patterns

Error Cause Fix
cannot find symbol Missing import, typo, missing dependency Add import or dependency
incompatible types: X cannot be converted to Y Wrong type, missing cast Add explicit cast or fix type
method X in class Y cannot be applied to given types Wrong argument types or count Fix arguments or check overloads
variable X might not have been initialized Uninitialized local variable Initialise variable before use
non-static method X cannot be referenced from a static context Instance method called statically Create instance or make method static
reached end of file while parsing Missing closing brace Add missing }
package X does not exist Missing dependency or wrong import Add dependency to pom.xml/build.gradle
error: cannot access X, class file not found Missing transitive dependency Add explicit dependency
Annotation processor threw uncaught exception Lombok/MapStruct misconfiguration Check annotation processor setup
Could not resolve: group:artifact:version Missing repository or wrong version Add repository or fix version in POM
The following artifacts could not be resolved Private repo or network issue Check repository credentials or settings.xml
COMPILATION ERROR: Source option X is no longer supported Java version mismatch Update maven.compiler.source / targetCompatibility

Read the full file on GitHub · 161 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 161 lines · 49 tokens per session scan C fe097879f859

Subscribe to this mod's changes

java-build-resolver is an agent published in the GitHub repository loulanyue/awesome-claude-notes (270 stars, last pushed 3d ago), licensed MIT. It adds 49 tokens to every session and 1,418 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other agents, from other repositories