미래이음연구소

목차

• 한눈에 보기 — 하네스 엔지니어링이란?
• 모델 → 프롬프트 → 하네스: 패러다임 전환
• OpenAI와 Anthropic이 같은 결론을 냈다
• 파인만식 깊은 이해 — 하네스와 편자
• AI 에이전트 팀 구성 실전
• 실전 도구 소개
• Q&A

한눈에 보기 — 하네스 엔지니어링이란?

하네스 엔지니어링이란 AI의 행동을 제한하고 목표에 집중하도록 환경을 설계하는 방법입니다.

모델 → 프롬프트 → 하네스: 패러다임 전환

OpenAI와 Anthropic이 동시에 같은 메시지를 내놓았습니다:

"이제 프롬프트 잘 쓰는 건 별로 안 중요하다"

OpenAI와 Anthropic이 같은 결론을 냈다

💬 쉽게 말하면: 프롬프트 장인 시대 끝.
이제는 AI가 일할 "사무실"을 잘 설계하는 사람이 이기는 시대 🧠

파인만식 깊은 이해 — 하네스와 편자

🐴 하네스: 엔진보다 중요한 '조향 장치'

LLM은 말처럼 강력하지만 통제 불가능합니다. 하네스 레이어가 있어야 비즈니스에 쓸 수 있습니다:

• ⏱️ 워크플로 엔진 — 작업 순서와 흐름 관리
• 🔄 리트라이·타임아웃 정책 — 실패 시 자동 재시도
• 👤 휴먼 검수 — 중요한 결정은 사람이 확인
• 🔐 권한·감사 로그 — 누가 뭘 했는지 기록

🧲 편자: 보이지 않는 '작은 부품'이 시스템 전체를 지탱

편자는 말발굽을 보호하는 작은 쇠조각이지만, 없으면 말이 다치고 마차 전체가 멈춥니다.

파인만식 한 줄 요약:
"말을 더 세 마리 붙이는 것보다, 제대로 된 마구와 편자를 다는 게 더 멀리, 더 안전하게 갑니다.
AI도 마찬가지로, 모델보다 그걸 둘러싼 장치가 세상을 바꿉니다."

AI 에이전트 팀 구성 실전

⚙️ Claude Code Agent Team 활성화

설정 파일 ~/.claude/settings.json에 아래 내용을 추가하면 에이전트 팀 기능을 활성화할 수 있습니다:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

🤖 서브에이전트로 회사와 조직을 대체한다

실제 건축 설계 사례에서 메인 에이전트가 서브에이전트들을 조율하는 구조:

• 🧠 메인 에이전트 — 전체 조율
• 📋 법규 분석 에이전트 — 건축법·조례 자동 분석
• 🎨 파사드 디자인 에이전트 — 외관 디자인
• 🏗️ 3D 모델링 에이전트 — 구조물 모델링
• 📊 API 연동 에이전트 — 외부 데이터 연동

결과: 복잡한 건축 설계 과정을 30분 만에 자동화!

실전 도구 소개

Q&A

Q. 하네스 엔지니어링이 프롬프트 엔지니어링을 대체하나요?
A. 대체라기보다 진화입니다. 프롬프트는 여전히 중요하지만, 이제는 프롬프트 하나에 의존하지 않고 시스템 전체를 설계하는 것이 핵심입니다.

Q. 비개발자도 하네스 엔지니어링을 할 수 있나요?
A. 네, bkit 같은 도구를 사용하면 코딩 없이도 에이전트 팀 구성이 가능합니다. 중요한 건 어떤 규칙을 만들지 설계하는 사고방식입니다.

Q. Claude Code에서 어떻게 적용하나요?
A. CLAUDE.md에 행동 원칙을 정의하고, settings.json에서 에이전트 팀을 활성화하면 됩니다. 서브에이전트를 나눠서 계획/실행/검증을 분리하는 것이 핵심입니다.

Q. OpenAI와 Anthropic 중 어떤 접근이 더 좋나요?
A. 둘 다 유효합니다. OpenAI는 규칙 기반 울타리, Anthropic은 AI 간 상호 감시 방식입니다. 실무에서는 두 가지를 함께 사용하는 것이 좋습니다.

Q. 하네스 엔지니어링을 배우려면 어디서 시작하나요?
A. bkit(bkit.ai) 문서를 읽고, Claude Code의 .claude 폴더 구조를 이해하는 것이 첫 걸음입니다. 미래이음연구소에서도 관련 교육을 진행합니다.

원본: 이준욱님 나눔 자료 (2026.03.28)