HomeInsightsClaude Code Harness 한국어 아카이브 제작기
Claude Code Harness 한국어 아카이브 제작기
프로젝트 2026.04.19

Claude Code Harness 한국어 아카이브 제작기

Claude Code를 구조적으로 다시 읽을 수 있도록 원문 분석을 한국어 읽기 중심 웹 아카이브로 재구성한 프로젝트입니다.

유민수
6

Archive Project

Claude Code를 더 깊게 읽고 싶은 한국어 독자를 위해, 원문의 정보 구조를 유지하면서도 책처럼 차분하게 읽히는 웹 아카이브로 재구성한 프로젝트입니다.

형태

한국어 문서 아카이브

구성

45개 문서 · 7개 파트

핵심 가치

읽기 경험 재구성

Overview

무엇을 만든 프로젝트인가

이 프로젝트는 단순 번역 저장소가 아닙니다. Claude Code의 내부 구조와 하네스 엔지니어링 개념을 한국어 독자도 구조적으로 읽고, 토론하고, 다시 구현까지 이어갈 수 있도록 설계한 읽기 중심 웹판입니다.

원문의 흐름을 해치지 않으면서도, 긴 분석 글을 웹에서 차분하게 읽히는 형태로 다시 묶는 데 초점을 두었습니다.

Structure

어떻게 재구성했는가

라이브 사이트는 45개의 문서와 부록, 7개의 파트, 그리고 서로 다른 독자 관점의 읽기 경로를 중심으로 구성했습니다. Agent Builders, Security Engineers, Performance Optimization처럼 관심사별 진입점을 제공해, 단순한 문서 보관소가 아니라 학습 흐름 자체를 설계한 아카이브에 가깝게 만들었습니다.

Stack

기술적으로는

  • Next.js App Router + TypeScript 기반 정적 문서 사이트
  • React Markdown과 Mermaid를 활용한 문서/다이어그램 렌더링
  • 빌드 시점에 한국어 문서를 읽어 페이지를 생성하는 구조
  • 원문 링크를 내부 문서 구조에 맞게 정리한 읽기 경험 중심 설계

Links

바로 보기

라이브 사이트: https://claude-code-harness-ko.vercel.app/

저장소: https://github.com/deformatic/claude-code-harness-ko

원문 분석: https://zhanghandong.github.io/harness-engineering-from-cc-to-ai-coding/

Takeaway

이 프로젝트의 의미

좋은 분석이 한국어로 다시 읽히고, 함께 공부하고, 자기만의 하네스와 에이전트 설계로 이어질 수 있게 만드는 공개 학습 허브입니다. 단순 보관보다 읽기 경험과 학습 흐름을 다시 설계했다는 점이 이 프로젝트의 핵심입니다.