내부 보관용과 배포용 파일을 처음부터 나눠 두고, 내보내기 전에 세 가지를 지웁니다.
작업물을 남에게 보낼 때마다 같은 걱정을 했습니다. 이 안에 내부 폴더 주소가 들어 있지는 않은지, 시험하려고 적어 둔 열쇠 값이 남아 있지는 않은지, 아직 정리되지 않은 메모가 섞여 있지는 않은지입니다. 보내기 직전에 뒤지면 매번 처음부터 봐야 하고, 한 번 놓치면 되돌릴 수 없습니다. 그래서 순서를 바꿨습니다. 보낼 때 걸러 내는 대신 처음부터 두 갈래로 나눠 둡니다. 안에서 쓰는 파일과 밖으로 나갈 파일을 다른 자리에 두고, 밖으로 나갈 파일에는 내부 주소, 개인 정보, 비밀값 세 가지를 아예 넣지 않습니다. 나눠 두니 내보내기 전 점검이 뒤지는 일에서 확인하는 일로 바뀌었습니다.
왜 파일을 두 갈래로 나누게 됐나요?
처음에는 한 폴더에 다 두고 필요할 때 골라서 보냈습니다. 문제는 고르는 기준이 그때그때 달라진다는 점이었습니다. 급할 때는 폴더째 압축하게 되고, 그 안에 무엇이 있었는지는 보낸 뒤에야 떠오릅니다.
AI에게 정리를 맡길 때도 같은 일이 생깁니다. 어떤 파일이 밖으로 나가도 되는지는 파일 이름만 봐서는 알 수 없습니다. 결국 사람이 하나씩 열어 봐야 합니다.
그래서 판단을 파일이 아니라 위치에 맡겼습니다. 밖으로 나갈 것은 배포용 자리에만 두고, 그 자리에는 내부 정보를 처음부터 넣지 않습니다.
무엇이 내부에만 두는 파일인가요?
기준은 하나입니다. 이 파일이 밖에 있어도 아무 일이 없는가입니다. 조금이라도 망설여지면 내부에 둡니다.
이렇게 정해 두면 판단이 빨라집니다. 파일을 열어 내용을 다 읽지 않아도 되고, 어디에 두느냐만 정하면 됩니다. 판단이 빠르면 나중에 몰아서 정리하는 일도 줄어듭니다.
| 내부에만 두는 것 | 이유 |
|---|---|
| 내부 폴더 주소와 링크 | 받은 사람이 열 수 없고 위치만 드러난다 |
| 계정 메일과 사람 이름 | 개인 정보가 된다 |
| 열쇠 값과 접속 정보 | 그대로 쓸 수 있는 값이다 |
| 고객·거래 관련 기록 | 동의 범위를 벗어난다 |
| 정리 전 메모와 실험 파일 | 결정으로 오해될 수 있다 |
내보내기 전에 무엇을 확인하나요?
나눠 두었더라도 마지막 확인은 남깁니다. 파일이 오가는 과정에서 섞일 수 있기 때문입니다. 확인은 세 가지로 고정했습니다.
첫째는 주소입니다. 문서 안에 내부 폴더로 이어지는 링크가 있는지 봅니다. 둘째는 이름입니다. 사람 이름과 계정이 남아 있는지 봅니다. 셋째는 값입니다. 열쇠나 접속 정보처럼 그대로 쓸 수 있는 문자열이 있는지 봅니다.
세 가지 모두 눈으로 훑기보다 검색으로 찾습니다. 검색어를 미리 정해 두면 매번 같은 방법으로 확인할 수 있고, 확인했다는 말이 아니라 확인한 결과가 남습니다.
- 주소 — 내부 폴더로 이어지는 링크
- 이름 — 사람 이름, 계정, 연락처
- 값 — 열쇠, 토큰, 접속 정보
- 판정 — 하나라도 나오면 내보내기를 멈춘다
버전은 어떻게 붙이나요?
배포용 파일에는 버전을 반드시 붙입니다. 이름이 같은 파일이 여러 개 돌아다니면, 상대가 어떤 것을 보고 있는지 물어보는 데 시간을 씁니다.
번호는 단순하게 씁니다. 처음 내보내는 것은 초기 번호로, 내용이 바뀌면 뒷자리를, 구조가 바뀌면 앞자리를 올립니다. 규칙보다 중요한 것은 한 번 정한 방식을 바꾸지 않는 것입니다.
함께 바뀐 내용을 한 줄로 남깁니다. 무엇이 달라졌는지 적혀 있지 않으면 새 버전을 받아도 처음부터 다시 읽어야 합니다.
이전 버전은 지우지 않고 그대로 둡니다. 받은 사람이 옛 버전을 보고 있을 수 있기 때문입니다. 새 버전을 올린 다음에 옛 버전을 정리하면, 그 사이에 링크가 끊기는 일이 생깁니다.
덮어쓰기 전에는 무엇을 남기나요?
승인이 끝난 문서와 마지막으로 정상 동작하던 파일은 덮어쓰기 전에 따로 남깁니다. 고치다 잘못됐을 때 돌아갈 자리가 있어야 하기 때문입니다.
남기는 자리는 임시 폴더가 아니라 프로젝트 안의 보관 폴더로 정했습니다. 임시 자리에 둔 것은 다음에 열었을 때 사라져 있을 수 있습니다.
보관은 오래 쌓아 두는 것이 목적이 아닙니다. 마지막 정상 상태 하나만 확실히 남아 있으면 대부분의 사고는 되돌릴 수 있습니다.
나누고 나서 무엇이 달라졌나요?
가장 크게 달라진 것은 내보내기 전에 드는 시간입니다. 전에는 폴더를 뒤지며 확인했고, 지금은 정해진 세 가지만 검색합니다.
마음도 편해졌습니다. 무엇이 들어 있을지 몰라 불안한 상태로 보내는 것과, 무엇을 확인했는지 알고 보내는 것은 같은 작업이 아닙니다.
| 한 폴더에 다 두었을 때 | 두 갈래로 나눈 뒤 |
|---|---|
| 보낼 때마다 기준이 달라짐 | 위치가 곧 기준이 됨 |
| 무엇이 들었는지 열어 봐야 앎 | 배포용에는 애초에 안 넣음 |
| 확인이 눈으로 훑기 | 확인이 정해진 검색 세 번 |
| 같은 이름 파일이 여러 개 | 버전과 바뀐 내용이 함께 남음 |
자주 묻는 질문
Q. 작은 작업물도 나눠야 하나요?
A. 밖으로 나갈 가능성이 있으면 나눕니다. 나중에 나누는 것보다 처음에 자리를 두 개 만드는 편이 훨씬 쌉니다. 나갈 일이 없는 작업물은 굳이 나누지 않습니다.
Q. 확인은 왜 눈으로 보지 않고 검색으로 하나요?
A. 눈으로 훑으면 확인한 범위가 남지 않습니다. 검색어를 정해 두면 매번 같은 방법으로 확인하게 되고, 무엇을 확인했는지도 기록으로 남습니다.
Q. AI에게 내보내기 정리를 맡겨도 되나요?
A. 정리는 맡기되 마지막 확인은 사람이 합니다. 파일 이름만으로는 안에 무엇이 들었는지 알 수 없기 때문에, 무엇을 지웠는지 목록으로 보고하게 하고 그 목록을 봅니다.
Q. 백업은 얼마나 오래 두나요?
A. 오래 쌓는 것보다 마지막 정상 상태 하나를 확실히 남기는 편이 낫습니다. 개수가 늘면 어느 것이 정상이었는지 다시 헷갈립니다.
확인 자료
- AI 개발 운영 규칙 문서 v1.3 — 10장 버전과 백업, 11장 로컬과 문서 저장소의 역할 (확인 2026-09-09)
- AI 개발 운영 규칙 현장 부록 v1.3 — 임시 폴더를 저장소로 쓰지 않는다 (확인 2026-09-09)
이 글은 직접 겪은 작업 기록을 정리한 것입니다. 확인하지 못한 항목은 본문에 쓰지 않았습니다. 대표 이미지는 이해를 돕기 위한 참고용 이미지입니다.