<aside> 🎯
한 줄 결론 — 규칙은 여러분이 정하고, 수백 개 파일에 그 규칙을 적용하는 반복 작업은 코딩 에이전트에게 맡깁니다. 단, 지우지 않기와 미리보기 먼저 두 가지는 꼭 지킵니다.
</aside>
| 항목 | 내용 |
|---|---|
| 대상 | 폴더·파일명 규칙은 알겠는데, 쌓이는 파일을 손으로 정리하기 벅찬 분 (코딩 경험 필요 없음) |
| 이번에 완성할 것 | 규칙 요약 파일 AGENTS.md, 표준 폴더 구조, 규칙대로 이름이 바뀐 첫 파일 묶음 |
| 예상 시간 | 40분 |
| 확인일 | 2026-09-27 · 도구 화면과 기능은 현재 화면·공식 문서를 우선하세요 |
앞 챕터 프로젝트 폴더 구조 · 파일명 규칙 · 버전 관리에서 폴더 6단계와 파일명 규칙을 정했습니다. 규칙은 좋은데, 막상 작업하다 보면 이런 일이 생깁니다.
image (37).png, download_8f2a.mp4 같은 식이다.이 반복 작업을 코딩 에이전트(Codex, Claude Code)에게 맡기는 게 이 챕터의 내용입니다. 코딩 에이전트는 컴퓨터의 작업 폴더를 열어 파일을 읽고, 이름을 바꾸고, 옮길 수 있습니다. 코드를 몰라도 한국어로 부탁하면 됩니다.
예시는 앞 챕터의 GOTGAN 프로젝트를 그대로 씁니다.
에이전트는 부탁한 일을 아주 빠르게 해냅니다. 잘못 부탁하면 잘못된 일도 빠르게 해냅니다. 그래서 아래 세 가지를 먼저 약속합니다.
| 약속 | 이유 |
|---|---|
| 1. 지우지 않는다 | 실패작도 _archive/로 옮길 뿐 삭제하지 않습니다. 앞 챕터의 원칙 그대로입니다. |
| 2. 미리보기 먼저 | 이름 바꾸기·옮기기 전에 "무엇을 어떻게 바꿀지" 표로 먼저 받고, 확인한 뒤에 실행하게 합니다. |
| 3. 처음엔 복사본으로 | 첫 연습은 파일 몇 개를 복사한 연습 폴더에서 합니다. 익숙해지면 실제 폴더로 옮겨갑니다. |
<aside> ⚠️
에이전트가 백업을 대신해 주지는 않습니다. 앞 챕터의 외장 SSD 미러링과 백업 요일은 그대로 지켜 주세요. 에이전트에게 정리를 맡기기 전날이 백업하기 가장 좋은 날입니다.
</aside>
AGENTS.md)결론 먼저 — 에이전트는 새 대화를 시작할 때마다 규칙을 잊습니다. 그래서 규칙을 프로젝트 폴더 안의 파일 한 장에 적어 두고 "이걸 먼저 읽어"라고 말합니다.
실제 순서
GOTGAN/)를 만들고 Codex나 Claude Code에서 엽니다.AGENTS.md를 만들게 합니다.붙여 넣을 값
이 폴더는 내 AI 단편영화 GOTGAN의 작업 폴더야. 폴더 규칙을 AGENTS.md에 정리해줘. 내용은 아래와 같아.
- 프로젝트 코드: GOTGAN
- 폴더: 00_planning, 01_assets, 02_clips, 03_edit, 04_master, 05_deliver, _archive
- 파일명: [프로젝트코드]_[씬]_[샷]_[종류]_[버전]_[상태].확장자
- 씬·샷은 두 자리(S01, SH02). 버전은 v01, v02… 확정본은 vF(샷마다 하나).
- 한글·공백·특수문자 금지. 공백 대신 _ 사용.
작업 규칙:
1. 파일을 절대 삭제하지 마. 버릴 파일은 _archive로 옮겨.
2. 이름을 바꾸거나 옮기기 전에 "현재 이름 → 바꿀 이름" 표를 먼저 보여주고, 내가 "진행"이라고 하면 실행해.
3. 같은 이름의 파일이 이미 있으면 덮어쓰지 말고 나에게 물어봐.
<aside> 💡
AGENTS.md는 여러 코딩 에이전트가 함께 쓰는 규칙 파일 이름입니다. Claude Code는 공식 문서에서 이 파일을 읽을 수 있다고 안내합니다. 도구가 자동으로 읽는지와 상관없이, 새 대화를 시작할 때 "AGENTS.md를 먼저 읽어줘" 한 줄을 붙이면 어느 도구에서든 안전합니다.
</aside>
통과 기준 — GOTGAN/AGENTS.md가 생겼고, 열어 보면 위 규칙과 작업 규칙 3가지가 들어 있습니다.