최근, agentic AI (Claude나 Cursor 등)를 사용하여 코드를 거의 직접 쓰지 않게 되었습니다.

코드의 모든 행을 리뷰하고 수정은 철저히 하고 있지만, 제 리뷰조차 이해 부채 (Comprehension Debt)가 쌓이고 있다는 사실을 깨달았습니다. 이전에는 "리뷰용 자료를 만들어줘", "여기는 모르겠으니까 시퀀스 다이어그램 (Sequence Diagram)을 그려줘"라고 개별적으로 지시를 내렸지만, 오늘은 Opus가 만들어준 자료가 전혀 머릿속에 들어오지 않아 리뷰를 시작할 수 없는 상황에 빠졌습니다 (망했다... 끝인가?).

리뷰를 포기하고 Cursor + Grok 4.5에 고민을 상담했더니, 중요한 깨달음이 있었습니다. 저는 글자로만 된 설명으로는 소스 코드의 움직임이 머릿속에 들어오지 않고, UML이나 시퀀스 다이어그램 등의 시각화가 없으면 이해하지 못하는 타입이었던 것입니다.

이 깨달음을 바탕으로 「자신의 이해 패턴에 최적화된 리뷰 자료 작성 스킬」을 AI에게 만들게 했더니, 자료의 질이 극적으로 향상되었고 리뷰가 원활하게 진행되게 되었습니다.

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

진정한 포인트: 개인마다 이해하는 방식은 다르다

이번에 만든 스킬은 「내가」 이해하기 쉬운 패턴에 최적화된 것입니다.

다른 사람에게는 또 다른 이해 방식이 있습니다. 같은 자료를 전달해도 결코 똑같이 이해된다는 보장은 없습니다.

다행히 현재의 AI는 매우 똑똑하기 때문에, 개인별로 커스터마이징한 자료를 만드는 노력은 크지 않습니다.

다만, 많은 사람이 "내 뇌는 이렇게 하면 이해하기 쉽다"라고 자각하거나 언어화하지 못하고 있는 것이 과제입니다. 자각이 없다면 커스터마이징된 자료를 만들 수 없습니다.

제안: 2단계로 「개인 최적화 리뷰 자료 작성 스킬」을 구축하기

스텝 1: 초기 질문을 통해 이해 스타일을 진단시키기

AI에게 다음과 같은 질문을 던져 자신의 인지 특성을 명확히 합니다.

• 과거에 이해하기 쉬웠던 자료·설명의 특징은 무엇인가 (그림, 텍스트, 코드, 표 등)
• 복잡한 로직을 설명받을 때, 어떤 표현이어야 머릿속에 잘 들어오는가
• 반대로, 어떤 설명일 때 이해가 멈추는가
• 시각화 (UML/시퀀스 다이어그램/플로우차트 (Flowchart))의 필요성
• 선호하는 정보 처리 순서 (전체상 → 상세 or 상세 → 전체)

스텝 2: 진단 결과에 기반하여 전용 스킬을 작성하기

진단 결과를 바탕으로 AI에게 다음과 같은 전용 지시 (커스텀 스킬)를 만들게 합니다.

구체적인 스킬 예시 (나의 경우): "당신은 나의 전속 코드 리뷰 가정교사입니다. 나는 『글자로만 된 설명으로는 움직임을 이미지화하기 어려운 시각 우위형』입니다.

리뷰 자료를 작성할 때 다음 규칙을 엄수해 주세요:

• 반드시 처음에 전체 시퀀스 다이어그램 (Mermaid 또는 PlantUML)을 출력할 것
• 각 처리 설명은 그림과 대응시켜 기술할 것
• 텍스트는 최소화하고, 중요한 흐름은 굵은 글씨나 불렛 포인트로 시각적으로 강조할 것
• 복잡한 부분은 여러 패턴의 그림 (일반 플로우 · 예외 플로우)을 준비할 것
• 마지막에 『이해도 확인을 위한 3가지 질문』을 붙일 것
• 나의 이해가 얕은 부분은 다른 각도에서의 시각화를 제안할 것"

이 스킬을 한 번 만들어 두면, 이후 모든 PR이나 코드에 대해 "이 스킬을 사용해서 리뷰 자료를 작성해줘"라고 지시하는 것만으로, 자신 전용으로 최적화된 자료가 자동으로 생성됩니다.

가정교사의 비유

이 접근 방식은 「가정교사를 붙이는 것」과 본질적으로 같습니다.

• 일반적인 수업 → 표준화된 자료 (모두에게 동일)
• 가정교사 → 그 아이의 머리에 들어가는 방식에 맞춰 자료·설명·속도를 전부 커스터마이징

AI 시대는, **각 개인에게 전속인 「이해 최적화 가정교사 AI」**를 가질 수 있는 시대입니다.

초기 진단 → 커스텀 스킬 구축의 2단계로 실현할 수 있습니다.

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

----'-*-

마치며

이해 부채 (Comprehension Debt)는 AI 생성 코드의 숨겨진 비용으로서, 2026년 현재도 주목받고 있습니다.

속도를 중시하다가 이해가 따라가지 못하게 되면, 나중에 큰 타격이 됩니다.

여러분도 꼭 한 번, 자신의 「이해하기 쉬운 패턴」을 AI와 함께 언어화해 보세요.

그리고 자신 전용의 리뷰 자료 작성 스킬을 구축한다면, 코드 리뷰가 고통이 아니라 오히려 즐거운 시간으로 바뀔 것입니다.