Learn · 12 강 소스 코드 정독

Learn Claude Code

튜토리얼이 아닌 분해. agent loop 한 줄부터 worktree 격리까지.

12 강 36 컴포넌트 기반 shareAI-lab/learn-claude-code

루프 없이는 agent도 없다

Agent loopstop_reasonmessages 히스토리tool_result 반환

루프는 그대로, 도구만 늘어났다

Tool dispatch mapJSON schemasafe_path 이탈 방지tool 확장

agent가 스스로 진행 상황을 관리하게 하라

TodoManagerin_progress 단일 제한nag reminder 주입구조화된 상태

큰 문제를 새로 열린 agent에게 넘긴다

Subagent 파견컨텍스트 격리CHILD_TOOLS 제한요약 반환

필요할 때만 불러오는 도메인 지식

2계층 skill 아키텍처YAML frontmatterload_skill tooltoken 경제

Context Compact

context가 차면 전략적으로 줄이는 법

Micro compactAuto compact수동 compact tooltranscript 지속성

상태를 디스크에 쓰면 압축도 살아남는다

Task CRUDblockedBy 의존성 그래프JSON 파일 지속성위상 정렬로 실행 가능 작업 찾기

Background Tasks

작업이 스스로 실행되고 agent는 블로킹되지 않는다

스레드 기반 bg task알림 큐LLM 호출 전 drain결과 다시 주입

여러 agent가 파일 메일함으로 통신한다

지속적 teammateJSONL 메일함5가지 메시지 유형팀 config.json

두 agent 사이의 핸드셰이크 프로토콜

shutdown 프로토콜plan_approval 프로토콜request_id 연결FSM: pending→approved/rejected

Autonomous Agents

스스로 일을 찾는 agent

WORK / IDLE 두 단계태스크 보드 폴링auto_claimidentity 재주입

Worktree Isolation

서로 다른 agent가 같은 나무를 차지하려 하지 않도록

git worktree add태스크 / worktree 바인딩keep vs remove디렉토리 격리