[docs] CLAUDE.md경량화 및 docs분리 후 라우팅

[seongwon030]

#️⃣연관된 이슈

ex) #이슈번호, #이슈번호

📝작업 내용

• CLAUDE.md는 명령어 + @include 라우팅만 유지하여 경량화
• docs/claude/ 하위에 architecture / api / ui / testing / features / conventions 구성

중점적으로 리뷰받고 싶은 부분(선택)

리뷰어가 특별히 봐주었으면 하는 부분이 있다면 작성해주세요

ex) 메서드 XXX의 이름을 더 잘 짓고 싶은데 혹시 좋은 명칭이 있을까요?

논의하고 싶은 부분(선택)

논의하고 싶은 부분이 있다면 작성해주세요.

🫡 참고사항

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
moadong	Ready	Preview, Comment	Apr 25, 2026 7:49am

[coderabbitai]

Warning

Rate limit exceeded

@seongwon030 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 45 minutes and 19 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 45 minutes and 19 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 46adf5c5-dfa4-45b5-9810-9ed35fe96293

📥 Commits

Reviewing files that changed from the base of the PR and between ac727b0 and 978f2c7.

📒 Files selected for processing (2)

• .gitignore
• frontend/docs/claude/api.md

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)

Validation error: Invalid regex pattern for base branch. Received: "**" at "reviews.auto_review.base_branches[0]"

⚙️ Configuration instructions

• Please see the configuration documentation for more information.
• You can also validate your configuration using the online YAML validator.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Walkthrough

프론트엔드 문서를 CLAUDE.md 파일의 임베드된 가이드에서 새로운 docs/claude/ 디렉토리의 도메인 특화 마크다운 파일들로 재구성했습니다. 아키텍처, API, 컨벤션, 기능, 테스팅, UI 설정에 관한 세부 문서를 분리했습니다.

Changes

Cohort / File(s)	Summary
문서 통합 및 재구성 frontend/CLAUDE.md	임베드된 아키텍처, 환경 변수, 테스팅/스토리북 세부 사항을 제거하고 새로운 docs/claude/ 파일들에 대한 외부 참조로 통합했습니다.
도메인 특화 문서 frontend/docs/claude/architecture.md, frontend/docs/claude/api.md, frontend/docs/claude/conventions.md, frontend/docs/claude/features.md, frontend/docs/claude/testing.md, frontend/docs/claude/ui.md	기술 스택, API 인증, 코딩 컨벤션, 실험 시스템 및 SSE, 테스트 설정, UI 테마 및 스타일링에 대한 새로운 한국어 문서 파일들을 생성했습니다.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

• [release] FE v1.1.21 #1124: CLAUDE.md/.claude에 대한 .gitignore 항목 추가로, 이번 PR의 frontend/CLAUDE.md 파일 변경과 직접 관련됩니다.

Suggested reviewers

• suhyun113
• oesnuj
• Zepelown

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목은 변경사항의 주요 목적을 명확하게 설명합니다. CLAUDE.md 경량화와 docs 분리 및 라우팅이라는 핵심 변경사항을 정확히 반영하고 있습니다.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ 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/#1502-claude-md-domain-split-MOA-825

---

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 `@frontend/docs/claude/api.md`:
- Line 8: The docs state that secureFetch() refreshes tokens on a 403, but the
implementation performs the refresh when response.status === 401; update the API
doc line describing secureFetch() to say "401 on unauthorized triggers token
refresh" (or otherwise match the implementation) so the documentation matches
the secureFetch() behavior checking response.status === 401.

🪄 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3fb57a41-13c2-438b-aeb5-95e2595fe9a2

📥 Commits

Reviewing files that changed from the base of the PR and between df3a8e2 and ac727b0.

📒 Files selected for processing (7)

• frontend/CLAUDE.md
• frontend/docs/claude/api.md
• frontend/docs/claude/architecture.md
• frontend/docs/claude/conventions.md
• frontend/docs/claude/features.md
• frontend/docs/claude/testing.md
• frontend/docs/claude/ui.md

[lepitaaar]

문서 분리 구조는 명확하고 유지보수성도 좋아졌습니다. 블로킹 이슈는 없어 승인합니다.\n\n비차단 제안 1건은 인라인으로 남겼습니다.