LLM Wiki

하네스 엔지니어링

4 min read

제시해주신 소스 문서들을 바탕으로 지정된 스키마와 작성 원칙을 철저히 준수한 ‘하네스 엔지니어링’ 지식 위키 노트를 작성하여 프로젝트 경로 내 [scratch/llm-wiki/wiki/하네스 엔지니어링.md](file:///Users/railscraft/.gemini/antigravity-cli/scratch/llm-wiki/wiki/하네스 엔지니어링.md)에 성공적으로 저장했습니다.

(LLM Wiki 작업 자율 수행 규칙 / No-Ask Policy에 따라 사용자 확인이나 중간 질문 없이 완전히 자율 완료하였습니다.)

📝 생성된 위키 노트 요약 (하네스 엔지니어링.md)

  1. Frontmatter 및 메타데이터:

    • 지정된 frontmatter 스키마(type: concept, status: draft, core: false, sources: 14개 소스 파일 목록, created: 2026-08-27, updated: 2026-08-27 등)를 완전하게 작성.

  2. 한 줄 정의 & 핵심 요지:

    • LLM 모델 자체의 지능이나 프롬프트 문구에 의존하지 않고, 외부 환경(제약, 컨텍스트, 실행, 검증, 생명주기)을 결정론적·구조적으로 통제하는 패러다임.
    • Mitchell Hashimoto의 핵심 정의(“AI 에이전트의 실패가 다시는 동일하게 반복되지 않도록 환경을 만드는 것”)와 미첼 하시모토의 비유(에이전트 = 모델(말) + 하네스(마구)) 정리.
    • Claude Code ARR 10억 달러 달성, Boris Cherny의 출력 품질 2~3배 향상 지목, LangChain의 Terminal Bench 2.0 점수 상향(52.8% ➔ 66.5%), Managed Agent 레이턴시 단축(p50 60%, p95 90% 이상) 등 검증된 empirical 수치와 소스 출처 명시.

  3. 상세 아키텍처 및 진화 단계:

    • 3단계 진화: CLAUDE.md 시대 ➔ AGENTS.md 시대 ➔ Harness Engineering 시대.
    • 5대 계층 아키텍처 (5-Layer Harness Stack): 1계층(제약), 2계층(컨텍스트), 3계층(실행), 4계층(검증), 5계층(생명주기) 표 형식 구조화 및 관리형 플랫폼과 개발자 간 역할 분담 모델 제시.
    • 비교 분석: 하네스 엔지니어링 vs 루프 엔지니어링 vs 그래프 엔지니어링 간 대상, 역할, 실패 원인 비교 정리.

  4. 구체적 실전 코드 예시 및 활용 시나리오:

    • Python 기반 샌드박스, YAML 권한 거버넌스(check_permission), 스냅샷/롤백(run_write/run_revert), 3단계 대화 요약 및 메모리 파일 저장(maybe_compress_context) 통합 아키텍처 코드 제시.
    • Subagent 컨텍스트 격리와 자동 Verification Loop 가동 시나리오 포함.

  5. 기술적 충돌 (Collision):

    • 하네스의 범주에 관한 정의 충돌 (Monolith vs. 5-Layer Monolith vs. Framework).
    • 컨텍스트 공급량에 대한 견해 충돌 (전수 주입 vs. ETH Zurich 수치 기반의 극단적 최소화 및 온디맨드 로딩).
    • 하네스 조기 투자에 대한 타당성 충돌 (초기 전수 구축 vs. 레거시/PoC 단계에서의 조기 최적화 부채 경계).

  6. 관련 노트 연동:

    • [[AI 에이전트 제어 루프]], [[모델 컨텍스트 프로토콜]], [[컨텍스트 세금]], [[에이전트 스킬]], [[에이전트 상태 관리]], [[Claude Code]] 등 최소 6개 이상의 관련 개념과 자연스럽게 연동.

(관련 작업 디렉터리: /Users/railscraft/.gemini/antigravity-cli/scratch/llm-wiki를 하부 작업 공간으로 권장합니다.)

그래프 뷰

백링크