AI 구조 변경 그 자리에서 검토하기

한 줄 요약: AI가 구조 파일에 제안한 변경을 읽는 법입니다. 어디에 표시되는지, 수락과 건너뛰기는 어디에 있는지, 「만료됨」은 무슨 뜻인지 정리했습니다.

화면에 있는 것은 작가의 파일이 아니라 제안입니다

수락을 누르기 전까지 파일은 1바이트도 바뀌지 않았습니다. 화면에 그려진 것은 디스크에 있는 내용이고, 그 위에 제안이 겹쳐져 있을 뿐입니다. 그러니 이 시점에 그 파일을 읽어 보거나 AI에게 다시 읽게 해도 돌아오는 것은 옛 판본입니다.

제안은 화면 한쪽에 목록으로 모이지 않고, 들어갈 자리에 그대로 나타납니다. 추가되는 것은 내려앉을 위치에 보입니다. 변경되거나 삭제되는 것은 이미 자리를 차지하고 있는 그 카드, 그 줄, 그 노드 위에 표시됩니다.

네 가지 표시, 하나의 조작 줄

표시	색	뜻
추가	초록	아직 없는 것입니다. 수락하면 들어옵니다
수정	호박	이미 파일에 있는 것이고, 내용이 바뀝니다
삭제	빨강	수락하면 없어집니다
이동	회색	위치가 바뀌거나 다른 막으로 넘어갑니다. 일부러 회색입니다. 빨강으로 그리면 지워지는 것으로 읽히기 때문입니다

표시된 자리마다 같은 줄이 붙습니다. 위 네 낱말 가운데 하나가 적힌 색 라벨, 그리고 수락과 건너뛰기입니다. 나머지 화면은 회색조로 유지되고 색은 그 라벨에만 씁니다.

비트 보드에는 한 가지가 더 있습니다. 비트가 다른 막으로 넘어갈 때는 라벨이 "2막 (대립)"(으)로 이동처럼 옮겨 갈 막의 이름까지 적습니다. 같은 막 안에서 옮기면 이동만 적힙니다.

네 가지 파일이 각각 어떻게 보입니까

.script 대본. 변경은 대본 본문 안에 그대로 자리하고, 앞쪽 가장자리를 따라 내려오는 색 띠로 구획됩니다. 추가되는 줄은 초록, 수정은 호박, 삭제는 빨강입니다. 대체되거나 지워지는 옛 줄은 취소선이 그어지고 흐려지며, 새 줄이 그 아래에 붙습니다. 씬 하나가 통째로 추가될 때는 초록 블록 하나가 나타나고 머리글에 새 씬이 적힙니다. 씬 헤딩을 고치는 자리에는 결과를 그대로 적은 라벨이 붙습니다 — 헤딩 → 내부 우안서방 · 밤. 줄을 그리는 것은 실제 대본 조판 요소이므로, 지금 보이는 모습이 수락한 뒤의 모습입니다.

.beats 비트 보드. 새 비트는 초록 점선 카드이고, 삽입될 바로 그 자리에 놓입니다. 몇 번째 막인지, 어느 두 카드 사이인지가 한눈에 보입니다. 기존 카드는 모양이 달라지지 않고 대신 테를 한 겹 두릅니다(빨강＝삭제 예정, 호박＝수정 예정, 회색＝이동 예정, 초록＝추가). 카드 자체의 테두리는 이미 「파일이 붙어 있음 / 아직 안 씀」을 나타내는 데 쓰이고 있기 때문입니다. 그래서 삭제될 비트에는 취소선이 그어지지 않습니다. 내용은 그대로 보이고 빨간 테와 삭제 라벨만 더해집니다. 수락과 건너뛰기는 그 카드 아래쪽에 있습니다. 막 단위 변경(막 이름 바꾸기, 막 지우기)은 막 머리글 위에 표시됩니다. AI가 막을 새로 열면 초록 점선으로 된 열이 하나 더 생기고, 그 안에 넣으려는 비트가 함께 들어 있습니다.

.map 관계도. 제안은 캔버스 위에 바로 그려집니다. 새 노드는 초록 점선 둥근 상자에 반투명 초록이 깔린 모습으로, 실제로 놓일 좌표에 나타납니다. 새 관계선은 초록 점선입니다. 기존 노드가 바뀌거나 없어질 예정이면 그 바깥에 점선 테두리가 둘립니다(호박＝수정, 빨강＝삭제). 관계선이 바뀔 예정이면 그 선 위에 굵은 점선이 겹쳐지고, 설명 글자가 바뀌는 경우에는 새 글자가 선 중점 바로 위에 적힙니다. 이동은 옛 위치에서 새 위치로 이어지는 회색 점선으로 그려지고, 옛 자리에는 속이 빈 점선 원이 남습니다. 수락과 건너뛰기는 그 노드나 선 옆에 떠 있는 작은 흰 카드 안에 있습니다.

.timeline 연표. 새 항목은 초록 점선 카드이고, 아무 카드 뒤에 붙는 것이 아니라 자기 시점에 맞는 올바른 시간 순서 자리로 정렬되어 들어갑니다. 수정될 항목은 테두리가 호박으로 바뀌고, 삭제될 항목은 빨강으로 바뀌면서 눈에 띄게 흐려집니다. 수락과 건너뛰기는 카드의 둘째 줄에 있습니다.

떠 있는 표시: 이 파일에 몇 건입니까

네 종류 모두 오른쪽 위에 작은 알약 모양 표시가 뜹니다. 건수 하나와 이 파일 전체 수락 버튼입니다. 대기 중인 것이 없으면 이 표시는 아예 없습니다.

그 건수는 화면에 찍힌 표시의 개수가 아니라 AI 호출 횟수입니다. 그래서 배치 하나(AI가 한 번에 여러 일을 한 경우)는 화면에 다섯 곳을 표시해도 1건입니다. 그 다섯 곳 가운데 어디서 수락을 눌러도 배치 전체가 들어갑니다.

「만료됨」은 무슨 뜻입니까

수락은 미리 계산해 둔 결과를 붙여 넣는 동작이 아닙니다. 당시의 그 조작을 가져와 지금의 파일에 대고 다시 실행합니다. 그 사이에 작가가 직접 한 수정을 덮어쓰지 않는 이유가 이것입니다.

대가가 있습니다. 그 조작이 손대려던 것이 이미 없어졌다면 실행할 수 없습니다. 그때 그 자리는 만료됨으로 표시됩니다. 수락 버튼은 아예 그려지지 않고 건너뛰기만 남으며, 옆에 회색 글자 한 줄이 붙습니다 — 더 이상 적용할 수 없습니다 — 대상이 파일에 없습니다.

흔한 원인은 셋입니다.

왜 만료됩니까

작가가 그 항목을 직접 지웠거나 고쳤습니다 이 변경이 의존하던 앞의 변경을 건너뛰었습니다 작가가 수락한 다른 변경이 대상을 없앴습니다

셋 다 고장이 아닙니다. 건너뛰고, 지금의 파일에 맞춰 다시 해 달라고 AI에게 청하십시오.

만료된 변경 가운데는 표시조차 그릴 수 없는 것이 있습니다. 고치려던 대상이 없으니 화면에 표시할 자리가 없기 때문입니다. 이런 것들은 떠 있는 표시 아래의 작은 카드에 모이고, 만료됨 라벨이 붙으며, 역시 건너뛰기만 주어집니다.

같은 것을 두 번 건드렸을 때는 어떻게 합쳐집니까

한 차례에 AI가 같은 항목을 두 번 건드렸다면 작가가 보는 것은 두 곳이 아니라 한 곳입니다.

• 추가했다가 삭제 → 상쇄되어 0이 되고, 화면에 흔적이 남지 않습니다. AI가 뭔가를 넣었다가 스스로 빼는 장면까지 볼 필요는 없습니다.
• 두 번 수정 → 한 곳입니다. 「이전」은 첫 수정 전의 상태이고, 「이후」는 마지막 결과입니다.
• 추가한 다음 수정 → 여전히 추가이고, 내용은 마지막 것으로 들어갑니다.
• 수정한 다음 삭제 → 삭제이고, 취소선이 그어져 보이는 것은 중간 판본이 아니라 작가가 원래 쓴 것입니다.

세계 지도는 예외입니다: 그 자리가 아니라 띠

.geomap은 방식이 다릅니다. 제안이 지도 위에 그려지지 않습니다. 대신 편집기 위쪽에 띠가 하나 나타납니다 — AI 변경 3건 검토 대기, 오른쪽에 이 파일 전체 수락과 검토가 있습니다.

검토를 누르면 패널이 펼쳐지고, 그 패널은 맨 앞의 한 건만 다룹니다. 한 건을 처리하면 다음으로 넘어가고, 건너뛰어 골라 잡는 방법은 없습니다. 패널은 위에서 아래로 이렇게 구성됩니다. 몇 번째 가운데 몇 번째인지, 건너뛰기와 수락, 이 변경이 항목을 지우거나 항목의 값을 비우는 경우에는 무엇이 그렇게 되는지 밝힌 호박색 경고, 무엇이 바뀌는지 적은 글 설명(지명 하나 추가, 강 하나 삭제 같은), 마지막으로 옛 지도와 새 지도의 축소 그림 두 장이 나란히 놓입니다. 확대할 수 있고, 두 쪽 화면이 함께 움직이도록 고정해 둘 수도 있습니다.

글 설명이 필요한 이유는 간단합니다. 지형 축소 그림 두 장으로는 「지명 하나가 이름이 바뀌었다」를 보여 줄 수 없습니다.

파일 트리에 뜨는 숫자

탐색기에서 파일 이름 오른쪽에 회색 둥근 배경의 숫자가 나타납니다. 그 파일에 검토 대기가 몇 건인지입니다. 폴더를 접어 두면 그 아래 전체 합계가 뜨고, 펼치면 안의 파일들이 각자 자기 숫자를 답니다. 마우스를 올리면 AI 변경 N건 검토 대기가 보입니다.

여러 파일에 동시에 대기가 있을 때는 「검토 대기 변경 N건」 목록에서 특정 파일로 바로 갈 수 있습니다. 목록의 각 줄은 파일 이름, 그 아래 폴더 경로, 그리고 그 파일의 건수입니다.

참고

• 산문 원고의 검토와는 다른 일입니다. .md 원고는 변경 검토를 지납니다. 나란히 놓인 창(원본 / AI 제안)에서 문단 단위로 취하거나 버립니다. 구조 파일은 이 문서가 설명하는 그 자리 검토를 지납니다. 버튼도 화면도 낱말도 다릅니다 — 산문 쪽 길은 여기에.
• 휴대폰에서도 검토할 수 있습니다. 대본 파일은 2026년 9월부터 휴대폰에서도 편집할 수 있습니다 — 줄이나 신 헤딩을 가볍게 누르면 그 자리에서 고쳐집니다 — 수락과 건너뛰기도 그대로 됩니다. 연표도 휴대폰에서 편집할 수 있습니다. 작은 화면에서 읽기 전용으로 남는 것은 세계 지도뿐입니다.
• 연표의 달력 보기에는 표시할 카드가 없습니다. 달력으로 바꾸면 표시가 하나도 보이지 않습니다. 그 모드에서 유일한 출구는 떠 있는 표시입니다. AI가 항목이 아니라 달력 설정을 고칠 때도 같습니다. 표시할 대상이 없으니 그 한 건은 떠 있는 표시에서 수락하십시오.
• 관계도의 그룹 변경도 같습니다. AI가 그룹을 추가하거나 이름을 바꿀 때 건수는 올라가지만 캔버스에는 아무것도 나타나지 않습니다. 떠 있는 표시에서 수락하거나 대화에서 처리하십시오.
• 보이는 캔버스 밖의 제안은 그려지지 않습니다. 현재 시야에서 너무 멀리 있는 표시는 그리지 않습니다. 그 구역으로 화면을 옮기거나, 그냥 「이 파일 전체 수락」을 쓰십시오.

관련

• Docs: AI가 구조 파일을 고치는 방식
• Docs: AI가 구조를 고칠 수 있을 때와 없을 때
• Docs: 변경 검토: AI 편집 확인하기
• Docs: 비트 보드란 무엇이고 언제 쓰는가
• Docs: 연표(.timeline)란 무엇인가
• Docs: 세계 지도 파일(.geomap)이란
• Docs: 왜 버전이 있고 데이터는 어떻게 지켜지는가