*이 기사는 AI 음성 입력(Aqua Voice)으로 텍스트 변환하여 작성되었습니다. 표기 불일치가 있을 수 있으니 양해 부탁드립니다.
AI를 “부탁”으로 제어하는 시대는 끝났다 — 하네스 엔지니어링 실전 가이드
안녕하세요. 잘 지내고 계신가요?
풀바디 트래킹 연구소의 히로예요.
이전 기사에서 AI 엔지니어링의 세 가지 유형을 설명했어요. 오늘은 하네스 엔지니어링의 실전 구현에 대해 깊이 들어갈게요 — 실제로 어떻게 만드는지에 대해서요.
하네스의 실제 모습
하네스는 AI가 안정적으로 작동하는 환경을 만드는 여러 구조적 요소로 구성돼요.
CLAUDE.md — 기초 파일
이것은 AI가 매번 시작할 때 읽는 마스터 문서예요. 프로젝트 구조, 규칙, 워크플로, 다른 파일에 대한 참조가 담겨 있어요. AI 동작의 설계도라고 생각하면 돼요.
스킬 파일
AI에게 자신이 누구이고 어떻게 행동해야 하는지 알려주는 페르소나 정의예요. 나의 글쓰기에서는: 1인칭은 “나”, 톤은 캐주얼한 존댓말, 항상 숨겨진 테마를 포함, 직접 테스트하지 않은 디바이스를 추천하지 않기 등이 포함돼요.
메모리 시스템
결정 로그, 세션 학습, 오류 기록 — 모두 세션 간에 지속되는 파일로 저장돼요. AI는 시작할 때 이것들을 읽고 연속성을 유지해요.
품질 훅
AI가 출력을 생성한 후 자동으로 실행되는 스크립트예요. 규칙 준수를 체크해요: 올바른 페르소나, 적절한 포맷, 지식 베이스에 대한 사실 정확성. 실패하면 자동 수정 루프가 작동해요.
워크플로
일반적인 작업을 위한 사전 정의된 단계 시퀀스예요. 기사 작성의 경우: 테마 확인, 숨겨진 테마 설계, 구조 작성, 집필, 수정. AI는 매번 지시받지 않아도 이 단계를 따라요.
핵심 통찰: 부탁이 아닌 구조
컨텍스트 엔지니어링에서는 AI에게 “이 스타일로 써주세요”라고 말해요. 그건 부탁이에요. AI가 따를 수도 있고, 벗어날 수도 있어요.
하네스 엔지니어링에서는 스타일이 AI가 자동으로 읽는 파일에 정의돼 있어요. 체커가 준수를 확인해요. AI가 벗어나면 다른 부탁이 아닌 구조적으로 교정돼요.
이건 “조심해서 운전해주세요”라고 부탁하는 것과 도로에 가드레일을 설치하는 것의 차이예요.
첫 번째 하네스 만들기
작게 시작하세요:
- 프로젝트의 기본 규칙이 담긴 CLAUDE.md 만들기
- 글쓰기 페르소나를 정의하는 스킬 파일 하나 추가
- 결정을 기록하는 간단한 메모리 파일 설정
- 품질 체크 하나 추가 (1인칭 사용 확인 정도라도)
필요에 따라 확장하세요. 하네스는 구조적 강제가 필요한 패턴을 발견할 때마다 자연스럽게 성장해요.
읽어주셔서 감사합니다! X 팔로우와 YouTube 채널 구독 부탁드립니다!