≡
지식위키
컨텍스트 이론
하네스 구현
AI 발전사
엔터프라이즈 하네스 보고서
검색
⌘K
다크
컨텍스트 이론
00
개요 왜 컨텍스트 엔지니어링
00
챕터 MOC — 왜 컨텍스트 엔지니어링인가
00.01
용어 탄생과 계보: 트윗 두 개가 바꾼 패러다임
00.02
정의 수렴: 업계·학계가 합의한 개념, 프롬프트 엔지니어링과의 비교
00.03
Transformer 어텐션 메커니즘과 KV 캐시: 컨텍스트 병목의 물리적 근거
00.04
컨텍스트 로트(Context Rot): 길이 증가에 따른 성능 저하 실증
00.05
에이전트는 왜 컨텍스트를 누적시키는가: 툴루프·멀티턴·메모리
00.06
5대 실패모드 분류체계: 오염·산만·혼란·충돌·부패
00.07
4대 전략 개관: Write · Select · Compress · Isolate
5대 실패모드 진단 퀴즈
00
핵심 용어집 (컨텍스트 엔지니어링)
01
오염 Poisoning
컨텍스트 오염 (Context Poisoning / Contamination)
컨텍스트 오염이란 무엇인가 — 정의와 4가지 실패 유형
오염의 자기강화(Self-reinforcing) 메커니즘 — 왜 되돌리기 어려운가
우발적 오염 실증 사례 — Gemini 2.5 포켓몬 에이전트
우발적 오염 vs 적대적 오염 — 발생 경로·지속성·탐지 난이도 비교
논문: AgentPoison — 메모리/RAG 백도어 공격 (Chen et al. 2024)
논문: PoisonedRAG — 지식 데이터베이스 오염 공격 (Zou et al. 2024)
논문: MemoryGraft — 경험 메모리 이식 공격 (Srivastava & He 2025)
적대적 오염 위협 지형 — Prompt Injection, Lethal Trifecta, 장기 메모리 오염
컨텍스트 오염 방어 전략 — Dual LLM, CaMeL, 메모리 위생, RAG 운영 체크리스트
미해결 과제 및 논쟁점 — 신뢰 트레이드오프, RAG의 역설, 현실 조건 괴리
논문: CaMeL — 설계로 프롬프트 인젝션 방어 (Debenedetti et al. 2025)
산업 실사고 사례 — 오염·프롬프트 인젝션
02
산만 Distraction
컨텍스트 산만 (Context Distraction)
컨텍스트 산만 — 정의와 핵심 직관
어텐션 희석 — 왜 긴 컨텍스트에서 집중력이 무너지는가
위치 편향 — Lost in the Middle U자형 성능 곡선
산만 임계점 (Distraction Ceiling) — 모델별 실효 컨텍스트 한계
Pokémon 에이전트 사례 — Gemini 2.5 Pro의 컨텍스트 산만 실증
[논문] Lost in the Middle — Liu et al., TACL 2024
[논문] RULER — 실효 컨텍스트 길이 측정 벤치마크, Hsieh et al., COLM 2024
[논문] NoLiMa — 어휘 매칭 없는 장문 추론 평가, Modarressi et al., ICML 2025
[논문] Context Length Alone Hurts — Du et al., EMNLP 2025
논쟁 — 컨텍스트 산만의 근본 원인: 어텐션 한계 vs. 훈련 데이터 부족 vs. 위치 인코딩
처방 — 컨텍스트 산만 완화 전략과 실무 체크리스트
03
혼란 Confusion
03
컨텍스트 혼란 — Map of Content
컨텍스트 혼란 — 정의와 메커니즘
툴 과부하 — MCP 실태와 토큰 경제학
모델 크기별 툴 혼란 취약성 스펙트럼
논문 리뷰 — Lost in the Middle (Liu et al., TACL 2024)
논문 리뷰 — RAG-MCP (Gan & Sun, arXiv 2025)
논문 리뷰 — CMTF & BoR (Babu & Iyer 2026 / Repantis et al. 2026)
논문 리뷰 — Less Context, Better Agents (Lodha et al., arXiv 2026)
'Less is More' — 컨텍스트 혼란 해결 전략 7가지
AI 강사·AX 컨설턴트를 위한 컨텍스트 혼란 현장 활용 가이드
04
충돌 Clash
컨텍스트 충돌 (Context Clash)
컨텍스트 충돌(Context Clash) 정의와 Breunig의 4분류 체계
컨텍스트 충돌이 발생하는 5가지 인과 경로
컨텍스트 충돌 유형 분류: 시간적·출처간·지시문·파라메트릭·자가생성
[논문] LLMs Get Lost In Multi-Turn Conversation (Laban et al. 2025)
[논문] Contextual Drag: 오류 시도가 후속 추론을 끌어내리는 메커니즘 (Cheng et al. 2026)
[논문] LLM 앵커링 편향의 존재·메커니즘·완화 (Huang et al. 2025)
[논문] SycEval: LLM 아첨이 컨텍스트 충돌을 능동적으로 생성하는 경로 (Fanous et al. 2025)
[논문] Lost in the Middle: 위치 편향이 충돌 해소를 방해하는 원리 (Liu et al., TACL 2024)
에이전트가 컨텍스트 충돌에 더 취약한 구조적 이유
컨텍스트 충돌 완화 전략 처방 및 실무 체크리스트
컨텍스트 충돌 vs. 인접 실패 모드 비교: Poisoning·Distraction·Confusion·Sycophancy
05
부패 ContextRot
05장 MOC — 컨텍스트 부패 (Context Rot)
컨텍스트 부패(Context Rot) — 정의와 용어의 기원
컨텍스트 부패의 분류학적 위치 — 오염·충돌·위치 편향과의 차별점
컨텍스트 부패의 발생 메커니즘 — 어텐션 구조적 한계와 인지 부하
[논문] Context Rot — Chroma Research 보고서 (Hong·Troynikov·Huber, 2025)
[논문] NoLiMa — 어휘 매칭 없는 장문 컨텍스트 평가 (Modarressi et al., ICML 2025)
[논문] RULER·HELMET — NIAH 이후 장문 벤치마크의 진화
컨텍스트 부패 완화 처방전 — 압축·위치·리랭킹·분리 전략
에이전트 시스템에서의 컨텍스트 부패 — 멀티턴·툴 루프 누적과 설계 원칙
06
해결전략 멀티에이전트 서브에이전트 롱텀
06장 MOC — 해결 전략: Write · Select · Compress · Isolate · 롱텀 메모리
Write 전략 — 스크래치패드 · 파일시스템 · 크로스세션 메모리
Select 전략 — RAG · 하이브리드 검색 · Tool Loadout · 능동적 검색
Compress 전략 — 요약 · 프루닝 · KV-캐시 최적화 · 압축 전용 LLM
Isolate 전략 — 멀티에이전트 · 서브에이전트 · Context Quarantine
멀티에이전트 찬성 — Anthropic 멀티에이전트 리서치 시스템 (2025)
멀티에이전트 반대 — Cognition 'Don't Build Multi-Agents' (Walden Yan, 2025)
Manus 실전 교훈 — KV-캐시 · 파일시스템 · 로짓 마스킹 · Attention Recitation
MemGPT / Letta — OS형 4계층 롱텀 메모리 · Sleep-time Compute
실패모드 ↔ 4전략 통합 매핑표 · 프로덕션 체크리스트 · 도메인별 선택 원칙
RAG vs 롱컨텍스트 논쟁 — 검색증강과 초장문맥, 무엇이 언제 우월한가
에이전트 벤치마크 — τ-bench · SWE-bench · GAIA · WebArena · BFCL
해결 전략
07
심화 오염 거버넌스 룰침범 재정의
07
심화 — 오염 거버넌스 MOC
문제정의 — 룰 침범(공간축)과 기준 재정의(시간축)
근본원인 — 권위·출처 메타데이터의 부재
공유 vs 격리 컨텍스트 — 핵심 트레이드오프
불변 규칙·쓰기보호 — CLAUDE.md/AGENTS.md 계층·Hook·Constitutional AI
메모리 계층과 권한 — MemGPT·오케스트레이터-워커·TierMem
provenance·신뢰등급 — 프로베넌스 역설과 Attested Identity
충돌 해소와 합의 — SCF·안전성 비합성성·AgentCity 삼권분립
처방 — 컨텍스트 = 슬롯 계약, 4계층 거버넌스 모델 (저자 견해)
실전 체크리스트 — 오염 거버넌스 운용 점검표
합의 알고리즘 — 비잔틴 내성·정족수의 LLM 적용과 한계
provenance 운영표준 — C2PA·검증가능자격증명(VC)·데이터 lineage
08
실전 ClaudeCode Codex 공식문서
08
실전 — Claude Code·Codex 공식문서로 보는 컨텍스트 관리 (MOC)
Claude Code — CLAUDE.md 메모리 계층
Claude Code — /compact와 자동 컴팩션
Claude Code — Auto Memory 세션 간 학습
Claude Code — 서브에이전트 컨텍스트 격리
Claude Code — Hooks 컨텍스트 전처리와 강제 집행
Claude Code — 프롬프트 캐싱과 비용 레버
OpenAI Codex — AGENTS.md 설정과 컨텍스트 관리
실패모드 × 공식기능 매핑표
실전 레시피 — 스니펫 모음
2026
컨텍스트 관리 신기능 — 5대 실패모드 처방의 최신 공식 구현
09
비교 감별진단 해설
09
비교·감별진단·해설 MOC
5대 컨텍스트 실패모드 종합 감별진단 — 오염·산만·혼란·충돌·부패
비교·감별 — 오염(Poisoning) vs 충돌(Clash)
비교·감별 — 오염(Poisoning) vs 부패(Rot)
비교 — 산만 vs 부패: 길이 축 형제 변별
비교 — 혼란 vs 산만: 내용의 부적절함 vs 순수 양
비교·감별: 혼란(Confusion) vs 충돌(Clash)
비교 — 4대 해결전략: Write · Select · Compress · Isolate 언제 무엇을 쓰나
비교 — 멀티에이전트/컨텍스트 격리: Anthropic 찬성 vs Cognition 반대
해설 — 컨텍스트 오염 깊이읽기: 상처에 들어간 균은 어떻게 자란다
해설 — 컨텍스트 산만 깊이읽기: 회의가 길어질수록 안건을 잊는다
깊이읽기 — 컨텍스트 혼란, 왜 도구를 많이 주면 멍청해지는가
깊이읽기 — 컨텍스트 충돌, 더 넣을수록 틀리는 역설
깊이읽기 — 컨텍스트 부패: 길이는 상한일 뿐, 보증이 아니다
2026년 관점에서 다시 보는 5대 실패모드 — 최신 연구·업계 동향
references
2026
아티클 — 산업 블로그·엔지니어링 글 6편
2026
신규 논문 — arXiv 22편 (보강 라운드)
전체 논문 인덱스 (96편)
참고문헌 — 검증 출처 모음
2026
도구 신기능 — Claude/Codex 컨텍스트 관리 기능
하네스 구현
00
시작하기
하네스 엔지니어링 학습 볼트
용어집
하네스 엔지니어링이란?
학습 순서
10
프레임워크분석
Claude Code 공식문서 — 핵심 개념
Codex 공식문서 — 핵심 개념
Claude Code · 진입점과 에이전트 실행 루프
Claude Code · 컨텍스트와 프롬프트 조립
Claude Code · 확장점: Hooks (라이프사이클 훅)
Claude Code · 확장점: Skills (점진적 공개 패키지)
Claude Code · 확장점: Slash Commands (사용자 정의 명령)
Claude Code · 확장점: Subagents (위임 에이전트)
Claude Code · 도구 시스템과 MCP (도구 정의·노출)
Claude Code · 가드레일: 권한·승인·샌드박스
Claude Code · 플러그인/마켓플레이스와 OMC 팀·브리지
1
. Claude Code
Codex · 고유 특별기능: Code Mode (도구를 코드로 실행하는 런타임)
Codex · 진입점과 에이전트 실행 루프 (run_turn / Task)
Codex · 프롬프트·컨텍스트 조립 (base 프롬프트 + AGENTS.md + 환경/스킬/권한 fragment)
Codex · 도구 시스템 (ToolSpec 정의 형식과 모델 노출 / ToolRouter 디스패치)
Codex · 확장점: Hooks (이벤트 기반 외부 명령 실행)
Codex · 확장점: Skills (SKILL.md + progressive disclosure)
Codex · 확장점: Subagents (병렬 멀티에이전트 spawn)
Codex · 확장점: MCP 연결 + Plugins (설치 배포 단위)
Codex · 가드레일: 샌드박스 + 권한 + 승인 (Seatbelt/Landlock/bwrap + Guardian)
Codex · 상태·메모리 영속성 (Rollout JSONL + state SQLite + Memories)
2
. Codex
OMC (oh-my-claudecode) · 진입점과 훅 실행 루프 (Claude Code 플러그인으로서의 OMC)
OMC (oh-my-claudecode) · 컨텍스트/프롬프트 조립 (CLAUDE.md 주입 + 키워드 감지 + 스킬 인젝션)
OMC (oh-my-claudecode) · 서브에이전트 (agents/*.md 역할 프롬프트와 위임)
OMC (oh-my-claudecode) · 스킬과 슬래시 커맨드 (SKILL.md 워크플로우 + 얇은 디스패처)
OMC · MCP 도구 시스템 (단일 't' 서버 + tool-registry 노출)
OMC (oh-my-claudecode) · 가드레일 (PreToolUse 강제 + 권한 핸들러 + 워커 RBAC advisory)
OMC (oh-my-claudecode) · 상태·메모리 영속성 (state / notepad / project-memory / wiki 4계층)
OMC (oh-my-claudecode) · OMC 고유 기능: Teams 런타임/브리지 (프로세스 기반 멀티에이전트 + 거버넌스)
3
. oh-my-claudecode (OMC)
gajae-code · 에이전트 실행 루프 (Agent Loop)
gajae-code · 컨텍스트·프롬프트 조립 (System Prompt + AGENTS.md 주입)
gajae-code · 확장점 형식: Hooks / Skills / Slash-Commands
gajae-code · 서브에이전트·태스크 위임 (Role Agents)
gajae-code · MCP 통합 (외부 도구 서버)
gajae-code · 도구 시스템: 정의 형식과 모델 노출
gajae-code · 가드레일: 권한·승인·스폰 게이트
gajae-code · Gajae 고유: 이중 영수증·워크플로 상태·모호성 게이팅
4
. gajae-code
ouroboros · 진입점 / CLI / ooo 커맨드 라우팅
ouroboros · 스펙 엔진: Seed 계약과 Double-Diamond(Interview→Ambiguity→Seed)
ouroboros · 이벤트 소싱 저장소와 Projection 읽기모델
ouroboros · 오케스트레이터 실행 루프(Seed→프롬프트→에이전트 실행)
ouroboros · 멀티 백엔드 프로바이더 어댑터 / 런타임 추상화
ouroboros · MCP 서버: 도구 정의·노출과 Subagent 디스패치
ouroboros · 확장점: Hooks / Skills / Slash-Commands 형식
ouroboros · 가드레일: 샌드박스 클래스 · 권한 번역 · 플러그인 방화벽
ouroboros · 고유기능: 진화 루프 · 드리프트 게이트 · 감사 원장(provenance)
5
. ouroboros
fable-ish · 플러그인 매니페스트와 확장점 배선
fable-ish · 훅 3종 이벤트 루프 (실행 진입점)
fable-ish · 컨텍스트/프롬프트 주입 (additionalContext 채널)
fable-ish · 작업 위험도 분류 엔진 (quick/normal/deep/blocked)
fable-ish · 증거 원장(ledger) 상태 영속성
fable-ish · 도구 결과 파싱과 증거 추출
fable-ish · 완료 검증 게이트 (Stop 차단 메커니즘)
fable-ish · 스킬 워크플로우 지침 계층
fable-ish · 가드레일: 소프트 권고 vs 하드 위임
6
. fable-ish
내 패턴 · 진입점과 플러그인 로딩 (settings.json -> 마켓플레이스 -> 플러그인)
내 패턴 · 컨텍스트·프롬프트 조립 (CLAUDE.md @-import 체인과 주입 헌법)
내 패턴 · 확장점: Hooks (전체 이벤트 라이프사이클과 system-reminder 주입)
내 패턴 · 확장점: Skills와 Slash-Commands (SKILL.md 프론트매터와 트리거)
내 패턴 · 확장점: Subagents (에이전트 .md 정의 형식과 모델 라우팅)
내 패턴 · 도구 시스템: MCP 브리지와 도구 정의·노출
내 패턴 · 가드레일: 권한·승인·샌드박스
내 패턴 · 상태·메모리 영속성 (다층 메모리와 세션 상태)
내 패턴 · 파이프라인 검증 게이트와 영수증 (admit / gate / claim-card)
7
. 내 패턴
FBZ_10 — 훅 라우터 (작업별 팩 주입)
FBZ_20 — 조기 종료 차단 훅 (finish-the-work)
FBZ_30 — 검증 접지 팩 (verification grounding)
FBZ_40 — 조사 프로토콜 (investigation protocol)
FBZ_50 — 멀티스토리 증거 게이트 (goals.py)
FBZ_60 — 스킬 & always-on 운영 블록
FBZ_70 — 설치 & 플러그인 구조
fablize — Opus를 Fable처럼 (개요)
FL_10 PromptCore — 결정적 공개안전 운영 프로파일
FL2 Evidence Gate — 증거 없는 완료 차단
FL_30 Fail-closed Gates (라이선스·성능·런타임·렌더·퍼블리시·완전성)
FableLayer Router — 비용 인식 Sonnet/Opus 라우팅
FL_50 Adapters — 배포 형태별 export 생성기 (Claude Code·Ollama·LM Studio·SillyTavern)
FL_60 Benchmark — 결정적 픽스처 채점 + raw JSON
FL_70 Hooks & 플러그인 구조 (early-stop, 설치)
FableLayer Procedure & Source Policy (조사 절차·공개안전 정책)
FableLayer 개요 — 공개안전 절차·검증·벤치마크 레이어
분석축 루브릭 (10축)
20
비교분석
10축 비교 매트릭스
독창 아이디어 모음
축별 심층 분석
30
개선점
내 패턴 개선 백로그
통합 하네스 설계안 — 베스트 오브 베스트
3
. 학습 인사이트 — 하네스 7종의 '설계 결정과 그 이유'
40
횡단분석
진입점·에이전트 루프 — 횡단분석
컨텍스트·프롬프트 조립 — 횡단분석
훅(Hooks) 횡단 — 코드가 AI의 행동에 끼어드는 법
스킬·커맨드 횡단 — 재사용 가능한 작업 절차를 패키징하는 법
도구·MCP 시스템 — 횡단분석
오케스트레이션·멀티에이전트 — 횡단분석
가드레일·샌드박스 횡단 — AI가 함부로 못 하게 막는 법
검증 루프 — 횡단분석
자기개선·반복 루프 — 횡단분석
상태·메모리 영속성 — 횡단분석
50
인사이트
하네스 설계 원칙 — 7개 하네스가 수렴한 10개 법칙
설계 플레이북 — '이런 요구·제약이면 이런 하네스'
하네스 안티패턴 — 코드에서 실제로 관찰된 위험·실패 설계 14선
나만의 하네스 조립 가이드 — 7프레임워크 베스트 부품을 내 이중모델 스택에 끼우기
AI 발전사
갑자기가 아니었다
Transformer: 구조의 전환
스케일의 경제
ChatGPT 순간
업무로 들어온 AI
RAG와 에이전트 시스템
평가와 환각
데이터, 저작권, 보이지 않는 노동
에너지와 인프라
규칙과 세계
공개 가중치와 작은 모델
멀티모달과 미래 읽기
수업 중 자주 쓰는 개념
강의 중 다시 확인할 자료
엔터프라이즈 하네스 보고서
개요
기초부터: 이 글을 읽는 데 필요한 네 가지 개념
왜 이 분석을 하게 되었는가
개인 하네스 복잡도의 정량적 분석
분산 프로토콜이 추가하는 복잡도 레이어
기업용 하네스가 추가하는 시스템 계층
조직 확장이 어려운 다섯 가지 구조적 이유
user-proxy의 확장 불가능성 — 가장 핵심적인 병목
M2 정체의 의미 — scope 경계 결정은 그 자체로 난제
UFC-Harness 경험에서의 현실 인식
결론과 시사점
일치하는 문서가 없습니다
서재
/
엔터프라이즈 하네스 보고서
현장 도입 리포트
엔터프라이즈 하네스 보고서
조직 규모에서 에이전트 하네스를 도입할 때의 설계·거버넌스·운영 관점을 정리한 보고서 볼트.
본문
개요
기초부터: 이 글을 읽는 데 필요한 네 가지 개념
왜 이 분석을 하게 되었는가
개인 하네스 복잡도의 정량적 분석
분산 프로토콜이 추가하는 복잡도 레이어
기업용 하네스가 추가하는 시스템 계층
조직 확장이 어려운 다섯 가지 구조적 이유
user-proxy의 확장 불가능성 — 가장 핵심적인 병목
M2 정체의 의미 — scope 경계 결정은 그 자체로 난제
UFC-Harness 경험에서의 현실 인식
결론과 시사점