AI 코딩 에이전트가 코드를 많이 쓸수록 개발자의 병목은 “직접 작성”에서 “시스템을 이해하고 다음 방향을 결정하는 능력”으로 이동한다. Geoffrey Litt의 “Understanding is the new bottleneck”은 이를 인지 부채(cognitive debt) 문제로 설명한다.
왜 이해해야 하는가
이해는 단순히 검증을 위한 절차가 아니다. 에이전트가 테스트와 자기검토를 점점 더 잘 수행하더라도, 인간은 제품과 시스템의 다음 아이디어를 제안해야 한다. 시스템을 이해하지 못하면 다음 루프에서 좋은 질문을 던질 수 없고, 에이전트가 만든 구조 위에서 창의적으로 참여하기 어렵다.
| 목적 | 설명 |
|---|---|
| 검증 | 결과가 스펙과 품질 기준에 맞는지 판단 |
| 참여 | 시스템 개념을 머릿속에 유지해 다음 설계 결정을 내림 |
| 유지보수 | 나중에 문제가 생겼을 때 맥락을 복구 |
기법 1: 코드 설명 문서
에이전트에게 “무엇을 만들었는지”가 아니라 “내가 앞으로 수정하려면 어떤 개념을 알아야 하는지”를 쓰게 한다. 좋은 설명 문서는 파일 나열보다 데이터 흐름, 핵심 불변조건, 확장 포인트를 설명한다.
프롬프트 예시:
이 변경을 유지보수할 개발자를 위해 설명 문서를 작성하라.
파일별 요약보다 핵심 개념, 데이터 흐름, 실패 모드, 다음 수정 시 주의점을 우선하라.기법 2: 이해도 퀴즈
코드를 읽었다고 착각하지 않으려면 에이전트에게 질문을 만들게 한다. 퀴즈는 “이 함수가 무엇을 하는가”보다 “이 조건이 깨지면 어떤 버그가 생기는가”처럼 사고를 요구해야 한다.
기법 3: 마이크로월드
마이크로월드는 시스템의 작은 부분을 직접 조작해 볼 수 있는 실험 환경이다. 예를 들어 스케줄러, 파서, 캐시 정책 같은 복잡한 내부 로직은 작은 HTML 시뮬레이터나 CLI 데모로 만들어 보면 구조를 훨씬 빠르게 이해할 수 있다.
팀 워크플로에 넣는 방법
- 큰 에이전트 PR에는 설명 문서와 이해도 질문을 함께 요구한다.
- 새 아키텍처에는 “작게 만져볼 수 있는 데모”를 만든다.
- 리뷰어는 diff 전체를 읽기 전에 에이전트에게 개념 지도부터 받는다.
- 이해가 부족한 부분을 다음 에이전트 작업의 명시적 입력으로 남긴다.
관련 문서
- claude-code — 터미널에서 동작하는 Anthropic의 AI 코딩 에이전트
- agent-harness — 에이전트 하네스 엔지니어링
- ai-code-review-tips-agentic — AI 코드 리뷰를 에이전틱하게 운영하는 방법
- long-running-agents — 장기 실행 에이전트 설계 원칙
참고 자료
- Understanding is the new bottleneck — Geoffrey Litt (2026-07-02)