# 이동훈의 루트AI - 하네스 엔지니어링(Harness Engineering) 15분 완전 정리 > **영상 링크:** [YouTube 보기](http://www.youtube.com/watch?v=MFZX1I_REyg) > **발표/채널:** 이동훈의 루트AI**핵심 주제:** 프롬프트·컨텍스트 엔지니어링을 넘어 2026년 가장 주목받는 AI 에이전트 운용 환경 구축 기술 '하네스 엔지니어링'의 개념, 패러다임 변화, 4대 기둥, 5대 핵심 원칙 요약 *** ## 1\. 하네스 엔지니어링\(Harness Engineering\)이란? \[00:00:50\] * **어원 및 비유:** '하네스(Harness)'는 본래 \*\*말에 씌우는 마구(고삐, 안장, 제갈 등)\*\*를 뜻함 [00:01:30]. 아무리 힘세고 빠른 말이라도 마구 없이 들판에 풀어놓으면 제멋대로 행동하듯, AI 모델 역시 제약 없이 두면 오버라이팅이나 엉뚱한 방향 탐색 같은 오류를 범함 [00:01:46]. * **AI 분야에서의 정의:** AI 에이전트를 감싸고 있는 **제약 조건, 도구, 피드백 루프, 문서화 및 전체 운영 시스템 환경**을 의미함 [00:02:18]. * **구글 딥마인드 엔지니어(필립 슈미드) 비유:** * **AI 모델** = CPU [00:02:28] * **하네스** = 운영체제(OS) [00:02:28] * CPU 성능이 아무리 좋아도 OS가 부실하면 컴퓨터가 제대로 작동할 수 없는 것과 같은 원리임 [00:02:35]. * **핵심 목표:** 에이전트가 실수했을 때 단순 프롬프트 수정에 의존하지 않고, **시스템 구조 자체를 변경하여 실수가 재발하지 않도록 재설계**하는 것 [00:02:48]. *** ## 2\. 왜 2026년에 하네스 엔지니어링이 급부상했는가? \[00:03:01\] 1. **AI 모델 성능의 상향 평준화** [00:03:10] * Claude, GPT, Gemini 등 주요 LLM의 기본 성능 격차가 줄어듦에 따라, 어떤 모델을 쓰느냐보다 **모델을 둘러싼 시스템(하네스)이 성패를 좌우**함 [00:03:22]. * **LangChain 사례:** 모델 변경 없이 하네스 시스템만 개선하여 코딩 벤치마크 점수를 **52.8%에서 66.5%로 대폭 향상**(32위권 밖에서 Top 5 진입) [00:03:32]. 2. **데모에서 실무/프로덕션 환경으로의 전환** [00:03:45] * 단순 일회성 데모가 아닌 실제 프로덕션 코드베이스 및 장시간 복잡한 작업(Long-running tasks)에 에이전트를 투입하면서 궤도 이탈, 무한 루프, 자가 평가 오류 등의 문제점 발생 [00:04:09]. 프롬프트 교정만으로는 이를 해결하기 어려움 [00:04:29]. 3. **개념 확립 및 업계 확산** [00:04:39] * 2026년 2월, HashiCorp 공동 창업자 미쉘 하시모토(Mitchell Hashimoto)가 블로그를 통해 개념과 명칭을 체계화 [00:04:39]. * 직후 OpenAI가 \*\*"100만 줄의 코드를 사람 코딩 0줄로 구축한 5개월간의 실험"\*\*을 '하네스 엔지니어링'이라는 이름으로 공개하며 업계 표준으로 떠오름 [00:00:31], [00:05:03]. *** ## 3\. 엔지니어링 패러다임의 진화 흐름 \[00:05:14\] | 구분 | 프롬프트 엔지니어링 [00:05:14] | 컨텍스트 엔지니어링 [00:05:58] | 하네스 엔지니어링 [00:06:29] | | :--- | :-------------------- | :-------------------- | :------------------- | | **핵심 질문** | **"무엇을 말할까?"** [00:05:26] | **"무엇을 첨부/보여줄까?"** [00:06:09] | **"어떤 환경에서 일하게 할까?"** [00:07:02] | | **비유 (이메일)** | 완벽한 이메일 한 통을 작성 [00:05:38] | 필요한 첨부문서/참고자료 제공 [00:06:20] | 사무실 공간, 업무 규칙, 보고 및 피드백 체계 설계 [00:06:39] | | **적용 단위** | 단발성 질의응답 (1회성) [00:05:49] | 세션/작업 단위 [00:06:29] | AI가 작동하는 전체 시스템 및 환경 [00:06:39] | > **참고:** 하네스 엔지니어링은 프롬프트/컨텍스트 엔지니어링을 대체하는 것이 아니라, 이를 포괄하는 가장 최상위의 제어 틀로 기능함 [00:07:02]. *** ## 4\. 하네스 엔지니어링의 4대 기둥 \[00:07:26\] ### ① 컨텍스트 엔지니어링 (Context Engineering) [00:07:26] * **원칙:** "저장소(Repository) 내에 없으면 에이전트에게 존재하지 않는다." [00:07:50] * 슬랙 대화, 구글 독스, 머릿속 규칙 등 기계가 접근할 수 없는 정보는 모두 코드 저장소 내에 명시적 문서(`CLAUDE.md`, `AGENTS.md` 등)로 포함해야 함 [00:08:07]. * **오픈AI의 실패 교훈 (지도의 원칙):** 하나의 거대한 지시 파일에 모든 규칙을 몰아 넣으면 에이전트가 탐색을 포기하거나 이전 규칙과 충돌함 [00:08:37]. **1,000페이지 분량의 매뉴얼을 주지 말고 '지도(주소 및 분리된 가이드)'를 제공**하여 적시에 필요한 정보만 로딩하도록 설계 [00:09:08]. ### ② 아키텍처 제약 (Architectural Constraints) [00:09:18] * **원칙:** 구현 방식은 자유롭게 맡기되, **반드시 지켜야 할 아키텍처 규칙은 기계적으로 강제**함 [00:09:39]. * 단순 말로 부탁하는 프롬프트 대신, 불법 동작이나 규칙 위반 코드가 물리적으로 실행/합류되지 않도록 제약 구조를 마련 [00:09:58]. * 선택지와 자유도를 줄여줄 때 오히려 정답 탐색 속도가 비약적으로 올라가는 역설적 효과 발생 [00:10:08]. ### ③ 피드백 루프 (Feedback Loops) [00:10:20] * AI는 스스로 작성한 결과물의 오류를 제대로 인지하지 못하는 경향이 있음 (Self-Correction 한계) [00:10:20]. * **가이드(Guide) & 센서(Sensor) 시스템:** * **가이드:** 작업 수행 직전 방향을 제시하는 규칙/프롬프트 [00:11:01]. * **센서:** 실행 후 결과를 검증하고 실패를 즉각 피드백하는 테스트 자동화, 린터(Linter) 및 제3의 검증 모델 [00:10:41], [00:11:01]. ### ④ 엔트로피 관리 (Entropy Management) [00:11:12] * 에이전트가 코드를 계속 생성함에 따라 발생하는 중복 코드, 미사용 파일, 문서와 코드 간의 불일치 등 무질서(엔트로피)를 방지함 [00:11:21]. * 정기적으로 **정리 및 청소 전담 에이전트**를 구동시켜 참고용 코드베이스의 청결성을 유지함 [00:11:42]. *** ## 5\. 하네스 엔지니어링의 5대 핵심 원칙 \[00:11:53\] 1. **모델을 바꾸지 말고 환경을 바꿔라** [00:12:03] * 성능 문제 발생 시 모델 업그레이드보다 시스템/환경 설정(하네스) 개선이 더 큰 성과를 냄 [00:12:12]. 2. **실패에서 시작하라** [00:12:33] * 처음부터 완벽한 하네스를 만들려 하지 말고, 에이전트 실행 과정에서 발생하는 실제 실패 사례를 수집하여 이를 구조적으로 막는 장치를 점진적으로 추가 [00:12:33]. *(예: 매주 금요일 20분간 실패 사례를 하네스에 반영)* [00:12:50]. 3. **적게 넣어라 (최소 규칙의 법칙)** [00:12:58] * 과도하게 많은 규칙이나 AI가 자체 생성한 과다 문서 등은 처리 비용을 늘리고 에이전트 성능을 저하시킴 [00:13:05]. 최소한의 필수 규칙으로 최대의 제어 효과를 도출할 것 [00:13:16]. 4. **말로 하지 말고 시스템으로 강제하라** [00:13:18] * 프롬프트 지시사항은 에이전트가 무시할 위험이 있으나, 테스트 코드, CI/CD 파이프라인, 린터 등 **시스템 레벨의 강제 장치는 무시할 수 없음** [00:13:26]. 5. **하네스도 진화한다** [00:13:38] * 기반 AI 모델이 발전함에 따라 하네스 구조도 단순화 및 최적화 방향으로 꾸준히 개편되어야 함 [00:13:49]. *** ##