diff --git a/AGENTS.md b/AGENTS.md
index 0601612c..77b09dc9 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -123,6 +123,7 @@ Strong success criteria let you loop independently. Weak criteria ("make it work
 - Android Gradle 프로젝트이며 `settings.gradle` 기준 모듈은 `:app` 단일 구성이다.
 - 모든 명령은 저장소 루트에서 실행한다.
 - 요청 범위를 우선 충족하고, 변경은 작고 안전하게 유지한다.
+- 기존 로직 수정이 아닌 신규 `Activity`, `Fragment`, `ViewModel` 및 그와 연결된 하위 코드는 `kr.co.vividnext.sodalive.v2` 패키지 하위에 작성한다.
 
 ## 작업 절차 핵심 규칙
 - PRD 문서와 구현 계획/TASK 문서 없이 구현하지 않는다.
diff --git a/docs/agent-guides/build-test-style.md b/docs/agent-guides/build-test-style.md
index 03fe97d8..56b575b0 100644
--- a/docs/agent-guides/build-test-style.md
+++ b/docs/agent-guides/build-test-style.md
@@ -96,6 +96,7 @@ adb shell am instrument -w -e class kr.co.vividnext.sodalive.SomeInstrumentedTes
 - DTO: `data class` + `*Request`, `*Response` suffix
 - 레이어 흐름: `Api` -> `Repository` -> `ViewModel` -> `Activity`/`Fragment`
 - DI는 `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`의 Koin 구성을 따른다.
+- 기존 로직 수정이 아닌 신규 `Activity`, `Fragment`, `ViewModel` 파일 및 코드와 그에 연결된 하위 코드(예: Repository, Api, DTO, adapter/helper 등)는 `app/src/main/java/kr/co/vividnext/sodalive/v2` 경로의 `kr.co.vividnext.sodalive.v2` 패키지 하위에 작성한다.
 
 ### 4) 타입/계약/에러 처리
 - nullability와 제네릭 타입을 의미가 바뀌지 않게 유지한다.