跳转到主要内容
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日 06:05 · 目录修订版 5bc079fe355af2214bc0

正在显示应用内置的快照(未配置内容来源)。来源处可能已有更新的内容。