Aller au contenu principal
kitlocal.dev

AGENTS.md for a Spring Boot service

A starting AGENTS.md for a Spring Boot service: build and test commands, layering and transaction rules, and the safety rules agents should follow.

Cette ressource n’est disponible qu’en anglais.

Type: AGENTS.md

KitLocal n’écrit jamais de fichiers sur votre ordinateur. Copiez le résultat ou téléchargez-le vous-même.

Renseigner les variables

Ce que vous saisissez reste dans ce navigateur. Cela n’est ni ajouté à l’URL, ni enregistré, ni envoyé.

Aperçu

Encore requis : Service name, Base package

# {{serviceName}}: agent guide

Spring Boot service on Java 21, built with Maven. Base package: `{{basePackage}}`.

## Commands
- Build and verify: `./mvnw -q verify`
- Tests: `./mvnw -q test`
Run the tests for the code you changed before declaring a task complete.

## Layering
- Controllers handle HTTP only: validate input (Bean Validation), call a service, map to a DTO.
- Business logic lives in services; transactions are declared on service methods, not controllers.
- Never return JPA entities from controllers; use DTOs.
- Repositories contain queries only. Watch for N+1 queries and unbounded result sets.

## Safety
- Do not log secrets, tokens or personal data.
- Schema changes go through migrations; never edit applied migrations.
- Do not add dependencies, change the Java version or alter security configuration without asking.
- Do not commit, push or deploy.

## Project-specific rules

À propos de ce catalogue

Instantané intégré · publié 15 nov. 2026, 06:05 · Révision du catalogue 5bc079fe355af2214bc0

Affichage de l’instantané intégré à l’application (aucune source de contenu n’est configurée). Du contenu plus récent peut exister à la source.