Claude API를 기반으로 파일, 셸, 검색 도구를 하나씩 추가하며 코딩 에이전트를 만드는 과정을 알려주는 단계별 Go 워크숍입니다.
walkinglabs/learn-harness-engineering
AI 코딩 에이전트의 신뢰성을 높이는 환경, 상태, 검증 및 제어 메커니즘 구축법을 프로젝트 중심으로 가르치는 강의입니다.
- 스타
- 23,559
- 포크
- 2,712
- 열린 이슈
- 18
- 마지막 커밋
- 16일 전
어떤 프로젝트인가요?
Learn Harness Engineering은 AI 코딩 에이전트를 둘러싼 시스템을 구축하는 방법을 다루는 입문자 친화적인 강의입니다. 강의의 전제는 강력한 모델이라도 지침, 영속 상태, 검증, 범위 제한, 세션 수명 주기 규칙이 없으면 실제 엔지니어링 작업에서 실패한다는 것입니다. 하네스 설계는 지침, 상태, 검증, 범위, 세션 수명 주기라는 다섯 가지 하위 시스템으로 구성됩니다.
강의는 14개 강의와 8개 실습 프로젝트로 구성되며, 모든 프로젝트는 동일한 Electron 기반 개인 지식 베이스 데스크톱 앱을 바탕으로 진행됩니다. 각 프로젝트에서는 같은 작업에 약한 하네스 구성과 강한 하네스 구성을 적용해 비교하므로, 학습자는 측정된 차이를 확인할 수 있습니다. 후반부 강의에서는 루프 엔지니어링(목표 루프, 타이머 루프, 메이커-체커 분리)과 그래프 엔지니어링(노드, 엣지, 공유 상태, 라우팅)을 다룹니다.
저장소에는 AGENTS.md, feature_list.json, init.sh 같은 바로 복사해 쓸 수 있는 템플릿을 모은 리소스 라이브러리, 재사용 가능한 harness-creator 스킬, 15개 언어로 번역된 콘텐츠도 포함되어 있습니다. 강의 본문은 VitePress 문서 사이트에서 제공합니다.
핵심 기능
- 01지침, 상태, 검증, 범위, 세션 수명 주기를 다루는 5개 하위 시스템 프레임워크.
- 02에이전트 신뢰성에 관한 핵심 질문 하나씩을 다루는 14개 강의.
- 03단일 Electron 지식 베이스 앱을 발전시켜 나가는 8개 실습 프로젝트.
- 04AGENTS.md, feature_list.json, init.sh 등 바로 복사해 쓸 수 있는 템플릿.
- 05여러 단계로 이루어진 에이전트 워크플로를 위한 루프 엔지니어링 및 그래프 엔지니어링 설명.
- 06간체 중국어를 포함한 15개 언어로 제공되는 콘텐츠.
활용 사례
- 실제 저장소 작업에 Claude Code, Codex 또는 유사한 에이전트를 이미 사용하고 있으며 더 안정적인 결과를 원하는 엔지니어.
- 저장소 구조와 환경 설계가 에이전트 출력에 어떤 영향을 미치는지 평가하는 테크 리드.
- 기존 프로젝트에 AGENTS.md, 진행 로그, 검증 단계를 마련하고 싶은 개발자.
빠른 시작
- 1
저장소를 클론하세요
- 2
harness-creator 스킬을 사용해 프로젝트용 하네스를 구성하세요(README의 빠른 시작 참고)
사용 전 알아둘 점
- 이 프로젝트는 설치 가능한 소프트웨어 도구가 아니라, 글로 작성된 강의와 프로젝트로 구성된 코스입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- learn-harness-engineering은(는) 무엇인가요?
- AI 코딩 에이전트의 신뢰성을 높이는 환경, 상태, 검증 및 제어 메커니즘 구축법을 프로젝트 중심으로 가르치는 강의입니다. Learn Harness Engineering은 AI 코딩 에이전트를 둘러싼 시스템을 구축하는 방법을 다루는 입문자 친화적인 강의입니다. 강의의 전제는 강력한 모델이라도 지침, 영속 상태, 검증, 범위 제한, 세션 수명 주기 규칙이 없으면 실제 엔지니어링 작업에서 실패한다는 것입니다. 하네스 설계는 지침, 상태, 검증, 범위, 세션 수명 주기라는 다섯 가지 하위 시스템으로 구성됩니다.
- learn-harness-engineering은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- learn-harness-engineering은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- learn-harness-engineering은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. learn-harness-engineering의 마지막 커밋은 2026년 10월 22일입니다.
- learn-harness-engineering은(는) 어디에 사용할 수 있나요?
- 실제 저장소 작업에 Claude Code, Codex 또는 유사한 에이전트를 이미 사용하고 있으며 더 안정적인 결과를 원하는 엔지니어. 저장소 구조와 환경 설계가 에이전트 출력에 어떤 영향을 미치는지 평가하는 테크 리드. 기존 프로젝트에 AGENTS.md, 진행 로그, 검증 단계를 마련하고 싶은 개발자.
- learn-harness-engineering는 어떻게 설치하나요?
- 저장소를 클론하세요 harness-creator 스킬을 사용해 프로젝트용 하네스를 구성하세요(README의 빠른 시작 참고)
- learn-harness-engineering은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/walkinglabs/learn-harness-engineering
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code 실전 팁 45가지 이상과 커스텀 상태 표시줄 스크립트, 일상적인 개발 기술을 담은 dx 플러그인 모음
Claude Code, Codex, OpenClaw, Hermes, 프롬프트 엔지니어링과 이미지·음성·음악 AI 도구를 다루는 무료 오픈소스 중국어 AI 강좌이자 실전 스킬 모음입니다.
터미널에서 실행하는 오픈소스 AI 코딩 에이전트로, 데스크톱·웹·에디터·채팅 인터페이스도 제공합니다.
Claude Code와 Gemini CLI에서 사용할 수 있는 에이전트용 디자인 스킬 273개와 슬래시 명령 76개 모음으로, 리서치부터 시스템, UI, 인터랙션, 전달까지 다룹니다.
Cursor와 Claude Code 같은 AI 에이전트가 Figma 디자인을 프로그래밍 방식으로 읽고 수정할 수 있게 해 주는 MCP 서버 및 Figma 플러그인입니다.