내 규칙을 기억시키기 (AGENTS.md)

지금까지 "파일 하나로 유지해 줘"를 최소 두 번은 말했을 거예요. 따뜻한 빵집 같은 색 취향도 서로 다른 세션에 두 번 설명했고요. 번거롭죠? 새 세션의 에이전트는 매번 출근 첫날인 요리사 같아요. 솜씨는 좋은데, 이 주방의 사정은 하나도 몰라요.

프로 주방은 이 문제를 패스 옆에 붙여둔 노트로 해결해요. 하우스 룰, 기준, 셰프의 취향을 한 번만 적어두는 거죠. Codex에게도 똑같은 게 있어요. 이 코스 전체에서 지렛대 효과가 가장 큰 파일, AGENTS.md예요.

오늘 만들 것

나를 기억하는 프로젝트예요. 하우스 룰을 한 번 적고, 새 세션을 열고, 완전히 새로운 대화가 시키지 않아도 그 규칙을 따르는 걸 지켜보게 돼요.

준비물

• first-page 폴더
• 약 25분

따라 하기

1. 원리 이해하기 (허무할 만큼 단순해요)

AGENTS.md는 폴더 안에 있는 평범한 텍스트 파일이에요. Codex가 그 폴더에서 새 작업을 시작하면 이 파일을 프로젝트 규칙으로 읽어요. 메커니즘은 이게 전부예요. 설정도 마법도 없어요. 매 근무조가 요리 전에 읽는, 조리대 위의 쪽지인 셈이죠. 상위 폴더와 현재 폴더에 규칙이 함께 있으면 현재 작업 위치에 더 가까운 규칙이 우선해요. 자세한 동작은 공식 AGENTS.md 안내에 정리돼 있어요.

2. 하우스 룰 받아 적게 하기

주방을 열고, Codex 작성창에 /init을 입력해도 기본 뼈대를 만들 수 있어요. 이번에는 규칙이 어디서 왔는지 분명히 보려고 직접 주문할게요:

이 프로젝트에 AGENTS.md 파일을 만들어 줘. 하우스 룰은 이거야:

- 나는 초보자야. 뭔가 바꾸기 전에, 뭘 하려는 건지 평범한 말로
  한 문장으로 먼저 알려 줘.
- 이 사이트는 index.html 파일 하나로 유지해. 절대 쪼개지 마.
- 내 디자인 취향: [2강에서 답한 것 — 예: "따뜻하게, 빵집처럼,
  굵은 포인트 컬러 하나"]. 새로 만드는 건 여기에 맞춰 줘.
- 변경할 때마다 브라우저 새로고침하라고 알려 줘.

그다음 이 파일이 언제 읽히고 왜 중요한지 두 줄로 나한테
다시 설명해 줘.

두 줄짜리 설명을 읽어 보세요. 방금 1번에서 이야기한 내용이 거의 그대로 들려와야 해요.

3. 작동 증명하기 (재미있는 부분)

규칙은 낯선 사람이 따라야 진짜예요. 그러니 낯선 사람을 데려오죠. Codex 패널에서 새 작업을 시작하세요. Ctrl+Shift+P(Mac은 Cmd+Shift+P)를 누르고 Codex: New Chat을 골라도 돼요. 새 작업, 백지 대화, 출근 첫날이에요. 이제 아무 맥락도 주지 않고 작은 걸 주문하세요:

페이지에 내가 읽고 있는 책 섹션을 추가해 줘.

자세히 지켜보세요. 먼저 한 문장으로 뭘 할지 알리고(규칙 1), 전부 index.html 안에서 처리하고(규칙 2), 따뜻하게 스타일링하고(규칙 3), 새로고침하라고 말해 줄 거예요(규칙 4). 이 세션에는 아무도 아무 말 하지 않았어요. 노트가 말해 준 거예요.

4. 나만의 규칙 하나 추가하기

파일을 손으로 고칠 필요는 없어요. 이것도 주문이면 돼요:

AGENTS.md에 규칙 하나만 더 추가해 줘: [나만의 규칙 — 예: "내
페이지 어디에도 '심층적'이라는 단어를 쓰지 마" 또는 "나한테는
항상 한국어로 답해 줘"].

이제부터 같은 걸로 에이전트를 두 번 바로잡게 된다면, 그건 번거로움이 아니라 규칙이 자기 존재를 알리는 순간이에요. 노트로 보내세요.

막혔을 때

• 새 세션이 규칙을 무시했어요 — 대개 규칙이 너무 많은 텍스트에 파묻힌 경우예요. 노트는 짧고 직설적으로 유지하세요. 날카로운 규칙 열 개가 공손한 규칙 마흔 개를 이겨요. 이렇게 물어보는 것도 방법이에요. "AGENTS.md를 다시 읽고, 방금 네가 한 일에 어떤 규칙이 적용되는지 말해 줘."
• 작업 도중에 AGENTS.md를 고쳤는데 아무 일도 없어요 — 이 파일은 작업 시작 시점에 읽혀요. 새 작업을 열면 새 근무조가 새 노트를 읽어요.
• 에이전트가 혼자서 거창한 AGENTS.md를 써버렸어요 — 다듬으세요. "AGENTS.md를 내가 실제로 준 규칙만 남게 줄여 줘." 부풀어 오른 노트는 에이전트가 매 세션 읽어야 하는 짐이에요. 날씬하게 유지하세요.

마무리 체크

나가기 전에 하나씩 확인해요:

□ AGENTS.md가 존재하고, '나의' 규칙이 평범한 말로 담겨 있다
□ 새 세션이 시키지 않아도 규칙을 따랐다
□ 내가 직접 생각해낸 규칙을 최소 하나 추가했다
□ 반사신경이 생겼다: 두 번 바로잡았다? → 노트로

다음 달의 세션들이 1년쯤 알고 지낸 사람과 일하는 느낌이 든다면, 그건 이 파일 덕분이에요. (설정 노트라는 아이디어를 더 깊이 파고 싶으면, 통째로 다룬 레시피가 있어요: 주방 노트. Claude의 CLAUDE.md를 예로 들지만, 원리는 AGENTS.md에 그대로 통해요.)

다음 레슨 — 05 되돌리기 안전장치 만들기 (git). 3강의 구조 작전은 에이전트의 짧은 기억에 기댔어요. 이제 진짜 영구적인 세이브 포인트를 설치할 시간이에요. 이 프로젝트에서 하는 어떤 일도 다시는 복구 불가능해지지 않도록요.

막히면 아래 질문 상자에 남겨 주세요 — 그러라고 있는 거예요.