AI 에이전트 시대, 코드를 이해하는 법
Author: lucas (@lucas_flatwhite)
URL: https://x.com/lucas_flatwhite/status/2072698321299464670?s=46
Stats at capture: 310 Likes | 111 Retweets | 52,993 Views
Referenced article: Geoffrey Litt, Understanding is the new bottleneck
Tweet content
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는 단순히 자동화하는 게 아니라, 인간을 더 깊이 증강할 수 있어야 한다.
Referenced article excerpt
Geoffrey Litt의 원문은 agent가 작성한 코드를 이해해야 하는 이유를 “verify”에서 “participate”로 재정의한다. Agent가 자체 검증을 점점 잘하게 되더라도, 인간이 창의적 참여자로 남으려면 시스템의 개념과 작동 방식을 이해해야 한다는 논지다. 원문은 code explainer docs, quizzes, micro-worlds를 핵심 기법으로 제안한다.