# AI 지시 파일 템플릿 두 장 (해민웨이)

출처: https://haeminway.com/ko/tech/claude-md-instruction-file
대괄호 [ ] 안만 내 내용으로 바꿔 쓰세요. 한 줄에 규칙 하나.

---

## 1. 전역 파일

저장 위치: Claude Code `~/.claude/CLAUDE.md` · Codex `~/.codex/AGENTS.md`
상한: 40줄 · 5,000자 이하

```markdown
# 작업 규칙 (모든 프로젝트 공통)

- 요청한 범위 안의 일은 다시 묻지 않는다. 범위 밖의 삭제·외부 게시·결제는 먼저 묻는다.
- 다른 프로젝트의 기록·메모리를 가져오지 않는다. 새 프로젝트는 새 대화로 시작한다.
- 내가 고친 내용과 로그인 정보를 보존한다. 비밀 키를 복사하거나 출력하지 않는다.
- 이미 있는 도구·함수를 먼저 쓴다. 바꾼 뒤 좁은 검사로 확인하고, 못 한 검사는 말한다.
- "끝났다"는 실제 실행 결과로 말한다. 결과 없이 완료라고 하지 않는다.
- [특정 작업]을 할 때만 [문서 경로]를 읽는다.
- 답은 [언어]로 짧게. 프로젝트 결정은 그 프로젝트 안에 기록한다.
```

---

## 2. 프로젝트 파일

저장 위치: Codex는 저장소 맨 위의 `AGENTS.md`를 쓰세요. Claude Code만 쓴다면 `CLAUDE.md`를 써도 됩니다.
두 도구를 같이 쓰면 `AGENTS.md`를 정본으로 두고 같은 폴더 `CLAUDE.md`에 `@AGENTS.md` 한 줄만 적기.
상한: 30줄 · 4,000자 이하

```markdown
# 이 저장소의 작업 기준

- 정본: 기본 폴더 [경로]의 [브랜치]. 요청 없이 브랜치를 바꾸지 않는다.
- 명령: 개발 [명령] / 검사 [명령] / 배포 [명령] (배포는 커밋한 뒤에만).
- 완료 조건: [명령]을 돌려 [결과]가 나오면 끝. 명령과 결과 숫자를 보고에 남긴다.
- 건드리지 않는 것: [파일·폴더]. 이유는 docs/decisions/[날짜-제목].md
- 밖으로 나가는 일(게시·메일·운영 배포)은 [누구] 승인 뒤에만 한다.
- 판단과 검증 결과는 docs/decisions/에 날짜 이름으로 남긴다.
```

---

## 3. 넣지 않는 것

| 넣지 않는 것 | 대신 두는 곳 |
|---|---|
| 비밀 키·토큰·비밀번호 | 각 도구의 로그인 저장소 |
| 다른 프로젝트의 명령 | 그 프로젝트의 지시 파일 |
| 여러 단계짜리 절차 | 별도 문서 + 지시 파일엔 경로 한 줄 |
| 왜 그렇게 정했는지 긴 사연 | 결정 기록(docs/decisions/) |
| 스크립트 안의 모델 이름 | 역할 배정 설정 파일 한 곳 |
| 꼭 막아야 하는 행동의 유일한 장치 | 훅·배포 스크립트 |
| 설치한 도구가 넣은 설명서 | 그 도구의 문서 |
| 끝난 일의 진행 상황 | 인계 파일·대시보드 |

## 4. 처음 만들 때 붙여 넣는 지시문

```text
이 폴더를 읽고 AGENTS.md 초안을 만들어 줘. 조건:
- 30줄 이하, 한 줄에 규칙 하나.
- 넣을 것: 실행·검사·배포 명령(package.json이나 README에서 실제로 확인한 것만),
  건드리면 안 되는 파일·폴더, "끝났다"를 판정하는 명령과 그 결과.
- 넣지 말 것: 비밀 키·토큰·비밀번호, 코드 구조 설명, 이 폴더와 상관없는 내 습관.
- 확인하지 못한 명령은 지어내지 말고 "확인 필요"라고 표시.
- 파일을 바로 쓰지 말고 초안을 먼저 보여 줘.
```