폴더가 보인다고 세팅이 끝난 게 아닙니다. 네 가지 동작을 실제로 해 봐야 압니다.
AI에게 문서 저장소를 연결해 주면 폴더 목록이 그럴듯하게 뜹니다. 여기서 「연결 완료」라고 기록해 두면 며칠 뒤 파일을 만들려는 순간 막힙니다. 목록을 읽는 권한과 파일을 만드는 권한, 만든 파일을 고치는 권한, 다른 폴더로 옮기는 권한이 각각 다르기 때문입니다. 제가 쓰는 개발 운영 규칙 문서는 이 지점을 아예 절차로 못 박아 뒀습니다. 시험 파일 생성, 그 파일 수정, 작은 문서 업로드, 업로드한 파일의 하위 폴더 이동. 네 가지가 모두 성공해야 세팅 완료로 기록합니다. 하나라도 실패하면 오류 원문을 그대로 남깁니다.
목록이 보이는 것은 권한 확인이 아니다
저장소를 연결하면 가장 먼저 폴더 목록이 뜹니다. 사람은 이 화면을 보고 준비가 끝났다고 판단합니다. 실제로는 읽기 권한 하나만 확인된 상태입니다.
읽기만 되는 상태로 작업을 시작하면 문제가 늦게 드러납니다. 계획을 세우고 문서 구조를 짜고 첫 파일을 만들려는 순간에야 막히고, 그때는 이미 대화가 길어져 있습니다.
권한 문제는 조용히 실패하는 편입니다. 도구가 오류를 던지지 않고 「처리했습니다」로 끝나는 경우도 있습니다. 그래서 결과를 눈으로 확인하지 않으면 실패한 줄도 모릅니다.
규칙 문서가 정한 기준은 단순합니다. 폴더가 보이는 것은 세팅이 아니고, 네 가지 동작을 실제로 해 봐야 세팅입니다.
실제로 해 보는 네 가지
첫째, 프로젝트 폴더 안에 작은 시험 파일을 만듭니다. 내용은 한 줄이면 충분합니다. 확인하려는 건 내용이 아니라 생성이 되느냐입니다.
둘째, 방금 만든 시험 파일의 내용을 고칩니다. 만드는 것과 고치는 것은 다른 권한입니다. 만들기만 되고 고치기가 막히는 경우가 실제로 있습니다.
셋째, 작은 문서 파일을 업로드합니다. 도구가 직접 만드는 것과 바깥에서 올리는 것은 경로가 다릅니다.
넷째, 업로드한 파일을 하위 폴더로 옮깁니다. 이동은 두 폴더 모두에 대한 권한이 필요해서 가장 늦게 막히는 동작입니다.
| 순서 | 해 보는 일 | 이걸로 확인되는 것 |
|---|---|---|
| 1 | 시험 파일 만들기 | 생성 권한 |
| 2 | 그 파일 내용 고치기 | 수정 권한 |
| 3 | 작은 문서 업로드 | 업로드 경로 |
| 4 | 하위 폴더로 이동 | 두 폴더의 이동 권한 |
| 판정 | 네 가지 전부 성공 | 그때만 세팅 완료 |
결과는 문서 두 곳에 남긴다
네 가지 시험 결과와 오류 원문은 쓰기 권한 점검 문서와 프로젝트 상태 문서에 남깁니다. 두 곳에 남기는 이유는 읽는 사람이 다르기 때문입니다.
권한 점검 문서는 무엇이 왜 막혔는지 찾을 때 봅니다. 상태 문서는 지금 이 프로젝트가 작업 가능한 상태인지 한 줄로 알고 싶을 때 봅니다.
오류 원문을 요약하지 않고 그대로 붙이는 것이 규칙입니다. 요약하면 다음에 같은 오류를 만났을 때 같은 오류인지 알아보지 못합니다.
권한을 열어 줄 때도 범위를 정합니다. 누구나 편집할 수 있는 공개 링크는 승인이 있을 때만 쓰고, 민감한 프로젝트는 지정한 계정에만 편집 권한을 줍니다.
- 권한 점검 문서 — 네 가지 시험 결과와 오류 원문 그대로
- 상태 문서 — 지금 작업 가능한 상태인지 한 줄
- 요약 금지 — 오류 원문은 붙여 넣는다
- 공개 편집 링크 — 승인이 있을 때만
고치지 못하는 문서를 갱신하는 법
쓰기 권한이 있어도 도구에 따라 기존 파일의 내용을 직접 고치지 못하는 경우가 있습니다. 목록도 보이고 업로드도 되는데 수정만 안 되는 상태입니다.
이때 쓰는 방법은 세 단계입니다. 새 파일로 올리고, 다시 조회해서 내용이 맞는지 확인하고, 구버전을 휴지통으로 옮깁니다.
핵심은 세 단계를 한 번에 끝내는 것입니다. 중간에 멈추면 같은 이름의 문서가 둘 남고, 다음에 여는 사람이 어느 쪽이 최신인지 알 수 없게 됩니다.
확인 단계를 빼면 안 됩니다. 업로드 성공 메시지는 파일이 만들어졌다는 뜻이지 내용이 맞다는 뜻이 아닙니다.
| 단계 | 하는 일 | 빠뜨렸을 때 |
|---|---|---|
| 1 | 새 파일로 업로드 | 갱신 자체가 안 됨 |
| 2 | 다시 조회해 내용 확인 | 빈 파일이 최신본이 됨 |
| 3 | 구버전 휴지통으로 | 최신본이 둘이 됨 |
확인은 설정과 같은 방법으로
값을 넣을 때 쓴 경로와 확인할 때 쓰는 경로가 다르면 없는 문제를 만들거나 있는 문제를 놓칩니다.
다른 경로로 읽으면 빈 값이 나올 수 있고, 그걸 보고 「저장이 안 됐다」고 판단해 같은 작업을 다시 합니다. 반대로 실제로 비어 있는데 다른 경로에서는 예전 값이 남아 보이기도 합니다.
그래서 확인은 넣을 때와 똑같은 방법으로 합니다. 업로드한 도구로 다시 읽고, 필요하면 파일을 내려받아 크기와 내용을 봅니다.
네 가지 시험도 마찬가지입니다. 시험 결과를 화면에서 눈으로 보고, 그 문장을 그대로 기록에 옮깁니다.
권한 점검 한눈에
| 확인 항목 | 판정 기준 |
|---|---|
| 폴더 목록이 보인다 | 읽기만 확인된 상태 — 아직 미완료 |
| 시험 파일 생성·수정 성공 | 쓰기 확인 |
| 업로드·이동 성공 | 경로와 두 폴더 권한 확인 |
| 네 가지 전부 성공 | 세팅 완료로 기록 |
| 하나라도 실패 | 오류 원문을 그대로 기록 |
자주 묻는 질문
Q. 폴더가 보이면 권한이 있는 것 아닌가요?
A. 목록이 보이는 것은 읽기 권한만 확인된 상태입니다. 생성·수정·업로드·이동은 각각 다른 권한이라 실제로 해 봐야 압니다.
Q. 네 가지 중 하나만 실패하면 어떻게 하나요?
A. 세팅 완료로 기록하지 않고 오류 원문을 그대로 점검 문서에 남깁니다. 요약해서 적으면 다음에 같은 오류를 알아보지 못합니다.
Q. 기존 문서를 도구가 고치지 못할 때는요?
A. 새 파일로 올리고, 다시 조회해 내용을 확인하고, 구버전을 휴지통으로 옮깁니다. 세 단계를 한 번에 끝내야 최신본이 하나로 남습니다.
Q. 확인은 어떤 방법으로 해야 하나요?
A. 값을 넣을 때 쓴 것과 같은 도구·경로로 읽습니다. 다른 경로로 읽으면 빈 값이 나와 없는 문제를 만들 수 있습니다.
확인 자료
- AI 개발 운영 규칙 문서 v1.3 — 1장 새 프로젝트 세팅, 3장 저장소 권한 검증, 10장 버전과 백업 (확인 2026-09-09)
- 현장 부록 v1.3 — 검증 방법 규칙과 문서 갱신 3단계 (확인 2026-09-09)
이 글은 직접 겪은 작업 기록을 정리한 것입니다. 확인하지 못한 항목은 본문에 쓰지 않았습니다. 대표 이미지는 이해를 돕기 위한 참고용 이미지입니다.