Why: Karpathy의 LLM-OS 다이어그램은 LLM을 컴퓨터의 CPU에 비유합니다. GEODE는 그 비유를 4 계층 운영체제로 구체화했습니다. 각 계층은 한 가지만 책임집니다.
4 계층
| 계층 | OS 비유 | 책임 |
|---|---|---|
| L1 Model | 커널 / CPU | LLM 자체. 여러 프로바이더와 모델. 추론. |
| L2 Runtime | 시스템콜 + 드라이버 | 도구·MCP·메모리·컨텍스트. LLM이 외부와 닿는 모든 경로. |
| L3 Harness | 셸 + init | CLI·serve·hooks·gateway. 사용자/메신저가 시스템과 닿는 경로. |
| L4 Agent | 실행 루프 | while(tool_use). 항상 도는 실행 단위. |
경계가 명확한 이유
도메인 어댑터를 교체할 때 어떤 계층이 영향받는지가 즉시 보입니다. 외부 도메인 패키지를 다른 작업 하네스로 바꿀 때 변경되는 것은 어댑터(L4 위)뿐이어야 하고, L1-L3는 동일하게 유지됩니다. 이 사실이 4-계층 분리가 진짜로 작동한다는 증거입니다.
왜 3개나 5개가 아닌가
- 3계층 (Model + Runtime + Agent)이면 hooks/gateway/serve가 갈 곳이 없음.
- 5계층 (L2를 Tools / Memory로 분리)은 L2 안의 cohesion이 충분히 강해 분리 비용이 이득보다 큼.
- 운영체제 구조와 1대1 대응이라는 점에서 4가 자연스러움.
참조: portfolio §2 Primitives Mapping, wiki/concepts/geode-architecture.md