AI 에이전트 시대, 코드를 이해하는 법

Geoffrey Litt가 제시한 기법들

너무 진짜 좋은 글이다.. 오늘 자기 전에 많은걸 생각하게 한다.

AI 에이전트가 코드를 점점 더 잘 쓰고 스스로 검증까지 하게 되면서, 인간이 코드를 줄 단위로 읽는 것은 점점 비효율적이 되고 있음.

그렇다면 인간은 이제 코드를 이해하지 않아도 될까..? 놉...

1. 이해의 목적이 바뀌었다
   검증은 에이전트가 점점 잘하게 되고 있지만, 참여는 인간만이 할 수 있는 영역이다.

2. 인지 부채
   이해하지 않고 넘어가는 것은 기술 부채. 단기적으로는 빨라 보이지만, 장기적으로 창의성과 유지보수 능력이 크게 떨어짐.

3. Explainer 문서의 원칙 3가지

• 배경 지식 먼저 가르치기
• 직관 먼저, 세부 코드 나중에
• 그냥 diff가 아니라 산문 형태로 논리적 순서에 따라 설명 + 코드 스니펫

4. /explain-diff 스킬
   저자가 실제로 매일 쓰는 Claude 커스텀 스킬.
   diff를 넣으면 Notion/HTML로 예쁘고 구조화된 설명 문서를 자동 생성해줌. 팀 협업에도 매우 유용.

5. 읽기만으로는 부족하다. 퀴즈가 필요함!
   설명서 끝에 인터랙티브 퀴즈를 넣어 실제로 이해했는지 확인함.

규칙: "퀴즈를 통과하지 못하면 코드를 다른 사람에게 보내지 않는다."

6. 퀴즈는 속도 조절 장치
   AI 루프는 너무 빠르다.

7. Micro-worlds
   코드를 그냥 읽는 게 아니라, 직접 만지고 놀 수 있는* 작은 시뮬레이션/디버거 환경을 만든다.

8. 에이전트에게 "이해를 위한 코드"를 만들게 하자
   에이전트가 코드를 짜는 것뿐만 아니라, 인간이 그 코드를 이해할 수 있게 돕는 도구까지 만들 수 있다.

이것이 이 스레드에서 가장 강력한 실천적 인사이트 중 하나!!!

9. 팀에서는 Shared Space가 핵심
   개인이 이해하는 것만으로는 부족하다.
   Notion 같은 공유 공간에서 계획, Explainer, 토론이 함께 이루어져야 팀 전체가 같은 멘탈 모델을 가질 수 있다.

10. 이것은 컴퓨팅의 본질적 비전이다
    Alan Kay가 50년 전에 말한 "컴퓨터는 책보다 더 나은 사고 도구"라는 비전과 연결된다.

AI는 단순히 자동화하는 게 아니라, 인간을 더 깊이 증강할 수 있어야 한다.