AI가 알아서 찾는 작업 폴더 만들기: 프롬프트보다 오래 가는 폴더 설계

Claude Code나 Codex에 "지난주 상담 정리한 거 기준으로 제안서 초안 써 줘"라고 말했다고 해 볼게요. 폴더가 정리돼 있으면 AI는 날짜가 붙은 상담 폴더를 찾아 그 파일을 읽고 바로 초안을 씁니다. 파일이 바탕화면과 다운로드 폴더에 흩어져 있고 이름이 최종.docx, 최종2.docx라면 AI는 여기저기 열어 보다가 엉뚱한 파일을 기준으로 쓰거나 "어떤 파일을 말씀하시는 건가요?"라고 되묻습니다.

그래서 요즘은 프롬프트를 길게 다듬는 것보다 AI가 일하는 폴더를 잘 짜 두는 것이 더 오래 간다고 생각합니다. 요청문은 그 대화에서 끝나지만 폴더와 규칙 파일은 다음 대화에도, 다음 달에도 그대로 남거든요. 이 글에서는 폴더를 나누는 원칙, 규칙 파일에 폴더 지도를 적는 법, 빈 폴더에서 시작할 때 쓸 요청문, 세션을 마칠 때 점검할 질문 세 가지를 차례로 정리합니다.

프롬프트 요령보다 자료 위치가 중요해진 이유

한때 프롬프트 요령으로 "심호흡하고 차근차근 생각해", "이 일에 내 일자리가 걸렸어" 같은 문장을 붙이는 게 유행했습니다. 질문 한 번에 답 한 번을 받던 시절에는 문장 몇 개가 결과를 흔들 수 있었으니까요.

Claude Code와 Codex는 사정이 다릅니다. 둘 다 내가 열어 둔 폴더 안의 파일을 스스로 찾아 읽고 고칩니다. 결과를 좌우하는 건 요청문의 말투보다 AI가 무엇을 읽고 일을 시작하느냐예요. 이걸 요즘은 컨텍스트 엔지니어링이라고 부릅니다. 쉽게 말하면 AI가 볼 자료를 골라서 찾기 쉬운 곳에 두는 일입니다.

Anthropic은 컨텍스트 엔지니어링 글에서 이 흐름을 설명합니다. 프롬프트에 맞는 단어를 찾는 문제에서 어떤 맥락을 주면 원하는 결과가 나올지의 문제로 넘어가고 있다는 거예요. 같은 글은 폴더 구조, 이름 규칙, 타임스탬프가 사람과 에이전트 모두에게 "이 자료를 언제 어떻게 쓸지" 알려 주는 신호라고 적고 있습니다. 모든 자료를 미리 넣어 두기보다 파일 경로 같은 가벼운 단서만 들고 있다가 필요할 때 찾아 읽는 방식도 소개하고요. 이 글의 설명으로는 Claude Code가 두 방식을 섞어 씁니다. CLAUDE.md는 시작할 때 미리 넣고 나머지 파일은 그때그때 검색해서 찾아 읽는 식이에요.

비용 면에서도 폴더 정리가 중요합니다. AI가 읽은 파일은 모두 컨텍스트 윈도우를 차지해요. Claude Code의 컨텍스트 윈도우 문서도 파일 읽기가 컨텍스트를 가장 많이 쓴다고 짚으면서 요청을 구체적으로 해서 읽는 파일 수를 줄이라고 권합니다. 폴더가 정리돼 있으면 AI가 헤매며 열어 보는 파일도 줄어들 거라고 봅니다.

폴더 설계 원칙 다섯 가지

아래 원칙은 코딩 프로젝트가 아니어도 똑같이 적용됩니다. 예를 들어 1인 컨설턴트가 고객 상담과 제안서를 AI와 함께 만든다면 이런 모양이 될 수 있어요.

내-업무/
├── CLAUDE.md
├── AGENTS.md
├── 참고자료/                      # 읽기만 하는 자료
│   ├── 서비스-소개.md
│   ├── 가격표-2026-09.md
│   └── 제안서-샘플/
├── 고객/
│   ├── 가나다상사/
│   │   ├── 2026-09-18-상담정리.md
│   │   └── 2026-09-25-제안서-초안.md
│   └── 라마바스튜디오/
│       └── 2026-09-22-상담정리.md
└── 결과물/                        # AI가 새로 만든 파일
    └── 2026-09-25-월간-정리.md

1. 참고 자료와 작업 결과를 나눕니다

AI가 읽기만 할 자료와 AI가 새로 쓰는 파일을 다른 폴더에 둡니다. 서비스 소개, 가격표, 잘 쓴 제안서 샘플은 참고자료/에 넣고 AI가 만든 초안은 고객 폴더나 결과물/에 쌓는 식이에요. 섞여 있으면 AI가 예전에 자기가 쓴 초안을 원본처럼 참고하는 일이 생깁니다. 나중에 사람이 봐도 어떤 게 확정된 자료인지 헷갈리고요.

2. 폴더와 파일 이름은 날짜로 시작합니다

2026-09-25-상담정리.md처럼 연-월-일을 앞에 붙입니다. 이렇게 쓰면 이름순 정렬이 곧 시간순 정렬이 됩니다. "지난주 상담", "가장 최근 제안서" 같은 말을 AI가 파일 이름만 보고 알아들을 수 있어요. 최종, 진짜최종, 수정본 같은 이름은 AI에게 아무 정보도 주지 않습니다.

3. 한 고객, 한 프로젝트는 한 폴더에 둡니다

같은 고객의 상담 기록, 견적, 제안서, 받은 자료를 한 폴더에 모읍니다. "가나다상사 건 정리해 줘"라고 하면 AI는 그 폴더만 보면 되고 다른 고객 자료를 섞어 읽을 일이 줄어요. 고객이 늘면 폴더가 늘 뿐이지 구조는 그대로입니다.

4. 맨 위 폴더(루트)에 파일을 흩뿌리지 않습니다

작업 폴더를 열었을 때 맨 위에 보이는 파일은 규칙 파일 정도로 줄여 둡니다. 루트에 이것저것 쌓이면 AI가 폴더를 훑을 때마다 읽어 볼 후보가 늘어나고 사람도 어디에 뭐가 있는지 놓칩니다. 새 파일을 어디에 둘지는 도구가 정해 주지 않으니 규칙 파일에 저장 위치를 적어 두는 게 좋아요. 방법은 바로 다음 장에 있습니다.

5. 원본은 고치지 않고 새 파일로 저장합니다

상담 녹취 정리본이나 고객이 보낸 자료는 원본 그대로 둡니다. AI에게 요약하거나 고치게 할 때는 날짜를 붙인 새 파일로 저장하게 하세요. 결과가 마음에 안 들면 원본에서 다시 시작하면 되고 AI가 어떤 내용을 바꿨는지 비교하기도 쉽습니다.

규칙 파일에 폴더 지도를 적습니다

폴더를 잘 나눠도 AI가 그 의도까지 알지는 못합니다. 참고자료/가 읽기 전용이라는 것, 새 파일은 어디에 저장해야 하는지는 적어 줘야 해요. 이걸 적는 곳이 에이전트 메모리 파일입니다.

• Claude Code는 CLAUDE.md를 읽습니다. 공식 문서에 따르면 작업 폴더와 그 위 폴더들에 있는 CLAUDE.md를 세션을 시작할 때 불러옵니다. 하위 폴더의 CLAUDE.md는 처음부터 읽지 않고 AI가 그 폴더의 파일을 읽을 때 함께 불러와요. 파일 하나는 200줄 아래로 유지하라고 권합니다. 불러온 파일은 세션 안에서 /context를 실행하면 Memory files 목록에서 확인할 수 있습니다.
• Codex는 AGENTS.md를 읽습니다. 공식 문서에 따르면 Codex는 일을 시작하기 전에 전역 설정 폴더(기본값 ~/.codex)의 파일을 먼저 읽습니다. 그다음 프로젝트 루트(보통 Git 저장소의 맨 위)부터 지금 작업 중인 폴더까지 내려가며 폴더마다 AGENTS.md를 하나씩 읽어 이어 붙여요. 작업 폴더에 가까운 파일이 뒤에 붙어서 앞의 지침보다 우선합니다. 이어 붙인 크기가 기본 32KiB(project_doc_max_bytes 설정)에 닿으면 뒷부분이 빠질 수 있으니 지도는 짧게 둡니다. 주의할 점이 하나 있어요. Codex는 .git이 있는 폴더를 프로젝트 루트로 봅니다(고급 설정 문서). Git을 쓰지 않는 업무 폴더라면 지금 연 폴더의 AGENTS.md만 읽으니 Codex는 항상 맨 위 내-업무/ 폴더를 열어서 시작하세요.

두 도구를 다 쓴다면 파일 두 개에 같은 내용을 따로 적지 않아도 됩니다. Claude Code는 작업 폴더와 그 위 폴더에 CLAUDE.md가 하나도 없을 때 AGENTS.md를 대신 읽습니다(v2.1.277 이상). 두 파일을 같이 두면 기본 설정에서는 CLAUDE.md만 읽으니 CLAUDE.md 안에 아래 한 줄을 적어 AGENTS.md를 불러옵니다. 코드 표시(백틱)로 감싸면 가져오기가 되지 않으니 그대로 적습니다. 가져온 파일도 세션을 시작할 때 함께 읽힙니다.

@AGENTS.md

공통 내용은 AGENTS.md에 두고 CLAUDE.md에는 이 한 줄과 Claude 전용 내용만 두는 방법이 편해요. 저도 프로젝트마다 저장소 루트에 CLAUDE.md와 AGENTS.md를 함께 둡니다.

규칙 파일 전체를 잘 쓰는 법은 CLAUDE.md 작성법에 따로 정리했습니다. 여기서는 그중 폴더 지도 부분만 봅니다. 위 예시 폴더라면 이 정도면 충분해요.

## 폴더 지도

- `참고자료/`: 서비스 소개, 가격표, 제안서 샘플. 읽기만 한다. 수정하거나 새 파일을 만들지 않는다.
- `고객/<고객명>/`: 고객별 상담 기록과 제안서. 고객 한 명당 폴더 하나.
- `결과물/`: 특정 고객에 속하지 않는 정리·보고서.
- 파일 이름은 `YYYY-MM-DD-내용.md` 형식으로 쓴다. 예: `2026-09-25-제안서-초안.md`

## 저장 규칙

- 루트에 새 파일을 만들지 않는다. 어디에 둘지 애매하면 먼저 물어본다.
- 원본 파일은 고치지 않는다. 요약·수정본은 날짜를 붙인 새 파일로 저장한다.
- "지난번", "최근" 같은 말은 파일 이름의 날짜로 판단한다.
- 가격은 `참고자료/`에서 날짜가 가장 최근인 가격표를 기준으로 한다.

지도는 짧을수록 좋습니다. 폴더마다 한 줄이면 충분해요. 파일 목록까지 적으면 파일이 바뀔 때마다 지도가 틀어지고 AI는 어차피 폴더를 직접 볼 수 있습니다. 지도에는 폴더를 봐서는 알 수 없는 것, 그러니까 폴더의 용도와 지켜야 할 규칙만 적습니다.

자주 쓰는 자료는 폴더에 마크다운으로 저장합니다

Claude Code와 Codex는 MCP 커넥터나 웹 검색으로 바깥 자료를 가져올 수 있습니다. 편리하지만 매번 같은 자료를 가져오게 하면 그때마다 도구를 부르고 가져온 결과가 대화의 컨텍스트에 쌓입니다. Claude Code는 MCP 도구 결과가 1만 토큰을 넘으면 경고를 띄울 정도로 결과가 커지기도 해요(MCP 문서). 가격 정책, 서비스 설명, 자주 쓰는 공식 문서 요약처럼 자주 보고 잘 안 바뀌는 자료라면 한 번 가져와서 폴더에 마크다운으로 저장해 두는 편이 낫습니다.

• 필요한 부분만 정리해 두면 AI가 읽는 양이 줄어듭니다.
• 연결이 끊기거나 페이지 구조가 바뀌어도 작업이 멈추지 않습니다.
• 어떤 내용을 기준으로 삼았는지 파일로 남습니다.

대신 언제 가져온 자료인지 꼭 적어 두세요. 파일 이름에 날짜를 넣거나 파일 맨 위에 한 줄 적으면 됩니다.

# 서비스 가격표

갱신: 2026-09-25 (출처: 회사 홈페이지 가격 페이지)

그리고 규칙 파일에 "갱신일이 한 달 넘은 자료를 쓸 때는 먼저 알려 줘" 같은 줄을 넣어 두면 오래된 자료로 조용히 일하는 걸 막을 수 있습니다. 매일 바뀌는 매출 숫자나 재고처럼 최신값이 중요한 자료는 반대로 그때그때 가져오는 게 맞아요. 바깥 도구를 연결하는 방법은 API 키로 내 도구를 Claude Code·Codex에 연결하기에서 다룹니다.

저는 자료를 세 곳에 나눠 둡니다. 프로젝트 하나에만 필요한 규칙은 그 저장소 안 규칙 파일에 둡니다. 여러 프로젝트에 공통으로 쓰는 운영 지식은 프로젝트 밖의 별도 위키 폴더에 마크다운으로 모아 둡니다. 영상처럼 용량이 큰 조사 자료는 Git에 넣지 않는 별도 폴더에 둡니다. 이렇게 정해 두면 새 프로젝트의 규칙 파일에 "공통 운영 지식은 그 위키 폴더에 있다"고 위치만 적어 두면 됩니다. 다만 작업 폴더 밖이라 도구에 따라 그 폴더 접근을 따로 허용해야 합니다. Claude Code라면 --add-dir로 폴더를 추가하는 식이에요(메모리 문서).

빈 폴더에서 시작하는 요청문

처음부터 폴더 구조를 혼자 설계하기는 막막합니다. 이럴 때는 AI에게 먼저 내 일을 인터뷰하게 하세요. 빈 폴더를 Claude Code나 Codex로 열고 아래 요청문을 붙여 넣습니다.

이 폴더를 내 업무용 작업 폴더로 만들려고 해. 바로 파일을 만들지 말고 먼저 나를 인터뷰해 줘.

1. 내가 하는 일, 자주 만드는 결과물, 자주 참고하는 자료, 함께 일하는 고객이나 프로젝트 단위를 알 수 있게 질문을 한 번에 하나씩 해 줘. 질문은 7개 이내로.
2. 인터뷰가 끝나면 다음 원칙으로 폴더 구조를 제안해 줘.
   - 읽기만 하는 참고 자료 폴더와 작업 결과 폴더를 나눈다.
   - 고객이나 프로젝트 하나는 폴더 하나.
   - 파일 이름은 YYYY-MM-DD-내용 형식.
   - 루트에는 규칙 파일만 둔다.
3. 제안한 구조를 나무 모양으로 보여 주고 CLAUDE.md 초안도 같이 보여 줘. 폴더마다 용도 한 줄, 저장 규칙 몇 줄이면 충분해.
4. 내가 확인하기 전에는 폴더나 파일을 만들지 마.

Codex를 쓴다면 3번의 CLAUDE.md를 AGENTS.md로 바꾸면 됩니다. 두 도구 모두 /init 명령이 있습니다. Claude Code의 /init은 있는 파일을 훑어 CLAUDE.md 초안을 만들고(문서) Codex의 /init은 지금 폴더에 AGENTS.md 뼈대를 만듭니다(문서). 빈 업무 폴더에는 훑을 자료도 없고 내 일의 방식도 들어 있지 않으니 인터뷰로 시작하는 편이 낫다고 봐요.

구조를 받아들였다면 폴더를 만들고 자료를 옮긴 뒤 새 대화에서 이렇게 확인합니다.

질문하지 말고 이 폴더만 보고 내가 무슨 일을 하는지, 어떤 자료가 어디에 있는지, 새 파일은 어디에 저장해야 하는지 요약해 봐.

새 대화에서 해야 앞서 나눈 인터뷰 내용이 섞이지 않고 폴더와 규칙 파일만으로 전달되는지 볼 수 있습니다. 요약이 내 생각과 다르면 틀린 부분이 폴더 이름 때문인지 규칙 파일 때문인지 보고 그쪽을 고칩니다. 그다음 "가장 최근 상담 정리를 기준으로 제안서 초안 써 줘"처럼 대충 말한 요청을 하나 던져서 AI가 맞는 파일을 찾아가는지 보면 끝이에요.

세션 끝에 던질 세 질문

폴더와 규칙 파일은 한 번에 완성되지 않습니다. 일하다 보면 빈틈이 보이는데 그 신호를 놓치지 않는 게 중요해요. 작업을 마칠 때 스스로 세 가지만 물어보세요.

1. 같은 설명을 또 했나? "우리 제안서는 세 쪽을 넘기지 않아"를 대화마다 말하고 있다면 규칙 파일로 옮길 때입니다.
2. 같은 파일을 매번 직접 건넸나? 가격표를 매번 첨부하거나 경로를 불러 줬다면 그 파일에 정해진 자리를 주고 지도에 적습니다.
3. 같은 실수가 반복됐나? 규칙을 적었는데도 계속 루트에 파일을 만든다면 규칙이 애매하거나 파일이 너무 길어서 묻혔을 수 있어요. Claude Code의 모범 사례 문서도 규칙이 있는데 계속 어긴다면 파일이 너무 길어 그 규칙이 묻힌 것일 수 있다고 설명합니다. 줄을 더 보태기보다 먼저 문장을 고치거나 필요 없는 줄을 지워 보세요.

세 질문을 AI에게 대신 던져도 됩니다. 세션 끝에 "이번 대화에서 내가 반복해서 설명한 것, 매번 직접 알려 준 파일, 네가 반복한 실수를 찾아서 규칙 파일이나 폴더 구조를 어떻게 고치면 좋을지 제안해 줘. 바로 고치지는 말고"라고 요청하면 후보를 모아 줍니다. 반영할지는 직접 보고 정하세요. 절차가 길어서 규칙 파일 몇 줄로 담기 어려운 일은 긴 작업을 스킬로 쪼개기처럼 따로 떼어 내는 편이 낫습니다.

정리

요청문은 그 대화에서 끝나지만 폴더와 규칙 파일은 계속 남습니다. 공을 들일 곳은 폴더 쪽이에요. 참고 자료와 작업 결과는 다른 폴더에 두고 이름은 날짜로 시작합니다. 한 고객이나 프로젝트는 한 폴더에 모으고 루트는 비우고 원본은 고치지 않습니다. CLAUDE.md나 AGENTS.md에는 폴더 용도와 저장 규칙만 짧게 적고 자주 쓰는 바깥 자료는 날짜를 붙여 마크다운으로 저장해 둡니다. 빈 폴더라면 인터뷰로 시작하고 새 대화에서 "이 폴더만 보고 요약해 봐"로 확인하면 됩니다.

함께 읽으면 좋은 글

• CLAUDE.md 작성법: 프로젝트 규칙을 한 페이지로
• 긴 작업을 스킬로 쪼개기: 사람 확인 지점을 넣는 기준 세 가지
• API 키로 내 도구를 Claude Code·Codex에 연결하기
• Claude Code 비용 줄이는 7가지: 컨텍스트·모델·캐시

출처와 확인 (2026-09-25)

• Effective context engineering for AI agents (Anthropic, 컨텍스트 엔지니어링 정의, 폴더 구조·이름 규칙·타임스탬프가 주는 신호, 필요할 때 찾아 읽는 방식과 Claude Code의 혼합 방식)
• How Claude remembers your project (CLAUDE.md 불러오는 위치와 순서, 200줄 권장, @ 가져오기와 백틱 예외, AGENTS.md 읽는 조건, /init, /context, --add-dir)
• Best practices for Claude Code (규칙 파일이 길면 규칙이 묻힘)
• Explore the context window (파일 읽기가 컨텍스트를 가장 많이 씀)
• Custom instructions with AGENTS.md (Codex의 AGENTS.md 탐색 순서, 우선순위, 32KiB 기본 한도)
• Advanced configuration (Codex 프로젝트 루트 기본값 .git, project_doc_max_bytes)
• Connect Claude Code to tools via MCP (MCP 출력 1만 토큰 경고)
• Developer commands (Codex /init은 현재 폴더에 AGENTS.md 뼈대 생성)