Harness Engineering · 실습형 커리큘럼

일회성 프롬프트에서
반복 가능한 시스템으로

AI에게 "한 번 시키는 법"은 누구나 압니다. 이 과정은 그다음을 가르칩니다 — 누가 돌려도 같은 품질이 나오는 하네스(harness)를 만드는 법. 코드를 쓰지 않는 실무자가 Claude Code로 7차시 만에 내 업무 하네스 한 벌을 완성합니다.

커리큘럼 보기 1차시 시작하기 →

코딩 지식 없이 시작 7차시 · 완성 사례 제공 Agent · Skill · Tool

claude — 2차시 실습

# 광고대행사 AE: 매체 5곳 성과를 주간 리포트로
▸ data 폴더의 매체별 성과 파일을 통합해서
  주간 리포트를 만들어줘

→ Skill: media-glossary ✓ 자동 적용
{ "전환": "5,705건", "CPA": "24,136원",
  "ROAS": "366.9%" }

이슈 카카오모먼트 163%로 목표(350%) 미달.
전주 대비 CPA +13.1% — 예산 재배분 검토.

먼저 알고 시작할 것

모든 실습을 관통하는 4가지 원리

도구가 Claude Code든 Codex든, 업종이 광고든 제조든 공공이든 — 좋은 하네스는 늘 이 네 가지의 변주입니다.

01

역할 분리

"무엇을(스펙)·누가(에이전트)·어떻게(스킬)"를 한 프롬프트에 뭉치지 않고 파일로 나눕니다. 나눠야 재사용·비교·유지보수가 됩니다.

02

지식의 외부화

매핑 규칙·도메인 지식·표준 양식을 프롬프트가 아니라 파일로 꺼냅니다. 지식이 바뀌어도 로직은 그대로입니다.

03

계약이 병렬성을 만든다

표준 스키마·출력 형식을 먼저 정하면 일을 병렬로 나누고, 매번 같은 형식으로 반복할 수 있습니다.

04

검증자는 분리한다

만든 주체가 자기 결과를 최종 승인하지 않습니다. 별도 리뷰어가 교차 검증합니다. 잘 쓰기와 빠뜨리지 않기는 다른 능력입니다.

하네스의 구성 요소

Agent · Skill · Tool — 세 개의 축

하네스는 결국 이 세 가지의 조합입니다. 무엇을 언제 쓰는지 구분하는 것이 이 과정의 핵심 감각입니다.

Agent

누가 — 역할·경계

일을 나눠 맡길 때
지시문(정의 파일)로 존재
예: 요구분석가, 검증자

Skill

무엇을·어떻게 — 지식·절차

판단·문체·도메인 지식
프롬프트에 주입되는 문서
"설명서" — 모델이 해석

Tool

무엇으로 실행 — 결정론적

계산·조회·외부 연동
실제 코드(예: MCP 서버)
"계산기" — 항상 같은 값

판단 규칙 — 정의가 고정돼 늘 같은 답이 나와야 하는 일(계산·조회·API)은 Tool로, 맥락에 따라 달라지는 판단(무엇이 중요한가·어떻게 쓸까)은 Skill로. 그 둘을 누구에게 맡길지가 Agent입니다.

커리큘럼 · 7차시

비전공자를 위한 하네스 과정

코드를 쓰지 않는 실무자를 위한 7차시 과정입니다. 1차시에서 고른 내 업무 하나를 7차시까지 끌고 가며, 마지막에 파일로 남는 하네스 한 벌을 완성합니다. 각 차시는 교재 + 실무 사례로 구성됩니다. 광고대행사 AE 정하늘 대리가 1차시부터 7차시까지 자기 업무를 하네스로 만드는 과정을 ‘완성된 답’으로 보여 줍니다.

먼저

0차시 — 실습 환경 준비

교육 전날까지 완료 · 25~35분

필수

설치가이드

터미널을 처음 열어 보는 분 기준으로 씌었습니다. Git · Claude Code · 에이전트 팀 · Harness 플러그인까지 한 번에 준비합니다.

💻 Windows / 🍎 macOS🔒 관리자 권한 불필요

설치가이드 열기 →

선택

Codex CLI

ChatGPT Plus 구독으로 두 번째 AI를 붙입니다. 3차시 비교 실습과 7차시 이미지 스킬에 씁니다.

🔑 ChatGPT Plus 이상~15분

Codex 설치가이드 →

6차시 전

MCP 서버 (Tool)

파이썬 40줄 계산기를 AI에 붙입니다. 코드는 읽기만 합니다.

🐍 Python 3.10+~30분

MCP 설치가이드 →

1부

기준 세우기 — 무엇을 맡길 것인가

개념과 판단 기준

1차시

나의 업무 지도

AI에게 맡길 일과 사람이 쥘 일을 기준을 갖고 나눕니다. 광고 AE의 업무 지도를 완성된 예시로 봅니다.

🧑‍💼 사례

1차시 열기 →

2차시

지식을 파일로

왜 매번 결과가 다른가. 판단 기준을 프롬프트 밖 파일로 꺼내면 무엇이 달라지는지 직접 비교합니다.

🏭 제조 · 엑셀

2차시 열기 →

3차시

일의 단계 판단

혼자 / 팀 / 시스템. 같은 보고서를 세 방식으로 만들어 보고 "이 일은 몇 단계짜리인가"를 판정합니다.

📊 리서치

3차시 열기 →

2부

시스템으로 만들기 — 팀 · 계약 · 도구

직접 만드는 구간

4차시

전문가 팀 만들기

단일 프롬프트 vs 하네스를 A/B로 비교하고, 차이가 중간 산출물에서 온다는 것을 확인한 뒤 내 팀을 만듭니다.

🏛️ 공공 · 제안서

4차시 열기 →

5차시

지저분한 데이터에 하네스

15,144건 공공데이터로 하네스를 처음부터 끝까지. 스펙으로 규칙을 못 박고, 원본과 대조해 검증합니다.

🍽️ 공공데이터 · 맛집

5차시 열기 →

6차시

환각을 막는 도구

AI는 숫자도 법 조문도 지어냅니다. 계산 MCP와 법령 MCP를 붙이고, 필요한 도구는 직접 만듭니다.

🔌 MCP · 계산 + 법령

6차시 열기 →

마무리

일상 업무 하네스 만들기

골라 쓰기 → 고쳐 쓰기 → 직접 만들기

7차시

골라 쓰고 · 직접 만들기

공개된 하네스 100선에서 골라 돌려 보고, 뜯어보고, 내 업무에 맞게 고친 뒤 처음부터 하나 만듭니다.

🧰 harness-100 · 🎓 수료

7차시 열기 →

선택

확장 트랙 3가지

파이프라인 하네스 · 계약 중심 팬아웃 · 코드 유지보수. 관심 있는 것만 고릅니다.

📦 저장소 모듈

확장 트랙 →

운영자

과정 설계 문서

대상·설계 원칙·차시별 세부 목차·평가 기준·콘텐츠 제작 가이드를 담은 설계도입니다.

📐 CURRICULUM.md

설계 문서 →

실습 모듈 원본

입문 → 실무 → 확장

차시 커리큘럼이 사용하는 실습 모듈의 원본 교안입니다. 각 카드는 GitHub의 실습 폴더로 연결됩니다. 순서대로 배우려면 위의 7차시 커리큘럼을 따르세요.

필터를 고르면 그 대상에 맞는 모듈이 강조됩니다.

STAGE 1

입문 — 하네스가 무엇을 바꾸는가

개념을 몸으로 익히는 3개 필수 + 3개 선택 실습

공용

공정 보고서 표준화

용어·문체가 제각각인 6개 분임조 엑셀을 표준용어집 기반으로 통합. 지식을 파일로 외부화하는 첫 감각.

🏭 제조Claude Code~30분

xlsx/ 실습 →

공용

세 가지 일하는 방식

같은 보고서를 단일 → 멀티 → 하네스 3단계로 만들며 "이 일은 몇 단계짜리인가"를 판단하는 눈을 기릅니다.

📊 마케팅Codex~40분

codex/ 실습 →

공용

단일 vs 에이전트 팀

배경지식 없는 상태에서 전문가 에이전트 구조가 제안서를 어떻게 바꾸는지 A/B로 비교합니다.

🏛️ 공공·의료Claude Code~40분

harness/ 실습 →

공용선택

정책 데이터 → 슬라이드

수집 → 갱신 → 디자인 → 검수로 이어지는 파이프라인 하네스. 기준일 하나로 전체가 갱신되는 살아있는 문서.

📑 정책Claude Code~40분

slide/ 실습 →

개발선택

스펙 → 하네스 직접 설계

스펙(What)을 쓰고 하네스(Who/How)를 직접 구성해 맛집 지도 웹앱을 완성. 역할 분리를 손으로 설계합니다.

🗺️ 데이터·웹Claude Code~60분

map/ 실습 →

개발선택

실시간 설비 대시보드

이기종 설비 텔레메트리를 표준 스키마로 정규화. 계약을 먼저 정해 병렬 개발하는 팬아웃 하네스.

🖥️ 제조·관제Claude Code~60분

dashboard/ 실습 →

STAGE 2

실무 — 매일 돌리는 하네스 엔지니어링

Codex를 대화형으로 익히고, 반복되면 자동화

New개발

트랙 A · 코드 유지보수

숨은 결함이 있는 품질 스크립트로 "초록불 ≠ 정확"을 체험. 대화형 진단 → 승인하며 패치 → 교차 리뷰, 그리고 CI 자동화.

🏭 제조Codex~40분

트랙 A 실습 →

New비개발

트랙 B · 업무 자동화

코드 없이 규제 모니터링을 시스템화. 대화형으로 형식이 흔들리는 문제를 겪고, 스키마 계약으로 매주 같은 구조를 보장.

🏦 금융Codex~30분

트랙 B 실습 →

개요

Harness Engineering 5원칙

샌드박스·권한 통제(대화형 승인 vs 자동화 샌드박스), 출력 계약, 검증자 분리 — 실무 하네스의 공통 규율을 정리합니다.

📐 공통Codex읽기

개요 읽기 →

STAGE 3

확장 — 에이전트에 없는 능력을 붙이기

세 번째 축 Tool을 직접 만든다

NewTool공용

오픈소스 MCP Tool 만들기

Python 40여 줄로 생산지표(OEE) 계산 MCP 서버를 만들어, Claude Code와 Codex가 같은 서버를 공유하게 합니다. Skill(설명서)과 Tool(계산기)의 차이를 손으로 익힙니다.

🏭 제조(→금융 확장)Claude Code + Codex~40분

tool/ 실습 →

두 개의 에이전트, 하나의 원리

대화형으로 익히고,
반복되면 자동화한다

Claude Code와 Codex는 문법이 다를 뿐 개념은 같습니다. 처음엔 대화형으로 일을 시키며 승인·권한 감각을 익히고, 세 번 이상 반복되는 일만 비대화형으로 자동화합니다. 자동화는 대화형의 대체가 아니라, 충분히 반복되는 일에 대한 졸업입니다.

대화형codex(TUI)·Codex 앱·Claude Code. 쓰기 전에 승인을 묻습니다 — 승인이 안전장치. 자동화codex exec·CI. 승인이 없으므로 샌드박스(read-only/workspace-write)로 통제. 공통규칙은 AGENTS.md·CLAUDE.md로, 출력은 스키마로 계약.

트랙 A — 대화형 → 자동화

# 1) 대화형: 권한 없이 진단만
▸ quality_check.py 를 검토해줘.
  수정 말고 결함만 진단.
✓ 단위 오류(ppm ×1000)·0 나눗셈 발견

# 2) 승인하며 패치 (쓰기 전 승인 요청)
approve? edit quality_check.py  [y]

# 3) 반복되면 자동화 (CI 게이트)
$ codex review --uncommitted

누구를 위한가

두 갈래의 학습 경로

본 과정 7차시는 모두 같습니다 — 코딩 지식은 필요 없습니다. 갈라지는 것은 수료 이후입니다.

비개발자 실무자 경로

기획·마케팅·관리·리서치 담당

1~7차시 전부 — 광고대행사 AE 정하늘 대리 사례를 따라갑니다
6차시 Python — 코드는 읽기만. 도구를 붙이고 AI에게 시켜 만듭니다
7차시 선택 확장 — 이미지 스킬로 발표자료까지 (Codex 구독 시)
확장 E1 — 정책 데이터 → 표준 슬라이드 (코드 없이 가능)
그다음 — 하네스 100선에서 내 업무와 비슷한 것을 골라 이식

개발자 엔지니어 경로

개발·데이터·플랫폼 담당

1~7차시 전부 — 같은 과정. 원리는 도메인을 가리지 않습니다
5차시 심화 — 스펙 작성 스킬을 직접 만들어 팀에 배포
6차시 심화 — server.py 를 읽고 도구를 여러 개 추가
확장 E2·E3 — 계약 중심 팬아웃 · 코드 유지보수 하네스(CI 게이트)
그다음 — 팀 표준 하네스를 만들어 .claude/ 로 배포

시작하기

5단계로 환경 준비

최초 1회만 설치하면 됩니다. 터미널이 처음이어도 괜찮습니다 — 설치가이드가 명령마다 "이렇게 나오면 정상 / 이렇게 나오면 오류"를 함께 안내합니다.

STEP 1

Git 설치

git --version

실습 저장소와 플러그인을 받는 데 필요합니다.

STEP 2

Claude Code 설치

irm https://claude.ai/install.ps1 | iex

설치 후 터미널을 새로 엽니다.

STEP 3

Harness · Skills 플러그인

/plugin marketplace add revfactory/harness
/plugin install harness@harness-marketplace

Anthropic Skills도 함께 설치합니다.

STEP 4

에이전트 팀 켜기

setx CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 1

하네스의 필수 조건입니다.

STEP 5

Python 설치 (6차시용)

python --version

3.10 이상이 아니면 설치합니다. 6차시 실습이 Python 위에서 돕니다 — 당일에 설치하려다 막히는 일이 가장 많습니다. 도구 연결(MCP)은 6차시 직전에 5분이면 됩니다. (Codex는 선택)

설치가이드 열기 → 1차시 시작하기 →

지금, 한 모듈부터

전체를 다 할 필요는 없습니다. 1~3차시만 해도 하네스의 핵심은 잡힙니다. 각 차시가 순서·관찰 포인트·자가 점검을 안내합니다.