- 2026.11.01 에이전트가 잊지 않게 하는 메모리 파일: 75개 중 다시 말할 일이 없어진 유형 5개
- 2026.10.31 대화가 길어지면 새 세션으로 갈아탑니다: HANDOFF.md 네 제목과 300K 기준
- 2026.10.30 AI 지시 파일, 전역 한 장·프로젝트 한 장으로 나눕니다 지금 보는 글
- 2026.10.28 AI 하나에 다 맡기지 않습니다: 설계·구현·검수 나누기
- 2026.10.11 반을 옮겼더니 지난달 성적표가 바뀌었다? 학원 프로그램이 꼬이는 진짜 이유
- 2026.10.10 문항 하나가 출고되기까지, 실제 입력과 출력
- 2026.09.29 아직도 시트에 적고, 카톡에 또 복사해 붙이세요?
- 2026.09.27 AI에게는 쓰는 일만 맡깁니다
- 2026.08.15 JSON으로 옮겼는데, 내일 교재는 어떻게 만드나
- 2026.08.15 공들여 만든 문제, 다시 쓰기 어려운 이유
AI 지시 파일, 전역 한 장·프로젝트 한 장으로 나눕니다
6월 전역 지시 파일 65줄은 전부 남의 플러그인 설명이었습니다. 지금은 33줄. 실제 파일 두 장과 복붙 템플릿을 공개합니다.
6월 11일의 제 전역 지시 파일은 65줄이었고, 그 65줄이 전부 설치한 플러그인의 설명서였습니다. 지금은 33줄이고 전부 제가 쓴 규칙입니다.
3줄 요약
- 전역 한 장: 모든 프로젝트에 공통인 일하는 방식만 → 제 파일 33줄
- 프로젝트 한 장: 그 저장소의 명령·금지·완료 조건 → 블로그 저장소 19줄
- 길이: 공식 권장은 200줄 이하, 실제로는 줄 수보다 글자 수를 봅니다
AI 코딩 도구는 일을 시작할 때마다 지시 파일부터 읽습니다. 이 파일을 어디에 몇 장, 얼마나 길게 두는지가 매일 결과를 바꿉니다.

지시 파일은 Claude CodeClaude Code 클로드 코드 Anthropic의 코딩용 AI 도구. 내 컴퓨터의 파일을 직접 읽고 고칩니다.눌러서 용어 설명서 보기 →에서는 CLAUDE.md, CodexCodex 코덱스 OpenAI의 코딩용 AI 도구. 터미널에서 코드를 읽고 고치는 일을 맡깁니다.눌러서 용어 설명서 보기 →에서는 AGENTS.md라는 이름의 글자 파일입니다. 이 글의 줄 수·글자 수·날짜는 10월 29일에 제 컴퓨터의 실제 파일과 백업, 커밋커밋 commit 고친 파일들을 한 단위로 묶어 변경 기록에 남기는 일.눌러서 용어 설명서 보기 → 기록에서 센 값입니다.
처음이라면 프로젝트 한 장부터 만듭니다
지시 파일이 아직 없다면 전역 파일보다 지금 작업하는 폴더의 한 장이 먼저입니다. 그 폴더에서 매번 반복해서 말하는 것부터 적게 됩니다.

위 그림은 이 블로그 저장소의 실제 AGENTS.md를 찍은 발췌 화면입니다. 개인 경로와 내부 주소를 가리고, 긴 줄은 앞부분만 실었습니다.
처음 만들 때는 직접 쓰지 말고 AI에게 초안을 시키는 편이 빠릅니다. 작업 폴더에서 Claude Code나 Codex를 열고 아래를 그대로 붙여 넣으세요.
이 폴더를 읽고 AGENTS.md 초안을 만들어 줘. 조건:
- 30줄 이하, 한 줄에 규칙 하나.
- 넣을 것: 실행·검사·배포 명령(package.json이나 README에서 실제로 확인한 것만),
건드리면 안 되는 파일·폴더, "끝났다"를 판정하는 명령과 그 결과.
- 넣지 말 것: 비밀 키·토큰·비밀번호, 코드 구조 설명, 이 폴더와 상관없는 내 습관.
- 확인하지 못한 명령은 지어내지 말고 "확인 필요"라고 표시.
- 파일을 바로 쓰지 말고 초안을 먼저 보여 줘.
초안이 나오면 세 가지만 확인합니다.
- 명령이 실제로 돌아가는지 → 한 번씩 직접 실행해 봅니다.
- “확인 필요” 줄 → 내가 아는 답으로 바꾸거나 지웁니다.
- 30줄을 넘었는지 → 넘으면 설명 문장부터 지웁니다.
Claude Code에는 /init이라는 초안 명령도 있습니다. 다만 코드 구조 설명이 길게 붙는 경우가 많아서, 저는 위처럼 “넣지 말 것”을 같이 주는 쪽을 씁니다.
파일을 저장한 뒤에는 정말 읽히는지 확인합니다. Claude Code에서는 새 대화를 열고 /context를 입력하면 시작할 때 불러온 지시 파일 목록이 나옵니다.
저장 위치도 확인합니다. 저장소 맨 위에 두면 어느 하위 폴더에서 열어도 읽히지만, 하위 폴더에만 두면 그 폴더에서 작업할 때만 읽힙니다.
두 장은 읽히는 때가 다릅니다
전역 파일은 어느 폴더에서 열든 항상 읽히고, 프로젝트 파일은 그 저장소에서 작업할 때만 읽힙니다. 그래서 전역에는 모든 프로젝트에 맞는 말만 남습니다.
세부 시점은 도구마다 다릅니다. Codex는 시작할 때 저장소 맨 위부터 지금 폴더까지의 파일을 모으고, Claude Code는 시작할 때 위쪽 파일을 읽은 뒤 작업 중에 하위 폴더 파일을 더 읽습니다.

두 도구의 공식 문서를 10월 29일에 다시 확인했습니다.
| Claude Code | Codex | |
|---|---|---|
| 전역 파일 | ~/.claude/CLAUDE.md | ~/.codex/AGENTS.md |
| 프로젝트 파일 | 폴더의 CLAUDE.md. 현재·위 폴더에 CLAUDE.md·.claude/CLAUDE.md·CLAUDE.local.md가 모두 없을 때만 AGENTS.md(전역 파일은 제외) | 폴더의 AGENTS.md |
| 여러 장일 때 | 위 폴더부터 아래로 이어 붙임 | 저장소 맨 위부터 아래로 이어 붙임 |
| 길이 기준 | 파일당 200줄 이하 권장 | 프로젝트 파일 합계 기본 32KiB에서 더 읽지 않음(설정으로 변경 가능) |
덮어쓰는 게 아니라 이어 붙인다는 점이 중요합니다. 전역에 “배포배포 deploy 만든 프로그램을 다른 사람이 쓸 수 있게 인터넷에 올리는 일.눌러서 용어 설명서 보기 →는 이렇게”라고 적으면 배포가 없는 프로젝트에서도 그 줄을 매번 읽습니다.
Claude Code 문서에는 이렇게 적혀 있습니다. 지시 파일은 강제 설정이 아니라 맥락으로 다뤄지고, 짧고 구체적일수록 더 꾸준히 따른다는 내용입니다.
이 글 원고를 만든 세션에서도 그대로였습니다. 블로그 저장소에는 CLAUDE.md가 없어서 AGENTS.md가 읽혔고, 전역 파일은 그 앞에 붙어 있었습니다.
전역 파일이 65줄에서 33줄이 되기까지
전역 파일이 길었던 이유는 제 규칙이 많아서가 아니었습니다. 설치한 도구가 자기 설명을 통째로 넣어 두었기 때문입니다.

제 컴퓨터에는 전역 파일 백업이 다섯 개 남아 있습니다. 지금 파일까지 여섯 시점을 세면 이렇습니다.
| 시점 | 줄 | 글자 | 내용 |
|---|---|---|---|
| 6월 11일 | 65 | 3,530 | 전부 멀티 에이전트에이전트 agent 목표를 주면 파일을 읽고 고치고 실행하는 일까지 스스로 이어 가는 AI 도구.눌러서 용어 설명서 보기 → 플러그인이 넣은 블록 |
| 6월 30일 | 64 | 3,529 | 같은 블록 |
| 10월 11일 | 26 | 2,658 | 제 작업 규칙 + 모델모델 model AI의 '두뇌' 하나하나를 부르는 말. 같은 회사도 크기·성능별로 여러 모델을 냅니다.눌러서 용어 설명서 보기 → 배정 + 보고 규칙 |
| 10월 12일 | 28 | 3,278 | 위키·도구 지도 두 줄 추가 |
| 10월 12일 | 30 | 3,334 | 같은 날 다시 백업 |
| 10월 28일 | 33 | 4,796 | 취향 파일·세션 교대·설계 분리 추가 |
6월 파일은 처음부터 끝까지 OMC:START와 OMC:END 사이에 있었습니다. 그 안에는 제가 쓴 적 없는 단어 신호가 열 개 넘게 들어 있었습니다.
"autopilot"이라고 쓰면 자동 진행 모드"ralph"라고 쓰면 끝날 때까지 반복하는 모드"tdd","deepsearch","ultrathink"같은 단어마다 다른 모드
평소 말에 그 단어가 섞이면 의도하지 않은 모드로 들어갈 수 있는 구조였습니다. 그 플러그인은 7월 23일에 운영에서 걷어 냈습니다.

10월 11일 백업에는 제 규칙 26줄만 남아 있습니다. 그 뒤에 늘어난 줄은 줄 안에 목적이 적혀 있습니다.
- 10월 12일: 그림·화면·보고 작업은 도구 지도를 먼저 보라는 줄 → 이미 있는 도구를 두고 새로 만드는 일을 줄이려고
- 10월 12일~28일 사이: 세션 교대 줄 → 대화가 길어지면 스스로 인계하고 새로 시작하게
- 10월 12일~28일 사이: 설계는 구현 담당에게 넘기지 않는다는 줄 → 넘기는 명세에는 모양과 구조까지 정해 두게
지금 전역 파일은 세 칸입니다
33줄은 작업 규칙, 모델 배정, 보고 규칙 세 칸으로 나뉩니다. 칸마다 시작과 끝 표시가 있어서 어느 칸을 누가 고치는지 정해져 있습니다.

| 칸 | 크기 | 들어 있는 것 |
|---|---|---|
| 작업 규칙 | 12항목, 2,369자 | 묻는 범위, 다른 프로젝트 기록 금지, 검증, 답하는 말투 |
| 모델 배정 | 1,534자 | 설계·구현·검수를 어느 역할에 보내는지 |
| 보고 규칙 | 722자 | 보고서를 언제 만들고 어디에 올리는지 |
칸 표시는 <!-- WORKING-RULES:START --> 같은 HTMLHTML 에이치티엠엘 웹페이지의 내용과 배치를 적는 기본 문서 형식.눌러서 용어 설명서 보기 → 주석입니다. Claude Code 문서에 따르면 이런 주석 줄은 AI에게 넘기기 전에 빠집니다.
사람과 스크립트만 보는 표시라서 AI가 읽는 분량에는 들어가지 않습니다. 이 글을 만든 세션에 들어간 전역 파일에도 주석 줄은 없었고, 주석을 빼고 세면 4,491자입니다.
작업 규칙 12항목에는 공통점이 있습니다. 모든 프로젝트에 맞는 말이거나, “이 일을 할 때만 이 문서를 읽어라”라는 길 안내입니다.
- User requests authorize scoped work; do not ask twice.
Confirm destructive or external actions outside that scope.
- Reuse tools, not project context. New project: new session.
- For harness changes only, follow ~/…/agentic-harness-core.md
- For Gemma, JEV or OpenJEV requests only, read the matching entry in
~/…/development-tools.json; do not import the entire tool library.
- Session lifetime: … roll over exactly as ~/…/README.md says;
that file is the only source for this procedure.
- Reply in concise Korean. Store project decisions in that project.
only가 붙은 줄이 길 안내입니다. 세션 교대 절차는 여러 단계짜리지만 전역 파일에는 “그 README가 유일한 정본”이라는 한 줄만 둡니다. 절차를 복사해 두면 두 곳이 서로 달라지는 날이 옵니다.
취향 파일도 같은 방식입니다. 제가 남긴 피드백을 모아 만든 30줄짜리 파일을 @ 한 줄로 불러오고, 앞에 “힌트일 뿐 권한이 아니다, 지금 지시가 이긴다”를 붙였습니다.
전역 파일에는 규칙과 길 안내만 둡니다. 절차·목록·설명은 다른 파일에 두고 “이 일을 할 때만 읽어라” 한 줄로 연결합니다.
프로젝트 파일은 사고가 날 때마다 한 줄씩 늘었습니다
블로그 저장소의 AGENTS.md는 10월 5일 8줄로 시작해 3주 동안 커밋 12번을 거쳐 19줄이 됐습니다. 줄마다 생긴 날짜와 이유가 커밋 기록에 남아 있습니다.

첫 8줄은 사고 하나에서 나왔습니다. 10월 5일에 확인해 보니 운영 중인 블로그와 저장소의 마지막 커밋이 서로 달랐습니다.
- 최신 작업이 커밋되지 않은 채 남아 있었고, 그 상태로 배포된 적이 있었습니다.
- 운영 사이트에 표시된 출처는 옛 커밋이어서 표시만 보고는 실제 내용을 알 수 없었습니다.
- 따로 만든 작업 폴더의 브랜치도 여러 개라, 어느 쪽이 최신인지 날짜로는 판단할 수 없었습니다.
그래서 기존 파일 936개를 백업하고 아래 배포 기준을 적었습니다. 그다음 운영 블로그의 공개 파일 604개를 하나씩 대조해 저장소와 같은지 확인했습니다.
- 기본 작업 폴더와 배포 정본은 (이 폴더)의 main이다.
사용자 요청 없이 이 폴더의 브랜치를 전환하지 않는다.
- 별도 작업 폴더의 브랜치는 검토용이다. 날짜나 커밋 순서만으로
최신이라고 판단하지 않는다.
- 운영 배포는 main에서 검증·커밋한 뒤 npm run deploy로 새로 빌드한다.
다른 작업 폴더나 기존 빌드 폴더에서 직접 배포하지 않는다.
그 뒤 커밋마다 규칙을 추가하거나 기존 문장을 고쳤습니다. 주요 변경만 추렸습니다.
| 날짜 | 추가·변경된 줄 | 커밋·기록에 남은 설명 |
|---|---|---|
| 10월 9일 | 외부 계정에 올리기 전 채널 장부 확인 | 게시 전 장부 확인과 공용 일정표 기록 |
| 10월 9일 | 보여 주는 화면은 대시보드대시보드 dashboard 여러 숫자와 상태를 한 화면에 모아 보여 주는 관리 화면.눌러서 용어 설명서 보기 → 하나 | 같은 날 “개별 화면 중지”로 적었다가 “다시 켬”으로 고침 |
| 10월 11일 | 조사 전에 지식 위키부터 검색 | 검색 → 반영 → 새로 안 것 돌려보내기 |
| 10월 20일 | 완료 기준: 범위와 끝 조건 한 줄, 빌드빌드 build 작성한 코드를 실제로 열어 쓸 수 있는 파일 묶음으로 바꾸는 작업.눌러서 용어 설명서 보기 → 뒤 검사 오류 0 | 하네스 정비 2차, 그날 승인 |
| 10월 21일 | 모든 외부 게시는 전문을 보여 주고 승인 뒤에만 | 통지 후 자동 공개 방식 폐지 |
| 10월 26일 | 보여 주기 전에 다른 모델 검수 | 제 피드백을 모으는 에이전트의 요청 |
10월 9일 줄은 하루 만에 바뀌었습니다. 처음엔 “개별 화면 제공 중지”였다가 같은 날 “대시보드를 다시 켠다”로 고쳤습니다.
이때 새 줄을 덧붙이지 않고 그 줄 자체를 고쳤습니다. 서로 반대인 두 줄이 같이 남으면 AI가 어느 쪽을 따를지 알 수 없습니다.
문장은 부탁이고, 막는 건 스크립트입니다
지시 파일에 “main에서만 배포한다”라고 적어도 그것만으로 막히지는 않습니다. 그래서 같은 날 배포 스크립트에도 같은 조건을 넣었습니다.

10월 5일 결정 기록에 남은 두 장치입니다.
- 지시 파일 → “기본 폴더의 main에서, 커밋한 뒤에 배포한다”
- 배포 도우미 → 기본 폴더의 main이 아니거나 커밋하지 않은 변경이 있으면 인증·업로드 전에 거부
문장은 AI가 판단할 때 쓰는 기준이고, 스크립트는 판단이 틀려도 막는 벽입니다. 되돌리기 어려운 일, 예를 들어 운영 배포·외부 게시·결제는 둘 다 둡니다.
Claude Code 문서도 같은 쪽을 가리킵니다. 어떤 경우에도 막아야 하는 행동은 지시 파일이 아니라 도구 실행 전에 끼어드는 훅(hook)으로 막으라고 안내합니다.
반대로 모든 줄에 잠금을 걸지는 않습니다. “답은 한국어로 짧게” 같은 줄은 어겨도 되돌릴 수 있어서 문장으로만 둡니다.
길이는 줄 수보다 글자 수를 봅니다
줄 수만 세면 긴 파일을 놓칩니다. 제 에이전트 지시 파일 중 하나는 49줄인데 글자는 10,361자였습니다.

10월 29일에 제가 쓰는 에이전트 저장소의 지시 파일을 셌습니다. 글자 수는 공백과 줄바꿈까지 센 값입니다.
| 파일 | 줄 | 글자 |
|---|---|---|
| 블로그 저장소 | 19 | 2,675 |
| 전역(Claude Code) | 33 | 4,796 |
| 위키 에이전트 | 43 | 3,257 |
| 빌더 에이전트 | 44 | 7,039 |
| 세션 관리 에이전트 | 49 | 10,361 |
| 화면 설계 에이전트 | 151 | 14,330 |
| 강의 앱 에이전트 | 198 | 10,686 |
세션 관리 에이전트 파일은 가장 긴 줄 하나가 1,307자였습니다. 줄 수로는 200줄 권장보다 한참 짧지만, 읽는 양은 강의 앱 198줄과 비슷합니다.
Codex의 기본 한도 32KiB는 글자가 아니라 바이트 기준입니다. 한글은 한 글자가 보통 3바이트라서 같은 글자 수라도 영어보다 빨리 찹니다.
- 세션 관리 에이전트 파일: 10,361자 → 20,582바이트
- Codex 기본 한도 32,768바이트의 약 63%
제가 템플릿에 적어 둔 상한은 이렇습니다. 지금 전역·블로그 파일이 이 안에 들어가는 크기입니다.
| 줄 | 글자 | 한 줄 | |
|---|---|---|---|
| 전역 파일 | 40줄 이하 | 5,000자 이하 | 규칙 하나 |
| 프로젝트 파일 | 30줄 이하 | 4,000자 이하 | 규칙 하나 |
넘으면 지울 순서도 정해 두었습니다. 설명 문장 → 다른 문서에 이미 있는 절차 → 끝난 일의 이력 순서입니다.
같은 규칙을 여러 도구에 넣을 때는 복사를 스크립트에 맡깁니다
보고 규칙 칸은 제가 직접 고치지 않습니다. 동기화 스크립트가 일곱 개 도구의 전역 파일에 이 칸을 써 넣습니다.

저는 Claude Code 말고도 Codex 계열과 OpenCode 등 여러 도구를 같이 씁니다. 같은 보고 규칙을 손으로 일곱 군데에 고치면 언젠가 한 곳이 빠집니다.
칸 문구는 스크립트 안에 있습니다. 여섯 곳에는 같은 짧은 문구를, 한 곳(GJC)에는 예전 긴 문구를 넣습니다.
대신 칸 머리에 보고 기준 원본 문서의 판 번호와 지문(파일 내용으로 만든 고유 값)을 적습니다. 원본이 바뀌면 칸이 낡았다는 걸 알 수 있게 하려는 장치입니다.
<!-- AGENT-REPORTING:START -->
<!-- AGENT-REPORTING:VERSION:24 -->
<!-- AGENT-REPORTING:SHA256:c0466bc8… -->
## Reports
Report when the reader must compare, decide, or look up numbers …
<!-- AGENT-REPORTING:END -->
이 글을 쓰면서 검사 명령(--check)을 돌려 봤더니 일곱 곳이 모두 “낡음”으로 나왔습니다. 원본 문서가 10월 24일에 고쳐졌는데 판 번호는 24 그대로여서, 지문만 달라진 상태였습니다.
- 판 번호만 비교했다면 → 이번 원본 변경을 놓쳤을 것입니다.
- 지문까지 비교해서 → 명령 한 번으로 일곱 곳이 한꺼번에 드러났습니다.
다시 맞추는 일은 그 원본을 관리하는 쪽에서 하고, 이 글에서는 검사 결과만 그대로 적습니다.
도구를 한두 개만 쓴다면 이 장치는 필요 없습니다. 두 도구라면 Claude Code 쪽 CLAUDE.md에 @AGENTS.md 한 줄을 적어 한 파일을 같이 읽게 하는 방법이 더 간단합니다. 불러온 파일도 같이 읽히니 길이 상한은 두 파일을 합쳐서 봅니다.
지시 파일에 넣지 않는 것
넣지 않을 목록을 정해 두면 파일이 다시 길어지지 않습니다. 아래는 지금 제 파일 두 장에서 빼 둔 것들입니다.

| 넣지 않는 것 | 대신 두는 곳 | 이유 |
|---|---|---|
| 비밀 키·토큰토큰 token AI가 글을 세는 단위로, 요금도 토큰 수로 매깁니다. 로그인 글에서는 접속을 증명하는 출입증을 뜻합니다.눌러서 용어 설명서 보기 →·비밀번호 | 각 도구의 로그인 저장소 | 지시 파일은 대화와 기록에 그대로 실림 |
| 다른 프로젝트의 명령 | 그 프로젝트의 지시 파일 | 전역은 모든 폴더에서 읽힘 |
| 여러 단계짜리 절차 | 별도 문서, 지시 파일엔 경로 한 줄 | 두 곳에 두면 서로 달라짐 |
| 왜 그렇게 정했는지 긴 사연 | 결정 기록(docs/decisions/) | 규칙만 읽히면 됨 |
| 스크립트 안의 모델 이름 | 역할 배정 설정 파일 한 곳 | 모델이 바뀌면 한 곳만 고침 |
| 꼭 막아야 하는 행동의 유일한 장치 | 훅·배포 스크립트 | 문장은 부탁일 뿐 |
| 설치한 도구가 넣은 설명서 | 그 도구의 문서 | 지운 뒤에도 남아 매일 읽힘 |
| 끝난 일의 진행 상황 | 인계 파일·대시보드 | 오늘 상태는 내일 틀림 |
모델 이름을 역할 이름으로 부르는 방식은 AI 하나에 다 맡기지 않습니다에 설정 파일째로 적어 두었습니다.
바로 쓰는 템플릿 두 장
아래 두 장을 복사해 빈칸만 채우면 됩니다. 제 파일에서 개인 도구 이름을 빼고 뼈대만 남겼습니다.

전역 파일(~/.claude/CLAUDE.md 또는 ~/.codex/AGENTS.md)입니다.
# 작업 규칙 (모든 프로젝트 공통, 40줄·5,000자 이하)
- 요청한 범위 안의 일은 다시 묻지 않는다. 범위 밖의 삭제·외부 게시·결제는 먼저 묻는다.
- 다른 프로젝트의 기록·메모리를 가져오지 않는다. 새 프로젝트는 새 대화로 시작한다.
- 내가 고친 내용과 로그인 정보를 보존한다. 비밀 키를 복사하거나 출력하지 않는다.
- 이미 있는 도구·함수를 먼저 쓴다. 바꾼 뒤 좁은 검사로 확인하고, 못 한 검사는 말한다.
- "끝났다"는 실제 실행 결과로 말한다. 결과 없이 완료라고 하지 않는다.
- [특정 작업]을 할 때만 [문서 경로]를 읽는다. ← 길 안내는 이 모양으로
- 답은 [언어]로 짧게. 프로젝트 결정은 그 프로젝트 안에 기록한다.
프로젝트 파일(저장소 맨 위의 AGENTS.md)입니다. Claude Code만 쓴다면 이름을 CLAUDE.md로 해도 되고, 두 도구를 같이 쓴다면 AGENTS.md를 정본으로 두고 CLAUDE.md에는 @AGENTS.md 한 줄만 적습니다.
# 이 저장소의 작업 기준 (30줄·4,000자 이하)
- 정본: 기본 폴더 [경로]의 [브랜치]. 요청 없이 브랜치를 바꾸지 않는다.
- 명령: 개발 [명령] / 검사 [명령] / 배포 [명령] (배포는 커밋한 뒤에만).
- 완료 조건: [명령]을 돌려 [결과]가 나오면 끝. 명령과 결과 숫자를 보고에 남긴다.
- 건드리지 않는 것: [파일·폴더]. 이유는 docs/decisions/[날짜-제목].md
- 밖으로 나가는 일(게시·메일·운영 배포)은 [누구] 승인 뒤에만 한다.
- 판단과 검증 결과는 docs/decisions/에 날짜 이름으로 남긴다.
두 장 모두 내려받기용 파일로도 올려 두었습니다. 파일 아래쪽에 “넣지 않는 것” 표도 같이 들어 있습니다.
이미 쓰고 있다면 이 순서로 줄입니다
지시 파일이 이미 있다면 새로 쓰기보다 세 번 세는 쪽이 빠릅니다. 줄 수, 글자 수, 가장 긴 한 줄입니다.
# 줄 수·글자 수·바이트 수 (글자 수는 UTF-8 환경에서 한글도 1자로 셈)
wc -l -m -c ~/.claude/CLAUDE.md AGENTS.md CLAUDE.md 2>/dev/null
# 300자 넘는 줄 찾기(파일 줄번호 길이)
python3 -c 'import sys
for f in sys.argv[1:]:
for n, l in enumerate(open(f, encoding="utf-8"), 1):
if len(l.rstrip()) > 300: print(f, n, len(l.rstrip()))' AGENTS.md
센 다음에는 이렇게 정리합니다.
- 전역 파일에서 특정 프로젝트 이름이 나오는 줄 → 그 프로젝트 파일로 옮깁니다.
- 300자 넘는 줄 → 절차라면 별도 문서로 빼고 “이 일을 할 때만 읽어라” 한 줄을 남깁니다.
- 서로 반대인 두 줄 → 오래된 줄을 지웁니다. 새 줄을 덧붙이지 않습니다.
- 설치한 도구가 넣은 블록 → 그 도구를 아직 쓰는지 확인하고, 안 쓰면 블록째 지웁니다.
- 되돌릴 수 없는 일에 관한 줄 → 스크립트나 훅에도 같은 조건이 있는지 봅니다.
제 경우 4번에서 가장 많이 줄었습니다. 65줄이 통째로 남의 설명서였으니까요.
정리한 뒤에는 새 대화를 열어 평소 하던 일을 하나 시켜 봅니다. 지운 줄 때문에 빠진 규칙이 있으면 그 자리에서 드러납니다. 같은 지적을 두 번 하게 되면 그때 한 줄을 다시 넣습니다.
해 볼 것
지금 작업하는 폴더에서 맨 위의 복붙 지시문 하나만 실행해 보세요. AI가 보여 주는 초안에서 “확인 필요” 줄만 채우면 첫 프로젝트 지시 파일이 생깁니다.
이미 전역 파일이 있다면 wc -l -m ~/.claude/CLAUDE.md 한 줄로 줄 수와 글자 수부터 세 보세요. 줄 수와 글자 수가 생각과 다르면 그 파일에 무엇이 들어 있는지 열어 볼 차례입니다.
무료 도구
영어 수업에 필요한 자료, 무료 도구로 직접 만들어 보세요
단어 시험지·지문 분석·변형문제·문항 검사 도구를 한곳에서 고를 수 있습니다.
무료 도구 열기 →새 글 소식
새 글이 나오면 메일로 알려 드립니다.
새 글 주소와 한 줄 요약만 보냅니다. 광고는 보내지 않습니다.
- 2026.11.01 에이전트가 잊지 않게 하는 메모리 파일: 75개 중 다시 말할 일이 없어진 유형 5개
- 2026.10.31 대화가 길어지면 새 세션으로 갈아탑니다: HANDOFF.md 네 제목과 300K 기준
- 2026.10.30 AI 지시 파일, 전역 한 장·프로젝트 한 장으로 나눕니다 지금 보는 글
- 2026.10.28 AI 하나에 다 맡기지 않습니다: 설계·구현·검수 나누기
- 2026.10.11 반을 옮겼더니 지난달 성적표가 바뀌었다? 학원 프로그램이 꼬이는 진짜 이유
- 2026.10.10 문항 하나가 출고되기까지, 실제 입력과 출력
- 2026.09.29 아직도 시트에 적고, 카톡에 또 복사해 붙이세요?
- 2026.09.27 AI에게는 쓰는 일만 맡깁니다
- 2026.08.15 JSON으로 옮겼는데, 내일 교재는 어떻게 만드나
- 2026.08.15 공들여 만든 문제, 다시 쓰기 어려운 이유