이해 부채

AI가 만든 코드는 빠르게 쌓이는데 팀의 이해가 따라가지 못해 생기는 격차로, 그 결과 돌아가지만 아무도 설명하지 못하는 코드가 남는다. AI 코딩 에이전트로 개발 속도를 올린 팀이 유지보수와 디버깅 위험을 점검할 때 쓰는 개념이다.

테스트가 통과해도 쌓인다

기술 부채는 개발이 점점 버거워지면서 스스로 드러나지만, 이해 부채는 반대로 잘못된 자신감을 준다. 코드는 깔끔하고 PR도 그럴듯한데, 승인한 사람은 그 코드가 왜 동작하는지, 무엇을 전제로 하는지, 시스템의 다른 부분과 어떻게 맞물리는지 설명하지 못한다. "맞는 코드는 받았지만 옳은 코드는 아니다"라는 말이 이 상태를 잘 보여 준다.

Anthropic이 엔지니어 52명을 연구했더니, AI 도움을 받은 그룹이 이후 치른 이해도 퀴즈에서 더 낮은 점수를 받았다. 차이가 가장 큰 영역은 디버깅이었다.

Anthropic 연구, 작업 후 치른 이해도 퀴즈의 평균 점수.

"AI가 짰다"는 변명이 되지 않는다

운영 중에 장애가 나도 책임은 그 코드를 승인한 엔지니어에게 있다. "테스트는 통과했다"는 말도 방어가 되지 않는다. 이해하지 못한 코드에 대해서도 책임은 그대로 지게 된다는 점이 이 부채의 핵심 위험이다. 문제가 생길 때마다 AI에게 땜질 코드를 다시 요청하면 부채는 더 불어난다.

모든 줄을 읽지 말고 루프를 리뷰한다

에이전트가 쏟아내는 코드를 사람이 한 줄씩 다 읽을 수는 없다. 그래서 결과물이 아니라 코드를 만드는 과정을 검토하자는 제안이 나왔다. 스펙, 아키텍처 규칙을 자동으로 검사하는 피트니스 함수, 평가 게이트, 에이전트 지시 파일을 리뷰하고, 줄 단위 리뷰는 보안이 중요한 경로에만 남긴다.

Margaret-Anne Storey의 정리에 따르면 코드, 팀의 이해, 그리고 그 뒤에 있는 목표와 이유를 적은 기록을 함께 관리해야 한다. 이 정리에서는 같은 개념을 '인지 부채'라고 부른다.

이렇게 갚아 나간다