From 698c395f3dc027509c45e1af4953c175104fb8e6 Mon Sep 17 00:00:00 2001
From: klaus <klaus@vividnext.co.kr>
Date: Thu, 14 May 2026 20:29:52 +0900
Subject: [PATCH] =?UTF-8?q?docs(agent):=20=EC=8B=A0=EA=B7=9C=20v2=20?=
 =?UTF-8?q?=ED=8C=A8=ED=82=A4=EC=A7=80=20=EC=9E=91=EC=84=B1=20=EA=B7=9C?=
 =?UTF-8?q?=EC=B9=99=EC=9D=84=20=EB=AC=B8=EC=84=9C=ED=99=94=ED=95=9C?=
 =?UTF-8?q?=EB=8B=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md                             | 1 +
 docs/agent-guides/build-test-style.md | 1 +
 2 files changed, 2 insertions(+)

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와 제네릭 타입을 의미가 바뀌지 않게 유지한다.