02-구조

02. 구조 — 컨텍스트의 7가지 구성 요소

Philipp Schmid는 컨텍스트를 7가지 슬롯으로 분해한다. 각 슬롯이 비어 있거나 잘못 채워지면 그 자리에서 에이전트 품질이 새어 나간다.

7 슬롯

1. 지시문/시스템 프롬프트(Instructions / System Prompt) — 에이전트의 정체성과 규칙. Claude Code의 CLAUDE.md가 여기에 매번 합쳐진다.
2. 사용자 프롬프트(User Prompt) — 이번 턴의 요청.
3. 단기 기억(State / History) — 같은 세션의 이전 메시지. /compact로 관리.
4. 장기 기억(Long-term memory) — 세션을 넘는 노트. .omc/notepad.md, project-memory.json, Anthropic Memory Tool.
5. 검색된 정보(Retrieved information / RAG) — 벡터 검색·grep·파일 읽기로 가져온 외부 지식.
6. 사용 가능한 도구(Available tools) — 도구 정의 자체가 컨텍스트를 차지한다. 너무 많으면 혼란을 만든다(Part 3/03 참조).
7. 구조화 출력(Structured output) — JSON 스키마처럼 출력 형식을 강제하는 명세.

”올바른 정보를 올바른 형식으로 올바른 시점에”

Schmid의 핵심 정의는 다음 문장에 압축되어 있다.

“the discipline of designing and building dynamic systems that provides the right information and tools, in the right format, at the right time.”

의역: “올바른 정보와 도구를 올바른 형식으로, 올바른 시점에 제공하는 동적 시스템을 설계·구축하는 학문.”

세 단어가 핵심이다.

• Right information — 모든 데이터가 아니라 이번 작업에 필요한 데이터만.
• Right format — 줄글이 나을 때, 표가 나을 때, JSON이 나을 때가 다르다.
• Right time — 사전 적재(pre-loading)가 아니라 필요할 때 가져오는 즉시 검색(Just-in-Time, JIT).

컨텍스트의 해부도(Anatomy)

Anthropic 응용 AI 팀이 제시한 좋은 컨텍스트의 4가지 특징.

• 시스템 프롬프트는 “the right altitude” — “적절한 고도” 에 있어야 한다. 너무 구체적이면 적응을 못 하고, 너무 추상적이면 행동이 흔들린다.
• 도구 세트는 작고 기능 중복이 없어야 한다.
• 예시는 망라적인 엣지 케이스가 아니라 다양하면서도 정전(canonical)에 가까운 것들로.
• 전체적으로 “tight, informative context” — “빡빡하면서도 정보 밀도가 높은 컨텍스트” 를 추구한다.