Files
sodalive-backend-spring-boot/AGENTS.md
Klaus 6cc15a8748 오디오 콘텐츠 테마 번역을 적용한다
오디오 콘텐츠 목록 응답에서 테마 문자열에 번역을 적용한다.

번역 데이터가 없을 때는 기존 원문을 유지한다.
2025-12-19 03:23:56 +09:00

1.7 KiB

이 문서는 본 저장소에서 **AI Coding Agent가 반드시 따라야 할 개발 헌법(운영 규칙)**이다. 모든 신규 코드는 본 문서를 최우선 기준으로 작성한다.


0. 전제

질문에 대한 답변과 설명은 한국어로 한다.


15. Commit Standards

  1. 커밋 메시지는 반드시 한국어로 작성한다.
  2. 제목(subject)은 현재형으로 작성한다. (예: “기능 추가”, “기능 추가함” 금지)
  3. 제목은 50자 이내로 작성한다.
  4. 제목과 본문 사이에는 반드시 한 줄 공백을 둔다.
  5. 본문은 한 줄당 72자 이내로 작성한다.
  6. 하나의 문단에서는 72자를 초과할 때만 줄바꿈한다.
  7. 공개 API 변경 사항만 설명하며, 패키지 프라이빗 구현 상세는 포함하지 않는다.
  8. 테스트 코드에 대한 언급은 커밋 메시지에 포함하지 않는다.
  9. 제목에 fix:, feat:, docs: 등의 접두어를 사용하지 않는다.
  10. 제목은 첫 글자를 대문자로 시작한다. 단, 함수명 등 소문자가 합당한 경우만 예외를 허용한다.
  11. 도구 광고, 브랜딩, 홍보성 문구를 절대 포함하지 않는다.
  12. 커밋 전에는 반드시 파일을 개별 stage 한다.
  13. 커밋 전 work/scripts/check-commit-message-rules.sh 검증을 통과해야 한다.

16. AI 사용 규칙 (AI Interaction Rules)

  • 매우 작은 단위의 변경만 수행한다.
  • 대규모 리팩터링은 반드시 사전 승인을 요청한다.

본 문서는 AI와 사람이 동일한 개발 규칙을 공유하기 위한 최상위 기준 문서이며, 모든 신규 코드는 본 문서를 기준으로 검토된다.