심화 마무리
가장 단순하게, 일단 돌아가게 만들어라
모든 복잡한 아키텍처 설계와 정교한 엔지니어링 패턴은 결국 하나의 단순한 진리를 가리킵니다.
"Do the simplest thing that works"
AI Agent 엔지니어링 실천
Claude Code 소스 코드에서 배운 세 가지 핵심 교훈
1
Agent의 핵심은 지능이 아닌 상태 관리입니다
모든 Agent 엔지니어링 문제는 결국 하나의 질문으로 귀결됩니다:어떤 정보가 언제, 어떤 형태로 컨텍스트 윈도우에 나타나는가. 모델의 지능은 사전 학습에서 주어지므로 제어할 수 없지만, 컨텍스트의 구성·정제·배열은 엔지니어가 결정할 수 있습니다.
Claude Code의 엔지니어링 복잡성 대부분은 컨텍스트를 세심하게 관리하는 데 있습니다:무엇을 넣고, 무엇을 빼고, 언제 압축하고, 언제 초기화할지. 모델을 더 똑똑하게 만드는 것은 오히려 부차적인 문제입니다. Context Engineering은 Agent 엔지니어링의 핵심 역량으로, 단순한 보조 수단이 아닙니다.
2
Harness는 가정을 코딩합니다—가정은 낡습니다
오늘 작성하는 모든 스캐폴딩 코드 한 줄 한 줄에는 현재 모델 역량에 대한 가정이 암묵적으로 담겨 있습니다. 모델이 업그레이드되면 이 가정들이 모두 무효화될 수 있습니다.
실제 사례:Claude Sonnet 4.5는 컨텍스트 불안이 있었습니다—대화가 길어질수록 모델 성능이 눈에 띄게 저하되었습니다. 팀은 이를 위해 context reset 메커니즘을 추가해 주기적으로 컨텍스트를 압축했습니다. 나중에 Opus 4.5로 전환하자 불안 현상이 사라졌고, context reset이 오히려 효율을 떨어뜨리는 짐이 되었습니다. 교훈:오늘 작성한 스캐폴딩은 내일 버려야 할 수도 있습니다.
3
모델이 강해질수록, 엔지니어링은 단순해집니다
재시도, 오류 수정, 포맷팅, 컨텍스트 압축 같은 보조 로직들은 모델 역량이 향상될수록 점점 불필요해집니다. 최선의 엔지니어링 결정은 내일 필요하지 않을 수도 있는 코드를 오늘 작성하지 않는 것입니다.
이것이 엔지니어링이 필요 없다는 의미는 아닙니다. 오히려 어떤 로직이 모델 발전에 따라 낡아질지, 어떤 것이 진정으로 지속되는 아키텍처 결정인지 이해하는 판단력이 가장 중요한 엔지니어링 역량입니다. 샌드박스 격리, 권한 계층화, 평가 체계는 낡지 않습니다. 하지만 특정 Prompt 기법이나 특정 모델 우회 방법은 반년 후면 필요 없어질 수 있습니다.
FULL JOURNEY
네 개 파트 전체 복습
PART 1
대형 언어 모델이란 무엇인가
Transformer의 어텐션 메커니즘부터 Token 경제학, 학습 과정에서 창발 능력까지. 대형 언어 모델은 명확한 능력 경계를 가진 확률 모델이며, 무엇이든 할 수 있는 블랙박스가 아닙니다.
PART 2
대형 언어 모델 활용하기
Prompt Engineering에서 Few-shot Learning, RAG에서 Function Calling까지. 대형 언어 모델과 협업하는 방법론을 익혀 생산성 배가기로 활용하세요.
PART 3
Demo에서 제품으로
「돌아가는」 것에서 「쓸 수 있는」 것으로 가는 간극. 비용 최적화, 지연 제어, 평가 체계, 안전 컴플라이언스로 AI Demo를 신뢰할 수 있는 프로덕션 제품으로 만들기.
PART 4
제품에서 디자인 패턴으로
5가지 Workflow + 자율 Agent, Context Engineering, 도구 설계, 장기 실행 아키텍처, 안전 컨테이너화. 오픈소스 엔지니어링 실천을 기반으로 Agent 시대의 핵심 디자인 패턴 마스터하기.
이 디자인 패턴들은 종착점이 아닙니다. 다음 세대 모델이 등장하면 변화할 것입니다.
하지만 그것들 뒤에 있는 사고방식을 이해하는 것이야말로 진정으로 이전 가능한 역량입니다.
하지만 그것들 뒤에 있는 사고방식을 이해하는 것이야말로 진정으로 이전 가능한 역량입니다.