본문 바로가기
AI.IT

하네스 엔지니어링 — AI 코딩 시대, 결과물을 통제하는 진짜 기술

by bamsik 2026. 5. 13.
반응형

 

HARNESS ENGINEERING ISSUE №47 · 2026.05
— AI-IT · LONG READ

하네스
엔지니어링

AI 코딩 시대, 같은 모델·같은 프롬프트라도 결과가 다른 이유. 결과물을 통제하는 진짜 기술은 모델 바깥에 있다.

FIELD NOTES · 워크플로우 · 룰 · 컨텍스트 ↗ READ 12 MIN
AI-IT · LONG READ № 47

하네스 엔지니어링 — AI 코딩 시대,
결과물을 통제하는 진짜 기술

프롬프트 엔지니어링이 2023년 키워드였다면, 하네스 엔지니어링은 2026년 키워드다. ZeroCho의 Codex+Superpowers 셋업과 Claude Code+gstack 셋업이 같은 결론에 도달한 이유.

JBS
장범석
AI 워크플로우 엔지니어 · 블로그 자동화 파이프라인 운영 (누적 발행 1,500건+) · Claude Code & OpenClaw 실무 적용
2026.05.13
READ 12 MIN
§ 01 — DEFINITION

하네스(Harness)가 뭔데?

Harness는 강아지 몸통을 채우는 그 장구다. 줄을 목에만 걸면 강아지가 사방으로 튀지만, 몸통을 감싸면 통제가 된다. AI도 똑같다.

같은 프롬프트를 줘도 결과 퀄리티가 천차만별인 이유는 단순히 모델 차이가 아니다. 모델 주변을 둘러싼 워크플로우, 권한, 컨텍스트, 검증 체계 전체가 결과를 만든다. 이걸 다 합쳐서 "하네스"라고 부르고, 그걸 설계·관리하는 일이 하네스 엔지니어링이다.

FIG.01 · THESIS
"
프롬프트 엔지니어링이 2023년 키워드였다면, 하네스 엔지니어링은 2026년 키워드다.
— 본문 핵심 명제 / 시대 정의
§ 02 — CASE STUDY A

ZeroCho의 Codex 셋업 — 핵심만

영상에서 ZeroCho는 ManicTime(유료 시간 추적 앱) 대체품을 Tauri + React + Rust로 직접 만든다. 그 과정에서 보여준 셋업이 인상적이었다.

데스크톱 Codex 권장 설정

ITEMVALUENOTE
모델GPT-5.5최신
IntelligenceMedium대부분 충분
속도Fast mode ON1.5배 빠름, 토큰 2배
컨텍스트1M 토큰 확장config에서 조정
권한자동 검토 → 전체익숙해지면 풀기

핵심 도구: Superpowers 플러그인

ZeroCho가 가장 강조한 도구. 하나의 프롬프트가 다음 흐름을 자동으로 탄다.

FIG.02 · PIPELINE
하나의 프롬프트가 거치는 자동 흐름
01
브레인스토밍
PM 역할 — 요구사항 풀어내기
02
Writing Plans
개발팀장 역할 — 작업 분해와 스펙 작성
03
서브에이전트 병렬 구현
worktrees로 충돌 방지하며 동시 실행
04
TDD 테스트
자동 생성된 테스트로 1차 검증
05
리뷰
실패 시 재구현 루프 진입
06
Compound 단계
실수를 docs에 누적 — 같은 실수 두 번 없게
07
머지 + worktree 정리
PR 머지 후 작업공간 회수
— 프롬프트 1회 입력으로 자동 진행되는 7단계 / Superpowers 플러그인

보조로는 gstack(CEO 리뷰, 디자인 리뷰, CSO 보안 점검 같은 역할놀이 스킬)을 깐다. 보안 점검(CSO)은 강력 추천. [출처: ZeroCho 2026.05 라이브 영상]

§ 03 — CASE STUDY B

실무에서 굴리고 있는 하네스 — Claude Code + OpenClaw

영상을 보면서 "어? 이거 이미 하고 있는데?" 싶었다. 진영만 다를 뿐 패턴은 동일하다.

FIG.03 · TWO CAMPS
독립 진화한 두 진영의 1:1 대응
CAMP A
ZeroCho 진영
  • Codex (GPT-5.5)
  • Superpowers 플러그인
  • Writing Plans 스킬
  • 서브에이전트 worktrees
  • TDD 내장
  • Compound Engineering
  • CSO 보안 스킬
CAMP B
내 진영
  • Claude Code (Opus 4.7)
  • gstack + openclaw-skills
  • /plan-ceo, /plan-eng
  • Agent + isolation:worktree
  • /qa, /review, /health
  • memory/*.md 위키 누적
  • /cso, /careful, /guard
— 같은 패턴이 두 진영에서 독립 진화 / 거의 1:1 대응

파이프라인 1 — 블로그 자동화 v2

멀티에이전트 마이그레이션 완료. 주제 입력 → 리서치(Exa/Brave) → PM → 작가 → 편집자 → 이미지 검색 체인 → 티스토리/Blogger 자동 발행. 누적 발행 1,500건 이상, 사람 손은 주제 입력과 최종 확인만. [출처: 자체 운영 데이터 2026.05]

파이프라인 2 — 일간 뉴스 큐레이션

매일 09:30 KST 사내 시스템 발행. 새벽 시간대 Claude 에이전트가 모든 분야 핫뉴스를 수집해 7개 섹션(AI/영상/TA/3D 등)으로 큐레이션 → merge 모드 업로드. "카테고리 enum 고정 금지" 같은 룰을 일부러 박아놨다. AI가 자기 편향대로 분류하지 못하게 매번 자율 선택하게 만든 거다 — 이게 내가 만든 하네스다.

§ 04 — KEY TAKEAWAYS

영상에서 가장 와닿은 7가지 교훈

ZeroCho가 정리한 핵심 메시지에 실무 코멘트를 붙였다.

FIG.04 · LESSONS
현장에서 검증된 7가지 룰
01
기획이 가장 중요하다
코드는 AI가 매번 다시 짠다. 스펙이 Single Source of Truth.
02
바퀴를 재발명하지 마라
Superpowers/gstack 등 기존 하네스를 베이스로 깔고 커스터마이징.
03
프로젝트마다 하네스가 달라야 한다
영상 제작용에 TDD는 불필요. 프로젝트에 맞춰 변형.
04
모델이 똑똑해질수록 하네스는 줄여라
GPT-6/Claude 5 시대엔 지금 하네스의 절반이 불필요. 항상 뺄 준비.
05
보안엔 토큰 아끼지 마라
프로그램은 복구되지만 데이터 삭제·보안 노출은 진짜 사고다.
06
토큰 한도는 진짜 넉넉하다
2시간 라이브에서 5시간 한도의 14%만 소모. Max는 사실상 무제한.
07
컨텍스트 자동 압축 시점이 가장 위험
정보 손실 구간. 75% 넘으면 직접 정리해서 위키에 박아두는 가드 필요.
— 출처: ZeroCho 2026.05 라이브 + 자체 실무 검증
FIG.05 · DATA POINT
14 %
2시간 코딩 라이브에서 ZeroCho가 소모한 Codex 5시간 한도 비율. 주간 한도 기준으로는 3%.
— 토큰 아끼느라 품질 깎는 게 가장 비효율적이라는 근거
§ 05 — ACTION ITEMS

그래서 뭘 해야 하는데?

단계별 실행 권장사항. 초심자와 경험자를 분리해서 정리했다.

FIG.06 · CHECKLIST
단계별 실행 권장사항
STAGE 1
처음이라면
  • Claude Code 또는 Codex 중 하나 설치 (한국어 자료는 Claude Code가 더 많음)
  • gstack(Claude) 또는 Superpowers(Codex) 설치 — 바퀴 재발명 금지
  • 첫 프로젝트는 작은 도구 하나로
  • CSO/보안 스킬은 첫날부터 켜기
  • 스펙 문서를 코드보다 먼저 쓰기
STAGE 2
이미 굴리고 있다면
  • 컨텍스트 압축 시점 가드 추가하기
  • Compound Engineering(실수 누적 docs) 도입
  • 프로젝트별로 하네스를 다르게 — 범용 템플릿 하나로 다 하지 말기
  • 모델 업그레이드마다 하네스에서 뺄 것 검토
  • 카테고리 enum 자율성 같은 "AI 편향 차단" 룰 박기
— 단계별 권장 액션 / Claude Code · Codex 양 진영 공통 적용
§ 06 — CLOSING

마치며

같은 모델, 같은 프롬프트라도 하네스가 있는 사람과 없는 사람의 결과물은 완전히 다르다. 그리고 하네스는 도구가 아니라 워크플로우와 룰의 조합이라서, 자기 프로젝트에 맞게 직접 설계해야 한다.

영상 진영(Codex+Superpowers)과 내 진영(Claude Code+gstack/openclaw-skills)이 사실상 같은 결론에 도달한 걸 보면 — 이건 더 이상 트렌드가 아니라 AI 코딩의 표준이 되어가고 있는 것 같다.

FIG.07 · CLOSING QUOTE
"
AI에 끌려다니지 말고,
하네스를 채워서 끌고 다녀라.
— ZeroCho, 2026.05 라이브 영상
REFERENCES · 참고자료
  • [1] ZeroCho 라이브 영상 "ManicTime 대체품 Codex 제작기" — 2026.05
  • [2] Superpowers 플러그인 공식 문서 (Codex marketplace)
  • [3] gstack · openclaw-skills GitHub 저장소
  • [4] Anthropic Claude Code 공식 문서 (Opus 4.7 · 1M context)
  • [5] 자체 운영 데이터: 블로그 자동화 파이프라인 v2 / 일간 뉴스 큐레이션 — 2026.05 기준
END OF ISSUE №47 HARNESS ENGINEERING / 2026.05.13

📌 함께 보면 좋은 글

반응형