CLAUDE.md 문서 언어 변경

[HA-SEUNG-JEONG]

🌱 연관된 이슈

☘️ 작업 내용

• CLAUDE.md를 읽는 데 드는 토큰 소비량을 줄이기 위해 해당 문서 전면 영어로 재작성

🍀 참고사항

스크린샷 (선택)

Summary by CodeRabbit

• 문서

  • 프로젝트 핵심 규칙·구현 원칙을 영어로 번역·재구성하고 가이드 범위와 명세를 확대했습니다.
  • 오류 처리, 런타임 안전성(React 키/이벤트, enum-like 처리 등) 및 운영/보안 규칙이 상세화되었습니다.
  • 커밋·브랜치·문서화 워크플로우와 명령어/예외 규칙이 구체화되었습니다.

• Chore

  • 포맷팅 대상 확장 패턴에서 일부 파일 확장자 제외로 린트-스테이지 설정을 조정했습니다.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
study-platform-client-dev	Error		Apr 3, 2026 3:38pm

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a8e12ef3-f261-4b7d-8adc-71fca0801904

📥 Commits

Reviewing files that changed from the base of the PR and between d77e549 and fdce6ac.

📒 Files selected for processing (2)

• CLAUDE.md
• package.json

✅ Files skipped from review due to trivial changes (2)

• package.json
• CLAUDE.md

---

📝 Walkthrough

Walkthrough

CLAUDE.md를 한국어에서 영어로 완전 번역하고 섹션 제목을 재구성했습니다. 문서에 백엔드 데이터 안전 패턴, 중앙화된 에러 처리 및 Sentry 가이드라인, React 안전 패턴(키/핸들러), 런타임-safe enum 처리 등 운영 규칙과 개발 관행을 추가했고, package.json의 lint-staged glob에서 md 확장자를 제거했습니다. 코드 엔티티 변경은 없습니다.

Changes

Cohort / File(s)	Summary
Documentation (CLAUDE guide) CLAUDE.md	한국어 → 영어 번역 및 섹션 재구성. 행동/정확성 기준 강화(탐색 한계, API 엔드포인트 금지, 단일 패스 수정 원칙 등), 완료 체크리스트/타입체크 예외, lint/prettier 실행 범위 제한, 프로젝트 아키텍처·라우팅·명령어 사용 가이드 재작성, React 안전 패턴(옵션 백엔드 ID 키 사용, 이벤트 핸들러 가드), enum-like 문자열의 런타임 안전 처리, 중앙화된 에러/Sentry 명세(핵심 파일·에러 분류 순서·mutation 전역 토스트/리포트 동작·프로덕션 보안 게이트 등), 문서/커밋/브랜칭 규약 및 /doc 활용 규칙 추가.
Tooling config package.json	lint-staged의 glob 패턴에서 md 확장자 제거 (즉, biome format --write 대상에서 .md 제외).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• 과제 제출 기간 관련 로직 수정 ,코드 복구 및 짜잘한 수정 작업 #470 — CLAUDE.md에 대한 중복/연관 변경이 있어 문서 충돌 또는 조정 가능성 있음.
• 클로드 가이드 추가 및 스터디 개설 날짜 수정 #373 — 동일한 CLAUDE 문서를 수정한 PR로 내용 흐름 및 규칙 차이 확인 필요.

Poem

🐰 영어로 번역해 깃발을 꽂았네,
규칙과 안전이 고운 당근빛으로 반짝여,
에러는 중앙에, 키는 조심히,
문서는 깔끔히, 개발자는 폴짝폴짝 기뻐하네 🎋

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목이 한국어로 작성되었으며, 주요 변경 사항(CLAUDE.md 문서의 한국어에서 영어로의 전환)을 명확하게 요약하고 있습니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CLAUDE.md`:
- Around line 201-206: Add a language identifier to the fenced code block that
begins with "AxiosError → isAxiosError() ✅ → extract HTTP status/error code"
(the triple-backtick block shown in CLAUDE.md) to satisfy markdownlint MD040;
for example change the opening fence to ```text or ```bash so the block is
explicitly language-specified and the CI/lint warning is resolved.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d78836a7-4db0-4026-b584-24595bd9a18c

📥 Commits

Reviewing files that changed from the base of the PR and between 5a237c0 and d77e549.

📒 Files selected for processing (1)

• CLAUDE.md