Claude Code, Cursor와 같은 도구의 내부가 실제로 어떻게 작동하는지 이해하고 싶다면, 공식 문서만 훑어보는 것으로는 갈피를 잡기 어렵습니다.

한 개발자가 자신의 AI 학습 노트를 오픈 소스로 공개했는데, Pi-Agent SDK를 예시로 들어 소스 코드를 장별로 나누어 상세히 설명합니다.

총 10장으로 구성되어 있으며, 전체 아키텍처 (Architecture), 에이전트 (Agent) 루프, 모델 호출 (Model Call)부터 도구 시스템 (Tool System), 컨텍스트 압축 (Context Compression) 및 세션 관리 (Session Management)까지 다룹니다.

GitHub: https://t.co/EJRjvvnDFK

각 장은 세 가지 질문에 답합니다: 이것은 무엇인가, 코드는 어떻게 작성되었는가, 그리고 당초 왜 이렇게 설계되었는가.

TypeScript와 Python 두 가지 버전이 있어 서로 대조하며 학습할 수 있으며, 본인에게 익숙한 언어를 선택하여 읽을 수 있습니다.

웹 온라인 버전, Markdown, 그리고 PDF 세 가지 방식으로 제공되므로, 오프라인으로 보거나 출력하여 공부하기에도 좋습니다.