스탠포드 CS336 강의가 공개한 AI 에이전트 사용 가이드라인, 우리가 배울 점

무슨 일이 있었나

스탠포드 대학의 CS336 "Language Modeling from Scratch" 강의가 GitHub에 흥미로운 파일을 공개했어요. CLAUDE.md라는 이름의 파일인데, 학생들이 과제를 할 때 Claude나 다른 AI 코딩 에이전트를 "어디까지", "어떻게" 써도 되는지를 명문화한 가이드라인이에요. 이게 단순한 학칙이 아니라, AI 에이전트와 사람이 함께 학습할 때 무엇을 지켜야 하는지를 처음으로 체계적으로 정리한 문서라서 화제가 됐어요.

왜 지금 이런 게 필요하냐면, 요즘 코딩 과제는 사실상 "학생 vs AI"의 경계가 모호해졌거든요. ChatGPT, Claude Code, Cursor 같은 도구가 너무 강력해서, 그냥 "AI 쓰지 마세요"라고 하면 현실성도 없고 학습 효과도 떨어져요. 그렇다고 무제한 허용하면 학생이 코드를 한 줄도 안 쓰고 졸업할 수 있죠. CS336은 그 사이의 균형점을 찾아본 거예요.

가이드라인의 핵심 원칙

파일의 큰 줄기는 "AI는 도구이지 대리인이 아니다"라는 거예요. 학생 본인이 개념을 이해하고, AI는 그 과정을 보조하는 위치에 있어야 한다는 거죠. 구체적으로는 몇 가지 원칙으로 나뉘어요.

첫째는 개념 이해는 본인이 책임진다예요. AI에게 "이 수식 설명해줘"라고 묻는 건 OK, 하지만 "내 과제 답안 써줘"는 NO. 그 차이가 뭐냐면, 전자는 학습의 일부지만 후자는 학습의 대체거든요. 사실 우리 실무에서도 비슷해요. "이 알고리즘이 왜 O(n log n)인지 설명해줘"는 좋지만 "내 코드 리뷰 코멘트 다 대신 답해줘"는 결국 본인 실력을 갉아먹는 거죠.

둘째는 AI가 생성한 코드는 본인이 한 줄씩 이해해야 한다예요. 그냥 복붙해서 돌아가면 끝, 이게 아니라 변수 하나하나, 함수 하나하나를 손가락으로 짚으면서 "왜 이렇게 짰지?" 답할 수 있어야 한다는 거예요. CS336은 언어 모델을 밑바닥부터 직접 구현하는 강의라서, 토크나이저나 어텐션 같은 핵심 부분에서 AI에 의존하면 강의 목적 자체가 사라지거든요.

셋째는 인용과 투명성이에요. AI를 썼으면 어디서 어떻게 썼는지 명시하라는 거죠. 이건 학술 정직성의 연장선인데, 실무에서도 PR에 "이 부분 Copilot 도움 받음" 같은 표시를 남기는 팀이 늘고 있어요.

왜 CLAUDE.md라는 파일명인가

이 부분이 재밌어요. Claude Code 같은 에이전트는 저장소 루트에 있는 CLAUDE.md나 AGENTS.md 파일을 자동으로 읽어서 "이 프로젝트에서 나는 어떻게 행동해야 하지?"를 파악하거든요. 그래서 CS336은 사람 학생뿐 아니라 AI 에이전트 자체에게도 직접 지시를 내리는 형태로 가이드라인을 작성한 거예요.

예를 들면 "학생이 답을 묻거든 바로 알려주지 말고 힌트만 줘라", "채점 대상 함수의 본문은 학생이 직접 작성하게 유도해라" 같은 식이죠. 이게 무슨 의미냐면, 앞으로의 교육은 "학생 교육"과 "학생의 AI 교육"이 동시에 이루어진다는 거예요. 선생님이 학생에게 시험 범위를 알려주듯, 강의 측이 AI에게도 "여기까지만 도와줘"라고 알려주는 거죠.

업계 맥락에서 본 의미

비슷한 흐름이 곳곳에서 나타나고 있어요. Anthropic, Cursor, GitHub은 각자 CLAUDE.md, .cursorrules, .github/copilot-instructions.md 같은 규약 파일을 표준화하려 하고 있고요. MIT, CMU 같은 다른 대학들도 비슷한 정책 문서를 준비 중이에요.

실무에서도 이런 가이드라인 파일이 점점 표준이 되고 있어요. "우리 회사 코드 스타일은 이렇고, 테스트는 이렇게 짜고, 보안 민감 영역은 이거다"를 적어두면 AI 에이전트가 그걸 매번 참고해서 일관된 결과물을 내거든요. 한 번 잘 적어두면 신입이 들어왔을 때 온보딩 문서로도 그대로 쓸 수 있어요.

한국 개발자에게 주는 시사점

사이드 프로젝트든 회사 프로젝트든, CLAUDE.md 또는 AGENTS.md를 한 장 적어두는 습관을 들이는 걸 추천해요. 거기에 우리 프로젝트의 의도, 금지 사항, 자주 쓰는 명령어, 코드 스타일을 적어두면 AI와의 협업 품질이 눈에 띄게 올라가요. 또 학습용 토이 프로젝트를 할 때도 "이번 주는 핵심 알고리즘은 AI 없이 직접 짠다" 같은 규칙을 스스로 정해두면 실력 차이가 확실히 벌어져요.

마무리

AI가 모든 코드를 대신 짜주는 시대에, "무엇을 직접 할 것인가"를 의식적으로 정하는 것이 곧 학습 전략이 됐어요. 여러분은 지금 본인의 AI 사용 규칙을 명문화한다면 어떤 줄을 가장 먼저 적으시겠어요? 그게 곧 본인이 가장 중요하게 여기는 실력의 모습이에요.