跳至主要內容
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.

此資源僅提供英文版本。

類型: AGENTS.md

KitLocal 不會將檔案寫入你的電腦。請複製結果或自行下載。

填寫變數

你輸入的內容只保留在此瀏覽器中,不會加入 URL、儲存或傳送到任何地方。

預覽

仍需填寫: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

關於此目錄

內建快照 · 發布於 2026年11月15日 清晨6:05 · 目錄修訂版 5bc079fe355af2214bc0

正在顯示應用程式內建的快照(尚未設定內容來源)。來源處可能已有更新的內容。