하네스 엔지니어링이란 무엇인가 — 에이전트·MCP·스킬로 AI 성능을 끌어올리는 법

핵심 메시지

• 질문과 답변만 주고받던 시절에는 프롬프트를 다듬고 검색 증강을 붙이는 일이 요령이었지만, 도구를 직접 쓰는 요즘 AI에서는 초점이 달라졌다.
• 하네스는 AI가 파일을 읽고 고치고 명령을 실행하도록 도구를 붙여 주고 사용법을 안내하는 껍데기, 즉 에이전트와 그 안의 MCP·스킬을 가리킨다.
• 이 껍데기를 손보는 일이 하네스 엔지니어링이며, 잘하면 값비싼 모델을 쓰지 않아도 성능이 크게 오른다는 연구가 여럿이라고 영상은 전한다.
• 본격적으로 하려면 코딩과 에이전트 구조에 대한 사전 지식, 그리고 실험을 돌릴 GPU나 비용이 필요해 진입 장벽이 낮지 않다.
• 대신 MCP와 스킬 파일, AGENTS.md 같은 문서로 에이전트를 가르치는 가벼운 방식은 누구나 해 볼 수 있다.

쉽게 이해하기

코딩애플이 '요즘 판교사투리'라는 이름으로 다룬 5분짜리 영상이다. 주제는 최근 개발자들 사이에서 자주 들리는 하네스 엔지니어링이라는 말이다. 영상은 AI에게 질문하고 답을 받던 시절에는 프롬프트를 다듬고 검색 증강으로 맥락을 잘 넣어 주는 기법이 유행이었다고 짚는다. 하지만 요즘 모델은 훨씬 똑똑하고 할 수 있는 일도 많아져서, 그냥 풀어 놓는 대신 목줄을 채우고 가르쳐 쓰는 쪽으로 관심이 옮겨 갔다는 것이다.

여기서 말하는 하네스가 무엇인지가 핵심이다. 요즘 쓰는 코딩 도구들은 AI에게 파일 읽기와 수정, 웹 검색, 터미널 명령 실행 같은 도구를 붙여 주고 그것을 잘 쓰도록 안내하는 프로그램이다. 영상은 이런 프로그램 자체를 하네스라고 부르고, 그 안에서 기능을 확장하는 MCP와 스킬도 같은 범주로 묶는다. 예를 들어 깃허브용 MCP를 설치하면 AI가 직접 저장소에 접속해 코드를 올릴 수 있게 되는데, 이런 장치로 AI를 통제하고 가르칠 수 있기 때문이다.

구체적인 사례로 든 것은 오마이파이라는 터미널용 에이전트다. 파이라는 오픈소스 에이전트를 가져다 코드 수정 방식을 뜯어고친 물건인데, 차이는 AI에게 수정 사항을 어떤 형식으로 뱉게 하느냐에 있다. 어떤 에이전트는 깃의 diff처럼 출력하게 하고, 클로드 코드는 변경할 코드를 그대로 뱉게 한 뒤 원본에서 같은 부분을 찾아 교체하는 식으로 구현돼 있다고 영상은 설명한다. 오마이파이는 이 방식이 마음에 들지 않아 각 줄에 무작위 문자를 붙여 두고 그 표식을 기준으로 수정하게 했는데, 그 결과 성능이 떨어지는 모델을 써도 코딩 점수가 크게 올랐다는 것이다. 클로드 에이전트 SDK로 역할이 다른 에이전트를 여럿 만들어 돌렸더니 긴 작업을 이어 갈 수 있었다는 사례도 함께 소개된다.

다만 영상은 단점도 분명히 짚는다. 에이전트를 직접 개조하려면 코딩과 에이전트 구조를 알아야 하고, 만든 하네스가 실제로 나은지 확인하려면 실험을 많이 돌려야 해서 좋은 GPU나 비용이 필요하다. 모델에 따라 결과가 달라질 수 있다는 점도 언급되는데, 특정 모델은 자기 회사가 만든 도구가 아닌 다른 하네스를 씌우면 잘 돌아가지 않는다는 이야기가 있다는 정도로 조심스럽게 전한다. 그래서 영상이 권하는 현실적인 방법은 MCP와 스킬을 조금씩 손보는 쪽이다.

가벼운 하네스 엔지니어링의 예도 구체적이다. 코드가 제대로 돌지 않는데 완성했다고 답하는 문제가 잦다면, 브라우저를 조작하는 MCP를 붙여 AI가 스스로 동작을 확인하게 만들 수 있다. 발표 자료를 만들 때 자꾸 글자 크기를 줄인다면 그러지 말라고 스킬 파일에 적어 두면 되고, 매번 지시하기 귀찮으면 에이전트가 알아서 읽는 문서 파일에 규칙을 적어 두면 된다. 프로젝트가 커져 AI가 파일을 훑기 버거워지면 구조를 문서로 정리하고, 길어지면 여러 파일로 쪼개는 편이 낫다. 영상은 이 모든 것이 결국 프롬프트로 길게 들어가는 지시라는 점을 상기시키며, 개에게 말로 명령하는 것과 같아서 지시가 복잡해지면 중간에 잊고 무시할 수 있다는 비유로 마무리한다.

주요 인사이트

• 이 용어의 실체는 새로운 기술이라기보다 이미 하고 있던 일에 이름이 붙은 것에 가깝다. 영상 스스로도 '실은 다 아는 것들'이라고 인정하는데, 그래서 오히려 어디까지가 하네스인지 정의가 흔들리기 쉽다.
• 모델을 바꾸지 않고 껍데기만 손봐도 성능이 오른다는 관찰은 비용 구조를 바꾼다. 굳이 비싼 모델을 쓸 이유가 줄어든다는 것이 영상이 짚은 함의다.
• 하네스와 모델은 서로 맞물려 있다. 특정 모델이 자기 회사 도구 밖에서 잘 안 돌아간다는 이야기가 사실이라면, 하네스를 고르는 일이 곧 모델을 고르는 일이 된다.
• 문서로 규칙을 적어 두는 방식은 결국 프롬프트 길이를 늘리는 일이다. 지시가 늘수록 지켜지지 않을 확률도 함께 늘어난다는 점을 영상은 명확히 경고한다.

자주 묻는 질문

관련 AI 소식