Skip to content

drafael/coding-harness / skills/java-coder

java-coder

Unverified

Mandatory for every task in a Java codebase, including planning, implementation, debugging, refactoring, review, testing, Maven or Gradle build and dependency changes, performance or security analysis, and Java-related documentation. Detect Java projects from pom.xml, Gradle files, gradlew, or .java sources. Load before inspecting or changing the repository even when the user does not explicitly mention Java. Covers Java 21+, Spring Boot, Swing/EDT, code style, testing, security, and desktop UI.

FileKindSize
README.mdmarkdown868 B
SKILL.mdskill md13.2 KB
references/apache-commons-lang3.mdmarkdown6.2 KB
references/desktop-apps.mdmarkdown20.0 KB
references/functional-composition.mdmarkdown4.3 KB
references/lombok.mdmarkdown2.7 KB
references/spring-boot-rules.mdmarkdown1.4 KB

references/spring-boot-rules.md

View on GitHub
# Spring Boot Rules

**Dependency Injection**
- Always use constructor injection — never field injection (`@Autowired` on fields)

**Architecture**
- Enforce the layered boundary: `Controller → Service → Repository`
- Never let repositories leak into controllers, or business logic leak into controllers

**API Design**
- Follow RESTful conventions for endpoint naming, HTTP methods, and status codes
- Use DTOs for all request/response payloads — keep them separate from JPA entities
- Default to Java records for DTOs; only use classes when mutability is required
- When Jackson is already used, prefer annotated DTOs for incoming JSON events with stable schemas, following established binding conventions rather than hand-written field-by-field tree traversal.
- Preserve independent handling of malformed entries when the event contract requires it. Keep `JsonNode` or tree parsing for genuinely dynamic content or boundaries deliberately bound separately.

**Error Handling & Validation**
- Centralize exception handling with `@ControllerAdvice`
- Declare constraints with Bean Validation annotations (`@NotNull`, `@Size`, etc.)
- Return `Optional<T>` from methods that may produce no result; avoid returning `null`

**Code Style**
- Prefer streams and functional pipelines over imperative loops, when it reads clearly
- For Lombok usage (`@RequiredArgsConstructor` on Spring components, `@Slf4j`, `@Builder`, `@NonNull`, etc.), see the **Lombok** section in `SKILL.md`
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 192kUpdated Claude CodeCodexVerifiedInstall