revfactory/harness-engineering

revfactory profile

Latest recorded source activity: March 2, 2026 at 04:25

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 2

GitHub stars: 2
GitHub forks: 0

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Harness Engineering Workshop > **"Stop fighting the chatbot. Start engineering the harness."** — Mitchell Hashimoto AI 에이전트가 코드를 작성하는 시대, 개발자의 역할은 "코드를 타이핑하는 것"에서 **"에이전트가 안정적으로 일할 수 있는 환경을 설계하는 것"**으로 변화하고 있습니다. 이 프로젝트는 **하네스 엔지니어링(Harness Engineering)**의 개념, 패턴, 실전 적용을 다루는 교육 워크숍 자료를 제작합니다. ## 하네스 엔지니어링이란? > "The model is the CPU, the harness is the OS." 하네스 엔지니어링은 AI 에이전트의 **바깥쪽 시스템** — 안전장치(Guardrails), 검증 루프(Verification Loops), 상태 관리(State Management), 관측 가능성(Observability) — 을 설계하고 구축하는 엔지니어링 분야입니다. ``` Harness Engineering ⊇ Context Engineering ⊇ Prompt Engineering ``` | 차원 | Prompt Eng. | Context Eng. | Harness Eng. | |------|------------|-------------|-------------| | 관심 범위 | 단일 프롬프트 | 단일 추론의 모든 입력 | 시스템 전체 | | 시간 축 | 정적 | 동적(런타임) | 지속적(세션 간) | | 핵심 질문 | 어떻게 말할 것인가? | 무엇을 보여줄 것인가? | 무엇을 방지/측정/수정? | ## 워크숍 구성 **대상**: 개발자 ~ 기술 리더 (범용) **실습 도구**: Claude Code **소요 시간**: 반나절 (4시간) **구조**: Why → What → How → Apply ### 모듈 | 모듈 | 주제 | 실습 | 시간 | |------|------|------|------| | **M1** | 왜 하네스인가? | Lab 1: 첫 CLAUDE.md로 에이전트 길들이기 | 60분 | | **M2** | 결정론적 통제 | Lab 2: Hooks Guardrails + Lab 3: 검증 루프 | 70분 | | **M3** | 지속적 에이전트 운영 | Lab 4: 장기 에이전트 상태 관리 | 60분 | | **M4** | 내 프로젝트에 적용하기 | Lab 5: 종합 하네스 구축 (자율 실습) | 50분 | ### 핵심 학습 흐름 ``` 실패 체험 → 개념 이해 → 도구로 해결 → 내 프로젝트에 적용 ``` ## 프로젝트 구조 ``` harness-engineering/ ├── README.md ├── CLAUDE.md # 프로젝트 가이드라인 ├── source.txt # 원문 소스 (OpenAI, Anthropic, LangChain, Martin Fowler) ├── .claude/ │ ├── agents/ # 커스텀 에이전트 (researcher, slide-writer 등) │ ├── commands/ # 슬래시 커맨드 (/module, /lab, /status 등) │ ├── skills/ # 스킬 (slide-deck, lab-builder) │ └── settings.json └── output/ ├── research/ # 사전 조사 결과 │ ├── 01-trends.md # 최신 동향 │ ├── 02-patterns-tools.md # 실전 패턴과 도구 │ ├── 03-antipatterns.md # 실패 사례와 안티패턴 │ ├── 04-curriculum-framework.md # 교육 프레임워크 │ └── 05-curriculum-proposal.md # 커리큘럼 재설계 제안 ├── slides/ # 모듈별 슬라이드 (M1~M4) — 작성 예정 ├── labs/ # 실습 가이드 (Lab1~Lab5) — 작성 예정 └── resources/ # 체크리스트, 참고자료 — 작성 예정 ``` ## 사전 조사 요약 4개 에이전트 팀이 병렬로 수행한 사전 조사 결과: | 조사 | 핵심 발견 | |------|----------| | **최신 동향** | OpenAI 100만 줄/0줄 수동, Stripe 주 1,000 PR, LangChain 하네스만으로 13.7%p 향상 | | **실전 패턴** | Hooks 17종 이벤트, CLAUDE.md vs AGENTS.md vs .cursorrules 비교, TDD 강제 패턴 | | **안티패턴** | AI Slop(코드 품질 2.74배 취약), Doom Loop(70%→23% 드리프트), Replit DB 삭제 사건 | | **교육 프레임워크** | 전문 하네스 교육 전 세계 거의 없음, MVH(최소 기능 하네스) 개념 도출 | ## 참고 자료 ### 핵심 원문 - [OpenAI — Harness Engineering](https://openai.com/index/harness-engineering/) - [Anthropic — Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents) - [LangChain — Improving Deep Agents with Harness Engineering](https://blog.langchain.com/improving-deep-agents-with-harness-engineering/) - [Martin Fowler — Harness Engineering](https://martinfowler.com/articles/exploring-gen-ai/harness-engineering.html) - [Mitchell Hashimoto — My AI Adoption Journey](https://mitchellh.com/writing/my-ai-adoption-journey) ### 핵심 인용문 > "에이전트가 실패하면, 모델의 한계가 아니라 환경 설계의 문제로 취급하라." — OpenAI > "2025 was agents. 2026 is agent harnesses." — Aakash Gupta > "엄격함(rigor)이 코드 레벨에서 하네스 환경을 설계하는 레벨로 이동했을 뿐이다." — Birgitta Böckeler ## 빌드 with Claude Code 이 프로젝트 자체가 Claude Code의 하네스 기능(에이전트 팀, 스킬, 커맨드)을 활용하여 제작되고 있습니다. ```bash # 슬라이드 모듈 생성 /module M1 # 실습 과제 생성 /lab Lab1 # 전체 진행 상황 확인 /status # 콘텐츠 품질 검토 /review ``` ## License MIT

Loading the repository README…

Skills in this repository

Career/Technical Education Teachers, Postsecondary Computer Science Teachers, Postsecondary

2 occupation categories · 100% classified

skill

occupation

description

updated

lab-builder

Computer Science Teachers, Postsecondary

Claude Code 기반 Harness Engineering 실습 과제를 설계하고 생성하는 스킬. 실습 가이드(README), 스타터 프로젝트, 솔루션, 평가 체크리스트를 포함합니다. 실습 생성, 핸즈온 랩 제작, 워크숍 실습 설계 시 사용합니다.

Source text: Korean

2026-03-02

slide-deck

Career/Technical Education Teachers, Postsecondary

Harness Engineering 교육용 슬라이드 덱을 작성하는 스킬. 모듈별 슬라이드 스크립트를 일관된 형식과 품질로 생성합니다. Mermaid 다이어그램, 발표자 노트, 핵심 메시지를 포함합니다. 슬라이드 작성, 모듈 생성, 발표자료 제작 시 사용합니다.

Source text: Korean

2026-03-02

Showing 2 of 2 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/revfactory/harness-engineering.