🤖 레슨

하네스 엔지니어링 — 모델이 아니라 작업장이 실력이다

같은 모델인데 순위가 30위→5위로? 비밀은 작업장 설계. 프롬프트→컨텍스트 다음의 '4번째 패러다임'이에요.

① 오늘의 미스터리

같은 AI인데, 왜 옆 가게는 사고가 날까

옆 동네 반찬가게 사장님도 우리와 똑같은 AI를 씁니다. 그런데 결과가 딴판이에요. 우리 가게는 유통기한 사고 한 번 없이 척척, 옆 가게는 가격이 틀리고 만료 반찬이 올라가고… "역시 나는 AI를 못 다루나봐"라며 한숨을 쉬시죠.

모델이 같은데 결과가 다르다 — 오늘은 이 미스터리의 범인을 잡고, 2026년 상반기 업계가 가장 주목하는 기술, 하네스 엔지니어링을 배웁니다.

설명을 따라 진행하면, 여기서 직접 쳐보게 돼요 👇

~/my-shop

$ _

📚 「하네스 엔지니어링 — 모델이 아니라 작업장이 실력이다」 레슨 내용 전체 텍스트로 훑어보기

같은 AI인데, 왜 옆 가게는 사고가 날까

모델이 같은데 결과가 다르다 — 오늘은 이 미스터리의 범인을 잡고, 2026년 상반기 업계가 가장 주목하는 기술, 하네스 엔지니어링을 배웁니다.

같은 모델을 쓰는데 두 가게의 결과가 딴판이에요. 차이는 어디서 났을까요?

맞아요. 지난 레슨에서 본 하네스(AI를 둘러싼 작업 환경 전체)가 범인이에요. 우리 가게엔 hook·규칙·검증이 깔려 있고, 옆 가게는 맨바닥에서 AI 혼자 일하고 있었던 거죠. 모델이 아니라 작업장이 실력입니다.

이걸 한 줄 공식으로 쓰면 이렇게 돼요.

에이전트 = 모델 + 하네스

에이전트의 실력은 모델 혼자 정하지 않아요. 같은 모델도 어떤 작업장(하네스)에 넣느냐에 따라 실력이 천차만별로 갈립니다.

실제로 증명된 이야기

2026년 3월, LangChain 팀이 에이전트 실력 시험(Terminal Bench 2.0)에서 모델은 한 글자도 안 바꾸고 하네스만 고쳐 순위를 30위에서 5위로 끌어올렸어요. 모델 교체 없이, 작업장 설계만으로요.

AI를 잘 쓰는 기술은 이렇게 진화해왔어요. 우리도 이 순서대로 배워왔죠.

세 번의 진화

1️⃣ 프롬프트 엔지니어링 — 한 문장을 잘 쓰기 ("이렇게 부탁하면 답이 좋아져요")
2️⃣ 컨텍스트 엔지니어링 — 맥락을 잘 주기 (CLAUDE.md·파일·책상 관리)
3️⃣ 하네스 엔지니어링 — 작업장 전체를 설계하기 (도구·규칙·검증·감시까지)

업계에선 하네스 엔지니어링을 '4번째 패러다임'이라고 부르기도 해요. 한 문장 → 맥락 → 작업장 전체로, 설계하는 범위가 점점 넓어진 거예요.

그럼 작업장을 '설계'한다는 건 구체적으로 뭘 정하는 걸까요? 딱 4가지예요. 주방에 비유하면 —

하네스의 4요소

🔧 도구 — 무엇을 쓸 수 있나 → 주방 설비 (칼·솥·저울)
🚧 가드레일 — 무엇을 못 하게 하나 → 위생 규칙 (만료 반찬 금지)
🔁 피드백 루프 — 스스로 고치게 → 맛보기 검사 (간 보고 다시 간하기)
👁 관찰가능성 — 사람이 지켜볼 수 있게 → CCTV (무슨 일이 있었는지 기록)

하네스 엔지니어링 = 이 4요소를 내 가게에 맞게 채워 넣는 일이에요.

먼저 우리 가게 작업장에 이미 어떤 부품이 깔려 있는지 창고를 열어봐요. 지금까지의 코스에서 하나씩 만들어온 것들이에요.

ls .claude — 작업장 부품 창고를 열어봐요

ls .claude/skills — 스킬 선반도 확인

전부 낯익죠? 스킬은 도구, 유통기한 hook은 가드레일, CLAUDE.md는 위생 규칙. 우리가 코스 내내 만들어온 게 사실 전부 하네스 부품이었던 거예요.

'유통기한 지난 반찬 등록을 차단하는 PreToolUse hook' — 하네스 4요소 중 어디에 해당할까요?

맞아요. 차단하는 장치 = 가드레일이에요. 같은 hook이라도 기록만 남기면 관찰가능성(CCTV), 막으면 가드레일(위생 규칙) — 역할로 분류하는 게 하네스 엔지니어의 눈이에요.

이제 하네스 엔지니어처럼 일해봐요. 첫 단계는 점검 — 4요소 중 뭐가 비었는지 찾는 거예요. 점검도 Claude에게 시키면 됩니다.

내 작업장을 하네스 관점에서 점검해줘. 도구·가드레일·피드백 루프·관찰가능성 4가지 중 빠진 게 뭐야?

— 4요소 관점으로 작업장 점검을 맡겨요

진단이 나왔어요 — 맛보기 검사(피드백 루프)와 CCTV(관찰가능성)가 빈 자리. 하네스 엔지니어링은 이렇게 빈 요소를 찾아 채우는 일이에요.

빈 자리 중 피드백 루프를 채워봐요. AI가 일한 결과를 스스로 검사하고 틀리면 고치게 하는 부품이에요.

상품 페이지를 만들 때마다 가격이 ₩ 표기인지 스스로 검사하고, 틀리면 바로 고치게 해줘

— 스스로 검사하고 고치는 장치를 부탁해요

ls .claude — 부품이 추가됐는지 창고를 다시 확인

모델은 한 글자도 안 바꿨어요. 작업장에 부품 하나를 더했을 뿐인데, 이제 가격 실수가 사장님 손까지 오지 않아요. LangChain이 30위→5위로 오른 것도 — 이것의 큰 버전입니다.

오늘의 공식. 빈칸에 들어갈 말은?

정답, 하네스(harness)예요. 에이전트의 실력 = 모델 × 작업장. 모델은 내가 못 바꾸지만 하네스는 전부 내 손으로 설계할 수 있어요 — 그래서 이게 '기술'이 됩니다.

AI가 일을 자꾸 망칠 때, 하네스 엔지니어는 어떤 순서로 움직일까요? (↑↓로 정렬)

정확해요. 관찰 → 진단 → 부품 추가 → 재측정. '더 좋은 모델 없나'가 아니라 '작업장 어디가 비었나'를 묻는 것 — 이게 하네스 엔지니어의 루틴이에요.

AI가 또 가격을 틀렸어요. 하네스 엔지니어링을 배운 사장님의 첫 질문은 무엇이어야 할까요?

맞아요. 같은 모델로도 작업장 설계만으로 30위→5위가 됐죠. 실패의 대부분은 모델 탓이 아니라 비어 있는 하네스 요소 탓이에요. 점검 → 진단 → 부품 추가, 이 순서로요.

한 줄로

에이전트 = 모델 + 하네스. 모델이 아니라 작업장이 실력이에요. 그리고 돌아보면 — 우리가 배운 CLAUDE.md·skill·hook·권한·검증 루프가 전부 하네스 부품이었어요. 여러분은 이미 하네스 엔지니어링을 하고 있었던 겁니다.

다음 레슨 예고 — 루프 엔지니어링

그런데 2026년 6월 지금, 업계에서 한 발 더 나간 말이 돌고 있어요 — "프롬프트를 치지 말고, 프롬프트하는 루프를 설계하라." 잘 지은 작업장 위에서, 간이 맞을 때까지 스스로 도는 시스템을 설계하는 법. 다음 레슨에서 만나요. 🔁