TL;DR

이 저장소는 모델 호출 자체가 아니라 도구 실행·상태 유지·권한 게이팅·루프 조율을 담당하는 '하니스'를 23개 섹션으로 나눠 개념과 코드로 함께 가르친다. 각 섹션은 opening·mechanism·per-system·failure-modes라는 같은 틀을 쓰고 Claude Code·Hermes Agent·mini-swe-agent 세 실제 시스템을 동일한 렌즈로 비교해 실제 구현이 어떻게 다른지 보여준다. 섹션 1부터 22까지는 실행 가능한 src/가 누적되어 이전 섹션과 diff를 떠보면 그 섹션이 새로 추가한 메커니즘 하나가 그대로 드러나고, test.py로 오프라인 검증을 하거나 demo.py로 실제 API 호출까지 확인할 수 있다. 메모리 심화 내용은 별도 저장소(learn-agent-memory)로 이어져 프로덕션 규모 메모리 루프까지 다룬다.

핵심 포인트

• 섹션마다 opening·mechanism·per-system·failure-modes라는 동일한 틀을 써서 개념을 배우자마자 실제 코드로 확인한다.
• Claude Code·Hermes Agent·mini-swe-agent 세 실제 시스템을 같은 렌즈로 비교해 하니스 설계의 실제 차이를 드러낸다.
• 섹션 간 코드가 누적되고 diff 하나가 그 섹션이 추가한 메커니즘과 정확히 일치하도록 구성했다.