어느 작은 서점이 있었다. 책장마다 책이 빼곡했지만, 손님들은 늘 같은 몇 권만 찾았다. 주인장은 아쉬웠다. “이 책들도 누군가의 인생을 바꿀 이야기들을 품고 있는데…” 그는 책등에 작은 메모를 붙이기 시작했다. “이 책은 비 오는 오후에 읽으면 좋습니다”, “3장 마지막 문장이 울컥합니다”. 손님들은 그 메모를 따라 새로운 책을 펼쳐보았고, 서점은 조금씩 활기를 되찾았다. 코드 저장소도 마찬가지다. 수십 줄의 커밋 메시지보다, 그 코드가 태어난 맥락이 더 중요한 순간이 있다.
GitWhy는 바로 그런 맥락을 기록하려는 시도다. 단순한 커밋 메시지 대신, 코드가 작성될 당시의 AI와의 대화, 참고한 문서, 심지어 개발자의 머릿속을 스친 의문까지 포착해 커밋에 묶어두는 확장 프로그램이다. 기술적으로는 Git의 주석 기능과 LLM API를 활용한 메타데이터 관리 도구에 가깝지만, 그 이면에는 ‘코드의 기억 상실’이라는 오래된 고민이 자리하고 있다.
소프트웨어 개발에서 맥락의 중요성은 새삼 강조할 필요도 없다. 2000년대 초반, 오픈소스 프로젝트들이 폭발적으로 성장하면서 ‘왜’라는 질문이 ‘어떻게’만큼 중요해지기 시작했다. 단순한 버그 수정 커밋도, “이 패치가 왜 필요한가”를 설명하는 상세한 메시지 없이는 리뷰어의 시간을 낭비하게 만든다. 그런데도 대부분의 개발자는 여전히 “Fix bug”나 “Update dependencies” 같은 무의미한 메시지를 남긴다. 시간이 흐를수록 ‘왜’는 사라지고, 코드는 점점 더 낯선 존재가 된다.
GitWhy는 이 문제를 기술적으로 해결하려 하지만, 그 근본에는 인간의 게으름과 망각에 대한 통찰이 있다. 개발자들은 맥락을 기록하는 일을 번거롭게 여긴다. 하지만 AI와의 대화 기록이 자동으로 저장된다면? 그 순간의 결정 과정이 자연스럽게 문서화된다면? 이 도구는 그런 ‘자연스러운 기록’의 가능성을 보여준다. 마치 스마트폰 카메라가 사진에 자동으로 위치와 날씨 정보를 붙이듯, 개발 환경이 코드의 맥락을 자동으로 포착하는 시대가 온 것이다.
기술은 인간의 한계를 보완할 때 가장 아름답다. GitWhy는 개발자의 기억력이라는 취약한 연결 고리를 보강하려는 시도다. 하지만 과연 모든 맥락이 기록될 가치가 있을까? AI와의 대화 중 쓸모없는 잡담도, 실패한 시도도, 심지어 오해에서 비롯된 코드도 모두 남게 된다면, 저장소는 점점 더 복잡해지지 않을까?
여기서 중요한 것은 ‘선택적 기억’의 문제다. 인간의 뇌가 중요한 것만 기억하듯, 소프트웨어 개발에서도 어떤 맥락이 가치 있는지는 프로젝트의 성격에 따라 다르다. 연구용 코드라면 실패한 시도까지 상세히 기록해야겠지만, 스타트업의 MVP라면 핵심 결정 과정만 남기는 게 효율적일 수 있다. GitWhy는 이런 선택의 폭을 개발자에게 넘기지만, 그 선택 자체가 또 다른 부담이 될 수 있다.
더 근본적인 질문은 이것이다. 코드의 맥락을 기록하는 일이 정말 개발 생산성을 높일까? 아니면 그저 또 하나의 ‘기술 부채’를 쌓는 꼴이 아닐까? 과거에도 주석 달기 운동, 문서화 캠페인 같은 시도들이 있었다. 대부분 실패했다. 이유는 단순하다. 개발자들은 코드를 쓰는 일보다 문서화를 더 싫어한다. GitWhy가 성공하려면 이 심리적 장벽을 넘어야 한다. 자동화된 맥락 기록이 개발자의 워크플로에 자연스럽게 녹아들어야 한다. 마치 IDE가 자동 완성 기능을 제공하듯, 맥락 기록도 ‘당연히 있어야 하는 기능’으로 인식되어야 한다.
이 도구가 흥미로운 이유는 기술적 완성도가 아니라, 소프트웨어 개발 문화에 던지는 질문 때문이다. 우리는 코드를 어떻게 기억하고, 어떻게 잊어야 하는가? 버전 관리의 본질은 무엇인가? GitWhy는 이 질문에 대한 하나의 답변일 뿐이다. 어쩌면 진짜 답은 더 단순한 곳에 있을지도 모른다. 개발자들이 자신의 코드를 사랑하는 법을 배우는 것. 코드가 그저 기능의 집합이 아니라, 개발자의 생각과 고민이 담긴 산물이라는 사실을 깨닫는 것. 그런 인식이 자리 잡을 때, 맥락은 자연스럽게 기록될 것이다.
기억은 때로 짐이 되기도 한다. 하지만 잊혀진 맥락은 더 큰 비용을 치르게 한다. GitWhy가 던지는 질문은 결국 이것이다. 우리는 코드의 기억을 어디까지 간직해야 하는가? 그 답은 각 프로젝트, 각 팀이 스스로 찾아가야 할 것이다. 이 도구가 그 여정의 시작점이 되길 바란다.
이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
