하네스 엔지니어링 (Harness Engineering)
별칭: Harness Engineering · 하네스 엔지니어링 · 하네스 · Agent Harness
요약
AI 에이전트가 추론에만 집중 할 수 있도록, 전체 수명 주기를 제어 하는 시스템 계층. 가이드(피드포워드) + 센서(피드백) + 권한 설계 + 검증 루프 + 메모리·재시도 + 인간 승인. 언어 모델 자체를 바꾸지 않고도 성능을 급등시키는 환경 설계의 기술 — case/langchain-harness-benchmark 52.8 → 66.5 점.
상세
Boris Cherny 의 정의 (entity/boris-cherny):
"AI 가 자기 작업을 스스로 검증 하게 만드는 환경."
Martin Fowler 의 정의 (entity/martin-fowler):
"에이전트를 프로덕션에서 작동하게 하는 숨겨진 아키텍처 계층."
LangChain 의 분해 — 4 통제망
| 통제 방식 | 실행 주체 | 설명 |
|---|---|---|
| 가이드 (Feedforward) | 행동 전 | 설계 원칙·코딩 컨벤션 사전 주입 |
| 센서 (Feedback) | 행동 후 | 출력 관찰 + 자가 수정 유도 |
| 컴퓨테이셔널 | CPU (결정론) | 단위 테스트, 정적 분석 |
| 인퍼렌셜 | GPU (의미론) | LLM as a judge — 코드 품질 의미 분석 |
4 계층 위치: term/four-layer-architecture 에서 3 계층 — SDK 위, 에이전트 아래.
concept/agentic-engineering / concept/spec-driven-development 와의 관계
| 개념 | 관점 |
|---|---|
| concept/spec-driven-development | 방법론 — Spec 우선 작성 |
| concept/harness-engineering | 환경 / 시스템 — 그 방법론을 강제 하는 운영 체제 |
| concept/agentic-engineering | 실행 모델 — Spec + 하네스 위에서 에이전트가 자기 검증 루프 수행 |
→ 세 개념은 겹치지만 시점이 다름. SDD = 입력 측 / Harness = 환경 측 / AE = 실행 측.
핵심 효과 (수치)
- LangChain (모델 변경 없이): 52.8 → 66.5점
- Microsoft Azure SRE: 45% → 75%
- SWE-bench: 12.5% → 53% (4×)
→ lesson/hrn-sdd-evidence 에서 6 출처 정량 데이터.
대표 구현체: Superpowers 프레임워크 (lesson/hrn-superpowers-framework) — 시각적 컴패니언 + 서브에이전트 + 2단계 리뷰.
방법론
강의에서 본 개념의 활용:
- 03 HRN — 본 강의의 정점 단원. 5 lesson 모두 본 카드의 분해.
- 02 VBC lesson/vbc-vs-sdd-hybrid — 5단계 플레이북이 하네스의 단편.
- 04 DSL — 하네스가 언어 로 표현됨 (CLAUDE.md / AGENTS.md / .cursorrules).
- 05 DEM — 라이브 시연이 하네스의 가시화.
- 06 CLN — 5대 검증 체크리스트 가 하네스의 압축본.
주의사항
- 번역 통일: 하네스 엔지니어링 한국어 음차. 제어망 공학 등 의역 자제.
- 하네스 어원: 말 안장 끈 / 낙하산 끈 — 자유롭게 움직이게 하면서도 떨어지지 않게 잡아주는 도구. 청중에게 친숙성 확보.
- 추상화 함정: 청중이 하네스 = 코드 로 오해할 수 있음 → 환경 + 도구 + 절차 + 문서의 통합 이라는 폭넓은 정의 강조.
- Superpowers 와 동일시 금지: Superpowers 는 대표 구현체 이지 하네스 자체 는 아님. 다양한 하네스 형태가 가능 (Cursor 의 Rules + Plan Mode 도 하네스).
- 3 개념 (SDD/Harness/AE) 의 분리 유지: 청중이 한 단어로 뭉치지 않게 매번 시점 차이 를 짚는다.