DeepSeek Harness를 지금 바로 써볼 수 있나요?

네. MIT 라이선스 오픈소스라 GitHub에서 받아 바로 쓸 수 있어요. 모델 어댑터부터 도구, 루프, UI까지 전부 플러그인으로 교체할 수 있는 구조예요.

하네스가 왜 모델보다 중요해지나요?

같은 모델이라도 하네스(도구, 메모리, 권한, 작업 루프)를 어떻게 꾸미느냐에 따라 결과가 크게 달라져요. 하네스가 개방되면서 품질의 변수가 모델에서 프로세스로 옮겨가고 있어요.

컨텍스트 엔지니어링이 구조가 된다는 건 무슨 뜻인가요?

dsh는 모델이 응답하기 전 매 단계 pre-step 훅을 실행해요. 이 지점에서 메시지를 검사하고 다시 쓰고 거부할 수 있어서, '잘 시키는 법'이 해킹이 아니라 코드로 박힌 구조가 돼요.

퀄리티는 모델이 아닌 프로세스다: DeepSeek Harness가 증명하는 것

같은 모델로 글을 써도 결과가 다른 이유가 뭘까요.

모델이 아닙니다. 프로세스예요.

DeepSeek가 오픈소스로 공개한 DeepSeek Harness(이하 dsh)는 이 명제를 정면에서 증명하는 도구입니다. 공식 슬로건은 단 하나예요. "Everything is a Plugin."

DeepSeek Harness GitHub 레포

하네스가 뭔가

모델은 뇌입니다. 하네스는 몸이에요.

도구, 메모리, 권한, 작업 루프, 워크스페이스, UI. 모델이 실제로 일하기 위해 필요한 모든 게 하네스에 들어있습니다. 같은 뇌라도 어떤 몸을 입히느냐에 따라 결과가 완전히 달라져요.

DeepSeek Harness는 이 몸을 통째로 오픈소스로 풀었습니다. MIT 라이선스, 스타 17만 개, 포크 1.8만 개 규모예요.

Everything is a Plugin

dsh의 설계 원칙은 하나로 수렴합니다. 모든 것이 플러그인이다.

모델 어댑터, 도구 레지스트리, 에이전트 루프, 저장소, 스킬, 서브에이전트, 샌드박스, 컨텍스트 압축, 시스템 프롬프트, UI까지. 전부 교체 가능한 플러그인으로 만듭니다.

플러그인은 capability(능력)를 등록하고, 다른 컴포넌트는 구체 클래스가 아니라 그 능력에 의존해요. 등록은 전부 되돌릴 수 있는 effect라서, 플러그인을 내렸다 올려도 흔적이 깔끔하게 정리됩니다.

이게 주는 실익은 하나예요. 코어를 포크하지 않고도 에이전트의 행동을 바꿀 수 있다는 것. 모델을 바꾸고, 도구를 바꾸고, 루프를 바꾸고, 메모리 전략을 바꾸는 게 전부 설정의 문제가 됩니다.

# 플러그인 예시 (개념)
plugin:
  register: llm.adapter        # 능력 등록
  depends: [sandbox, storage]  # 의존성 선언
  effects:                     # 되돌릴 수 있는 effect
    - register_tools
    - register_hooks

컨텍스트 엔지니어링이 구조가 되는 순간

dsh에서 가장 흥미로운 건 pre-step 훅이에요.

모델이 응답하기 전, 매 단계마다 훅이 실행됩니다. 플러그인은 이 지점에서 보낼 메시지를 검사하고, 다시 쓰고, 거부할 수 있어요. 시스템 프롬프트를 수정하거나, 도구 목록을 제한하거나, 컨텍스트를 주입하거나, 압축을 교체할 수 있죠.

즉, 컨텍스트 엔지니어링이 해킹이 아니라 구조가 되는 거예요. "잘 시키는 법"이 코드로 박힙니다.

세션도 특이합니다. 세션은 타입이 있는 이벤트의 append-only 로그예요. 모델이 보는 히스토리는 이 로그에서 파생됩니다. 모델이 본 모든 것은 세션 기록에서 재구성 가능해야 하죠. **"로그가 기억한다"**는 원칙입니다.

모델과 하네스의 분리

이 설계가 시장에 던지는 메시지는 분명해요.

지금까지 에이전트 품질의 차이는 "어느 모델이냐"로 설명됐습니다. 하지만 하네스가 개방되면서, 같은 모델로도 훨씬 나은 결과를 만드는 게 가능해졌어요. 아니, 오히려 하네스의 차이가 더 큰 변수가 되고 있어요.

실제로 이 글을 쓰는 시스템도 같은 원리로 돌아갑니다.

출처가 검증된 사실만 쓰는 리서치 게이트
em dash 같은 금지어를 잡는 리뷰 게이트
한 줄 한 메시지의 가독성 규칙
발행 후 링크를 검증하는 파이프라인

모델은 하나인데, 이 프로세스들이 퀄리티를 만들고 있어요. 모델을 바꾸기 전에 프로세스를 먼저 바꿔야 하는 이유입니다.

그래서 뭘 하면 되나

모델을 바꾸기 전에 프로세스를 먼저 보세요.

체크리스트 하나가 모델 업그레이드보다 더 큰 차이를 만듭니다. 하네스가 그걸 코드로 증명하고 있어요.

에이전트가 일하는 방식, 그리고 그 결과물의 퀄리티를 결정하는 건 점점 "어느 모델이냐"가 아니라 "어떻게 시키느냐"가 되어가고 있습니다. 이 흐름을 제대로 배우고 싶다면, 지금이 타이밍입니다.

바이브코딩 시즌제 아카데미 Fronmpt에서 시즌3 모집 알림을 받고 있어요. 에이전트와 하네스, 그리고 프로세스로 결과를 만드는 법을 제대로 배우는 곳입니다.

원문과 참고 자료

👉 시즌3 모집 알림 신청하기

FAQ

자주 묻는 질문

DeepSeek Harness를 지금 바로 써볼 수 있나요?: 네. MIT 라이선스 오픈소스라 GitHub에서 받아 바로 쓸 수 있어요. 모델 어댑터부터 도구, 루프, UI까지 전부 플러그인으로 교체할 수 있는 구조예요.
하네스가 왜 모델보다 중요해지나요?: 같은 모델이라도 하네스(도구, 메모리, 권한, 작업 루프)를 어떻게 꾸미느냐에 따라 결과가 크게 달라져요. 하네스가 개방되면서 품질의 변수가 모델에서 프로세스로 옮겨가고 있어요.
컨텍스트 엔지니어링이 구조가 된다는 건 무슨 뜻인가요?: dsh는 모델이 응답하기 전 매 단계 pre-step 훅을 실행해요. 이 지점에서 메시지를 검사하고 다시 쓰고 거부할 수 있어서, '잘 시키는 법'이 해킹이 아니라 코드로 박힌 구조가 돼요.