AI가 구조 파일을 고치는 방식

한 줄 요약: AI가 고칠 수 있는 구조 파일은 다섯 가지이고, 파일마다 손댈 수 있는 자리와 일부러 잠가 둔 자리가 나뉘어 있습니다. 파일을 통째로 다시 쓰지 않고 항목 하나씩 고치는 이유까지 정리했습니다.

무엇을 해결합니까

《묵조》의 「메모」 폴더에는 「이야기 뼈대.beats」가 들어 있습니다. 3막 14비트입니다. 2막 가운데가 늘어져서, 심연이 배조가 베끼고 있는 책이 같은 《조석지》라는 것을 알아차리는 비트를 하나 넣어 달라고 AI에게 청한다고 해 보겠습니다.

AI는 그 판을 읽습니다. 다만 읽는 것은 원본 파일이 아니라 요약입니다. 막, 비트마다의 제목과 요약, 각 카드가 어느 파일을 가리키는지까지입니다. 좌표, 정렬 키, 색처럼 프로그램만 보는 항목은 들어가지 않습니다. 넣어 봐야 정작 읽어야 할 내용을 밀어내기 때문입니다.

요약에는 손실이 있습니다. 그래서 AI가 「이 파일의 새 내용은 이렇습니다」라는 방식으로 파일을 통째로 돌려주게 하면, 보여 주지 않았던 것은 없는 것으로 처리되어 조용히 사라집니다. 정렬 키 하나가 빠지면 카드 순서가 흐트러집니다. AI가 본 적 없는 파일 카드가 빠지면 작가가 붙여 둔 9장이 판에서 없어집니다. 그런데도 오류 메시지는 어디에도 뜨지 않습니다.

4.0은 그 길 자체를 바꿨습니다. AI는 파일을 내놓지 않습니다. 대신 이름이 붙은 조작을 하나씩 보냅니다. 「2막, 일곱 번째 비트 다음에, 이런 제목의 비트를 추가」처럼. 언급하지 않은 자리는 1바이트도 움직이지 않습니다.

다섯 가지 파일, 각각 어디까지

파일	AI가 할 수 있는 일	일부러 잠가 둔 것
.script 대본	씬 추가, 씬 헤딩 변경, 씬 삭제. 씬 안의 요소(대사, 지문, 트랜지션, 숏 등) 추가·변경·삭제	대만식과 할리우드를 고르는 서식 설정
.beats 비트 보드	막 추가·변경·삭제. 비트 추가·변경·삭제·이동	작가가 붙여 둔 챕터 카드와 대본 카드. 막을 지우면 안의 비트는 사라지지 않고 미배정으로 남고, 비트를 지우면 붙어 있던 카드는 그 자리에 남습니다
.map 관계도	노드 추가·변경·이동·삭제. 관계선 추가·변경·삭제. 그룹 추가·변경·삭제. 지도 제목 변경	그룹의 테두리(구성원에서 계산되는 값입니다). 그리고 노드 데이터를 고치는 도구는 위치를 함께 옮기지 않습니다. 이동은 별개의 도구입니다
.geomap 세계 지도	지명 추가·변경, 글자 라벨 추가·변경, 강 그리기, 경계 그리기, 지형과 식생 칠하기, 지명이나 라벨 지우기, 지도 제목 변경	캔버스 크기와 좌표계. 이 도구가 다루는 단위는 픽셀이 아니라 격자 칸입니다
.timeline 연표	항목 추가·변경·삭제. 달력 설정	작가가 손으로 붙여 둔 출처(어느 메모, 어느 장). 그리고 달력을 설정하는 도구는 항목을 절대 건드리지 않습니다

연표가 AI에게 읽기 전용이라고 적힌 옛 설명을 보셨다면, 그 설명은 지난 것입니다. 연표는 이제 고칠 수 있습니다.

여기에 메모 도구가 한 조 더 있습니다. 작품에 메모가 하나라도 있거나 AI가 첫 메모를 막 만든 뒤라면, AI가 메모를 읽고 쓸 수 있습니다. 메모를 새로 만드는 일은 처음부터 언제나 됩니다.

파일을 통째로 쓰는 길은 막혀 있습니다

이 다섯 가지 파일에 대해서는 AI의 일반 쓰기 도구가 거부됩니다. 권장하지 않는 정도가 아닙니다. 파일 덮어쓰기, 일부 치환, 파일 삭제 — 글쓰기 스튜디오에서는 이 다섯 확장자에 대해 셋 다 통과하지 않습니다. 항목 단위 도구가 유일한 길입니다. 그러니 「AI가 내 관계도를 덮어썼다」는 일은 일어날 수 없습니다. 그 동작 자체가 존재하지 않습니다.

예외는 새로 만들기 하나입니다. AI는 빈 .beats, .timeline, .map, .geomap, .script를 열어 줄 수 있습니다. 작가가 탐색기에서 폴더를 우클릭해 「새 비트 보드」로 만드는 것과 똑같은 빈 파일입니다. 그다음에 항목 단위 도구로 내용을 채웁니다. 그래서 「《묵조》 관계도를 하나 만들고, 인물 여덟 명을 먼저 올려 주십시오」는 통하는 청입니다.

한 번에 여러 곳: 배치

「막을 하나 열고, 그 안에 비트 세 개를 넣어 주십시오」를 네 번에 나눠서 주고받으면 네 번을 기다려야 합니다. 그래서 파일 종류마다 배치 도구가 있어서, AI가 여러 조작을 한 번의 호출에 담아 보냅니다.

여기서 두 가지는 알아 두실 만합니다. 화면에 보이는 것이 달라지기 때문입니다.

배치 하나 안의 두 규칙

조작 1이 「4막」을 만듭니다 조작 2가 방금 만든 4막을 가리켜 비트를 넣습니다 조작 3이 한 개 더 넣습니다

뒤의 조작은 앞의 조작이 방금 만든 것을 가리킬 수 있습니다. 그래서 「막을 열고 채우기」가 한 번의 호출로 끝납니다.

• 전부 아니면 전무. 배치 안의 조작 하나라도 실패하면 전체가 적용되지 않습니다. 「막은 생겼는데 비트는 두 개만 들어간」 반쪽 상태가 나오지 않습니다. 실패하면 AI는 「이 배치는 하나도 적용되지 않았습니다」를 전달받고, 오류 내용을 들고 다시 시도합니다.
• 수락의 단위는 표시가 아니라 호출입니다. 배치 하나는 화면에 여러 곳으로 표시되지만, 그 여러 곳이 같은 호출에 속합니다. 그중 어느 한 곳에서 수락을 누르면 배치 전체가 들어갑니다. 오른쪽 위 표시에 뜨는 숫자가 세는 것도 호출이므로, 배치는 1건입니다.
• 배치에는 한 줄 설명이 반드시 붙습니다. 이 배치가 무엇을 하려는지 적은 문장이고, 작가가 읽도록 쓰였으며, 검토 카드에 그대로 나옵니다.

따로따로 수락하고 싶으시면 AI에게 「한 번에 한 곳씩 고쳐 주십시오」라고 하십시오. 그러면 호출을 하나씩 나눠 보냅니다.

고친 다음에 보이는 것

조작 하나든 배치든, 결과가 파일에 바로 쓰이지는 않습니다. 먼저 검토 대기가 됩니다. 추가되는 것은 들어갈 자리에 자라고, 변경·삭제되는 것은 원래 그 카드·그 줄·그 노드 위에 표시되며, 옆에 바로 수락과 건너뛰기가 있습니다.

그 부분의 전체 설명은 AI 구조 변경 그 자리에서 검토하기에 있습니다.

먼저 분명히 해 둘 두 가지

• AI가 먼저 손대는 일은 없습니다. 배경에서 비트 보드를 정리하거나 연표를 채워 두는 절차는 없습니다. 작가가 AI 대화에서 청할 때만 움직이고, 움직인 뒤에도 작가의 수락을 기다립니다.
• 못 고친다고 답할 때가 있습니다. 대개 고장이 아니라, 이 대화가 그 파일 종류의 도구를 아직 받지 못한 것입니다. 판단 기준과 해결 순서는 AI가 구조를 고칠 수 있을 때와 없을 때에 있습니다.

관련

• Docs: AI 구조 변경 그 자리에서 검토하기
• Docs: AI가 구조를 고칠 수 있을 때와 없을 때
• Docs: 변경 검토: AI 편집 확인하기
• Docs: 비트 보드란 무엇이고 언제 쓰는가
• Docs: 연표(.timeline)란 무엇인가
• Docs: 관계도: 인물 관계를 한 장으로 그리기
• Docs: 세계 지도 파일(.geomap)이란
• Docs: AI 도구와 diff 흐름