하네스 엔지니어링, 왜 지금 이렇게 많이 언급되는가

최근 들어 LinkedIn, X 등 다양한 채널에서 하네스 엔지니어링(Harness Engineering)이라는 키워드가 자주 언급되고 있다.

그렇다면 하네스란 무엇이며, 왜 이렇게까지 주목받고 있는 것일까?

처음 이 개념을 접하면 다소 허무하게 느껴질 수 있다.
흔히 말하는 “소문난 잔치에 먹을 것 없다”는 표현처럼, 하네스를 구성하는 개별 요소들은 이미 우리가 알고 있는 것들이다.

예를 들어 다음과 같은 것들이다.

• CLAUDE.md
• SubAgent
• Hooks
• MCP
• Skills

이 자체만 놓고 보면 새로운 개념이라기보다, 기존에 존재하던 구성 요소들의 집합처럼 보인다.
그렇다면 왜 이 개념이 다시 강조되고 있는 것일까?

---

하네스가 중요한 이유: 숨겨진 의도

이 질문에 답하기 위해서는 과거 개발 방식과 현재를 비교해볼 필요가 있다.

LLM이 등장하기 전, 우리는 ‘보일러플레이트 코드’라는 개념과 함께 일해왔다.
반복적으로 작성해야 하지만 반드시 필요한 코드들, 그리고 그로 인해 누적되는 개발자의 피로도는 당연한 것으로 받아들여졌다.

그러나 LLM이 등장한 이후 상황은 완전히 달라졌다.

이제는 다음과 같은 일이 가능해졌다.

• JPA를 깊이 이해하지 않아도 활용 가능
• 복잡한 설정 없이 빠르게 기능 구현 가능
• 반복 코드 작성 부담의 급격한 감소

즉, 코드를 작성하는 속도는 확실히 10배 가까이 빨라졌다.

그렇다면 질문을 하나 던질 수 있다.

우리의 서비스 가치도 10배 향상되었는가?

현실은 그렇지 않다.
코드 생산성은 비약적으로 증가했지만, 사용자에게 매력적인 서비스는 여전히 소수만 만들어지고 있다.

---

문제의 본질: LLM은 “야생마”다

이 현상의 핵심은 LLM의 동작 방식에 있다.

LLM에게 단순히 “무엇을 만들고 싶은지”만 전달하면,
그 모델은 매우 충실하게 결과를 만들어낸다.

하지만 그 과정에서 중요한 문제가 발생한다.

• 아키텍처에 대한 고민이 생략된다
• 트레이드오프가 고려되지 않는다
• 의사결정이 개발자 대신 LLM에 의해 자동으로 이루어진다

즉, 결과는 빠르게 나오지만 그 결과가 우리가 의도한 시스템인지 보장할 수 없다.

이 지점에서 하네스라는 개념이 등장한다.

---

하네스는 도구가 아니라 “프레임워크”다

하네스를 단순한 도구 집합으로 보면 본질을 놓치게 된다.
오히려 다음과 같이 이해하는 것이 더 적절하다.

하네스는 LLM의 동작 방식을 제어하고, 의도를 강제하는 프레임워크다

즉, 우리가 명시적으로 말하지 않아도
LLM이 더 나은 선택을 하도록 “유도하는 구조”라고 볼 수 있다.

흥미로운 점은, 최근 공개된 Claude Code 관련 정보에서도
성능 향상의 핵심 요소가 모델 자체가 아니라 모델을 감싸는 하네스 구조였다는 점이다.

이는 중요한 시사점을 준다.

앞으로의 경쟁력은 “모델을 얼마나 잘 쓰느냐”가 아니라
“모델을 어떻게 감싸고 제어하느냐”에서 나온다

---

그래서 하네스는 어떻게 설계해야 하는가

여기서 가장 중요한 질문이 남는다.

그래서 하네스를 어떻게 만들어야 하는가?

솔직히 말하면, 이 질문에 대한 정답은 아직 없다.
나 역시 여전히 고민하고 있는 영역이다.

다만 한 가지는 분명하다.

• 하네스 설계는 자동화되기 어렵다
• 도메인에 맞는 설계는 여전히 사람의 판단이 필요하다

이 점은 과거 우리가 이야기하던 개념과 매우 닮아 있다.

• 객체지향 설계
• 도메인 주도 설계

결국 중요한 것은 동일하다.

“이 도메인에서 어떤 책임과 협력이 필요한가?”

하네스 역시 마찬가지다.
도메인에 따라 LLM의 행동을 어떻게 제한하고, 어떤 선택을 유도할지 고민해야 한다.

---

변하지 않는 원칙은 존재할까

소프트웨어 개발에는 시대가 변해도 유지되는 원칙들이 존재한다.
그렇다면 하네스 설계에도 그런 원칙이 존재하지 않을까?

이 질문에 대한 답을 찾기 위해,
나는 Claude Code의 구조를 분석해보고자 한다.

---

다음 이야기

다음 글에서는 Claude Code의 내부 구조를 분석하고,
그 안에서 발견한 하네스 설계 패턴과 인사이트를 정리해보고자 한다.