Java 코드 설계

호출하기 쉽고 잘못 사용하기 어려우며, 유효한 상태를 명확하게 표현하는 코드를 설계한다. 단순 문법·API 조회, 일반적인 Spring 설정이나 의존성 설치에는 설계 경계에 관한 판단이 필요한 경우에만 사용한다.

작업 범위와 완료 조건

• 검토만 요청받으면 파일을 변경하거나 포맷터를 실행하지 않는다. 발견 사항, 근거, 권고안과 검증 한계를 보고한다.
• 작성·수정 요청에서는 요청 범위의 변경을 완료하고, 변경한 파일을 프로젝트 방식으로 포맷한 뒤 관련 동작을 집중 검증한다. 계약이나 동작이 달라졌을 때만 관련 Javadoc과 테스트를 갱신한다.
• 대상 코드와 주변 사용례를 먼저 확인한다. 동작 판단에는 관련 테스트를, 버전 의존 API에는 빌드 설정의 Java 버전을 확인한다. 이미 확인한 설정은 관련 변경이나 불확실성이 없으면 다시 읽지 않는다.

참조 문서 선택

가장 가까운 역할의 문서부터 읽고, 공개 계약이나 의존성 경계가 다른 역할에 걸칠 때만 인접 문서를 추가한다.