하네스 엔지니어링이란?

한 줄 정의

하네스(Harness) = LLM(거대 언어모델) 자체가 아니라, 그 모델이 실제로 일을 해내도록 감싸는 모든 장치. 입력을 채우고(컨텍스트), 도구를 쥐여주고(툴), 행동을 규칙으로 묶고(가드레일), 결과를 검증하는 틀.

비개발자 비유 - LLM = 똑똑하지만 기억상실에 손발이 없는 천재.

• 하네스 = 그 천재에게 메모(컨텍스트) 를 주고, 연장(툴) 을 쥐여주고, 업무규칙(가드레일) 을 정해주고, 검수자(검증) 를 붙이는 것.
• “하네스 엔지니어링” = 이 틀을 잘 설계하는 기술. 모델을 바꾸지 않고도 결과 품질을 끌어올린다.

하네스를 이루는 4기둥

flowchart LR
    A["컨텍스트<br/>무엇을 보여줄까"] --> M((LLM))
    B["툴<br/>무엇을 시킬 수 있나"] --> M
    C["가드레일<br/>무엇을 막을까"] --> M
    M --> D["검증<br/>제대로 했나"]
    D -->|실패시 반복| M

기둥	질문	예시 (세 시스템에서)
컨텍스트	모델에게 무엇을 보여줄까	CLAUDE.md / AGENTS.md, 메모리, 압축
툴	무엇을 시킬 수 있나	파일읽기·실행, MCP 서버
가드레일	무엇을 막을까	권한모드, 샌드박스, 승인정책, 훅
검증	제대로 했나	테스트 실행, 리뷰 에이전트, 반복 루프

에이전틱 엔지니어링 vs 하네스 엔지니어링

• 에이전틱 엔지니어링: LLM이 스스로 판단하고 도구를 써서 여러 단계를 실행하는 에이전트를 설계하는 큰 분야.
• 하네스 엔지니어링: 그 에이전트를 실제로 굴러가게 하는 실행 틀에 집중하는 실전 영역. 이 볼트의 주제.

왜 비개발자에게 중요한가

• 코드를 한 줄도 못 짜도, 하네스를 잘 설계하면 에이전트가 코드를 대신 짠다.
• 전직 준비생에게 이건 “프로그래밍 언어 암기”보다 빠른 진입로다 — 개념·설계·검증 감각이 핵심이라서.

다음 읽을거리

• 학습로드맵 로 순서 잡기
• 실물 보기: Claude Code는 어떻게 생겼나

개념