Context Engineering · Harness Engineering
이론에서 구현까지, 한 서재
왜 컨텍스트가 무너지는지(WHY)와 어떻게 하네스를 짓는지(HOW)를 4권 · 260편으로 엮었다. 아래 색인에서 아무 문서로나 바로 들어간다.
컨텍스트 이론
122개 문서 → 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대 실패모드 — 최신 연구·업계 동향
하네스 구현
113개 문서 → 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 비교분석
40 횡단분석