교수 업무는 수업, 연구비, 논문, 학회, 학생지도처럼 종류가 많고, 종류마다 파일을 두는 방식과 일하는 순서가 다릅니다. 이 문서는 Dropbox를 업무 분류별 폴더로 나누고, 분류 폴더마다 규칙 wiki를 두어 Claude Code가 그 폴더의 규칙대로 일하게 만드는 방법을 정리한 것입니다. 제가 실제로 쓰는 구조를 다른 분들도 따라 할 수 있게 일반화했습니다. 명령과 경로는 macOS 기준입니다.
~/Dropbox/
├── 학교-수업/ ← Claude Code 세션은 여기서 연다
│ ├── AGENTS.md ← 진입점: 작업 시작과 끝, 작업별로 읽을 문서
│ ├── CLAUDE.md -> AGENTS.md
│ ├── wiki/
│ │ ├── index.md ← 이 폴더의 규칙 문서 목록
│ │ ├── layout.md ← 폴더 깊이와 배치
│ │ ├── conventions.md ← 파일명, 현재본과 이전 버전
│ │ ├── folders/ ← 실제 폴더마다 설명 문서 1개
│ │ ├── logs/ ← 실제 폴더마다 작업 로그 1개
│ │ └── lint.py ← 과목 폴더 구조와 wiki 등록 검사
│ ├── 26년2학기-학부/
│ ├── 26년2학기-대학원/
│ └── 지난학기/
├── 학교-일반/
├── Grants/
├── Manuscript/
├── Projects/
├── Meetings/
├── 학회/
├── 연구-학생지도/
├── 연구-피어리뷰/
└── 연구-특허/
Dropbox 최상위 폴더에 업무 분류 폴더를 두고, 분류 폴더마다 AGENTS.md와 wiki/를 둡니다. 작업은 항상 분류 폴더를 Claude Code 세션의 작업 폴더로 열어서 합니다. Claude Code는 공식 문서(https://code.claude.com/docs)를 따라 설치합니다. 터미널에서 cd ~/Dropbox/학교-수업을 실행한 뒤 claude를 입력하거나, 데스크톱 앱에서 이 폴더를 골라 세션을 엽니다. 그러면 학교-수업에서 연 세션은 수업 wiki의 규칙을 읽고 그대로 작업하며, 그 안의 학기 폴더와 과목 폴더는 모두 같은 규칙을 따릅니다.
규칙은 세 곳에 나뉘어 있습니다.
| 위치 | 담는 내용 | 예 |
|---|---|---|
~/.claude/CLAUDE.md |
모든 세션에 적용할 짧은 원칙과 규칙을 찾는 순서 | 되돌리기 어려운 일은 먼저 묻기 |
~/Claude/wiki/ (선택) |
여러 분류 폴더에 걸치는 규칙과 분류 폴더 목록 | 메일 쓰는 법, 한국어 문체, 밖으로 보내는 문서 점검 |
분류 폴더의 AGENTS.md와 wiki/ |
그 업무에만 적용되는 규칙과 작업 기록 | 과목 폴더 구조, 과제 제출물 보관 방식 |
Claude Code는 전역 CLAUDE.md와 작업 폴더의 CLAUDE.md를 함께 읽을 뿐 어느 쪽이 우선인지 스스로 정하지 않습니다. 그래서 전역 CLAUDE.md에 규칙이 겹치면 작업 폴더의 규칙을 먼저 따르라고 적어 둡니다.
- Claude Code는 세션을 시작할 때 작업 폴더와 그 상위 폴더들의
CLAUDE.md를 자동으로 읽습니다. 분류 폴더에서 세션을 열면 그 업무의 규칙이 세션 시작부터 맥락에 들어갑니다. - 업무마다 규칙이 따로 있으니 수업 일에 연구비 규칙이 섞이지 않고, 규칙 파일 하나가 끝없이 길어지지도 않습니다.
- 실제 자료 폴더는 사람이 Finder에서 바로 찾을 수 있게 얕고 단순하게 둡니다. 에이전트용 설명과 로그는 분류 폴더의
wiki/에 모으고, 자료 폴더 안에는 넣지 않습니다. - 새 세션은 지난 대화 내용을 그대로 이어받지 않습니다. Claude Code의 자동 메모리는 그 컴퓨터의 Claude Code에만 남으므로, 결정을
wiki/logs/에 적어 두어야 다음 세션과 다른 도구가 같은 기록을 읽습니다. - 정본을
AGENTS.md에 두고CLAUDE.md를 그 파일에 연결해 두면, Codex처럼AGENTS.md를 읽는 도구도 같은 규칙으로 일합니다.
Dropbox 최상위에 업무 분류 폴더를 만듭니다. 저는 아래처럼 나눕니다.
| 폴더 | 담는 일 |
|---|---|
학교-수업 |
강의자료, 과제, 시험, 성적 |
학교-일반 |
학과 행정, 위원회, 교원 업적, 연구실 운영 |
Grants |
연구비 제안서와 수행 과제 |
Manuscript |
준비 중인 논문 원고와 리비전 |
Projects |
연구 프로젝트의 데이터와 분석 |
Meetings |
외부 강연, 자문, 출장 |
학회 |
학회 활동 |
연구-학생지도 |
학생과 연구원의 지도, 학위과정, 서류 |
연구-피어리뷰 |
심사를 맡은 원고 |
연구-특허 |
특허 |
분류의 경계는 규칙이 달라지는 지점에 둡니다. 같은 규칙으로 처리할 수 있는 일은 한 폴더에 넣고, 파일명 규칙이나 보관 방식이 달라지면 폴더를 나눕니다.
이미 CLAUDE.md가 있으면 아래 명령을 실행하기 전에 그 내용을 AGENTS.md로 옮기고 CLAUDE.md를 지웁니다. 자료가 이미 많은 폴더라면 6단계처럼 Claude Code에게 맡겨도 됩니다.
cd ~/Dropbox/학교-수업
mkdir -p wiki/folders wiki/logs
touch AGENTS.md wiki/index.md
ln -s AGENTS.md CLAUDE.mdDropbox가 ~/Library/CloudStorage/Dropbox에 설치되어 있다면 경로를 그에 맞게 바꿉니다. 링크를 만들기 어려우면 CLAUDE.md에 @AGENTS.md 한 줄만 적어도 Claude Code가 AGENTS.md를 함께 읽습니다.
AGENTS.md에는 작업을 시작하고 끝낼 때의 순서와, 작업별로 먼저 읽을 wiki 문서만 적습니다. 세부 규칙은 wiki 문서로 나누고, 문서 하나가 한 가지 일만 맡게 합니다.
# 학교-수업 작업 규칙
이 파일은 `~/Dropbox/학교-수업`의 진입점이다. 세부 규칙은 `wiki/`의 문서가 소유한다.
## 작업 시작과 끝
1. 파일을 찾거나 만들거나 옮기기 전에 `wiki/index.md`를 읽는다.
2. 대상 폴더에 해당하는 `wiki/folders/<폴더>.md`를 읽는다.
3. 작업을 마치면 `wiki/logs/<폴더>.md`에 결정, 바뀐 파일, 확인 결과, 남은 일을 적는다.
4. 새 폴더를 만들면 `wiki/folders/`와 `wiki/logs/`에도 문서를 같이 만든다.
## 작업별로 먼저 읽을 문서
| 작업 | 문서 |
|---|---|
| 강의자료 보관, 파일명, 이전 버전 정리 | `wiki/conventions.md`, `wiki/layout.md` |
| 새 학기나 새 과목 폴더 만들기 | `wiki/layout.md`, `wiki/folders/index.md` |
| 수업 일정, 휴강, 보강 | `wiki/calendar.md` |
| 과제 제출물 보관과 피드백 | `wiki/feedback.md`, 대상 `wiki/folders/<폴더>.md` |
| 구조를 바꾼 뒤 점검 | `python3 wiki/lint.py <폴더>` |표에 적은 문서는 필요해질 때 만듭니다. 아직 만들지 않은 문서의 행은 지워 두어야 Claude가 없는 파일을 찾지 않습니다.
wiki/layout.md에는 실제 폴더의 구조를 정해 둡니다. 과목 폴더라면 이런 식입니다.
<학기>/<과목>/
├── <지금 쓰는 강의 파일>.pptx ← 현재 자료는 과목 폴더 바로 아래
├── admin/ 공식 문서와 행정 파일
├── resources/ 이 과목에만 쓰는 참고자료
├── submissions/ 학생 제출물 (그 아래 WeekN/ 한 단계만 허용)
└── old/ 이전 버전
과목 폴더에서 한 번만 들어가면 원하는 파일이 나오게 하고, misc/나 기타/처럼 경계가 모호한 폴더는 만들지 않습니다.
wiki/folders/<폴더>.md에는 실제 폴더 하나의 역할과 현재 자료를 적습니다. 중첩 폴더는 2026-2_유전학.md처럼 학기와 과목을 이은 이름 하나를 정해 folders/와 logs/에 같이 씁니다.
# 2026-2 유전학
실제 폴더: `~/Dropbox/학교-수업/26년2학기-학부/유전학`
## 먼저 찾을 현재 자료
- `260902-Orientation.pptx`
- `260907-Lecture02.pptx`
## 운영 결정
- 학생이 메일로 낸 과제는 `submissions/WeekN/`에 원본 파일명 그대로 둔다.
- 작업 이력은 `../logs/2026-2_유전학.md`에 있다.wiki/logs/<폴더>.md에는 작업이 끝날 때마다 한 항목씩 덧붙입니다.
## [2026-09-23] move | Week 4 제출물 보관
- 한 일: 메일로 온 제출물 18개를 `submissions/Week4/`에 저장했다.
- 확인: 파일 수와 열리는지를 확인했다. `python3 wiki/lint.py 26년2학기-학부/유전학` 결과는 PASS다.
- 남은 일: 첨부가 빠진 학생 1명에게 다시 요청해야 한다.~/.claude/CLAUDE.md는 모든 세션에 들어갑니다. 업무별 규칙은 넣지 않고, 어느 폴더에서든 지킬 원칙과 규칙을 찾는 순서만 적습니다.
# 전역 규칙
## 항상 지킬 것
1. 요청받은 작업은 실제로 끝내고, 결과를 확인한 뒤에 완료했다고 보고한다.
2. 메일 발송, 파일 삭제, 일정 변경처럼 되돌리기 어려운 일은 실행 전에 확인을 받는다.
3. 일정은 캘린더, 파일 상태는 파일에서 직접 확인한다. 못 찾은 것을 없다고 단정하지 않는다.
4. 작업 중에 받은 교정은 해당 분류 폴더의 wiki에 규칙으로 적는다.
5. 규칙이 겹치면 작업 폴더의 규칙을 이 파일보다 먼저 따른다.
## 규칙을 찾는 순서
1. 작업 폴더의 `CLAUDE.md`(= `AGENTS.md`)
2. 그 폴더의 `wiki/index.md`가 가리키는 문서
3. 여러 폴더에 걸친 규칙(메일, 문체, 산출물)은 `~/Claude/wiki/index.md` (만든 경우)
4. 다른 분류 폴더의 일이 섞이면 `~/Claude/wiki/`의 폴더 목록 표(만든 경우)에서 그 폴더를 찾아 `AGENTS.md`를 직접 읽는다. 표가 없으면 `~/Dropbox/<분류>/AGENTS.md`를 직접 읽는다.분류 폴더가 많아지면 ~/Claude/wiki/에 폴더 목록 표(폴더 경로, 진입점, 로그 위치)를 하나 둡니다. 다른 분류의 일이 섞일 때 Claude가 이 표를 보고 해당 폴더의 AGENTS.md를 찾아 읽습니다.
작업 폴더 밖의 파일을 읽을 때 Claude Code는 허락을 묻습니다. 자주 읽는 폴더는 ~/.claude/settings.json의 permissions.additionalDirectories에 넣고, 한 번만 쓸 폴더는 세션 안에서 /add-dir로 추가합니다. /add-dir는 그 세션에만 적용됩니다. 이렇게 추가한 폴더의 CLAUDE.md는 자동으로 읽히지 않으므로, 필요하면 직접 읽으라고 말합니다.
자료가 이미 많은 분류 폴더라면 위 2~4단계를 Claude Code에게 맡기는 편이 빠릅니다. 분류 폴더에서 세션을 열고, 3단계와 4단계의 예시를 함께 붙여 넣은 뒤 아래처럼 요청합니다.
이 폴더를 업무 workspace로 정리하려고 해. 위에 붙인 예시 구조를 따라 줘.
1. 하위 폴더를 훑어서 폴더마다 무엇이 들어 있는지 정리해 줘. 파일은 옮기거나 지우지 마.
2. 루트에 AGENTS.md를 만들고, CLAUDE.md는 AGENTS.md를 가리키는 심링크로 만들어 줘.
3. wiki/index.md, wiki/layout.md, wiki/conventions.md를 만들고, wiki/folders/index.md에 폴더 목록을 적어 줘.
4. 학기 폴더와 과목 폴더처럼 두 단계까지의 폴더마다 wiki/folders/<폴더>.md와 wiki/logs/<폴더>.md를 하나씩 만들어 줘.
5. 실제 자료 폴더 안에는 wiki, AGENTS.md, 로그 파일을 넣지 마.
6. 과목 폴더 경로를 인자로 받아, 그 폴더 구조가 wiki/layout.md 규칙을 지키는지,
wiki/folders/와 wiki/logs/에 문서가 있는지 검사하고 PASS나 FAIL을 출력하는 wiki/lint.py를 만들어 줘.
- 세션은 항상 분류 폴더에서 엽니다. Dropbox 최상위에서 열면 분류 폴더의 규칙이 세션을 시작할 때 들어가지 않습니다.
- 여러 분류에 걸친 일은 주가 되는 분류 폴더에서 열고, 다른 폴더의
AGENTS.md도 읽으라고 말합니다. 학회 발표 슬라이드에 원고 그림을 가져오는 일이라면학회에서 열고Manuscript/AGENTS.md를 읽게 합니다. - Claude가 틀리면 그 자리에서 "이걸 wiki 규칙으로 남겨"라고 합니다. 그래야 다음 세션에서 같은 실수가 줄어듭니다. 규칙은 자동 메모리보다 분류 폴더의 wiki에 적어야 다른 도구와 다른 세션도 같은 규칙을 읽습니다.
- 규칙 파일은 짧게 둡니다. 저는
CLAUDE.md는 5KB 안팎, 규칙 문서 하나는 40줄 안팎을 목표로 삼습니다. 자료 목록이 긴 폴더 설명 문서는 예외로 둡니다. 길어지면 문서를 쪼개기 전에 중복과 사례부터 지웁니다. - 같은 규칙을 두 문서에 적지 않습니다. 두 곳에 있으면 한쪽만 고쳐져서 서로 어긋납니다.
- 로그는 이력이고 규칙이 아닙니다. 현재 규칙은 wiki 문서에 두고, 로그에는 무엇을 했고 무엇을 확인했는지만 적습니다.
- 구조를 바꾼 뒤에는
lint.py를 돌려 실제 폴더와 wiki 문서가 맞는지 확인합니다. - 임시 파일과 변환 결과는 Dropbox 밖(예:
~/tmp/)에 만들게 합니다. 그래야 자료 폴더에 중간 파일이 쌓이지 않습니다. - Dropbox 온라인 전용 파일은 0바이트로 보일 수 있어서 Claude가 빈 파일로 오해할 수 있습니다. 자주 다루는 분류 폴더는 오프라인에서도 쓸 수 있게 내려받아 두고, wiki에 파일 크기만 보고 판단하지 말라고 적어 둡니다.
- 되돌리기는 Dropbox 버전 기록으로 충분하므로, 원고나 연구비 폴더에서는 git 명령을 쓰거나 제안하지 말라고 적어 둡니다.
- Claude Code가 읽은 파일 내용과 명령 출력은 Anthropic 서버로 전송됩니다. 개인 계정이라면 Claude 개인정보 설정에서 대화를 모델 학습에 쓰도록 허용했는지 확인합니다. 허용하면 Claude Code 대화도 학습에 쓰이고 더 오래 보관됩니다. 학생 개인정보, 성적, 심사 중인 원고가 든 폴더는 소속 기관의 규정을 먼저 확인합니다.
- 비밀번호와 API 키는 이 폴더들에 두지 않습니다.
- 규칙 문서의 지시는 강제 장치가 아닙니다. 파일 삭제처럼 되돌리기 어려운 명령은
~/.claude/settings.json의permissions에 있는ask목록에 삭제 명령을 넣어 항상 묻도록 설정해 둡니다.
한국어 문체 규칙을 매 세션 넣고 싶으면 ~/.claude/settings.json에 SessionStart hook을 걸어 규칙 파일을 출력하게 합니다. hook이 출력한 내용은 세션 맥락에 들어갑니다. 이미 settings.json이 있으면 hooks 항목만 합쳐 넣고, 파일 경로는 자기 문체 규칙 파일로 바꿉니다.
{
"hooks": {
"SessionStart": [
{ "hooks": [ { "type": "command", "command": "cat \"$HOME/Claude/wiki/writing-style.md\"" } ] }
]
}
}