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.