revfactory/harness-engineering

revfactory-Profil

Letzte erfasste Quellaktivität: 2. März 2026 um 04:25

SkillsMP-Katalog aktualisiert: 26. Oktober 2026 um 11:37

gesammelte Skills: 2

GitHub-Stars: 2
GitHub-Forks: 0

README des Repositorys

README-Quelldatei: README.md

README-Quelldatei lesen

Vollständige README anzeigen

# 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

README des Repositorys wird geladen…

Skills in diesem Repository

Hochschullehrer für Berufs- und Technikbildung Hochschullehrer für Informatik

2 Berufskategorien · 100% klassifiziert

Skill

Beruf

Beschreibung

Aktualisiert

lab-builder

Hochschullehrer für Informatik

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

Quellsprache: Koreanisch

2026-03-02

slide-deck

Hochschullehrer für Berufs- und Technikbildung

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

Quellsprache: Koreanisch

2026-03-02

Es werden 2 von 2 gesammelten Skills angezeigt.

Mit einem KI-Assistenten installieren

Diesen Prompt kopieren und in den verwendeten KI-Assistenten einfügen.

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