하네스 엔지니어링(Harness Engineering): AI 에이전트 팀 구축을 위한 혁신적 프레임워크

최근 LLM(대형 언어 모델)의 발전으로 코딩 보조 도구들이 비약적으로 성장했습니다. 하지만 여전히 복잡한 시스템 설계나 다단계 파이프라인이 필요한 작업에서는 단일 모델의 한계가 명확합니다. 이러한 한계를 극복하기 위해 등장한 개념이 바로 하네스 엔지니어링(Harness Engineering) 입니다.

이 글에서는 하네스 엔지니어링의 핵심 개념과 함께, 실제 프로젝트에 어떻게 적용할 수 있는지 Harness 오픈소스 저장소의 내용을 바탕으로 자세히 알아보겠습니다.

1. 하네스 엔지니어링이란?

하네스(Harness) 는 본래 말의 마구나 안전벨트처럼 무언가를 '잡아매고 조절하는 장치'를 뜻합니다. 소프트웨어 공학에서의 하네스는 특정 시스템을 테스트하거나 실행하기 위해 필요한 부수적인 환경과 도구들의 집합을 의미합니다.

하네스 엔지니어링 은 여기서 한 걸음 더 나아가, AI 에이전트들이 복잡한 도메인 지식을 이해하고 협업할 수 있도록 최적화된 '팀 아키텍처'를 설계하고 구축하는 기술 을 말합니다.

2. Software 3.0 시대, 하네스가 필요한 이유

최근 토스 테크(Toss Tech) 블로그의 Software 3.0 시대, Harness를 통한 조직 생산성 저점 높이기 아티클에서는 하네스가 현대 소프트웨어 개발 팀에 왜 필수적인지 명확한 이유를 제시합니다.

• 개인의 '센스'를 팀의 '시스템'으로 (Raising the Floor)

동일한 LLM을 사용하더라도 개개인의 'AI 리터러시'에 따라 결과물의 품질 차이가 매우 큽니다. 하네스는 뛰어난 엔지니어의 노하우를 '실행 가능한 코드'로 패키징하여 배포함으로써, 팀 전체의 생산성 저점(Floor)을 상향 평준화합니다.

• 살아있는 문서, 실행 가능한 SSOT (Executable SSOT)

기존의 위키나 노션 문서는 작성되는 순간 낡은 정보가 되기 쉽습니다. 하지만 하네스로 정의된 지식은 사람이 읽으면 가이드라인이 되고, LLM이 읽으면 즉시 실행 가능한 지시사항이 됩니다. 문서와 코드의 괴리를 없애는 진정한 의미의 SSOT(Single Source of Truth) 역할을 수행합니다.

• 도메인 최적화와 예측 가능성

범용 AI 도구는 우리 팀의 구체적인 도메인 맥락(코딩 컨벤션, 비즈니스 로직 등)을 모릅니다. 하네스는 우리 팀만의 '도메인 레이어'를 구축하여 AI가 팀의 규칙을 준수하게 만들며, RAG(검색 증강 생성) 방식보다 훨씬 높은 예측 가능성과 신뢰성을 제공합니다.

3. 핵심 개념: 6가지 팀 아키텍처 패턴

하네스 프레임워크는 문제의 성격에 따라 6가지 표준화된 팀 아키텍처 패턴을 제시합니다.

4. 구체적인 사용법 (Harness Plugin 활용)

Harness 저장소에서는 Claude Code를 위한 플러그인 형태의 도구를 제공합니다.

설치 및 설정

먼저 Claude Code에서 에이전트 팀 기능을 활성화해야 합니다.

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

그 다음, 하네스 플러그인을 설치합니다.

/plugin marketplace add revfactory/harness
/plugin install harness@harness

하네스 구축하기

설치가 완료되면 Claude Code에게 다음과 같이 명령하기만 하면 됩니다.

"하네스 구성해줘" (또는 "Build a harness for this project")

하네스는 다음과 같은 단계를 거쳐 자동으로 팀을 구성합니다.

1. 도메인 분석: 프로젝트의 성격 파악
2. 팀 아키텍처 설계: 최적의 패턴 선택 (위의 6가지 중)
3. 에이전트 정의 생성: .claude/agents/ 폴더 내 생성
4. 스킬 생성: 에이전트가 사용할 도구(.claude/skills/) 정의
5. 검증 및 테스트: 팀이 제대로 동작하는지 확인

5. 실전 활용 사례 (Prompts)

하네스를 설치한 후, 다음과 같은 프롬프트를 통해 즉시 전문 에이전트 팀을 꾸릴 수 있습니다.

• 풀스택 웹 개발 팀 구축

Build a harness for full-stack website development. 
The team should handle design, frontend (React/Next.js), backend (API), 
and QA testing in a coordinated pipeline from wireframe to deployment.

결과: 디자이너, 프론트엔드 개발자, 백엔드 개발자, QA 엔지니어로 구성된 팀이 자동으로 설정됩니다.

• 심층 리서치 및 보고서 작성

Build a harness for deep research. 
I need an agent team that can investigate any topic from multiple angles 
— web search, academic sources, community sentiment 
— then cross-validate findings and produce a comprehensive report.

• 코드 보안 및 리팩토링

Build a harness for comprehensive code review. 
I want parallel agents checking architecture, security vulnerabilities, 
performance bottlenecks, and code style 
— then merging all findings into a single report.

6. 마치며: 하네스 진화 메커니즘

하네스 엔지니어링의 가장 흥미로운 점은 '진화(Evolution)' 입니다. 실제 프로젝트에서 사용하면서 발생한 피드백을 /harness:evolve 스킬을 통해 피드백하면, 다음 세대의 하네스는 이전보다 더 정교하고 프로젝트에 최적화된 형태로 생성됩니다.

단순히 AI에게 코드를 짜달라고 하는 시대를 넘어, 이제는 **AI 팀을 어떻게 구성하고 관리할 것인가(Harness Engineering)**가 엔지니어의 핵심 역량이 되고 있습니다. 여러분의 프로젝트에도 하네스를 도입해 생산성을 극대화해 보세요!

참고 링크:

• Harness GitHub Repository
• Harness 100 - 100가지 기성품 하네스 모음
• 토스 테크: Software 3.0 시대, Harness를 통한 조직 생산성 저점 높이기