# 좋은 하네스를 구성하는 다섯 축

> 환경·역할·기준·루프·정리의 상호작용

- Canonical: https://learning.reopt.ai/courses/harness-engineering/lessons/he-m3-concept
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/harness-engineering/lessons/he-m3-concept

---

[하네스 엔지니어링](/courses/harness-engineering) 3. 하네스의 5요소와 검증 루프 5 / 9

# 좋은 하네스를 구성하는 다섯 축

환경·역할·기준·루프·정리의 상호작용
개념 학습 45 XP 9분

대부분의 하네스는 표현이 달라도 환경, 역할, 기준, 루프, 정리 의 다섯 축으로 환원됩니다. 역할 수를 늘리는 것보다 역할 사이의 입출력 계약과 실패 시 돌아갈 지점을 명확히 하는 편이 중요합니다.
평가자는 장식이 아니라 독립된 판정 경계 builder가 만든 결과를 같은 맥락의 자기평가만으로 통과시키지 않습니다. 위험이 높을수록 reviewer·evaluator·브라우저 QA를 독립된 증거 생성 단계로 둡니다.

| 요소 | 핵심 질문 | 실패 신호 |
| Environment | 필요한 정보와 도구를 찾을 수 있는가 | 탐색 반복·stale context |
| Roles | 누가 만들고 누가 판정하는가 | 책임 중복·무한 handoff |
| Criteria | 완료를 기계적으로 판정할 수 있는가 | 그럴듯한 미완료 |
| Loops | 실패 뒤 어디로 돌아가는가 | 같은 수정 무한 반복 |
| Maintenance | 낡은 규칙을 누가 지우는가 | 문서·도구 엔트로피 |

- 1 위험 분류 변경의 가역성·영향 범위·외부 부작용을 평가합니다.

- 2 역할 계약 각 역할의 입력·산출물·종료 조건을 정합니다.

- 3 증거 게이트 테스트·접근성·브라우저·로그 중 필요한 증거를 고릅니다.

- 4 복구와 종료 재시도 상한, 사람 승인, 중단 기준을 명시합니다.

실무에 남길 기준

- 역할 개수보다 역할 사이의 계약이 중요하다
- Criteria는 추상적 품질 문구가 아니라 실행 가능한 판정식이어야 한다
- Maintenance가 없으면 좋은 하네스도 빠르게 stale context가 된다

[이전](/courses/harness-engineering/lessons/he-m2-scenario) 이해했어요 · 계속

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact