왕초보용 0부터 시작하는 하네스 엔지니어링 with 코덱스(코덱스 세팅까지)

이번 영상은 슬라이드 메이커를 처음부터 만드는 과정을 따라가면서, 자연어 지시 → AGENTS.md → 스킬(Skill) → 훅(Hooks) 순서로 어떻게 하네스를 단단하게 거는지 단계별로 보여드립니다. 윈도우 + Codex + VS Code 환경에서 진행했고, 대학 강의용 슬라이드를 만들어주는 도구를 예시로 사용했습니다.

[도서 구매][Yes24] : https://www.yes24.com/product/goods/183530330
[도서 구매][교보] : https://product.kyobobook.co.k....r/detail/S0002195189
오픈카톡방 : https://open.kakao.com/o/ggK7EAJh

타임라인
0:00 하네스란 무엇인가 - 스킬·에이전트·훅 한눈에 소개
0:43 왜 슬라이드 메이커 만들기로 시연하는가
1:43 Codex 설치와 yolo 모드로 실행하기
2:04 GPT-5 강제 적용과 컨텍스트 윈도우 1M 설정
3:27 VS Code에서 터미널로 Codex 띄우기
4:24 하이퍼프레임즈·리모션, 슬라이드 도구 선택
7:53 검색으로 도구 조사부터 시키기
8:30 AGENTS.md 만들기 - 목적·선행조건·구조 박아두기
11:05 대학용 슬라이드 9가지 타입 생성과 정적 뷰 확인
16:50 9개 슬라이드 타입을 프로젝트 로컬 스킬로 분리
20:22 AGENTS.md에서 스킬을 자동 참조하게 연결하기
21:38 DESIGN.md 분리, 디자인 가이드 강제
24:04 페이퍼로지 폰트 등 타이포그래피 규제
25:17 메탈 스타일로 다시 생성해 결과 비교
29:27 훅(Hooks) 도입 - 포트 3000번 고정하기
30:41 StopHook 작성과 에이전트 라이프사이클 설명
33:12 새 요청으로 훅이 실제로 동작하는지 확인
36:30 말 / 스킬 / AGENTS.md / 훅, 언제 무엇을 쓸까
38:00 마무리

오늘 다룬 내용
- 하네스를 거는 네 가지 수단: 자연어 지시, AGENTS.md, 스킬(Skill), 훅(Hooks)
- AGENTS.md는 200줄 내외로 프로젝트 목적·선행 조건·전체 흐름만 담고, 디테일은 밖으로 분리한다
- 반복되는 세부 패턴은 프로젝트 로컬 스킬로 빼고, AGENTS.md에서 호출 규칙만 알려준다
- DESIGN.md를 따로 두면 폰트·컬러·레이아웃 같은 디자인 규약과 슬라이드 구조 규약의 충돌을 줄일 수 있다
- 훅은 판단 없이 즉시 실행되기 때문에 "포트 3000 고정"처럼 절대 어기면 안 되는 규칙에 어울린다
- Codex에서 GPT-5·1M 컨텍스트·fast 모드를 강제 적용하는 흐름
- 하이퍼프레임즈 기반 슬라이드 메이커 예시로 본 하네스의 전체 그림

#코덱스 #Codex #하네스 #AgentHarness #AGENTSmd #스킬 #Skill #Hooks #훅 #슬라이드메이커 #하이퍼프레임즈 #Remotion #VSCode #AI코딩 #바이브코딩 #VibeCoding #프롬프트엔지니어링 #LLM #코딩에이전트 #에이전트설계 #프로젝트구조 #개발자도구 #자동화 #생산성