이 페이지는?

Harness Engineering 영상의 핵심 내용을 정리한 보충 자료입니다.

영상에서 다룬 하네스 엔지니어링의 개념, 4가지 기둥, 그리고 **실제 시스템이 어떻게 작동하는지 의사코드(pseudo-code)**로 확인할 수 있습니다.

한 줄 요약

<aside> 💡

AI 에이전트가 실수했을 때, 프롬프트를 고치지 마세요. 마구(harness)를 고치세요.

그 실패가 구조적으로 반복 불가능하도록 시스템을 바꾸는 것 — 그게 하네스 엔지니어링입니다.

</aside>

AI 활용 방법론의 4가지 축

AI를 활용하는 방법론은 4가지 축으로 나뉩니다. 순서대로 졸업하는 게 아니라 전부 다 필요한 상호보완적인 축이에요.

🐴 말(Horse) 비유로 이해하기

AI 에이전트를 거대한 **짐말(draft horse)**이라고 생각해 보세요.

<aside> 🏋️

에이전틱 엔지니어링 = 말 훈련

추론 루프 설계, 멀티 에이전트 조율, 도구 사용법 교육 → 말 자체를 더 강하게 만드는 것

</aside>

<aside> 🔧

하네스 엔지니어링 = 마구 제작

가죽 끈, 고삐, 수레를 만드는 것 → 말이 밭을 갈 수 있도록 방향과 한계를 정해주는 장비

</aside>

<aside> ⚡

말을 아무리 잘 훈련시켜도, 마구 없이는 밭을 갈 수 없습니다.

</aside>

하네스 엔지니어링의 4가지 기둥

기둥 1: 기계가 읽는 컨텍스트 파일

CLAUDE.md, AGENTS.md, .cursorrules 같은 파일들은 단순한 문서가 아니라 AI가 실행하는 런타임 설정 파일입니다.

<aside> 📄

예시: CLAUDE.md에 "새로운 라이브러리를 도입하지 마. DB 쿼리는 반드시 ORM을 통해서만 해."라고 쓰면, AI 에이전트는 이 규칙을 자신의 행동 제약으로 인식합니다. 매번 프롬프트에 반복할 필요가 없어요.

</aside>