feat(2주차): item 28 ~ 32

AGENTS.md

@@ -0,0 +1,65 @@
+- 인코딩은 항상 UTF-8
+- 주석/답변은 한국어
+
+## Context
+
+@.claude/core/FLAGS.md
+
+## 파일 작성 규칙
+
+### 한글/이모지 포함 파일 생성 시
+
+- Write/Edit 도구 대신 Bash heredoc 사용:
+
+```bash
+cat << 'EOF' > filename.md
+한글과 이모지가 포함된 내용
+EOF
+```
+
+- 'EOF'를 따옴표로 감싸서 변수 확장 방지
+
+## 문서화 규칙 
+
+- 공통 코드(ErrorResponse DTO, HTTPClient Config, AuthStatus 등)은 이후 참조할 수 있도록 코드 위치, 사용법, 동작, 반환값, 파라미터 등을 README.md에 명시
+- CustomStatus 등 에러 코드는 중복되지 않게 README.md에 추가될 때마다 기록
+
+## 코딩 원칙
+
+### KISS (Keep It Simple, Stupid)
+
+단순하고 명확한 코드를 작성하라. 불필요한 복잡성은 기술 부채다.
+
+준수 사항:
+
+- 함수는 한 가지 일만 하도록 작성 (Single Responsibility)
+- 함수 길이는 가급적 50줄 이하로 유지
+- 중첩 깊이는 3단계를 넘지 않도록
+- 복잡한 로직은 명확한 이름의 작은 함수로 분리
+- 자기 설명적 코드 작성 (변수/함수명으로 의도를 표현)
+- 과도한 디자인 패턴이나 추상화 지양
+
+금지 사항:
+
+- 한 번에 이해하기 어려운 복잡한 원라이너
+- 불필요한 레이어나 간접 참조
+- "clever" 코드보다는 "clear" 코드
+
+### YAGNI (You Aren't Gonna Need It)
+
+현재 필요한 것만 구현하라. 미래를 위한 코드는 현재의 부담이다.
+
+준수 사항:
+
+- 명시적으로 요구된 기능만 구현
+- 실제로 3번 반복될 때 추상화 고려 (Rule of Three)
+- 작게 시작하고 필요할 때 확장
+- 확실한 요구사항이 있을 때만 확장 포인트 추가
+
+금지 사항:
+
+- "나중에 필요할 것 같아서" 추가하는 파라미터/옵션
+- 현재 사용하지 않는 인터페이스나 추상 클래스
+- "미래 대비" 설정이나 플래그
+- 사용되지 않는 제네릭 프레임워크
+

CLAUDE.local.md

@@ -0,0 +1,65 @@
+- 인코딩은 항상 UTF-8
+- 주석/답변은 한국어
+
+## Context
+
+@.claude/core/FLAGS.md
+
+## 파일 작성 규칙
+
+### 한글/이모지 포함 파일 생성 시
+
+- Write/Edit 도구 대신 Bash heredoc 사용:
+
+```bash
+cat << 'EOF' > filename.md
+한글과 이모지가 포함된 내용
+EOF
+```
+
+- 'EOF'를 따옴표로 감싸서 변수 확장 방지
+
+## 문서화 규칙 
+
+- 공통 코드(ErrorResponse DTO, HTTPClient Config, AuthStatus 등)은 이후 참조할 수 있도록 코드 위치, 사용법, 동작, 반환값, 파라미터 등을 README.md에 명시
+- CustomStatus 등 에러 코드는 중복되지 않게 README.md에 추가될 때마다 기록
+
+## 코딩 원칙
+
+### KISS (Keep It Simple, Stupid)
+
+단순하고 명확한 코드를 작성하라. 불필요한 복잡성은 기술 부채다.
+
+준수 사항:
+
+- 함수는 한 가지 일만 하도록 작성 (Single Responsibility)
+- 함수 길이는 가급적 50줄 이하로 유지
+- 중첩 깊이는 3단계를 넘지 않도록
+- 복잡한 로직은 명확한 이름의 작은 함수로 분리
+- 자기 설명적 코드 작성 (변수/함수명으로 의도를 표현)
+- 과도한 디자인 패턴이나 추상화 지양
+
+금지 사항:
+
+- 한 번에 이해하기 어려운 복잡한 원라이너
+- 불필요한 레이어나 간접 참조
+- "clever" 코드보다는 "clear" 코드
+
+### YAGNI (You Aren't Gonna Need It)
+
+현재 필요한 것만 구현하라. 미래를 위한 코드는 현재의 부담이다.
+
+준수 사항:
+
+- 명시적으로 요구된 기능만 구현
+- 실제로 3번 반복될 때 추상화 고려 (Rule of Three)
+- 작게 시작하고 필요할 때 확장
+- 확실한 요구사항이 있을 때만 확장 포인트 추가
+
+금지 사항:
+
+- "나중에 필요할 것 같아서" 추가하는 파라미터/옵션
+- 현재 사용하지 않는 인터페이스나 추상 클래스
+- "미래 대비" 설정이나 플래그
+- 사용되지 않는 제네릭 프레임워크
+

GEMINI.md

@@ -0,0 +1,65 @@
+- 인코딩은 항상 UTF-8
+- 주석/답변은 한국어
+
+## Context
+
+@.claude/core/FLAGS.md
+
+## 파일 작성 규칙
+
+### 한글/이모지 포함 파일 생성 시
+
+- Write/Edit 도구 대신 Bash heredoc 사용:
+
+```bash
+cat << 'EOF' > filename.md
+한글과 이모지가 포함된 내용
+EOF
+```
+
+- 'EOF'를 따옴표로 감싸서 변수 확장 방지
+
+## 문서화 규칙 
+
+- 공통 코드(ErrorResponse DTO, HTTPClient Config, AuthStatus 등)은 이후 참조할 수 있도록 코드 위치, 사용법, 동작, 반환값, 파라미터 등을 README.md에 명시
+- CustomStatus 등 에러 코드는 중복되지 않게 README.md에 추가될 때마다 기록
+
+## 코딩 원칙
+
+### KISS (Keep It Simple, Stupid)
+
+단순하고 명확한 코드를 작성하라. 불필요한 복잡성은 기술 부채다.
+
+준수 사항:
+
+- 함수는 한 가지 일만 하도록 작성 (Single Responsibility)
+- 함수 길이는 가급적 50줄 이하로 유지
+- 중첩 깊이는 3단계를 넘지 않도록
+- 복잡한 로직은 명확한 이름의 작은 함수로 분리
+- 자기 설명적 코드 작성 (변수/함수명으로 의도를 표현)
+- 과도한 디자인 패턴이나 추상화 지양
+
+금지 사항:
+
+- 한 번에 이해하기 어려운 복잡한 원라이너
+- 불필요한 레이어나 간접 참조
+- "clever" 코드보다는 "clear" 코드
+
+### YAGNI (You Aren't Gonna Need It)
+
+현재 필요한 것만 구현하라. 미래를 위한 코드는 현재의 부담이다.
+
+준수 사항:
+
+- 명시적으로 요구된 기능만 구현
+- 실제로 3번 반복될 때 추상화 고려 (Rule of Three)
+- 작게 시작하고 필요할 때 확장
+- 확실한 요구사항이 있을 때만 확장 포인트 추가
+
+금지 사항:
+
+- "나중에 필요할 것 같아서" 추가하는 파라미터/옵션
+- 현재 사용하지 않는 인터페이스나 추상 클래스
+- "미래 대비" 설정이나 플래그
+- 사용되지 않는 제네릭 프레임워크
+