java-build-resolver

A Java build troubleshooting guide for Maven and Gradle projects. Maven and Gradle are tools that compile Java code, run tests, manage libraries, and perform project checks.

In plain words
What is it for?
Use it when a Java or Spring Boot build fails, to inspect compiler errors, dependency conflicts, Maven or Gradle settings, and code-quality checks, then apply and verify a small fix.
Why use it?
It helps identify the cause of compilation, dependency, configuration, annotation-processor, Checkstyle, or SpotBugs failures without making broad unrelated changes.

Agent

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.

agentmods
npx agentmods add agents/raja21068/autoresearch/java-build-resolver
Clone the repo
git clone --depth 1 https://github.com/raja21068/AutoResearch
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,364 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin 88% copy Near-identical to another mod 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 $0.00049 $0.01364
Opus 5 $0.00024 $0.00682
Sonnet 5 $0.00010 $0.00273
Haiku 4.5 $0.00005 $0.00136

Measured 2d ago against content hash 99e05ac7d2a6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 2d 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

This is a copy

88% identical to java-build-resolver — 12 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/agents/java-build-resolver.md · 154 lines

How it starts

The opening of the file, as written. The whole thing — 154 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 · 154 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. 2d ago First seen · 154 lines · 49 tokens per session scan C 99e05ac7d2a6

Subscribe to this mod's changes

java-build-resolver is an agent published in the GitHub repository raja21068/AutoResearch (2 stars, last pushed 3mo ago), licensed MIT. It adds 49 tokens to every session and 1,364 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it C with 1 finding (recursive force delete). It is 88% identical to java-build-resolver, differing in 12 lines, and is treated as a copy.

Related

Other agents, from other repositories

arm-cortex-expert

Senior embedded software engineer specializing in firmware and driver development for ARM Cortex-M microcontrollers (Teensy, STM32, nRF52, SAMD). Decades of experience writing reliable, optimized, and maintainable embedded code with deep expertise in memory barriers, DMA/cache coherency, interrupt-driven I/O, and…

wshobson/agents · 72 tokens

team-reviewer

Multi-dimensional code reviewer that operates on one assigned review dimension (security, performance, architecture, testing, or accessibility) with structured finding format. Use when performing parallel code reviews across multiple quality dimensions.

wshobson/agents · 43 tokens

api-scaffolding-backend-architect

Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and…

wshobson/agents · 77 tokens

application-performance-observability-engineer

Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and incident response workflows. Use PROACTIVELY for monitoring infrastructure, performance optimization, or production reliability.

wshobson/agents · 52 tokens

application-performance-performance-engineer

Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability…

wshobson/agents · 76 tokens

ui-visual-validator

Rigorous visual validation expert specializing in UI testing, design system compliance, and accessibility verification. Masters screenshot analysis, visual regression testing, and component validation. Use PROACTIVELY to verify UI modifications have achieved their intended goals through comprehensive visual analysis.

wshobson/agents · 54 tokens