실전 하네스 엔지니어링
박성훈책 전체 구조를 이미 알고 있습니다. 바로 작성합니다.
---
## 도서 소개 — 《실전 하네스 엔지니어링》
**에이전트가 코드를 쓰는 세상에서, 엔지니어는 무엇을 하는가?**
2025년, Mitchell Hashimoto는 에이전트에게 기능 구현을 맡기기 시작했다. 에이전트는 빠르게 코드를 만들었다. 그런데 같은 실수를 반복했다. 그는 에이전트를 탓하지 않았다. 대신 AGENTS.md를 열고 한 줄을 추가했다. 그 한 줄이 다음번 실수를 막았다. 그 경험이 6개월 뒤 하나의 원칙이 됐다. *"에이전트가 실수할 때마다, 그 실수가 다시 일어나지 않도록 공학적 해법을 만들어라."*
이 책은 그 원칙을 조직 전체의 시스템으로 확장하는 방법을 다룬다.
---
### 이 책이 다루는 것
에이전트 하네스(Harness)는 AI 에이전트가 코드를 작성하는 환경 전체를 설계하는 기술이다. AGENTS.md 하나로 시작하지만, 성숙한 하네스는 다섯 개의 레이어로 구성된다. 에이전트에게 지시를 전달하는 **컨텍스트 레이어**, 잘못된 방향을 구조적으로 차단하는 **제약 레이어**, Initializer·Coding·GC 에이전트가 순환하는 **오케스트레이션 레이어**, 실패가 개선으로 이어지는 **피드백 루프**, 그리고 모델이 교체되어도 흔들리지 않는 **어댑터 레이어**.
Hashimoto의 개인 하네스, OpenAI Codex의 Initializer-Coding-GC 삼중 루프, Stripe의 Blueprint와 Minions 병렬 아키텍처, LangChain이 4번의 재설계 끝에 도달한 결론, Anthropic 내부 에이전트 운영 원칙까지. 이 책은 실제로 검증된 패턴들만을 담는다.
---
### 이 책의 구성
총 31개 챕터와 에필로그, 14개 부록으로 구성된다.
**PART I·II (WHY·WHAT)** 는 하네스 엔지니어링이 왜 필요한지, 그리고 하네스의 해부학적 구조를 다룬다. 에이전트가 왜 혼자서는 충분하지 않은지, 컨텍스트 드리프트·조기 완료 선언·Dead Letter 같은 실패 패턴들이 왜 반복적으로 나타나는지를 규명한다.
**PART III·IV·V (CORE·LIFECYCLE·TOOLS)** 는 하네스의 핵심 기술을 다룬다. 컨텍스트 엔지니어링, 아키텍처 제약 설계, 장기 실행 에이전트의 상태 관리, 그리고 MCP·A2A 프로토콜이 하네스 안에서 어떤 위치를 차지하는지를 설명한다.
**PART VI·VII (SAFETY·CASE)** 는 에이전트 안전 설계와 실제 사례를 다룬다. OpenAI, Hashimoto, Stripe, LangChain, Anthropic, Vercel이 각자 어떤 방식으로 하네스를 구축했는지, 그 선택의 이유와 트레이드오프를 분석한다.
**PART VIII·IX (ENTERPRISE·PRACTICE)** 는 엔터프라이즈 도입과 실전 연습이다. CPS 구조, 멀티에이전트 확장, Observability 시스템을 다루고, 직접 손을 움직이는 연습(AGENTS.md 구축, 커스텀 린터, Ralph Wiggum Loop, Stripe Minions 구현, MCP 통합)을 단계별로 안내한다.
**PART X·XI (IMPLEMENTATION·FUTURE)** 는 조직 도입 전략과 엔지니어의 미래를 다룬다. Hashimoto 6단계 모델, 파일럿-팀-전사 전환 전략, 버티컬 특화 하네스, AI CoE 설계부터 역할 변화와 열린 질문들까지.
---
### 이 책이 필요한 사람
에이전트를 써봤는데 같은 실수가 반복되는 팀, Claude Code나 Cursor를 도입했지만 코드 품질이 불안정한 팀, 에이전트를 조직에 도입하려는 엔지니어링 리더, 그리고 AI가 코드를 쓰는 세상에서 자신의 역할이 무엇인지 고민하는 모든 소프트웨어 엔지니어.
이 책은 AI 도구를 더 잘 쓰는 방법을 가르치지 않는다. 에이전트가 더 잘 일할 수 있는 **환경**을 만드는 방법을 가르친다. 그 차이가 하네스 엔지니어링의 전부다.
---
### 책이 끝날 때
에이전트는 더 좋아질 것이다. 그럴수록 에이전트에게 맥락을 전달하는 하네스의 중요성도 같이 커진다. 하네스를 만드는 사람이 필요한 이유는 사라지지 않는다.
당신의 AGENTS.md는 언제나 미완성일 것이다. 그래서 당신은 계속 엔지니어일 것이다.
---
## 도서 소개 — 《실전 하네스 엔지니어링》
**에이전트가 코드를 쓰는 세상에서, 엔지니어는 무엇을 하는가?**
2025년, Mitchell Hashimoto는 에이전트에게 기능 구현을 맡기기 시작했다. 에이전트는 빠르게 코드를 만들었다. 그런데 같은 실수를 반복했다. 그는 에이전트를 탓하지 않았다. 대신 AGENTS.md를 열고 한 줄을 추가했다. 그 한 줄이 다음번 실수를 막았다. 그 경험이 6개월 뒤 하나의 원칙이 됐다. *"에이전트가 실수할 때마다, 그 실수가 다시 일어나지 않도록 공학적 해법을 만들어라."*
이 책은 그 원칙을 조직 전체의 시스템으로 확장하는 방법을 다룬다.
---
### 이 책이 다루는 것
에이전트 하네스(Harness)는 AI 에이전트가 코드를 작성하는 환경 전체를 설계하는 기술이다. AGENTS.md 하나로 시작하지만, 성숙한 하네스는 다섯 개의 레이어로 구성된다. 에이전트에게 지시를 전달하는 **컨텍스트 레이어**, 잘못된 방향을 구조적으로 차단하는 **제약 레이어**, Initializer·Coding·GC 에이전트가 순환하는 **오케스트레이션 레이어**, 실패가 개선으로 이어지는 **피드백 루프**, 그리고 모델이 교체되어도 흔들리지 않는 **어댑터 레이어**.
Hashimoto의 개인 하네스, OpenAI Codex의 Initializer-Coding-GC 삼중 루프, Stripe의 Blueprint와 Minions 병렬 아키텍처, LangChain이 4번의 재설계 끝에 도달한 결론, Anthropic 내부 에이전트 운영 원칙까지. 이 책은 실제로 검증된 패턴들만을 담는다.
---
### 이 책의 구성
총 31개 챕터와 에필로그, 14개 부록으로 구성된다.
**PART I·II (WHY·WHAT)** 는 하네스 엔지니어링이 왜 필요한지, 그리고 하네스의 해부학적 구조를 다룬다. 에이전트가 왜 혼자서는 충분하지 않은지, 컨텍스트 드리프트·조기 완료 선언·Dead Letter 같은 실패 패턴들이 왜 반복적으로 나타나는지를 규명한다.
**PART III·IV·V (CORE·LIFECYCLE·TOOLS)** 는 하네스의 핵심 기술을 다룬다. 컨텍스트 엔지니어링, 아키텍처 제약 설계, 장기 실행 에이전트의 상태 관리, 그리고 MCP·A2A 프로토콜이 하네스 안에서 어떤 위치를 차지하는지를 설명한다.
**PART VI·VII (SAFETY·CASE)** 는 에이전트 안전 설계와 실제 사례를 다룬다. OpenAI, Hashimoto, Stripe, LangChain, Anthropic, Vercel이 각자 어떤 방식으로 하네스를 구축했는지, 그 선택의 이유와 트레이드오프를 분석한다.
**PART VIII·IX (ENTERPRISE·PRACTICE)** 는 엔터프라이즈 도입과 실전 연습이다. CPS 구조, 멀티에이전트 확장, Observability 시스템을 다루고, 직접 손을 움직이는 연습(AGENTS.md 구축, 커스텀 린터, Ralph Wiggum Loop, Stripe Minions 구현, MCP 통합)을 단계별로 안내한다.
**PART X·XI (IMPLEMENTATION·FUTURE)** 는 조직 도입 전략과 엔지니어의 미래를 다룬다. Hashimoto 6단계 모델, 파일럿-팀-전사 전환 전략, 버티컬 특화 하네스, AI CoE 설계부터 역할 변화와 열린 질문들까지.
---
### 이 책이 필요한 사람
에이전트를 써봤는데 같은 실수가 반복되는 팀, Claude Code나 Cursor를 도입했지만 코드 품질이 불안정한 팀, 에이전트를 조직에 도입하려는 엔지니어링 리더, 그리고 AI가 코드를 쓰는 세상에서 자신의 역할이 무엇인지 고민하는 모든 소프트웨어 엔지니어.
이 책은 AI 도구를 더 잘 쓰는 방법을 가르치지 않는다. 에이전트가 더 잘 일할 수 있는 **환경**을 만드는 방법을 가르친다. 그 차이가 하네스 엔지니어링의 전부다.
---
### 책이 끝날 때
에이전트는 더 좋아질 것이다. 그럴수록 에이전트에게 맥락을 전달하는 하네스의 중요성도 같이 커진다. 하네스를 만드는 사람이 필요한 이유는 사라지지 않는다.
당신의 AGENTS.md는 언제나 미완성일 것이다. 그래서 당신은 계속 엔지니어일 것이다.
주제 분류
