지식위키
HOW — 어떻게 짓는가

하네스 구현

LLM에게 일을 시키는 하네스를 9개 프레임워크로 나눠 에이전트 루프·컨텍스트 조립·훅·스킬·툴·오케스트레이션·가드레일·검증 축으로 해부·비교·종합한 실전 분석 볼트.

네 권의 거대한 책이 건물처럼 서 있는 아이소메트릭 디오라마 도판
00

시작하기

하네스 엔지니어링 학습 볼트
용어집
하네스 엔지니어링이란?
학습 순서
10

프레임워크분석

Claude Code 공식문서 — 핵심 개념
Codex 공식문서 — 핵심 개념
Claude Code · 진입점과 에이전트 실행 루프
Claude Code · 컨텍스트와 프롬프트 조립
Claude Code · 확장점: Hooks (라이프사이클 훅)
Claude Code · 확장점: Skills (점진적 공개 패키지)
Claude Code · 확장점: Slash Commands (사용자 정의 명령)
Claude Code · 확장점: Subagents (위임 에이전트)
Claude Code · 도구 시스템과 MCP (도구 정의·노출)
Claude Code · 가드레일: 권한·승인·샌드박스
Claude Code · 플러그인/마켓플레이스와 OMC 팀·브리지
1. Claude Code
Codex · 고유 특별기능: Code Mode (도구를 코드로 실행하는 런타임)
Codex · 진입점과 에이전트 실행 루프 (run_turn / Task)
Codex · 프롬프트·컨텍스트 조립 (base 프롬프트 + AGENTS.md + 환경/스킬/권한 fragment)
Codex · 도구 시스템 (ToolSpec 정의 형식과 모델 노출 / ToolRouter 디스패치)
Codex · 확장점: Hooks (이벤트 기반 외부 명령 실행)
Codex · 확장점: Skills (SKILL.md + progressive disclosure)
Codex · 확장점: Subagents (병렬 멀티에이전트 spawn)
Codex · 확장점: MCP 연결 + Plugins (설치 배포 단위)
Codex · 가드레일: 샌드박스 + 권한 + 승인 (Seatbelt/Landlock/bwrap + Guardian)
Codex · 상태·메모리 영속성 (Rollout JSONL + state SQLite + Memories)
2. Codex
OMC (oh-my-claudecode) · 진입점과 훅 실행 루프 (Claude Code 플러그인으로서의 OMC)
OMC (oh-my-claudecode) · 컨텍스트/프롬프트 조립 (CLAUDE.md 주입 + 키워드 감지 + 스킬 인젝션)
OMC (oh-my-claudecode) · 서브에이전트 (agents/*.md 역할 프롬프트와 위임)
OMC (oh-my-claudecode) · 스킬과 슬래시 커맨드 (SKILL.md 워크플로우 + 얇은 디스패처)
OMC · MCP 도구 시스템 (단일 't' 서버 + tool-registry 노출)
OMC (oh-my-claudecode) · 가드레일 (PreToolUse 강제 + 권한 핸들러 + 워커 RBAC advisory)
OMC (oh-my-claudecode) · 상태·메모리 영속성 (state / notepad / project-memory / wiki 4계층)
OMC (oh-my-claudecode) · OMC 고유 기능: Teams 런타임/브리지 (프로세스 기반 멀티에이전트 + 거버넌스)
3. oh-my-claudecode (OMC)
gajae-code · 에이전트 실행 루프 (Agent Loop)
gajae-code · 컨텍스트·프롬프트 조립 (System Prompt + AGENTS.md 주입)
gajae-code · 확장점 형식: Hooks / Skills / Slash-Commands
gajae-code · 서브에이전트·태스크 위임 (Role Agents)
gajae-code · MCP 통합 (외부 도구 서버)
gajae-code · 도구 시스템: 정의 형식과 모델 노출
gajae-code · 가드레일: 권한·승인·스폰 게이트
gajae-code · Gajae 고유: 이중 영수증·워크플로 상태·모호성 게이팅
4. gajae-code
ouroboros · 진입점 / CLI / ooo 커맨드 라우팅
ouroboros · 스펙 엔진: Seed 계약과 Double-Diamond(Interview→Ambiguity→Seed)
ouroboros · 이벤트 소싱 저장소와 Projection 읽기모델
ouroboros · 오케스트레이터 실행 루프(Seed→프롬프트→에이전트 실행)
ouroboros · 멀티 백엔드 프로바이더 어댑터 / 런타임 추상화
ouroboros · MCP 서버: 도구 정의·노출과 Subagent 디스패치
ouroboros · 확장점: Hooks / Skills / Slash-Commands 형식
ouroboros · 가드레일: 샌드박스 클래스 · 권한 번역 · 플러그인 방화벽
ouroboros · 고유기능: 진화 루프 · 드리프트 게이트 · 감사 원장(provenance)
5. ouroboros
fable-ish · 플러그인 매니페스트와 확장점 배선
fable-ish · 훅 3종 이벤트 루프 (실행 진입점)
fable-ish · 컨텍스트/프롬프트 주입 (additionalContext 채널)
fable-ish · 작업 위험도 분류 엔진 (quick/normal/deep/blocked)
fable-ish · 증거 원장(ledger) 상태 영속성
fable-ish · 도구 결과 파싱과 증거 추출
fable-ish · 완료 검증 게이트 (Stop 차단 메커니즘)
fable-ish · 스킬 워크플로우 지침 계층
fable-ish · 가드레일: 소프트 권고 vs 하드 위임
6. fable-ish
내 패턴 · 진입점과 플러그인 로딩 (settings.json -> 마켓플레이스 -> 플러그인)
내 패턴 · 컨텍스트·프롬프트 조립 (CLAUDE.md @-import 체인과 주입 헌법)
내 패턴 · 확장점: Hooks (전체 이벤트 라이프사이클과 system-reminder 주입)
내 패턴 · 확장점: Skills와 Slash-Commands (SKILL.md 프론트매터와 트리거)
내 패턴 · 확장점: Subagents (에이전트 .md 정의 형식과 모델 라우팅)
내 패턴 · 도구 시스템: MCP 브리지와 도구 정의·노출
내 패턴 · 가드레일: 권한·승인·샌드박스
내 패턴 · 상태·메모리 영속성 (다층 메모리와 세션 상태)
내 패턴 · 파이프라인 검증 게이트와 영수증 (admit / gate / claim-card)
7. 내 패턴
FBZ_10 — 훅 라우터 (작업별 팩 주입)
FBZ_20 — 조기 종료 차단 훅 (finish-the-work)
FBZ_30 — 검증 접지 팩 (verification grounding)
FBZ_40 — 조사 프로토콜 (investigation protocol)
FBZ_50 — 멀티스토리 증거 게이트 (goals.py)
FBZ_60 — 스킬 & always-on 운영 블록
FBZ_70 — 설치 & 플러그인 구조
fablize — Opus를 Fable처럼 (개요)
FL_10 PromptCore — 결정적 공개안전 운영 프로파일
FL2 Evidence Gate — 증거 없는 완료 차단
FL_30 Fail-closed Gates (라이선스·성능·런타임·렌더·퍼블리시·완전성)
FableLayer Router — 비용 인식 Sonnet/Opus 라우팅
FL_50 Adapters — 배포 형태별 export 생성기 (Claude Code·Ollama·LM Studio·SillyTavern)
FL_60 Benchmark — 결정적 픽스처 채점 + raw JSON
FL_70 Hooks & 플러그인 구조 (early-stop, 설치)
FableLayer Procedure & Source Policy (조사 절차·공개안전 정책)
FableLayer 개요 — 공개안전 절차·검증·벤치마크 레이어
분석축 루브릭 (10축)
20

비교분석

10축 비교 매트릭스
독창 아이디어 모음
축별 심층 분석
30

개선점

내 패턴 개선 백로그
통합 하네스 설계안 — 베스트 오브 베스트
3. 학습 인사이트 — 하네스 7종의 '설계 결정과 그 이유'
40

횡단분석

진입점·에이전트 루프 — 횡단분석
컨텍스트·프롬프트 조립 — 횡단분석
훅(Hooks) 횡단 — 코드가 AI의 행동에 끼어드는 법
스킬·커맨드 횡단 — 재사용 가능한 작업 절차를 패키징하는 법
도구·MCP 시스템 — 횡단분석
오케스트레이션·멀티에이전트 — 횡단분석
가드레일·샌드박스 횡단 — AI가 함부로 못 하게 막는 법
검증 루프 — 횡단분석
자기개선·반복 루프 — 횡단분석
상태·메모리 영속성 — 횡단분석
50

인사이트

하네스 설계 원칙 — 7개 하네스가 수렴한 10개 법칙
설계 플레이북 — '이런 요구·제약이면 이런 하네스'
하네스 안티패턴 — 코드에서 실제로 관찰된 위험·실패 설계 14선
나만의 하네스 조립 가이드 — 7프레임워크 베스트 부품을 내 이중모델 스택에 끼우기