자율형 에이전트를 위한 하네스 엔지니어링

— 명세 실행기에서 자율 동료로, 자유 안에 안전을 기록한다

---

본 3 부는 AI 가 단순한 코드 생성기를 넘어 자율적으로 일하는 동료가 되는 자리 를 따라간다. 2 부에서 기록된 명세 주도 개발(SDD) 은 AI 에 무엇을 시킬지 를 정밀하게 기록하는 방법이었지만, 어떻게 일하는지 의 자율성은 다루지 않았다. 2026 년의 AI 에이전트는 단순히 명세를 받아 코드 한 덩어리를 출력하는 단계를 넘어, 스스로 작업을 분해하고, 코드를 수정하고, 테스트를 돌리고, 결과를 검증하고, 인간 리뷰어에게 보고하는 단계로 진입했다 — 2 분짜리 함수 자동완성 에서 2 시간짜리 기능 자율 구현 으로의 도약이다. 이 도약을 가능하게 하는 두 축이 본 부의 주제다 — 첫째, 인간 개발자의 역할 재정의 (코드 저자에서 아키텍트이자 리뷰어로). 둘째, 하네스 엔지니어링(Harness Engineering) — 자율 안에서의 안전벨트.

하네스(harness) 는 등산가의 안전벨트이자 마부의 마구다. 자유롭게 움직이되 떨어지지 않게, 힘차게 달리되 방향을 잃지 않게 기록하는 통제 장치다. AI 에이전트의 하네스도 같은 결로 작동한다 — Commands(명령 단위) · Rules(규칙) · Skills(능력) · Hooks(개입) 의 4 대 요소가 AI 의 자율성에 안전벨트를 기록한다. 이 4 대 요소는 Claude Code · GitHub Copilot · Cursor 같은 2026 년 주요 도구가 모두 같은 결론에 수렴한 산업적 사실 이며, 각 요소가 SDD 의 4 단계 (헌장 / 명세 / 계획 / 작업) 와 한 결로 묶인다.

---

◆ 본 부에서 다룰 3 장

• Chapter 7. 에이전틱 엔지니어링 — 코더에서 아키텍트로 카파시 Software 3.0 의 자기 부정 · 인간 역할의 코드 저자 → 아키텍트·리뷰어 전환 · 2 분 자동완성 → 2 시간 자율 구현 의 도약
• Chapter 8. 하네스 4 대 요소 — Commands · Rules · Skills · Hooks Commands(명령 단위) · Rules(규칙) · Skills(능력) · Hooks(개입) 의 정의와 SDD 4 단계와의 매핑 · Claude Code / GitHub Copilot / Cursor 의 수렴
• Chapter 9. 점진적 하네스 통합 — 실증 워크플로우 하네스를 처음부터 모두 기록하는 게 아니라 점진적으로 통합 하는 5 단계 · 실증 워크플로우 + 운영 안정성 측정 지표 · 팀 단위 로 기록하는 자리

---

◆ Part 3 어휘 축

→ 왜 (Ch 7) → 무엇으로 (Ch 8) → 어떻게 (Ch 9) 의 흐름. Part 1 의 대화 방식, Part 2 의 입력 명세 위에 작동 골격 이 박히는 자리.

---

마법사는 통제할 수 없고, 명세 실행기는 명세 안에서만 작동한다. 자율 에이전트는 그 둘을 넘어 — 하네스 안의 자유 로 일한다. 이것이 책 표어 "설계 없이는 코딩이 안 된다" 의 마지막 자리다 — 설계는 코드의 형태가 아니라 시스템의 형태로 기록된다.