두 창작자가 교대로 검토할 때, '여기가 틀렸어'를 실행 가능한 수정서로 쓰는 방법은?
'여기가 틀렸어'를 수정서로 바꾸는 핵심 동작은 하나뿐입니다. 모든 의견을 버전, 노드, 현상, 기대, 이유, 책임, 검증이라는 일곱 칸에 넣는 것입니다. 두 사람이 교대로 검토할 때는 먼저 각자 독립적으로 수정서를 작성하고, 충돌 항목을 병합한 뒤에야 원고를 수정합니다. 아래에서는 가상의 교육용 예시로 전체 과정을 진행하며, 인물, 대사, 수치는 실제 측정 자료가 아닙니다.
안내
'여기가 틀렸어'를 수정서로 바꾸는 핵심 동작은 하나뿐입니다. 모든 의견을 버전, 노드, 현상, 기대, 이유, 책임, 검증이라는 일곱 칸에 넣는 것입니다. 두 사람이 교대로 검토할 때는 먼저 각자 독립적으로 수정서를 작성하고, 충돌 항목을 병합한 뒤에야 원고를 수정합니다. 아래에서는 가상의 교육용 예시로 전체 과정을 진행하며, 인물, 대사, 수치는 실제 측정 자료가 아닙니다.
먼저 두 사람이 공유하는 수정서를 정한다
수정서는 문학 평론이 아니라 인계 가능한 작업 지시서입니다. 일곱 열을 고정하고, 한 열이라도 빠지면 수정 대기열에 넣지 않는 것을 권장합니다:
| 열 | 작성 요건 | 반례 |
|---|---|---|
| 버전 | 브랜치 또는 저장 이름에 날짜 추가 | "최신 버전" |
| 노드 | 장면/인터랙션 노드 번호까지 구체적으로 | "중간 부분" |
| 현상 | 독자가 볼 수 있거나 읽을 수 있는 원문 | "느낌이 안 맞아" |
| 기대 | 어떤 상태로 바꿀지, 제3자가 판단 가능 | "더 긴장감 있게" |
| 이유 | 캐릭터 목표, 관계 또는 앞뒤 맥락과의 연관 | "그냥 마음에 안 들어" |
| 책임 | 누가 고치고, 누가 보지 않는지 | "다 같이 보자" |
| 검증 | 수정 후 어떻게 확인하고, 누가 확인하는지 | "다시 한번 보자" |
'노드'는 인터랙티브 영상 게임에서 개별적으로 위치를 지정할 수 있는 인터랙션 단위를 말하며, 보통 표로 구성되고 드래그 캔버스가 아닙니다. 노드 번호를 명확히 써야 두 사람이 같은 지점을 말하는 것입니다.
가상 사례: 같은 장면, 두 개의 충돌 의견
가상 프로젝트 《안개항의 편지》를 설정하고, 브랜치는 mist-dev입니다. 제3막 노드 N-07에서 플레이어가 맡은 견습 우편배달부가 반송된 편지를 늙은 선의에게 돌려주어야 합니다. 현재 텍스트 원문은:
늙은 선의는 편지를 받아 들고 웃으며 말했다: "책상 위에 놓아둬, 나중에 볼게."
검토자 갑(캐릭터 라인 담당)이 작성한 수정서:
- 버전: mist-dev 10-04
- 노드: N-07
- 현상: "웃으며"가 늙은 선의의 "견습생을 잃은 후 더 이상 면전에서 편지를 뜯지 않는다"는 기존 설정과 충돌
- 기대: 그가 편지를 되밀며 "이건 네가 전할 편지가 아니야"라고 말하도록 변경
- 이유: 그의 목표는 과거를 회피하는 것이며, 받는 것보다 되미는 것이 회피에 더 부합
- 책임: 갑이 텍스트 수정
- 검증: 을이 한 번 읽고 새로운 과거 사건이 추가되지 않았는지 확인
검토자 을(인터랙션 리듬 담당)이 작성한 수정서:
- 버전: mist-dev 10-04
- 노드: N-07
- 현상: 플레이어가 방금 장거리 호송을 겪었는데, 여기서 "책상 위에 놓아둬" 한마디가 선택의 무게를 없앰
- 기대: 편지 받는 동작은 유지하되, 플레이어가 먼저 "용건을 설명한다" 또는 "말없이 편지를 건넨다"를 선택하게 함
- 이유: 두 선택지가 서로 다른 관계 상태에 대응하며, 플레이어가 자신의 선택이 받아들여진다고 느낄 수 있음
- 책임: 을이 노드 선택지 수정
- 검증: 갑이 두 선택지 모두 캐릭터 경계를 위반하지 않는지 확인
두 수정서 모두 규정을 충족하지만, "편지를 받을지 되밀지"에서 직접적으로 모순됩니다. 이때 각자 절반씩 고치면 안 됩니다.
처리 규칙: 모순을 먼저 해결하고, 그다음 원고를 수정한다
모순된 의견의 처리는 순서대로 진행하며, 단계를 건너뛰지 않습니다:
- 버전을 맞춘다. 두 사람이 같은
mist-dev 10-04를 보고 있는지 확인합니다. 한쪽이 오래된 저장본을 보고 있다면, 해당 수정서를 먼저 무효화합니다. - 사실과 선호를 분리한다. "되밀기"는 이미 쓰인 캐릭터 설정과 연관되므로 사실 층에 속하고, "선택의 무게가 없어짐"은 체험 층에 속합니다. 두 층이 모두 성립할 때 사실 층이 우선 제약하며, 체험 층은 그 안에서 구현합니다.
- 최소 공통 변경을 찾는다. 병합 결과는: 되미는 동작을 유지하고, "용건을 설명한다/말없이 편지를 건넨다"를 되밀기 전의 두 선택지로 둡니다. 이렇게 하면 캐릭터가 깨지지 않고 리듬도 보완됩니다.
- 유일한 책임자를 지정한다. 텍스트는 갑이 수정하고, 노드 선택지는 을이 수정하며, 두 사람 모두 상대방의 열을 넘어서 수정하지 않습니다.
- 검증 방법을 쓴다. 검증은 "다시 한번 보자"가 아니라 구체적 동작입니다: 갑이 N-07 전문을 소리 내어 읽고, 제공되지 않은 과거 사건이 문장마다 나오는지 대조합니다. 을이 두 선택지를 한 번씩 진행하여 둘 다 다음 노드로 진입할 수 있는지 확인합니다.
두 단계 후에도 여전히 충돌한다면, 두 의견 모두 보류로 표시하고 수정에 들어가지 않습니다. 보류가 강제 병합보다 안전한데, 강제 병합은 종종 캐릭터를 어정쩡하게 만들기 때문입니다.
병합된 수정서는 이렇게 생겼습니다
| 버전 | 노드 | 현상 | 기대 | 이유 | 책임 | 검증 |
|---|---|---|---|---|---|---|
| mist-dev 10-04 | N-07 | "웃으며"가 회피 설정과 충돌; 단문 수신이 선택의 무게를 없앰 | 편지를 되밀고, 되밀기 전에 두 선택지 제공 | 사실 층이 캐릭터를 제약하고, 체험 층이 리듬을 보완 | 갑이 텍스트 수정, 을이 선택지 수정 | 갑이 과거 사건 확인, 을이 두 선택지 진행 |
"이유" 열에는 판결이 아니라 연관을 씁니다. 이는 제3자가 변경이 경계를 넘었는지 판단할 수 있게 하며, 검토자를 대신 보증하는 것이 아닙니다.
수정 후, 다운스트림에서 수동 확인 필요
N-07 텍스트와 선택지를 변경하는 것은 노드 수정에 해당합니다. 현재 프로젝트 구현에 따르면, 관련 완료된 미리보기와 내보내기는 "업데이트 필요"로 표시되고, 이전 데이터는 보존됩니다. 창작자는 이전 미리보기의 텍스트가 여전히 성립하는지, 새 내보내기에 수정 내용이 포함되었는지 확인해야 합니다. 이번 의견이 영상 속 동작까지 바꾸었다면, 해당 클립을 별도로 나열해야 하며, "노드 수정됨" 한마디로 숨겨서는 안 됩니다.
내보내기는 두 가지입니다: 로컬素材 패키지 localAssets는 소재, 플레이어, 설명 파일을 포함하며, 설명에 따라 실행하고 오프라인에서 확인합니다. 원격 링크 패키지 remoteUrls는 애플리케이션 도메인 아래의 안정적인 진입점을 통해 접근하며, 네트워크와 서비스에 의존하고 영구 자원 보장이 아닙니다. localhost는 다른 사람 컴퓨터에서 그 사람 자신의 기기를 가리키므로, 팀원에게 범용 주소로 보낼 수 없습니다. 압축 파일이 풀린다고 해서 플레이 가능성이 검증된 것은 아닙니다.
완료 검사
수정서가 수정 단계에 들어갈 수 있는 것은 일곱 열이 모두 갖추어지고 다음을 충족할 때뿐입니다:
- 현상 열이 원문이나 구체적 노드를 인용할 수 있음;
- 기대 열이 제3자가 독립적으로 달성 여부를 판단할 수 있음;
- 이유 열이 개인 취향이 아니라 캐릭터 설정이나 앞뒤 맥락을 가리킴;
- 책임 열에 수정자가 한 명뿐임;
- 검증 열이 태도가 아니라 동작임.
두 사람이 교대로 검토할 때는 매 회차마다 같은 노드의 충돌만 처리하고, 처리 후 다음 노드를 시작하는 것을 권장합니다. 이 글은 DramaFork에서 정리했으며, 현재 프로젝트 구현에 따라 설명합니다. 문서 협업에는 실시간 다인 동시 편집 약속이 없으므로, 두 사람이 위 순서대로 인계하면 됩니다.
다음 검토 전에, 먼저 각자 일곱 열을 채우고, 만나서는 충돌하는 그 칸만 이야기하세요.
