walkinglabs/learn-harness-engineering

이 프로젝트는 무엇인가요?

Learn Harness Engineering은 AI 코딩 에이전트(Claude, GPT, Codex 등)가 실제 소프트웨어 프로젝트에서 안정적으로 작동하도록 지원하는 시스템을 구축하는 방법을 가르치는 무료 오픈소스 코스입니다. 더 나은 프롬프트를 작성하는 것이 아니라 AI가 작동하는 환경을 설계하는 것입니다.

핵심 아이디어: 가장 강력한 AI 모델도 적절한 구조를 제공하지 않으면 실제 엔지니어링 작업에서 실패할 것입니다. 이 코스는 그 구조를 구축하는 방법을 보여주며, 이를 하네스라고 부릅니다.

하네스는 무엇을 하나요?

README는 하네스에 5개의 하위 시스템이 있으며, 각각 특정 역할이 있다고 설명합니다:

지침 – 에이전트에게 무엇을, 어떤 순서로, 시작 전에 무엇을 읽어야 하는지 알려줍니다. 하나의 거대한 파일이 아니라 에이전트가 필요에 따라 탐색하는 점진적 공개 구조입니다.
상태 – 완료된 것, 진행 중인 것, 다음에 할 것을 추적합니다. 디스크에 저장되어 다음 세션이 이전 세션이 중단된 지점에서 정확히 재개됩니다.
검증 – 통과한 테스트 스위트만 증거로 간주됩니다. 에이전트는 실행 가능한 증거 없이 성공을 주장할 수 없습니다.
범위 – 에이전트를 한 번에 하나의 기능으로 제한합니다. 과도한 범위, 여러 작업을 반쯤 끝내는 것, 미완료 작업을 숨기기 위해 기능 목록을 다시 작성하는 일이 없습니다.
세션 수명 주기 – 시작 시 초기화하고, 종료 시 정리하고, 다음 세션을 위한 깨끗한 재시작 경로를 남깁니다.

README에는 이들이 어떻게 맞물리는지 보여주는 다이어그램과 텍스트 버전이 포함되어 있습니다: "모델은 작성할 코드를 결정합니다. 하네스는 언제, 어디서, 어떻게 작성할지 관리합니다."

코스에는 무엇이 포함되어 있나요?

코스는 세 부분으로 나뉩니다:

강의 – 하네스 엔지니어링의 이론을 설명하는 14개의 개념 단위.
프로젝트 – 처음부터 에이전트 작업 공간을 구축하는 8개의 실습 프로젝트.
리소스 라이브러리 – 자신의 저장소에 바로 넣을 수 있는 복사 가능한 템플릿(AGENTS.md, feature_list.json, init.sh 등).

스킬 섹션도 있으며, 프로젝트를 위해 몇 분 안에 프로덕션급 하네스를 스캐폴딩할 수 있는 harness-creator 스킬이 포함되어 있습니다.

어떻게 바로 사용할 수 있나요?

README는 빠른 시작을 제공합니다: 이미 코딩 에이전트를 사용하고 있다면, 프로젝트 루트에 4개의 파일을 추가하여 오늘부터 개선할 수 있습니다:

AGENTS.md – 에이전트의 운영 매뉴얼
init.sh – 설치 + 검증 + 시작 실행
feature_list.json – 존재하는 기능, 완료된 기능
claude-progress.md – 세션 진행 로그(이름은 역사적이지만 에이전트에 구애받지 않습니다. 모든 에이전트가 사용할 수 있습니다)

이 파일들은 저장소 안에 있으므로 모든 세션이 동일한 상태에서 시작됩니다. README는 이것만으로도 에이전트 세션이 "프롬프트만으로 실행하는 것보다 훨씬 안정적"이라고 말합니다.

캡스톤 프로젝트는 무엇인가요?

모든 6개(현재 8개) 코스 프로젝트는 동일한 제품을 중심으로 합니다: 실제 앱. README는 문장 중간에 끊기지만, 프로젝트가 단일 실제 애플리케이션을 중심으로 구축된다는 것은 분명합니다.

최근에 새로 추가된 것은 무엇인가요?

README는 두 가지 주요 업데이트를 강조합니다:

2026년 8월: 프론티어 하네스 설계 분석에 대한 새 섹션 추가 – 실제 제품(Pi, Claude Code, Codex, DeepSeek)이 하네스를 구축하는 방법을 코스의 5-하위 시스템 프레임워크를 적용하여 깊이 있게 분석한 4개. 또한 그래프 엔지니어링에 대한 강의 14와 워크플로를 그래프로 그리는 프로젝트 08을 추가.
2026년 7월: 루프 엔지니어링에 대한 강의 13과 첫 자동 루프를 구축하는 프로젝트 07, 그리고 목표 루프, 타이머 루프, 메이커-체커 루프에 대한 코드 템플릿을 추가.

기타 세부 사항

언어: 코스는 15개 언어로 제공됩니다(영어, 중국어, 일본어, 한국어, 스페인어, 프랑스어, 러시아어, 독일어, 아랍어, 베트남어, 우즈베크어, 터키어, 포르투갈어-브라질, 우크라이나어 등).
PDF: PDF 코스북을 생성하는 빌드 파이프라인이 있습니다(npm run pdf:build), 출력은 artifacts/pdfs/에.
라이선스: MIT.
커뮤니티: 커뮤니티에 참여할 수 있는 Discord 링크가 있습니다.

이 코스는 왜 존재하나요?

README는 동기를 설명합니다: 모델은 코드를 작성할 수 있지만, 실제 저장소에서 여러 세션에 걸쳐 지속적인 인간 감독 없이 실제 엔지니어링 작업을 안정적으로 완료할 수 있나요? 현재 답은 "하네스 없이는 안 됩니다"입니다. 이 코스는 그 하네스를 구축하는 방법을 가르쳐, AI 에이전트를 신뢰하고 작업을 맡기면서 결과를 검증하고 뒷처리를 하지 않도록 합니다.

요약하자면: Learn Harness Engineering은 AI 코딩 에이전트를 때때로 도움이 되는 조수에서 신뢰할 수 있는 팀원으로 바꾸는 프레임워크와 도구를 제공하는 실용적이고 프로젝트 기반의 코스입니다.