콘텐츠로 이동

하네스 엔지니어링

created: 2026.4.16


프롬프트 엔지니어링 시대

사람 → 프롬프트 → 모델 → 답변

하네스 엔지니어링

사람 → 목표 → 에이전트 → [도구 호출 → 판단 → 도구 호출 → 판단 → … ] → 결과

  • 에이전트가 자율적으로 수십 ~ 수백 번 판단
  • 모델이 뛰어나도 자율적 판단 횟수가 늘어나면 정확도 떨어짐

하네스

  • Feedforward(사전 제어) - 틀릴 여지를 줄임
    • 맥락과 규칙 제시
    • 시스템 프롬프트, CLAUDE.md 등
    • 도구 정의와 제약 조건
    • 예시와 패턴 제공
    • 도로의 차선과 표지판 같은 역할
  • Feedback(사후 제어) - 틀린 걸 바로 잡음
    • Computational(결정론적): 테스트, 린터, 타입 체커
    • Inferential(추론적): AI 코드 리뷰어, 품질 심사 에이전트
    • 자동차 차선 이탈 경고 시스템 같은 역할
  • Guardrails(가드레일) - 넘으면 안되는 선
    • 파일 삭제 금지, 특정 API 호출 차단
    • 비용 한도, 시간 한도
    • 샌드박스 격리
    • 도로의 방호벽 같은 역할

Keep Quality Left 원칙

  • 하네스 설계의 핵심 철학
  • 저렴하고 빠른 검증 <-> 비싸고 느린 검증
  • 린터, 타입체커(pre-commit) - 테스트(pre-push) - 코드리뷰(pre-merge) - 프로덕션 모니터링(post-deploy)
  • 가능한 왼쪽에서 문제 잡기

Martin Fowler 프레임워크

카테고리 검증 성숙도
유지보수성 코드 스타일, 구조 규칙 높음(린터 등 도구 성숙)
아키텍처 적합성 성능, 설계 원칙 중간
동작 정확성 기능이 맞게 동작하나 낮음(가장 어려움)
  • 동작 정확성: 비즈니스 요구사항 충족 판단