하네스 엔지니어링 학습 볼트
이 볼트의 목적
비개발자 → 개발자 전직을 위한 에이전틱 엔지니어링(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축 거친 비교·개선백로그(요약본) | 비교 매트릭스 |
분석 방식
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 보관
Obsidian 사용 팁
- 그래프뷰(왼쪽 사이드바)를 열면 개념이 어떻게 연결됐는지 한눈에 보인다.
[[ ]]위에 마우스를 올리면 미리보기. 클릭하면 이동.- 검색은
Ctrl+O(빠른 열기),Ctrl+Shift+F(전체 검색).