Explain Diff

에이전트가 코드 변경을 마치면, 그 변경을 깊이 있게 설명하는 문서(explainer)를 만들어 주세요. 이 스킬은 Geoffrey Litt가 AI Engineer World's Fair 2026에서 발표한 "Understanding is the new bottleneck" 접근을 따른다. 발표자가 공개한 원본 스킬(HTML·Notion 두 변형)과 PENEKhun의 한국어 번역·render.py 개선판을 통합했다. 출력 형식은 마크다운을 기본으로 한다.

왜 이해인가

• 에이전트가 코드를 대신 짜는 시대에도 사람의 이해는 여전히 중요하다. 이유는 검증(verify)이 아니라 참여(participate) 다. 에이전트는 스스로의 작업을 검증하는 데 점점 더 능숙해지고 있다. 하지만 프로젝트는 에이전트와의 수많은 반복 루프로 진행되며, 시스템에 대한 풍부한 개념을 머릿속에 가진 사람만이 다음 아이디어를 떠올리고 창의적으로 참여할 수 있다.
• 인지 부채(cognitive debt): 에이전트가 코드를 만드는 속도보다 사람이 시스템의 작동 원리를 머릿속에 유지하는 속도가 느려질 때 쌓인다. 기술 부채의 사촌이다. 단기적으로는 이해하지 않고 넘어갈 수 있지만 결국 대가를 치른다. (Margaret Storey, Simon Willison)
• 산출물은 diff 리뷰를 위한 부가물이 아니라, 팀원(그리고 미래의 나)이 프로젝트에 능동적으로 참여하기 위한 기반이다. 완성된 문서는 팀이 함께 보고 토론할 수 있는 공유 공간(예: Notion)에 두는 것을 기본으로 한다.

산출물

에이전트가 작업을 마칠 때마다 explainer 문서를 만든다. 원시 diff를 처음부터 줄 단위로 읽게 하는 대신 이 문서를 먼저 읽게 한다. (원시 diff는 마지막에 첨부) 기본 언어는 한국어다.

다음 섹션을 포함한다.