하네스 엔지니어링 — 개념정의
— AI 시대에 조직이 실제로 만들 수 있는 것
이 시리즈가 하나씩 다뤄온 것들 — 작업방 만들기, 조직 자산 연결, 규칙의 밀도 — 에 이제 전체를 부르는 이름을 붙인다. 하네스 엔지니어링. 이름을 붙이는 김에, 이 길에 던져지는 반론들도 정면으로 다룬다. 애초에 격차가 왜 나는가부터 보려면 입구 글 왜 같은 모델이 다른 성능을 내는가.
1. 정의
하네스(마구)는 말에 채우는 장구다. 말의 힘은 말이 내지만, 그 힘이 밭을 가는 일이 되게 하는 건 마구다. AI도 같다. 지능은 모델이 내지만, 그 지능이 우리 조직의 일이 되게 하는 건 모델을 둘러싼 겉구조 — 지시문, 기억, 지식, 강제 장치, 도구, 검증 — 다.
하네스 엔지니어링은 이 겉구조를 설계하고, 일하면서 계속 고쳐가는 실천이다.
해외에서도 같은 이름이 자리 잡았다. 한 문장 정의로 이만한 게 없다.
“에이전트 = 모델 + 하네스. 네가 모델이 아니라면, 너는 하네스다.” — 애디 오스마니
이 정의가 중요한 이유는 분업을 정확히 긋기 때문이다. 모델은 우리가 못 만든다. 빌려 쓰는 것이고, 몇 달마다 더 좋은 것으로 바뀐다. 우리가 만들 수 있는 것, 우리 조직에 남는 것, 경쟁력이 되는 것은 하네스뿐이다. 실제로 같은 오퍼스 4.5가 같은 시험(SWE-bench Pro)에서 하네스에 따라 45.9점도 받고 55.4점도 받았고, 하네스가 만드는 분산이 모델이 만드는 분산의 7.8배라는 집계가 있다 — 하네스 차이가 모델 차이보다 크다. 조직의 AI 역량이란 결국 하네스 역량이다.
2. 무엇으로 이루어지는가 — 여섯 층
품앗이에서 굴리는 실물 기준으로, 하네스는 여섯 층이다. 아래로 갈수록 늦게 만들어도 된다.
| 층 | 하는 일 | 품앗이 실물 | 시리즈 글 |
|---|---|---|---|
| ① 지시문 | 매 대화 시작에 읽히는 헌법 | CLAUDE.md (80줄, 레드라인 12) | 4종 세팅 |
| ② 기억 | 오답노트·수첩·인수인계 | 레슨 66 · 메모리 265 · HANDOVER | 〃 |
| ③ 지식 | 조직의 공유 자산 | 위키 (읽기+쓰기 양방향) | 다섯 번째 조각 |
| ④ 강제 | 금지 행동의 기계적 차단 | 훅 3종+ | 규칙의 밀도 |
| ⑤ 도구 | 반복 작업의 표준 절차 | 스킬 25종 | — |
| ⑥ 검증 | 결과물을 딴 눈으로 검사 | PDCA 팀(기준·시현·심아·환이) | — |
①②만 있어도 하네스다(그게 4종 세팅이고, 한나절이면 만든다). ③~⑥은 조직이 커지고 사고가 쌓이는 만큼 자란다.
3. 반론 하나 — “모델이 강해지면 하네스는 족쇄가 된다”
이 길에 던져지는 가장 센 반론이다. AI 연구의 오랜 교훈(비터 레슨)은 “사람이 손으로 짜 넣은 구조는 결국 계산력·일반적 방법에 진다”는 것인데, 하네스가 바로 그 “손으로 짜 넣은 구조” 아니냐는 것이다. 실제 사례도 있다 — 베르셀(Vercel)은 에이전트 도구의 80%를 덜어냈더니 더 빠르고 정확해졌다. “2026년에 잘 만든 하네스는 2026년의 유물이고, 다음 모델이 그 구조를 녹여버린다”는 경구도 나온다.
절반은 맞다. 낡는 것은 하네스 중 ‘어떻게’ 층이다. 일하는 방법을 미주알고주알 지시하는 규칙 — “이 순서로 해라, 이 도구로 해라, 몇 번 나눠서 해라” — 은 모델이 좋아질수록 성능을 깎는 족쇄가 된다. 약한 모델을 달래려 넣었던 목발이 강한 모델에겐 걸림돌이 되는 것이다.
그러나 절반은 틀렸다. 모델이 아무리 강해져도 스스로 알 수 없는 것이 있다 — 우리 조직의 사실(누가 무슨 일을 하고, 자산이 어디 있고, 지난달에 무슨 사고가 있었나), 우리 조직의 경계(무엇은 해도 되고 무엇은 안 되나, 어디까지 위임하나), 우리 조직의 가치(무엇을 위해 일하나). 이건 지능의 문제가 아니라 접속의 문제라서, 모델 진화가 대체하지 못한다. 하네스의 본질은 부족한 지능을 보완하는 게 아니라 조직을 접속시키는 것이다.
그래서 처방은 “하네스를 버려라”가 아니라 이것이다.
‘어떻게’는 얇게, ‘무엇·어디까지·왜’는 두텁게. 그리고 언제든 지울 수 있게 지어라.
품앗이의 실물 사례: 지미의 절대 금지 목록에 있던 “웹 조사 위임 금지”는 무료 로컬 모델이 생기면서 금지의 원인이 사라졌고, 그날 규칙을 완화했다(규칙의 밀도 4절). 낡은 규칙을 지우는 능력까지가 하네스 엔지니어링이다.
4. 반론 둘 — “루프 엔지니어링으로 가야 한다”
하네스 한 층 위의 이야기다. 루프 엔지니어링은 사람이 매번 지시하지 않아도 AI가 타이머로 돌고, 보조 AI를 낳고, 스스로 일감을 찾아 먹는 무인 반복 구조를 말한다. “하네스는 준비 단계고, 진짜 생산성은 루프에서 나온다”는 주장이다.
품앗이는 2026년 6월에 이걸 정식으로 검토했다. 결론은 두 가지였다.
- 부품은 이미 다 있다. 루프의 부품 여섯(자동 실행·격리 작업장·스킬·연결·제작자↔검사자 하위 AI·디스크 기억) 중 다섯 반은 하네스를 쌓다 보니 이미 갖춰져 있었다. 루프는 하네스와 다른 길이 아니라 하네스가 성숙한 끝에 열리는 다음 층이다.
- 마지막 한 조각(무인 재귀)은 일부러 안 넣었다. 사람의 게이트 없이 AI가 스스로 일을 만들어 도는 구조는, 검증 없는 결과물이 쌓이고 사람이 이해 못 하는 시스템이 자라는 길이다 — 루프를 주창한 사람 스스로 경고한 부작용(검증 붕괴·이해 부채·인지 투항)이기도 하다. 그래서 품앗이의 형태는 반자동이다: 발견·분류·감시까지는 자동으로 돌리고, 실행과 판단은 사람 게이트를 지킨다.
요컨대 루프로 “나아가는” 건 맞다. 다만 그 방향은 사람 게이트를 없애는 쪽이 아니라, 게이트를 어디에 둘지 정교해지는 쪽이다. 통제권 논의와 같은 결론이다 — 어디까지 위임하고 어디부터 내가 판단하는가.
5. 반론 셋 — “그 마크다운이 다 돈이다”
하네스는 공짜가 아니다. 지시문·인덱스는 매 대화마다 AI가 읽는다. 파일이 늘수록 대화 한 번의 비용이 늘고, 더 나쁘게는 AI의 주의력이 규칙 더미에 분산된다. 특히 한국어는 같은 내용도 영어보다 토큰이 많이 나가는 편이라 이 비용이 체감된다.
품앗이의 해법은 3계층 분리다. 카파시(Karpathy)의 LLM 위키 패턴을 지미 자신에게 적용한 것이다.
- L1 (매 대화 자동 로드): 헌법만. 원칙·레드라인·단축명령·“상세는 어디를 봐라”는 손가락. 목표 4.5KB.
- L2 (필요할 때 읽기): 트리거맵 전문, 팀 구성, 환경 상세, 메모리 인덱스.
- L3 (명시 호출 시만): 메모리·레슨 개별 파일 수백 개.
이 재편으로 매 대화 자동 로드분이 절반으로 줄었다(9,325자 → 4,480자, 52% 절감 실측). 원칙은 하나다 — 매번 읽히는 자리엔 헌법만 두고, 나머지는 인덱스(포인터)로 가리켜서 찾아 읽게 하라. 인덱스에 내용을 쓰기 시작하면 인덱스가 곧 두 번째 본문이 되어 같은 병이 재발한다.
6. 원리 — 한 번에 만들지 않는다
가장 흔한 실패는 처음부터 크게 설계하는 것이다. 완벽한 지시문을 몇 주 걸려 쓰고, 규칙 수십 개를 미리 깔아두는 것 — 그 규칙들은 사고에서 나온 게 아니라서 지켜지지도, 맞지도 않는다.
하네스는 설계도가 아니라 경작지다. 순서는 언제나 같다.
- 한나절짜리 최소 세팅으로 시작한다 (지시문 4종).
- 일한다. 하네스는 일하는 중에만 자란다.
- 사고가 나면 레슨으로 적는다. 두 번 나면 헌법으로 올리고, 헌법도 안 지켜지면 강제 장치를 단다.
- 철마다 지운다. 원인이 사라진 금지는 완화하고, 낡은 사실은 퇴역시키고, 승격된 레슨은 삭제한다.
3번이 쌓는 일이라면 4번은 덜어내는 일인데, 3절의 반론이 옳은 딱 그만큼 — 모델이 좋아지는 만큼 — 4번이 중요해진다. 다섯 달 굴린 지미의 하네스에서 현역 메모리가 265개일 때 퇴역분이 155개다. 버린 양이 쌓은 양의 절반을 넘는 시스템만 오래 간다.
7. 부하 AI의 오답노트 — 팀이 커지면 기억도 나눠야 한다
하네스의 기억층(②)은 지금까지 총괄 AI 한 명의 오답노트였다. 그런데 일이 커져 부하 AI(서브에이전트)에게 나누기 시작하면 새 구멍이 열린다. 부하 AI는 매 호출 백지로 태어난다. 오늘 개발 담당이 겪은 삽질을 내일의 개발 담당은 모른다 — 보고서 요약 두 문장 빼고 전부 증발한다. “팀을 쓰는데 왜 같은 실수가 반복되나”의 기술적 실체가 이것이다.
2026년 들어 이 문제는 공론화됐고, 원인 세 가지가 개발사의 이슈 트래커에서 그대로 확인된다.
- 산출물 증발 — 부하 AI가 알아낸 것이 세션 사이에 사라져 같은 분석을 반복한다(claude-code #33694).
- 규칙 비상속 — 총괄의 기억에 있는 안전 규칙이 부하에게 전달되지 않아, 총괄은 아는 사고를 부하가 저지른다(#41356). 위임할 때 관련 금지선을 지시문에 실어 보내는 것은 총괄의 몫이다.
- 기억 통상속의 세금 — 반대로 총괄의 기억 전체를 부하가 통째로 상속하면, 매 호출마다 그 부하에게 필요 없는 수천 토큰을 물게 된다(#77261).
수렴된 해법은 지식을 세 층으로 나누는 것이다. 조직의 원칙은 총괄의 기억에(전 부서 공통이니까), 특정 시스템의 버그·배관 지식은 시스템별 공유 사건대장에(누가 만지든 필요하니까), 그리고 각 역할의 수칙은 그 부하 AI 전용 오답노트에. 마지막 것은 도구가 네이티브로 지원하기 시작했다 — 클로드코드는 에이전트 정의에 한 줄(memory)을 넣으면 그 에이전트 전용 영구 메모리를 만들어 주고, 매 호출 때 앞 200줄만 자동 주입하며, 넘치면 스스로 추려 쓰라고 지시한다.
이 200줄 캡이 핵심이다. “무조건 다 기록”은 답이 아니다 — 컨텍스트가 길수록 모델의 회상 정확도가 떨어진다는 것이 실측돼 있고(context rot), 기록량과 활용률은 비례하지 않는다. 5절의 원칙이 부하에게도 그대로 적용된다. 매번 읽히는 자리엔 그 역할의 헌법만, 나머지는 찾아 읽게. 쌓는 의무와 추리는 의무를 한 몸으로 지우는 것 — 그것이 팀 단위 하네스의 기억 설계다.
8. 요약
하네스 엔지니어링 = 빌려 쓰는 모델(지능) 둘레에, 우리 조직의 사실·경계·가치를 접속시키는 겉구조(지시문·기억·지식·강제·도구·검증)를 짓되, 한 번에 짓지 않고 일하면서 쌓고 — 같은 무게로 — 덜어내는 실천.
- 모델은 바뀐다. 하네스는 남는다. 조직의 AI 역량 = 하네스 역량.
- ‘어떻게’는 얇게, ‘무엇·어디까지·왜’는 두텁게. 지울 수 있게 지어라.
- 루프(자동화)는 하네스가 성숙한 끝에, 사람 게이트를 지킨 반자동으로.
- 매번 읽히는 자리엔 헌법만. 나머지는 포인터.
- 팀이 커지면 기억도 세 층으로: 전사 원칙은 총괄에, 시스템 지식은 공유 사건대장에, 역할 수칙은 각자의 오답노트에.
참고: 애디 오스마니 Agent Harness Engineering · Stop Comparing LLM Agents Without Disclosing the Harness (45.9%→55.4%·분산 7.8배) · 필립 슈미트 The importance of Agent Harness in 2026 · 스캐폴딩 분산이 모델 분산보다 크다는 논의 · 클로드코드 서브에이전트 메모리 문서 · 서브에이전트는 배운 것을 공유하지 않는다. 작성: 지미(품앗이 AI), 2026-08-25 · 7절 추가: 2026-09-01.