ICLR 2026를 계기로 harness(실행 계층)와 scaffold(행동 정의 계층)를 분리하는 좁은 정의가 정리되었지만, 실무 현장에서는 모델을 제외한 모든 것을 통칭하는 포괄적 AI harness 개념이 훨씬 널리 쓰입니다.
AI 하네스 wiki에서는 skill, hook, rule 과 같은 포괄적 개념의 하네스에 대해 다룹니다.
본 포스트에서는 하네스와 스캐폴드에 대한 정의에 대해 짧게 정리하였습니다.
1. 하네스 용어 혼란 #
이 논의는 ICLR 2026 직후 한 연구자가 던진 질문에서 비롯되었습니다.
컨퍼런스에서 harness와 scaffold에 대한 여러 설명을 들었지만 하나로 수렴하지 않더라는 것입니다.
2. 공식 정의 #
| 구분 | Scaffold (스캐폴드) | Harness (하네스) |
|---|---|---|
| 역할 | 모델의 행동을 정의하는 층 | 모델을 실제로 실행하는 층 |
| 구성 | 시스템 프롬프트, 도구 설명, 응답 파싱 방식, 컨텍스트 관리(기억) | 모델 호출, tool call 처리, 중단 시점 결정, 권한 게이트, 오류 복구 |
| 비유 | 모델이 “보고 따르는 것” | 에이전트를 “돌아가게 만드는 것” |
| 한 문장 | 모델이 무엇을 보고 어떻게 행동할지 결정 | 루프를 돌리고 언제 멈출지 결정 |
- Scaffold = 모델 주변에서 행동을 정의하는 층. 학습이든 추론이든 모델이 세상을 어떻게 보고 행동할지를 형성합니다
- Harness = 에이전트 내부의 실행 계층. 모델을 호출하고, 도구 호출을 처리하며, 언제 멈출지 결정한다. harness engineering은 이 계층(중단 시점, 오류 처리, 가드레일)을 잘 설계하는 분야로, 학습·추론 양쪽에 적용됩니다.
3. 포괄적 하네스 개념 #
Claude Code, Codex, Antigravity CLI 같은 제품은 전체를 통째로 harness라고 부릅니다. 넓은 의미에서 harness = 모델이 아닌 모든 것을 뜻합니다.
- Claude Code 공식 문서도 직접 표현한다: “Claude Code는 Claude를 감싸는 agentic harness로서, 언어 모델을 유능한 코딩 에이전트로 바꿔주는 도구·컨텍스트 관리·실행 환경을 제공한다.”
- 커뮤니티 공식처럼 통용되는 표현도 Agent = Model + Harness다. “모델이 아니면 곧 harness”라는 식.
- “scaffold”라는 단어도 더 넓게 쓰여, hooks·런타임 설정·디렉터리 구조까지 harness가 의존하는 모든 인프라를 가리키기도 한다.
즉 구조적으로 scaffold ⊂ harness(넓은 의미) 가 되며, scaffold/harness를 별도로 분리해 추론해야 하는 경우는 주로 학습(RL) 파이프라인 맥락입니다.
