AI 코딩 시대의 코드 이해법: 노션 제프리 리트가 제시한 세 가지 기법

핵심 메시지

• 에이전트가 5만 줄짜리 PR까지 만들어내는 지금, 코드를 한 줄씩 읽는 방식만으로는 따라잡기 어렵고 '이해'가 새로운 병목이 됐다.
• 이해에는 두 가지 이유가 있다. 하나는 결과가 맞는지 '검증'하기 위함이고, 다른 하나는 다음 아이디어를 내는 창의적 '참여'를 위함이다. 검증은 점점 에이전트가 대신하지만, 참여를 위한 이해는 사람의 몫으로 남는다.
• 이해를 게을리하면 '인지 부채(cognitive debt)'가 쌓인다. 기술 부채처럼 한동안은 버틸 수 있어도 결국 프로젝트에 더 이상 기여할 수 없는 순간이 온다.
• 교육학의 오래된 지혜를 빌려 설명 문서, 마이크로월드, 공유 공간이라는 세 가지 기법으로 에이전트 시대에도 이해를 지킬 수 있다.
• 코드 생성이 사실상 공짜가 된 지금은 오히려 개념을 더 깊이 이해할 도구를 값싸게 만들 수 있는 기회다.

쉽게 이해하기

노션의 디자인 엔지니어 제프리 리트는 AI 엔지니어 콘퍼런스 강연에서 '사람이 여전히 코드가 어떻게 동작하는지 이해해야 한다'는 다소 도발적인 주장을 던졌다. 에이전트가 방대한 코드를 대신 작성하는 시대에 이 질문은 실제로 논쟁거리가 됐다고 그는 말한다. 다만 그가 말하는 이해는 코드를 한 줄씩 읽는 옛 방식이 아니라, AI의 도움을 받아 더 잘 이해하는 새로운 방식이다.

리트는 먼저 '왜 이해해야 하는가'를 두 갈래로 나눈다. 많은 사람이 떠올리는 이유는 '검증'이다. 에이전트가 내놓은 결과가 명세에 맞는지, 프로덕션을 망가뜨리지 않는지 확인하는 일이다. 그러나 이런 옳고 그름 판단은 에이전트도 점점 잘하게 되어 사람의 역할이 줄어든다. 그가 강조하는 진짜 이유는 '참여'다. 무슨 일이 벌어지는지 이해할 때 그 이해가 다음 아이디어의 토대가 되고, 사람은 프로젝트의 능동적이고 창의적인 참여자가 된다.

첫 번째 기법은 '설명'이다. 리트는 매일 쓰는 explain-diff라는 스킬을 소개한다. 코드 변경을 던져 주는 대신, 배경 설명으로 시작해 세부보다 직관을 먼저 전하고, 필요한 곳엔 만져볼 수 있는 인터랙티브 그림을 넣으며, 마지막에 산문형으로 풀어 쓴 코드 디프를 순서대로 보여 준다. 문서 맨 아래에는 다섯 문항짜리 퀴즈를 두어, 이 퀴즈를 통과하지 못하면 동료에게 리뷰를 요청하지 않는 규칙을 스스로에게 적용한다. 그는 이 퀴즈를 모든 것이 빨라지는 시대의 '속도 조절 장치'라고 부른다.

두 번째 기법은 '마이크로월드'다. 교육자 시모어 페퍼트의 '수학 나라(mathland)'에서 영감을 얻어, 에이전트에게 개념을 몸으로 느낄 수 있는 일회용 UI를 만들게 한다. 예컨대 프롤로그 인터프리터의 내부 상태를 단계별 타임라인으로 시각화한 디버거를 만들어 버그를 고치면서 기계의 감을 익히고, 개인 웹사이트를 다른 프레임워크로 옮길 때는 버튼만 누르면 이전이 한 단계씩 진행되는 작은 게임을 만들어 직접 해 본 듯한 이해를 얻는다.

세 번째 기법은 '공유 공간'이다. 혼자만의 이해를 넘어 팀이 함께 이해해야 창의적 협업이 가능하다는 것이다. 노션은 사람과 에이전트가 함께 참여하는 멀티플레이어 대화, 계획 문서에 코멘트로 토론하는 협업 공간을 실험하고 있으며, 최근에는 클로드와 커서 같은 코딩 에이전트를 노션 안으로 불러들이는 기능을 선보였다. 리트는 앨런 케이가 50년 전 쓴 글을 인용하며, 컴퓨터의 본래 목적은 사람을 레벨업하는 것이었고 AI로 코드가 공짜가 된 지금이 그 비전을 되살릴 때라고 강연을 맺는다.

주요 인사이트

• '코드 리뷰가 새로운 병목'이라는 말은 흔히 정확성 검증을 떠올리게 하지만, 리트는 검증보다 '참여를 위한 이해'가 더 근본적인 병목이라고 본다.
• 좋은 코드 설명은 잘 쓴 커밋 메시지처럼 세부 코드보다 변경의 '본질과 직관'을 먼저 전해야 한다.
• 읽었다고 이해한 것은 아니다. 앤디 마투섹의 '책은 작동하지 않는다'는 문제의식처럼, 퀴즈 같은 장치로 이해를 강제로 점검할 필요가 있다.
• 에이전트가 만드는 코드의 목적이 항상 '출시할 소프트웨어'일 필요는 없다. 이해를 돕기 위한 시뮬레이션과 디버거 같은 일회용 도구를 값싸게 찍어낼 수 있다.
• AI는 사람을 루프 밖으로 밀어내는 도구가 아니라, 오히려 더 깊이 루프 안으로 끌어들이는 도구가 될 수 있다.

자주 묻는 질문

관련 AI 소식