🐴 하네스 엔지니어링이란?
“마차가 얼마나 빠르냐보다, 커브길에서 뒤집히지 않고 목적지까지 가게 해 주는 장치가 진짜 기술이다.” — 파인만식 해석
하네스 엔지니어링(Harness Engineering)이란 AI의 행동을 제한하고 목표에 집중하도록 환경을 설계하는 방법이다.
- 🐴 하네스(마구) = AI가 일할 환경·규칙·감시 시스템을 만들어주는 것
- 🧲 편자(말발굽 쇠) = 테스트·모니터링·보안 같은 사소하지만 필수적인 디테일
- 🎯 모델 성능보다 주변 장치와 구조 설계가 실제 세상의 안전·신뢰성을 좌우한다
한눈에 보기
| 🐴 AI 모델 | 말 = 엔진 |
| 🔧 하네스 | 마구 = 조향장치 |
| 🧲 편자 | 말발굽 쇠 = 디테일 |
| 🏁 안전한 도착 | 신뢰할 수 있는 AI 시스템 |
📅 AI 시대의 진화 타임라인
OpenAI와 Anthropic은 같은 결론에 도달했다. “이제 프롬프트 잘 쓰는 건 별로 안 중요하다”
| 연도 | 시대 | 핵심 질문 |
|---|---|---|
| 2024년 | 🤖 모델 싸움 | 어떤 AI가 더 똑똑해? |
| 2025년 | ✍️ 프롬프트 | AI한테 뭐라고 말해야 돼? |
| 2026년 | 🏗️ 하네스 | AI가 일할 환경을 어떻게 짜? |
🏗️ 두 거인이 같은 결론을 냈다
| 기업 | 핵심 메시지 | 결과 |
|---|---|---|
| OpenAI | 프롬프트 수천 줄 쓰지 마. 대신 AI가 못 넘는 규칙을 만들어 | 사람이 코드 한 줄도 안 쓰고 100만 라인 소프트웨어 완성 |
| Anthropic | 하나한테 다 시키지 마. 계획/실행/검증 AI를 나눠 | 사람 없이 며칠간 혼자 일하는 에이전트 구현 |
📌 우리가 기억할 3가지
- AI가 실수하면? → 프롬프트 고치지 말고 시스템을 고쳐라
- 만능 AI 하나보다 → 작은 도구 3~5개로 쪼개라
- AI가 왜 그렇게 했는지 → 로그를 남겨라
프롬프트 장인 시대 끝. 이제는 AI가 일할 “사무실”을 잘 설계하는 사람이 이기는 시대 🧠
🐴 하네스와 🧲 편자 — 파인만식 깊은 이해
말(馬)한테 고삐 채우듯이 AI한테도 울타리 + 규칙 + 감시 시스템을 만들어주는 것이 하네스다.
🐴 하네스 레이어 구조
| 구성 요소 | 역할 |
|---|---|
| 🐴 LLM = 말 | 강력하지만 통제 불가능 |
| 🔧 워크플로 엔진 | 일정·순서 제어 |
| 🔄 리트라이·타임아웃 정책 | 안정성 확보 |
| 👤 휴먼 검수 | 품질 보증 |
| 🔐 권한·감사 로그 | 보안·추적 |
🧲 편자: 보이지 않는 ‘작은 부품’이 시스템 전체를 지탱
| 비유 | AI 시스템에서의 해당 요소 |
|---|---|
| 🧲 편자 | 테스트 코드 |
| 🧲 편자 | 모니터링 지표 |
| 🧲 편자 | 데이터 검증 |
| 🧲 편자 | 레이트 리미트 |
| 🧲 편자 | 라벨링 규칙 |
“사람들이 멋져 보이는 신경망 구조를 떠들 때, 실제로 시스템을 살리거나 죽이는 건 구석에 박힌 ‘못 하나’일 수 있다”
파인만식 한 줄 요약:
“말을 더 세 마리 붙이는 것보다, 제대로 된 마구와 편자를 다는 게 더 멀리, 더 안전하게 갑니다. AI도 마찬가지로, 모델보다 그걸 둘러싼 장치가 세상을 바꿉니다.”
📖 4장: AI 디자인 도구들
| 도구 | 링크 | 특징 |
|---|---|---|
| Stitch | stitch.withgoogle.com | Google의 AI 디자인 도구 |
| Pencil | pencil.dev | AI 기반 디자인 플랫폼 |
| Paper | paper.design | 협업 디자인 도구 |
📖 5장: Agent Teams — AI 에이전트 팀 구성
Claude Code Agent Team 활성화
설정 파일 ~/.claude/settings.json에 아래 내용을 추가:
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }🛠️ 하네스 엔지니어링 도구 비교
| 도구 | 링크 | 설명 |
|---|---|---|
| Jkit | GitHub Pages | bkit에서 영감받고 제작한 하네스 도구 |
| bkit | bkit.ai | 하네스 엔지니어링을 가장 잘 적용한 패키지 |
서브에이전트들로 회사와 조직을 대체한다
- 인공지능 서브 에이전트들을 조합하여 복잡한 건축 설계 과정을 30분 만에 자동화할 수 있다.
- 법규 분석, 파사드 디자인, 3D 모델링까지 유기적으로 연결한다.
- 전문가 개입 없이도 고품질 설계 결과물을 빠르게 생성한다.
✅ 학습 체크리스트
- ✅ 하네스 엔지니어링의 개념 이해하기
- ✅ 2024 → 2025 → 2026 패러다임 전환 파악하기
- ✅ 하네스와 편자의 비유 이해하기
- ⬜ 실제 AI 프로젝트에 하네스 원칙 적용해보기
- ⬜ bkit 또는 Jkit으로 에이전트 팀 구성 실습하기
- ⬜ 서브에이전트 워크플로 설계해보기
미래이음연구소 AI 교육
이신우 소장이 이끄는 미래이음연구소에서 바이브코딩, 하네스 엔지니어링, AI 에이전트 실전 교육을 진행합니다.
강의 문의: 010-3343-4000 | 홈페이지: lab.duonedu.net
원본 출처: Share Note for Obsidian (2026.03.28.)
