HOW-WHY 크로스맵 — 이론(context) ↔ 구현(harness)

HOW-WHY 크로스맵

두 볼트가 강하게 겹치는 주제들을 이론(context, 왜 무너지나) ↔ 구현(harness, 어떻게 짓나) 으로 나란히 세운 대응표. 왼쪽에서 실패의 메커니즘을 이해하고, 오른쪽에서 그 실패를 막는 실제 설계를 본다. 같이 읽어야 “원리를 아는 구현”과 “구현으로 검증된 원리”가 맞물린다.

홈으로: 지식위키 · 컨텍스트 볼트 · 하네스 위키

1. 서브에이전트 격리 (Isolate)

이론 (WHY)	구현 (HOW)
Isolate 전략 — Context Quarantine	오케스트레이션·멀티에이전트 횡단
멀티에이전트 찬성 — Anthropic · 반대 — Cognition	CC 서브에이전트 · CX 멀티에이전트 · OMC 서브에이전트 · GJ 위임 · OB 서브에이전트 · 내패턴 서브에이전트

왜 같이 읽나: 이론은 “왜 컨텍스트를 격리해야 하나(오염·충돌 확산 차단, 어텐션 예산 보존)“와 그 찬반 논쟁을 다루고, 구현은 각 프레임워크가 서브에이전트를 어떤 프롬프트·복귀 계약·병렬 정책으로 실제로 격리하는지 보여준다. 이론의 트레이드오프(멀티에이전트 찬성 vs. 반대)를 구현별 설계 차이로 직접 대조할 수 있다.

2. 컨텍스트 어셈블리 & 부패·산만 (Compress/Write)

이론 (WHY)	구현 (HOW)
05 부패 (Context Rot) · 부패 완화 체크리스트	컨텍스트 조립 횡단
02 산만 · 산만 완화 체크리스트	에이전트 루프 횡단

왜 같이 읽나: 이론은 컨텍스트가 길어질수록 어텐션이 희석되고(부패) 히스토리에 과의존하는(산만) 메커니즘을 밝힌다. 구현은 프레임워크가 매 턴 프롬프트를 어떤 순서·예산으로 조립하고 무엇을 잘라내는지(compaction, 프루닝)를 보여준다. “왜 짧게 유지해야 하나”의 답이 조립 파이프라인 설계로 구체화된다.

3. 툴 과부하 & 혼란 (Select)

이론 (WHY)	구현 (HOW)
툴 과부하 — MCP 실태 · Less is More	툴·MCP 시스템 횡단
paper: RAG-MCP · paper: Less Context	CX 툴 시스템 · GJ 툴 노출

왜 같이 읽나: 이론은 툴 정의가 너무 많으면 선택 정확도가 떨어진다는 실증(RAG-MCP 등)을 제시한다. 구현은 각 하네스가 툴을 어떻게 정의·노출·게이팅해 이 과부하를 줄이는지 보여준다. “몇 개까지, 어떻게 걸러 노출할까”의 원칙과 실물을 짝지어 읽는다.

4. 메모리 & 상태 (Write / 롱텀 메모리)

이론 (WHY)	구현 (HOW)
Write 전략 — 스크래치패드·파일시스템 · MemGPT/Letta 롱텀 메모리	상태·메모리 횡단
Manus KV캐시·파일시스템 교훈	CX 영속·메모리

왜 같이 읽나: 이론은 컨텍스트를 외부(파일·메모리 계층)로 덜어내는 Write 전략과 MemGPT식 OS형 메모리 관리를 설명한다. 구현은 프레임워크가 세션 간 상태를 실제로 어디에·어떻게 저장·복원하는지 보여준다. “무엇을 컨텍스트 밖으로 빼내고 언제 다시 불러올까”를 이론과 구현으로 교차 확인한다.

5. Claude Code / Codex 실전

이론 (WHY)	구현 (HOW)
CLAUDE.md 메모리 계층 · 서브에이전트 컨텍스트 격리 · /compact·자동 컴팩션	Claude Code 개요 · CC 프롬프트 조립
Codex AGENTS.md 설정 · 실패모드↔공식기능 매핑표	Codex 개요 · CX 컨텍스트 조립

왜 같이 읽나: 이론 08장은 5대 실패모드를 Claude Code·Codex의 공식 기능(메모리 계층·컴팩션·서브에이전트)에 1:1로 매핑한다. 구현 10장은 같은 두 도구를 내부 동작 관점에서 해부한다. “이 기능이 어떤 실패를 막는가(이론)“와 “이 기능이 내부적으로 어떻게 도는가(구현)“를 같은 도구를 두고 겹쳐 읽을 수 있다.

6. 가드레일 & 오염 방어

이론 (WHY)	구현 (HOW)
오염 방어전략 · paper: CaMeL 방어	가드레일·샌드박스 횡단
불변규칙·쓰기보호 · 컨텍스트=슬롯 계약 4계층	CX 샌드박스·승인 · CC 가드레일

왜 같이 읽나: 이론은 오염·룰 침범을 막기 위한 방어전략(격리·출처 신뢰·불변규칙, CaMeL)과 “컨텍스트=슬롯 계약” 거버넌스 모델을 제시한다. 구현은 샌드박스·승인 게이트·쓰기보호 규칙이 하네스에서 실제로 어떻게 강제되는지 보여준다. “무엇을 신뢰하지 말아야 하나”의 원칙이 권한·승인 메커니즘으로 구현되는 지점을 잇는다.