Zum Hauptinhalt springen
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.

Diese Ressource ist nur auf Englisch verfügbar.

Typ: AGENTS.md

KitLocal schreibt nie Dateien auf deinen Computer. Kopiere das Ergebnis oder lade es selbst herunter.

Variablen ausfüllen

Was du eingibst, bleibt in diesem Browser. Es wird weder zur URL hinzugefügt noch gespeichert oder irgendwohin gesendet.

Vorschau

Noch erforderlich: 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

Über diesen Katalog

Mitgelieferter Snapshot · veröffentlicht 15.11.2026, 06:05 · Katalogversion 5bc079fe355af2214bc0

Es wird der mit der App gelieferte Snapshot angezeigt (keine Inhaltsquelle konfiguriert). An der Quelle könnten neuere Inhalte vorliegen.