본문으로 바로 가기
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

앱에 내장된 스냅샷을 표시하고 있습니다(콘텐츠 소스가 설정되지 않았습니다). 소스에는 더 새로운 콘텐츠가 있을 수 있습니다.