docs(home): 메인 홈 추천 문서를 정리한다

docs/agent-guides/code-style.md

@@ -8,6 +8,21 @@
 - API는 `enum ...Api: TargetType`, 저장소는 `final class ...Repository` 형태를 우선 사용한다.
 - 상태 모델은 `struct`/`enum` 중심으로 두고, 화면 상태는 `ObservableObject`에서 관리한다.
 
+## 컴포넌트 위치 규칙
+- 여러 페이지에서 재사용 가능한 컴포넌트는 `SodaLive/Sources/V2/Component/**` 아래에 작성한다.
+- 공용 컴포넌트는 기능/페이지 접두사가 아니라 UI 형태나 역할 기준 폴더에 배치한다.
+  - 카드 형태: `SodaLive/Sources/V2/Component/Card`
+  - 배너/캐러셀 형태: `SodaLive/Sources/V2/Component/Banner`
+  - 텍스트 표시/확장/축약 형태: `SodaLive/Sources/V2/Component/Text`
+  - 버튼 형태: `SodaLive/Sources/V2/Component/Button`
+  - 크리에이터 프로필/그리드 형태: `SodaLive/Sources/V2/Component/Creator`
+- 공용 컴포넌트 타입명은 `HomeRecommendation...`, `MainHome...`처럼 특정 페이지나 API 이름을 접두사로 붙이지 않는다. 예: `CommunityPostCard`, `BannerCarousel`, `ExpandableTextView`.
+- 공용 컴포넌트는 특정 API 응답 모델에 직접 의존하지 않는 것을 우선한다. 필요한 값은 표시용 프로퍼티 또는 작은 display model로 받는다.
+- 특정 페이지 내부에서만 사용하는 컴포넌트는 해당 페이지 폴더 하위 `Components`에 둔다. 예: `SodaLive/Sources/V2/Main/Home/Components/MainHomeLiveSection.swift`.
+- 페이지 전용 컴포넌트는 페이지 문맥을 드러내기 위해 `MainHome...`처럼 페이지 접두사를 사용할 수 있다.
+- 처음에는 페이지 전용으로 만들었더라도 다른 페이지에서 재사용 요구가 생기면 `SodaLive/Sources/V2/Component/**`의 적절한 형태별 폴더로 이동한다.
+- 공용으로 만들지 페이지 전용으로 둘지 애매하면, 현재 요청 범위 기준으로만 판단한다. 재사용 근거가 없으면 페이지 전용으로 시작한다.
+
 ## 임포트 규칙
 - 시스템 프레임워크(`Foundation`, `SwiftUI`, `Combine`)를 먼저 배치한다.
 - 서드파티(`Moya`, `CombineMoya`, SDK들)는 이후 배치한다.