sodalive-ios/docs/20260914_크리에이터_DM_리스너_선택/plan-task.md

크리에이터 DM 리스너 선택 Goal 실행형 구현 계획

문서 항목	내용
상태	구현 검증 중
작성일	2026-09-14
요구사항 기준	docs/20260914_크리에이터_DM_리스너_선택/prd.md
API 기준	docs/20260914_크리에이터_DM_리스너_선택/prd.md §11
현재 Phase	Phase 3 검증
현재 활성 Goal	P3-GATE

목표

크리에이터가 메인 대화 탭에서 팔로우 리스트 또는 닉네임 검색으로 리스너를 선택하고 기존 유저-크리에이터 DM 방 생성 API로 DM 방을 시작한다.

현재 상태

Phase	상태	완료 Task	활성/다음 Goal	차단 또는 남은 조건
1	완료	2/2	없음	없음
2	완료	5/5	없음	수동 네트워크 QA 필요
3	진행 중	0/1	P3-GATE	수동 QA 미수행

범위

포함

• 메인 대화 탭 우측 하단 크리에이터 전용 + 플로팅 버튼.
• 신규 리스너 선택 화면과 라우팅.
• 기존 팔로우 전체 리스트 API 재사용.
• GET /member/search?nickname= 2글자 이상, 500ms debounce 검색.
• 검색 empty 문구 다국어 처리.
• SodaV2ActionModal 기반 확인 팝업.
• 기존 DM 방 생성 API의 request model 확장과 recipientId 기반 호출.
• 성공 시 AppStep.userCreatorChatRoom(roomId:) 진입.

제외

• 채팅방 메시지 UI와 WebSocket 전송 로직 변경.
• 새 공통 모달 컴포넌트 작성.
• 신규 dependency 추가.
• 팔로우 전체 리스트 API 서버 계약 변경.

기술적 제약

• 기술 스택: SwiftUI, Combine, Moya, 기존 AppState/AppStep 라우팅.
• UI 배치: Figma 2372:23496, 팝업 2372:23521 기준.
• 공통 컴포넌트: SodaV2ActionModal, 기존 색상·폰트·spacing token 재사용.
• API 재사용: FollowCreatorRepository, UserRepository.searchUser, UserCreatorChatRepository 기준.
• request model: UserCreatorCreateRoomRequest는 recipientId와 creatorId를 optional로 표현할 수 있어야 한다.
• 검증: 테스트 번들 타깃이 확인되지 않으므로 focused 자동 테스트 대신 빌드와 수동 QA 기준을 명시한다.

Task TDD 작성 규칙

현재 저장소는 docs/agent-guides/build-test-verification.md 기준 테스트 번들 타깃이 확인되지 않는다. 구현 Task는 가능한 경우 작은 ViewModel 단위 테스트를 우선 검토하되, 테스트 타깃이 없으면 TDD 예외 사유와 대체 검증 방법을 Task에 기록한다.

Phase 1 — 라우팅과 진입점

Phase 결과: 크리에이터가 메인 대화 탭에서 신규 리스너 선택 화면에 진입할 수 있다.

선행조건: PRD 확정.

Phase 완료 조건: P1-T1, P1-T2 완료와 빌드 통과.

구현 항목

Task 1.1 메인 대화 탭 플로팅 버튼

Goal 실행 P1-T1: 크리에이터 계정의 메인 대화 탭 우측 하단에 신규 DM 시작 + 버튼을 표시한다.

• 시작 조건: CDM-ENTRY-001, CDM-ENTRY-002 확정.
• 완료 증거: 크리에이터 role에서만 버튼 표시, 비크리에이터에서는 미표시.
• 범위 밖: 새 화면 내부 리스트와 API 호출.
• TDD 예외 사유: UI 조건 렌더링 작업이며 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: UserDefaults.role이 MemberRole.CREATOR.rawValue일 때와 아닐 때의 수동 QA, Debug 빌드.

Files:

• Modify: SodaLive/Sources/V2/Main/MainView.swift
• Reuse: SodaLive/Sources/V2/CreatorChannel/Components/CreatorChannelFloatingIconButton.swift 또는 기존 홈 플로팅 버튼 컴포넌트

Interfaces:

• Consumes: MemberRole.CREATOR.rawValue, MainTab.chat

• Produces: MainView 채팅 탭 overlay에서 신규 DM 시작 액션

• 버튼 재사용 후보를 확인하고 새 공통 abstraction 없이 가장 가까운 기존 플로팅 버튼을 사용한다.

• 기존 MainChatView 수정 없이 MainView overlay에서 버튼을 표시한다.

• MainView에서 현재 탭이 .chat이고 role이 creator일 때만 버튼을 표시한다.

• 버튼 bottom padding은 main tab bar와 mini player가 가리지 않도록 기존 creatorActionMenuBottomPadding 계산 방식을 따른다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Task 1.2 AppStep 라우팅 추가

Goal 실행 P1-T2: 신규 리스너 선택 화면으로 이동할 수 있는 AppStep 라우팅을 추가한다.

• 시작 조건: P1-T1 완료.
• 완료 증거: + 버튼 탭 시 신규 화면이 push되고 뒤로가기로 복귀 가능.
• 범위 밖: 화면 내부 API 연동.
• TDD 예외 사유: 라우팅 연결 작업이며 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: 수동 내비게이션 QA와 Debug 빌드.

Files:

• Modify: SodaLive/Sources/App/AppStep.swift
• Modify: SodaLive/Sources/ContentView.swift
• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift

Interfaces:

• Produces: AppStep.userCreatorChatRecipientSearch

• Consumes: AppState.shared.setAppStep(step:)

• AppStep에 신규 case를 추가한다.

• AppStepLayerView에서 신규 case를 새 화면으로 매핑한다.

• MainView의 채팅 탭 + 버튼 액션에서 신규 AppStep을 호출한다.

• 새 화면은 최소 shell만 만들고 내부 API는 Phase 2에서 연결한다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Phase 2 — 리스트, 검색, 확인, 방 생성

Phase 결과: 크리에이터가 리스너를 선택하고 DM 방 생성 후 채팅방에 진입한다.

선행조건: Phase 1 완료.

Phase 완료 조건: P2-T1~P2-T5 완료와 Phase 2 Gate 통과.

구현 항목

Task 2.1 화면 UI shell과 다국어 키

Goal 실행 P2-T1: Figma 기준 신규 화면 shell과 필요한 다국어 키를 추가한다.

• 시작 조건: P1-T2 완료, Figma 2372:23496, 2372:23521 확인.
• 완료 증거: 검색 바, 섹션 타이틀, 리스트 검색 안내 문구, empty 영역, 팝업 문구 키가 존재한다.
• 범위 밖: 실제 API 호출과 방 생성.
• TDD 예외 사유: UI shell과 resource 추가 작업이며 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: SwiftGen 또는 프로젝트 string 생성 절차가 있으면 실행, 없으면 빌드로 I18n 참조 성공 확인.

Files:

• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift
• Modify: localization resource files used by I18n

Interfaces:

• Produces: I18n.UserCreatorChatRecipientSearch.searchPlaceholder

• Produces: I18n.UserCreatorChatRecipientSearch.sectionTitle

• Produces: I18n.UserCreatorChatRecipientSearch.emptyMessage

• Produces: I18n.UserCreatorChatRecipientSearch.dialogTitle

• Produces: I18n.UserCreatorChatRecipientSearch.dialogMessage(_ nickname: String)

• Produces: I18n.UserCreatorChatRecipientSearch.sendButton

• 검색 안내 문구 팬 이름을 입력하세요를 다국어 키로 추가한다.

• 섹션 타이틀 팔로워를 다국어 키로 추가한다.

• empty 문구 사용자가 없어요.\n다른 이름으로 다시 검색해 주세요.를 다국어 키로 추가한다.

• 팝업 제목과 본문, 보내기 문구를 다국어 키로 추가한다.

• 화면 shell이 Figma 기준 검은 배경, 뒤로가기, 검색 바, 리스트 영역을 표시하도록 작성한다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Task 2.2 초기 팔로우 전체 리스트 연동

Goal 실행 P2-T2: 화면 진입 시 기존 팔로우 전체 리스트 API로 초기 목록을 표시한다.

• 시작 조건: P2-T1 완료.
• 완료 증거: 화면 최초 진입 시 /live/recommend/following/channel/all/list가 기존 pagination 정책으로 호출된다.
• 범위 밖: 검색 API와 방 생성 API.
• TDD 예외 사유: network ViewModel 작업이나 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: Charles/Xcode network log 또는 Moya stub 가능 시 요청 path·query 확인, Debug 빌드.

Files:

• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift
• Reuse: SodaLive/Sources/Follow/FollowCreatorRepository.swift
• Reuse: SodaLive/Sources/Follow/GetCreatorFollowingAllListResponse.swift

Interfaces:

• Consumes: FollowCreatorRepository.getFollowedCreatorAllList(page:size:)

• Produces: UserCreatorChatRecipientItem(id:nickname:profileImageUrl:)

• ViewModel에 isLoading, errorMessage, isShowPopup, items, page, isLast 상태를 추가한다.

• 최초 진입 시 getFollowedCreatorAllList(page: 1, size: 10)을 호출한다.

• API response의 creatorId, nickname, profileImageUrl을 화면 공통 item으로 매핑한다.

• 리스트 마지막 아이템 노출 시 다음 page를 호출한다.

• 오류는 기존 toast 방식으로 표시한다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Task 2.3 유저 검색과 debounce

Goal 실행 P2-T3: 2글자 이상 검색어에 대해 500ms debounce 후 유저 검색 API를 호출하고 empty 상태를 표시한다.

• 시작 조건: P2-T2 완료.
• 완료 증거: 0~1글자는 검색 요청 0회, 2글자 이상은 마지막 입력 500ms 후 요청 1회.
• 범위 밖: 유저 선택 후 방 생성.
• TDD 예외 사유: 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: 수동 입력 QA와 network 요청 횟수 확인.

Files:

• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift
• Reuse: SodaLive/Sources/User/UserRepository.swift
• Reuse: SodaLive/Sources/User/UserApi.swift

Interfaces:

• Consumes: UserRepository.searchUser(nickname:)

• Produces: search mode item list and empty state flag

• 검색어 상태를 ViewModel로 전달한다.

• trim 결과가 2글자 미만이면 pending debounce를 취소하고 초기 팔로우 리스트 모드로 돌아간다.

• trim 결과가 2글자 이상이면 500ms debounce 후 UserRepository.searchUser(nickname:)를 호출한다.

• 검색어가 바뀌면 이전 debounce 작업과 이전 검색 결과 적용을 취소하거나 무시한다.

• 검색 결과 0건이면 중앙 empty 문구를 표시한다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Task 2.4 유저 선택 확인 팝업

Goal 실행 P2-T4: 리스트 유저 터치 시 V2 공통 팝업으로 DM 보내기 확인을 받는다.

• 시작 조건: P2-T2 또는 P2-T3 완료.
• 완료 증거: 유저 터치 시 API 호출 없이 팝업이 뜨고, 취소 또는 dimmed tap으로 닫힌다.
• 범위 밖: 보내기 이후 방 생성 API 구현.
• TDD 예외 사유: UI interaction 작업이며 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: 수동 QA와 Debug 빌드.

Files:

• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift
• Reuse: SodaLive/Sources/V2/Component/Modal/SodaV2ActionModal.swift

Interfaces:

• Consumes: UserCreatorChatRecipientItem

• Produces: selected recipient state

• 리스트 아이템 tap handler에서 selected recipient를 저장한다.

• SodaV2ActionModal title은 메시지 보내기 키를 사용한다.

• message는 선택 유저 닉네임을 넣어 {{사용자이름}}에게 메시지를 보낼까요? 형식으로 표시한다.

• 취소와 dimmed tap은 selected recipient를 초기화한다.

• 보내기 버튼은 P2-T5의 방 생성 액션을 호출할 수 있도록 연결 지점만 만든다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Task 2.5 recipientId 기반 DM 방 생성

Goal 실행 P2-T5: 확인 팝업의 보내기에서 선택한 리스너 ID로 기존 DM 방 생성 API를 호출하고 채팅방에 진입한다.

• 시작 조건: P2-T4 완료.
• 완료 증거: request body가 recipientId를 포함하고, 성공 response의 roomId로 userCreatorChatRoom에 진입한다.
• 범위 밖: 채팅방 내부 메시지 전송 UI 변경.
• TDD 예외 사유: API integration 작업이나 현재 테스트 타깃이 확인되지 않는다.
• 대체 검증 방법: network request body 확인, 성공 시 화면 이동 수동 QA, 기존 크리에이터 채널 DM 시작 회귀 확인.

Files:

• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/Models/UserCreatorChatModels.swift
• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/Repository/UserCreatorChatRepository.swift
• Modify: SodaLive/Sources/V2/Main/Chat/UserCreatorChat/UserCreatorChatRoomView.swift
• Verify: SodaLive/Sources/V2/CreatorChannel/CreatorChannelView.swift

Interfaces:

• Produces: UserCreatorCreateRoomRequest(recipientId: Int? = nil, creatorId: Int? = nil)

• Produces: UserCreatorChatRepository.createRoom(recipientId: Int)

• Preserves: UserCreatorChatRepository.createRoom(creatorId: Int) existing caller behavior

• UserCreatorCreateRoomRequest를 recipientId와 creatorId optional request로 변경한다.

• 기존 createRoom(creatorId:)는 creatorId만 보내도록 유지한다.

• 신규 createRoom(recipientId:)를 추가하고 recipientId만 보낸다.

• 보내기 탭 중 중복 제출을 막기 위해 loading 상태 동안 버튼 액션을 무시한다.

• 성공 response의 roomId로 AppState.shared.setAppStep(step: .userCreatorChatRoom(roomId: roomId))를 호출한다.

• 실패 시 서버 message 또는 I18n.Common.commonError를 toast로 표시한다.

• 기존 크리에이터 채널의 AppStep.userCreatorChatCreator(creatorId:) 흐름이 creatorId request를 유지하는지 확인한다.

• xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 실행해 성공을 확인한다.

Phase 3 — 검증 Gate

Phase 결과: 신규 DM 시작 흐름과 기존 DM 시작 흐름이 모두 동작한다.

선행조건: Phase 2 전체 완료.

검증 방법

Phase 3 Gate

Goal 실행 P3-GATE: 요구사항 전체와 회귀 위험을 최종 판정한다.

• 시작 조건: P2-T1~P2-T5 완료.
• 완료 증거: 아래 명령과 수동 QA 결과를 Progress에 기록.
• 범위 밖: 실패와 무관한 UI 리팩터링.

xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build

Expected: exit code 0.

수동 검증:

• 크리에이터 계정: 메인 대화 탭 우측 하단 + 버튼 표시.
• 비크리에이터 계정: 메인 대화 탭 우측 하단 + 버튼 미표시.
• 신규 화면 최초 진입: /live/recommend/following/channel/all/list?page=0&size=10&timezone=... 호출.
• 검색 1글자: /member/search 요청 0회.
• 검색 2글자 이상 연속 입력: 마지막 입력 500ms 후 /member/search?nickname= 요청 1회.
• 검색 결과 없음: 중앙 empty 문구 표시.
• 유저 선택: SodaV2ActionModal 표시, 취소와 dimmed tap 닫힘.
• 보내기: /api/v2/user-creator-chat/rooms/create request body에 recipientId만 포함.
• 방 생성 성공: UserCreatorChatRoomView로 이동.
• 기존 크리에이터 채널 DM 시작: request body에 creatorId만 포함하고 기존처럼 동작.

실행 순서와 의존성

순서	Goal	선행조건	병행 가능	차단 시 다음 행동
1	P1-T1	PRD 확정	아니요	role/진입 정책 재확인
2	P1-T2	P1-T1	아니요	AppStep 라우팅 방식 확인
3	P2-T1	P1-T2	아니요	다국어 생성 절차 확인
4	P2-T2	P2-T1	아니요	기존 팔로우 API 계약 확인
5	P2-T3	P2-T2	아니요	검색 response model 확인
6	P2-T4	P2-T2 또는 P2-T3	아니요	팝업 문구 재확인
7	P2-T5	P2-T4	아니요	서버 request contract 확인
8	P3-GATE	Phase 2 전체	아니요	실패 소유 Task에 회귀 수정 Task 추가

P1-T1 → P1-T2 → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-T5 → P3-GATE

변경 금지 항목

• Pods/**, generated/**, build/**를 직접 수정하지 않는다.
• 새 dependency를 추가하지 않는다.
• 기존 DM 방 UI와 WebSocket 전송 로직을 변경하지 않는다.
• recipientId와 creatorId를 서로 다른 값으로 동시에 보내는 request를 만들지 않는다.
• 실패하는 검증을 통과시키기 위해 테스트를 삭제·완화하거나 타입 오류를 우회하지 않는다.

의사결정 및 중단 규칙

• PRD와 구현 계획이 충돌하면 PRD Decision Log를 먼저 갱신한다.
• 검색 API response model이 기존 SearchResponseItem으로 충분하지 않으면 코드 변경 전에 이 문서에 Task를 추가한다.
• 서버가 recipientId request를 거부하면 P2-T5를 중단하고 request contract 확인 Task를 추가한다.
• UI가 Figma와 충돌하면 Figma 구조를 우선하되 기존 V2 component token을 벗어나지 않는다.

Progress

기존 기록을 삭제하거나 덮어쓰지 않고 실제 실행 결과를 차수별로 누적한다.

문서 작성 — 2026-09-14

• 상태: 완료
• 무엇을: PRD와 Goal 실행형 구현 계획 초안 작성.
• 왜: 사용자 요청이 “모호한 것은 인터뷰하고 문서만 생성, 코드 구현 금지”였기 때문.
• 어떻게:
  • docs/sample/sample-prd.md 확인 — 샘플 구조 반영.
  • docs/sample/sample-plan-task.md 확인 — Phase/Task/Goal 구조 반영.
  • Figma 2372:23496, 2372:23521 확인 — 화면과 팝업 기준 반영.
  • 기존 코드 조사 — MainChatView, FollowCreatorViewModel, UserApi.searchUser, UserCreatorChatRepository, SodaV2ActionModal 기준 반영.
• 남은 항목: 사용자 문서 검토.
• 다음 행동: PRD와 plan-task 승인 또는 수정 요청.

Phase 1~2 구현 — 2026-09-14

• 상태: 빌드 검증 완료, 수동 QA 필요
• 무엇을:
  • 메인 대화 탭에 크리에이터 전용 신규 DM 시작 + 버튼을 추가했다.
  • AppStep.userCreatorChatRecipientSearch 라우팅과 리스너 선택 화면을 추가했다.
  • 팔로우 전체 리스트, 2글자 이상 500ms debounce 검색, empty 상태, 확인 팝업, recipientId 기반 방 생성을 연결했다.
  • 기존 creatorId 기반 createRoom(creatorId:) 흐름은 유지했다.
• 왜: PRD의 크리에이터 선제 DM 시작 요구사항을 기존 API와 V2 컴포넌트 재사용으로 구현하기 위해서다.
• 어떻게:
  • 신규 Swift 파일은 프로젝트 수동 등록 위험이 있어 만들지 않고, 기존 컴파일 대상인 UserCreatorChatRoomView.swift에 선택 화면 타입을 추가했다.
  • UserCreatorCreateRoomRequest는 encodeIfPresent로 recipientId와 creatorId 중 nil 필드를 request body에서 제외하도록 했다.
  • 검색 응답은 기존 UserRepository.searchUser 사용처와 동일하게 ApiResponse<[GetRoomDetailUser]>로 디코딩했다.
  • 검색어를 2글자 미만으로 지울 때 진행 중인 검색 요청을 취소하고 초기 팔로우 리스트로 복귀하도록 했다.
  • 검색/팔로우 목록/방 생성 로딩 상태를 분리해 지연된 검색 실패가 방 생성 중복 방지 상태를 해제하지 않도록 했다.
  • 최신 검색 요청만 성공·실패 상태를 반영하고, 새 검색 시작 시 이전 검색 결과를 비워 현재 검색어와 목록이 어긋나지 않도록 했다.
• 검증:
  • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build — 성공.
  • 첫 빌드는 Swift 접근제어 오류를 발견했고 UserCreatorChatRecipientItem 접근 수준을 보정했다.
  • 두 번째 빌드는 코드사인/리소스 복사 단계에서 120초 제한으로 중단됐다.
  • 세 번째 빌드는 600초 제한으로 재실행해 ** BUILD SUCCEEDED ** 확인.
  • 검색 취소 로직 보정 후 xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build를 재실행해 ** BUILD SUCCEEDED ** 확인.
  • Oracle 코드 리뷰에서 검색 취소·지연 실패·이전 결과 잔존 이슈를 지적받았고, 상태 처리 보정 후 동일 빌드를 재실행해 ** BUILD SUCCEEDED ** 확인.
• 수동 QA 미수행:
  • 이 환경에서 로그인된 크리에이터/비크리에이터 계정과 실기기 또는 시뮬레이터 네트워크 관찰을 아직 실행하지 못했다.
  • 아래 Phase 3 Gate의 수동 검증 항목은 앱 실행 환경에서 별도 확인해야 한다.

Decision Log

날짜	ID	상태	결정	근거	영향 Goal/문서
2026-09-14	DEC-001	확정	코드 구현 없이 문서만 작성한다.	사용자 직접 지시	전체
2026-09-14	DEC-002	확정	초기 목록은 기존 팔로우 전체 리스트 API를 사용한다.	사용자 답변 B	P2-T2
2026-09-14	DEC-003	확정	새 크리에이터→리스너 DM 시작 request는 recipientId를 사용한다.	서버 request contract	P2-T5

발견된 문제

ID	심각도	상태	발견 내용	영향 Goal	처리 계획
ISSUE-001	Medium	처리 완료	현재 iOS UserCreatorCreateRoomRequest는 creatorId 단일 필드만 가진다.	P2-T5	request model을 optional recipientId/creatorId 구조로 확장했다.
ISSUE-002	Low	처리 완료	신규 Swift 파일은 project.pbxproj 수동 등록이 필요해 누락 시 빌드 실패 위험이 있다.	P1-T2, P2-T1~P2-T5	기존 컴파일 대상인 UserCreatorChatRoomView.swift에 선택 화면 타입을 추가했다.

최종 보고 형식

구현 완료 보고에는 아래 항목을 기록한다.

• 구현 결과: 완료한 Phase와 사용자가 수행할 수 있게 된 DM 시작 흐름.
• 변경: 주요 파일과 사용자에게 보이는 동작.
• 결정: 적용된 Decision Log ID와 결정 내용.
• 검증: 실행한 명령, exit code, 수동 QA 성공·실패 결과.
• 남은 항목: 외부 의존, 후속 범위, 또는 없음.
• 문서: 갱신한 PRD, plan-task, review 문서 경로.