TL;DR

이 레포지토리는 독립 실행형 도구나 일반 SDK가 아니라 AI 코딩 에이전트의 안정적인 작업 환경을 만드는 방법을 배우는 프로젝트형 교육 과정이다. VitePress 문서, 14개 강의, 8개 실습 프로젝트, 15개 언어의 템플릿과 참고 자료가 포함되며, Electron 기반 개인 지식 베이스 앱을 단계적으로 확장한다. 핵심 방식은 AGENTS.md 같은 지침, 디스크에 저장하는 진행 상태, 테스트·lint·type-check 기반 검증, 한 번에 하나의 기능만 처리하는 범위 제한, 세션 초기화와 인수인계를 하나의 실행 주기로 묶는 것이다. Claude Code나 Codex 같은 파일 편집형 코딩 에이전트를 실제 저장소에 적용하려는 개발자라면 학습과 즉시 사용 가능한 템플릿을 함께 얻을 수 있지만, 코드를 직접 실행하고 검증할 기본 개발 환경이 필요하다.

핵심 포인트

• 이 레포지토리는 실행 도구보다 AI 코딩 에이전트용 Harness Engineering을 배우는 프로젝트형 강좌이다. VitePress 문서 사이트와 Electron·TypeScript·React 기반 실습 프로젝트를 함께 제공한다. 따라서 바로 설치해 사용하는 라이브러리보다 에이전트 운영 구조를 학습하려는 개발자에게 적합하다.
• Harness는 Instructions, State, Verification, Scope, Session Lifecycle의 다섯 하위 시스템으로 구성된다. AGENTS.md, feature_list.json, 진행 로그, init.sh, 테스트와 lint를 연결해 에이전트의 입력부터 검증과 세션 종료까지 통제한다. 프롬프트를 반복하는 대신 저장소 안에 작업 규칙과 증거를 남기려는 접근이다.
• 8개 프로젝트는 하나의 Electron 기반 개인 지식 베이스 앱을 단계적으로 발전시키는 방식으로 이어진다. Prompt-only와 rules-first 비교에서 시작해 다중 세션 연속성, 범위 제어, 자기 검증, 자동화 Loop, Graph Engineering까지 확장한다. 각 프로젝트의 solution이 다음 프로젝트의 starter가 되어 개념과 구현을 함께 따라갈 수 있다.
• Claude Code, Codex, OpenHands 등 파일 편집과 명령 실행을 지원하는 코딩 에이전트를 전제로 한다. skills/harness-creator는 AGENTS.md, feature list, init.sh, 검증 workflow를 생성하고 audit-harness.sh는 Node.js 없이 기존 저장소의 Harness 구성을 점검한다. 다만 실습을 완료하려면 터미널, Git, 테스트와 디버깅에 대한 기본 역량이 필요하다.

이미지 분석