backend-spring-data

Detect transactional and repository bugs in Spring Data JPA code.

3|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/infraspecdev/tesseract --skill backend-spring-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-spring-data
Source: https://github.com/infraspecdev/tesseract/tree/main/shield/skills/backend/spring-data
Command: npx skills add https://github.com/infraspecdev/tesseract --skill backend-spring-data

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps reviewers catch subtle Spring Data JPA issues that compile cleanly but fail at runtime, including broken transaction boundaries, ineffective repository queries, and entity design mistakes.

Core Features & Use Cases

  • Reviews transactional behavior for private methods, self-invocation, propagation choices, and read-only optimization.
  • Audits repository methods and JPQL or native queries for missing modifying annotations and missing transaction boundaries.
  • Checks entity design for equals and hashCode pitfalls, fetch strategy choices, cascade usage, and repository annotation patterns.
  • Use it when reviewing a Spring Boot service that uses JPA repositories and you need a focused correctness pass before merging.

Quick Start

Ask the skill to review your Spring Boot 3.x Spring Data JPA code for transactional correctness, query mutations, entity equality, and fetch strategy problems.

Frequently Asked Questions about backend-spring-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect Spring Data JPA transactional bugs from self-invocation or private methods?

To detect Spring Data JPA transactional bugs, review private transactional methods and self-invocation cases where proxies are bypassed. Checking these invocation patterns prevents silent transaction boundary failures that compile cleanly but break at runtime.

How do I review JPQL or native update queries for missing modifying annotations in Spring Boot?

Reviewing JPQL or native update queries requires checking for missing @Modifying annotations and absent transaction boundaries. Auditing repository methods ensures modifying queries execute correctly within Spring Data JPA without throwing silent transaction errors.

What are common Spring Data JPA entity design pitfalls with equals, hashCode, and cascade rules?

Common Spring Data JPA entity design pitfalls include incorrect equals and hashCode implementations, improper fetch strategy choices, and misconfigured cascade rules. Reviewing entity mappings and repository annotation patterns prevents persistent context corruption and unexpected loading behavior.

Does this Spring Data JPA review process support Spring Boot 3.x services?

Yes, this Spring Data JPA review process applies to Spring Boot 3.x services using JPA repositories and transactional service methods. It checks transactional correctness, query mutations, entity equality, and fetch strategy problems specific to the Spring Boot 3.x framework.

When should I check readOnly transaction settings and propagation choices in Spring Data JPA?

Check readOnly transaction settings and propagation choices during a focused correctness pass before merging. Reviewing transactional behavior for read-only optimization and propagation choices ensures Spring Data JPA repository methods perform efficiently without unnecessary write locks.

How do I validate entity graphs and fetch strategies for Spring Data JPA repositories?

Validate entity graphs and fetch strategies by reviewing repository annotation patterns and mapping configurations. Checking entity graphs in Spring Data JPA ensures queries load required associations efficiently, avoiding N+1 select issues and suboptimal data fetching.