하네스 엔지니어링 학습 볼트

[!abstract] 이 볼트의 목적 비개발자 → 개발자 전직을 위한 에이전틱 엔지니어링(Agentic Engineering) / 하네스 엔지니어링(Harness Engineering) 학습 노트. 세 시스템 — Claude Code · OpenAI Codex CLI · oh-my-claudecode(OMC) — 이 “LLM에게 일을 시키는 하네스” 라는 같은 문제를 어떻게 다르게 푸는지 비교하며 패턴을 익힌다.

어디서 시작하지?

하네스엔지니어링이란 — 개념부터 (반드시 먼저)
학습로드맵 — 순서·예상시간 체크리스트
용어집 — 모르는 단어 나오면 여기로

4층 구조 (개념 → 세로분해 → 가로횡단 → 정수)

층	폴더	다루는 것	진입점
개념	00_시작하기	하네스 4기둥·용어	하네스엔지니어링이란
세로	프레임워크분석	9대상 기능별 심층분해(형식·예시·AI주입·템플릿) + 공식문서 개념	분석축 루브릭
가로	40 횡단분석	10개 기능축을 프레임워크별 형식단위 비교(공통패턴·분기점·차용베스트)	훅 횡단
정수	50 인사이트	설계원칙·의사결정 플레이북·안티패턴·나만의 하네스 조립가이드	조립가이드
(1차)	20 비교 · 30 개선	10축 거친 비교·개선백로그(요약본)	비교 매트릭스

[!note] 분석 방식 9개 대상(Claude Code·Codex·OMC·gajae-code·ouroboros·fable-ish·fablize·fablelayer·내 패턴)을 Claude + Codex 교차검증으로 분해(/ccg식). ※ fablize·fablelayer는 개별 분해만 — 횡단·비교매트릭스는 7개 기준. 공식문서(code.claude.com 135p, developers.openai.com 88p)는 10_프레임워크분석/_원문아카이브에 전량 보관(색인 제외). 소스는 _소스레포에 zip.

개념 허브 (그래프 중심 노드)

이 노드들로 세 시스템이 그래프에서 연결된다:

하네스(Harness) · 컨텍스트 엔지니어링 · 에이전트(Agent) · 툴(Tool)
MCP(Model Context Protocol) · Hook(훅) · 에이전트 위임 · 검증 루프

진행 현황 (완료)

볼트 골격 + 진입 폴더(00)
공식문서 전량 수집 (claude-code 135p + codex 88p)
9대상 기능별 심층분해 (Claude+Codex; +fablize +fablelayer 추가 분해)
횡단분석 10 (기능축별 7프레임워크 비교) + Codex 교차검증
인사이트 4 (설계원칙·플레이북·안티패턴·조립가이드) + Codex 메타검증
1차 비교/개선(20/30) — 거친 요약본
전체 위키링크 정합 + 소스 zip 보관

[!tip] Obsidian 사용 팁

그래프뷰(왼쪽 사이드바)를 열면 개념이 어떻게 연결됐는지 한눈에 보인다.

[[ ]] 위에 마우스를 올리면 미리보기. 클릭하면 이동.

검색은 Ctrl+O(빠른 열기), Ctrl+Shift+F(전체 검색).