본문 바로가기
스터디 열기

맥락 제공이라는 일

이 책에서 가장 많이 나오는 말은 맥락입니다. 본격적인 질문에 들어가기 전에, 제가 이 말을 어떤 뜻으로 쓰는지 먼저 정리해 두겠습니다.

1. 지능으로 메울 수 없는 정보

AI가 똑똑해진다는 것은 세상에 이미 적혀 있는 지식을 더 많이, 더 잘 다룬다는 뜻입니다. 프로그래밍 언어, 보안 원칙, 문서 작성법처럼 어딘가에 글로 남아 있는 것은 이미 사람보다 AI가 더 많이 압니다.

하지만 세상에 적혀 있지 않은 것은 지능으로 메울 수 없습니다. 위니브에서 Claude Code와 일할 때 쓰는 작업 지침 파일에는 이런 내용이 날짜와 함께 적혀 있습니다.

  • 블로그 글은 대필할 수 있으므로, 화면에 보이는 작성자 프로필을 고를 수 있어야 한다. 화면에 보이는 작성자와 실제로 글을 쓰고 고친 계정의 기록은 따로 남긴다.
  • 교재 PDF는 다운로드한 뒤에는 공유될 수 있는 파일로 본다. 그러니 따로 요청하지 않는 한 파일 보호 장치를 더 강화하지 않는다.
  • 화면 문구에는 이모지 대신 글자 배지와 아이콘을 쓰고, 서버나 브라우저 같은 내부 사정은 화면에 쓰지 않는다.
  • 상담 문의에는 문자 메시지를 쓰지 않는다.

이 중 어느 것도 AI가 스스로 알아낼 수 없습니다. 특히 두 번째가 흥미롭습니다. 일반적인 보안 원칙으로 보면 유료 교재 파일은 더 단단히 지키는 것이 맞습니다. 실제로 그전에 정리한 요구사항 문서에는 권한을 더 좁히고 파일 주소를 더 단단히 막자는 제안이 들어 있었습니다. 똑똑한 AI일수록 좋은 일반론을 압니다. 하지만 우리 회사가 그 파일을 어떻게 보기로 했는지는 일반론에 없습니다. 그래서 지침 파일에는 "더 보수적인 제안보다 이 확정 정책을 우선한다"는 문장까지 들어가 있습니다.

제가 말하는 맥락은 이런 것입니다. 우리의 사정, 일의 목적, 조직이 내린 판단, 그리고 제가 좋다고 느끼는 기준입니다. 지능이 아무리 높아져도 이것은 누군가 알려 주어야 합니다.

2. 맥락을 담는 그릇들

맥락을 AI에게 건네는 방법은 여러 가지입니다.

그릇담기는 것특징
대화지금 하는 일의 목적, 방금 내린 결정가장 생생하지만 대화가 끝나면 흩어짐
지침 파일(CLAUDE.md, AGENTS.md)프로젝트의 규칙, 하지 말아야 할 일일할 때마다 자동으로 읽힘
메모리AI가 대화에서 기억해 둔 내 선호와 사실내가 한 번은 말한 것만 기억함
스킬업무 방식, 양식, 점검 목록, 스크립트필요할 때만 꺼내 읽음
LLM 위키쌓아 둔 자료와 그 정리지식을 문서로 키워 감
결과물과 기록코드, 커밋, 작업 기록, 이슈AI가 직접 읽고 판단의 근거로 씀

요즘의 도구들은 이 그릇들을 점점 잘 연결해 줍니다. 지침 파일은 자동으로 읽히고, 메모리는 알아서 쌓이고, 스킬은 필요할 때 불려 옵니다. 그래서 맥락을 많이 넣어 두기만 하면 AI가 알아서 잘할 것처럼 보입니다.

그런데 이 책에서 다룰 이야기의 대부분은 바로 여기서 생깁니다. 적어 둔 맥락이 지켜지지 않기도 하고, 이미 바뀐 생각이 지침에 남아 AI를 붙잡기도 하고, 맥락을 줄이는 과정에서 의도가 빠지기도 합니다. 맥락을 주는 일만큼 이미 준 맥락을 돌보는 일이 중요했습니다.

3. 사람이 설 수 있는 세 자리

맥락을 중심에 놓고 보면 사람이 AI의 작업 고리에 끼어드는 자리는 크게 세 곳입니다.

첫째는 일을 맡기기 전입니다. 지침 파일과 스킬, 첫 요청이 여기에 속합니다. 둘째는 AI가 일하는 동안입니다. 계획을 승인하거나 코드를 검토하는 일이 여기에 속합니다. 셋째는 결과물이 나온 뒤입니다. 만들어진 것을 실제로 실행해 보고 판단하는 일입니다.

예전의 저는 둘째 자리, 특히 코드를 검토하는 자리에 사람이 꼭 있어야 한다고 생각했습니다. 지금은 생각이 많이 바뀌었습니다. 그 과정은 7장에서 이야기합니다.

그리고 그림의 마지막 화살표가 이 책에서 가장 중요한 부분입니다. 결과물을 써 보면 사람에게 새로운 맥락이 생깁니다. 처음에는 설명할 수 없었던 원하는 것이 그제야 보입니다. 그것을 다시 AI에게 알려 주는 일까지가 맥락 제공입니다. 맥락 제공은 일을 시작할 때 한 번 하고 끝나는 일이 아니라, 고리 전체에서 계속 일어나는 일이라는 것이 이 책의 출발점입니다.

마지막 수정