오염
틀린 사실이 눌러앉아 이후 판단을 계속 오염 → 그 줄을 지우거나 대화를 끊는다.
MODULE 07 · 하네스와 컨텍스트
하네스와
컨텍스트
모델을 감싼 뼈대(하네스)와 유한한 책상(컨텍스트) — 에이전트가 무너지는 순간을 읽는 4개 레슨
AI 에이전트 실무 교재 · Module 07
Lesson 23 · 하네스란
두뇌는 부품, 하네스가 제품
- 01모델글을 넣으면 다음 글을 내놓는 두뇌 — 혼자선 세상에 손을 못 댄다
- 02하네스모델을 감싼 비-모델 코드 전체 — 도구 배선·실행 루프·컨텍스트 조립
- 03차이같은 두뇌라도 어떤 뼈대에 앉히느냐가 챗봇과 에이전트를 가른다
Lesson 23 · 한눈에
Lesson 23 · 매 턴의 루프
하네스가 한 턴에 하는 일
- 01조립시스템 프롬프트·대화·읽은 파일·도구 목록을 모델 앞에 깐다
- 02호출묶음을 모델에 넘긴다 — 답 또는 “이 도구 써줘” 요청이 온다
- 03실행도구 요청이 오면 하네스가 실제로 파일·명령·검색을 돌린다
- 04되먹임결과를 다시 모델 앞에 깔고 1번으로 — 목표에 닿을 때까지 반복
Lesson 24 · 유한한 책상
Lesson 24 · 토큰과 윈도우
책상이 꽉 차면 벌어지는 일
- 01밀려난다한계를 넘으면 오래된 맥락이 잘리거나 요약되며 약속이 사라진다
- 02흐려진다책상이 넓어도 구석에 깔린 지시는 주의에서 멀어진다
- 03비용이다올린 토큰만큼 돈·시간이 든다 — 쓸데없는 건 빼라
Lesson 25 · 5대 실패모드
Lesson 25 · 진단과 처방
다섯 고장, 다섯 처방
산만
맥락이 비대해 목표를 잊고 겉돈다 → 작게 쪼개고 끝난 단계는 치운다.
혼란
무관한 도구·정보가 끼어 엉뚱한 선택 → 이 작업에 필요한 것만 남긴다.
충돌
앞뒤 지시가 모순돼 헤맨다 → 옛 지시를 명시적으로 폐기하고 최신본만.
부패
거듭 요약하다 디테일이 닳는다 → 중요한 원본은 파일로 보존한다.
Lesson 26 · 물리적 분리
무거운 일은 다른 책상에서
- 01곁가지 분리방대한 조사·긴 로그 분석은 별도의 깨끗한 책상(서브에이전트)에 맡긴다
- 02결론만 회수과정은 그 책상에 두고, 본 책상엔 핵심 결론만 가져온다
- 03본 책상 보존곁가지 책상이 어질러져도 본 책상은 가볍게 유지된다
Lesson 26 · 물리적 브레이크
사람이 거는 제동
- 01새 대화로단락이 끝나면 책상을 통째로 갈아 새 대화로 — 가장 단순·강력
- 02점검 게이트“여기까지 요약하고 멈춰, 확인 받고 계속” — 폭주를 막는 정거장
- 03결론은 파일로한 단계 결과를 파일에 적어두면 다음 대화는 그것만 읽고 시작
“
깨끗한 책상이
똑똑한 에이전트를 만든다.
하네스가 뼈대(L23), 컨텍스트가 유한한 책상(L24)임을 알았고, 다섯 실패모드(L25)와 분리·브레이크(L26)까지 봤다. 다음은 맥락을 디스크에 보관하는 법 — 메모리·세션 관리다.
Module 07
출처 · 더 읽을거리
- Anthropic — Effective context engineering for AI agents
컨텍스트를 자원으로 다루는 관점 · anthropic.com/engineering/effective-context-engineering-for-ai-agents - Anthropic — Claude Code 공식 문서(서브에이전트)
별도 컨텍스트의 곁가지 처리 · docs.anthropic.com/en/docs/claude-code/sub-agents - Drew Breunig — How long contexts fail
컨텍스트가 망가지는 방식의 분류 · dbreunig.com