AI 하네스 · 2부 · 챕터 4

지시 파일 — AI에게 '업무 매뉴얼'을 주는 법

The Instruction File — Giving Your AI a Work Manual

비개발자 하네스 4요소의 첫째, 지시 파일을 만드는 챕터입니다. 같은 AI가 왜 다른 결과를 내는지에서 출발해, 새 대화마다 리셋되는 AI에게 역할·금지 사항·형식·참고 자료를 심어 두는 법을 오픈AI와 하시모토의 교훈으로 풀고, 다섯 가지 원칙과 30분 실습으로 실제로 작동하는 지시 파일 하나를 완성합니다.

출전: 『AI 하네스』 2부 · 챕터 4
시리즈: 2부 — 4요소를 하나씩 설계하는 법(챕터 4~7)
구성: 3부 9장

차례

PART I왜 지시 파일인가
01같은 AI, 같은 날, 같은 요청 — 그런데 결과가 다릅니다
02AI는 알려 주지 않으면 모릅니다
03개발자의 AGENTS.md와 비개발자의 지시 파일
PART II두 가지 교훈과 한 가지 방법
04오픈AI의 교훈 — 지도를 줘라, 매뉴얼을 주지 마라
05하시모토의 원칙 — 실수가 생기면 파일이 두꺼워집니다
06점진적 노출 — 스킬로 지시 파일을 분할하는 법
PART III원칙과 실습
07비개발자 지시 파일 작성의 5가지 원칙
08왜 비개발자에게 중요한가
09실습 — 나만의 AI 업무 매뉴얼 만들기(약 30분)
＋정리 체크리스트 · 토론 질문 · 편집자 주 · 사진 출처표

학습 목표

새 대화를 열 때마다 AI의 기억이 리셋되는 까닭과, 지시 파일이 그 리셋을 막는 원리 설명하기
개발자의 AGENTS.md에 담기는 것과 비개발자의 지시 파일에 담기는 것을 짝지어 말하기
"지도를 줘라, 매뉴얼을 주지 마라"를 지시 파일의 길이와 분리 원칙으로 옮기기
AI의 실수 하나를 규칙 한 줄로 바꾸는 하시모토 방식으로 내 지시 파일을 키우기
업무 유형별로 지시 파일을 나누는 점진적 노출을 프로젝트나 스킬로 구현하기
역할·금지·형식·참고·실수 규칙의 다섯 원칙에 따라 지시 파일 초안을 쓰기
30분 실습의 세 단계(생성·초안·테스트)를 밟아 작동하는 지시 파일 하나 완성하기

용어 뜻풀이

지시 파일제1장: AI가 작동하기 전에 알아야 할 역할·금지 사항·형식·참고 자료를 한곳에 정리한 업무 매뉴얼
리셋(reset)제2장: 새 대화를 열면 지난 대화에서 한 설명이 존재하지 않는 것이 되어 AI가 백지로 돌아가는 일
AGENTS.md제3장: 개발자가 쓰는 에이전트 전용 지시 파일. 코드 규칙·구조·금지된 패턴을 담는 문서
지도와 매뉴얼제4장: 100줄짜리 핵심 포인터(지도)와 1,000페이지 규정집(매뉴얼)을 견주는 오픈AI 팀의 비유
핵심 포인터제4장: 상세 규칙은 별도 문서에 두고 "더 자세한 내용은 여기를 참조하라"고만 적는 짧은 지시 파일
복리 효과제5장: 실수마다 더한 규칙 한 줄이 내일과 다음 달에도 작동해 지시 파일이 두꺼워지며 쌓이는 것
컨텍스트 오염제6장: 다른 업무의 규칙이 한 파일에 섞여 지금 하는 작업에서도 AI의 컨텍스트를 차지하는 일
점진적 노출(progressive disclosure)제6장: 필요한 지침을 필요한 시점에만 활성화하는 원리. 스킬과 업무별 프로젝트로 구현하는 것
스킬(Skills)제6장: 지침·컨텍스트·도구를 하나로 묶어 두었다가 해당 업무를 시작할 때 불러오는 패키지
금지 목록제7장: "이 표현은 절대 쓰지 마라"처럼 AI가 쓸 수 없는 공간을 먼저 정하는, 즉시 효과가 나는 규칙
프로젝트 인스트럭션(Project Instructions)제9장: 클로드 프로젝트에서 지시 파일을 적는 입력란. 챗GPT에서는 맞춤화 설정이 이에 해당하는 것
완성 기준제9장: 역할에 맞는 톤, 지정한 길이·구조, 금지 표현 없음 — 실습이 끝났는지 확인하는 세 가지

PART I

왜 지시 파일인가WHY AN INSTRUCTION FILE

01SAME AI, DIFFERENT RESULT

같은 AI에 같은 요청을 넣어도 결과가 다른 두 경우를 나란히 놓고, 그 차이가 지시 파일에 있다는 데서 챕터를 엽니다.

같은 AI, 같은 날, 같은 요청 — 그런데 결과가 다릅니다

같은 AI, 같은 날, 같은 요청입니다. 그런데 결과가 다릅니다.

한쪽은 이렇습니다. "콘텐츠 마케터용 인스타그램 캡션을 작성해 줘"라고 입력하면, AI가 영어 표현이 섞인 캐주얼한 문장을 내놓습니다. 지난주에 수정을 요청했던 과장 표현이 또 나옵니다. 분량도 매번 다릅니다. 수정하는 데 원고 작성보다 시간이 더 걸립니다.

다른 쪽은 이렇습니다. 같은 요청을 입력하면, 브랜드 톤 가이드에 맞는 문장이 나옵니다. 금지 표현은 없고, 분량은 150자 안팎, 해시태그는 3개입니다. 지난달에 한 번 수정을 요청했던 사항이 지금도 반영되어 있습니다.

흰 주사위 여러 개 — 사진 1 · 주사위. 지시 파일이 없는 쪽의 결과물은 분량도 표현도 던질 때마다 다릅니다. Gaz, 2004 · Wikimedia Commons · CC BY-SA 3.0

같은 요청, 같은 AI	지시 파일이 없는 쪽	지시 파일이 있는 쪽
표현	영어 표현이 섞인 캐주얼한 문장. 지난주에 고친 과장 표현이 다시 나옵니다	브랜드 톤 가이드에 맞는 문장. 금지 표현이 없습니다
분량·해시태그	매번 다릅니다	150자 안팎, 해시태그 3개
지난 수정 요청	다음 대화에서 다시 나옵니다	지난달에 한 번 요청한 것이 지금도 반영되어 있습니다
일이 되는 방식	매번 새 대화에서 AI에게 맥락을 설명합니다	AI가 작동하는 환경에 규칙을 미리 심어 두었습니다

표 1 · 같은 요청, 다른 결과 — 제1장의 두 경우를 항목별로 정리한 것

차이는 지시 파일입니다. 한쪽은 매번 새 대화에서 AI에게 맥락을 설명합니다. 다른 쪽은 AI가 작동하는 환경에 규칙을 미리 심어 두었습니다. 챕터 3에서 선언한 비개발자 하네스 4요소 가운데 첫 번째가 이것입니다.

이 챕터에서는 지시 파일을 어떻게 만들고, 무엇을 담고, 어떻게 성장시키는지를 다룹니다. 챕터 말미의 실습(약 30분)까지 마치면 실제로 작동하는 지시 파일 하나가 완성됩니다.

02RESET

오픈AI 코덱스 팀의 원칙 "접근할 수 없는 것은 존재하지 않는 것이다"를 비개발자 맥락으로 옮깁니다. 새 대화마다 리셋되는 AI에게 기억을 심는 길은 환경뿐이라는 논지입니다.

AI는 알려 주지 않으면 모릅니다

오픈AI(OpenAI) 코덱스 팀이 5개월간의 에이전트 운용 보고서에서 밝힌 원칙이 있습니다. "에이전트의 관점에서, 컨텍스트 내에서 접근할 수 없는 것은 존재하지 않는 것이다."

이것을 비개발자 맥락으로 바꾸면 이렇습니다. AI는 알려 주지 않으면 모릅니다. 역할을 설명하지 않으면 모르고, 금지 사항을 명시하지 않으면 지키지 않고, 형식 기준을 정해 주지 않으면 임의로 결정합니다. 그리고 매번 새 대화를 열 때마다 그 사실이 리셋됩니다.

구체적인 예를 들면 이렇습니다. 지난 대화에서 "우리 브랜드는 영어 혼용을 하지 않는다"고 설명했습니다. AI는 그 대화 안에서는 지킵니다. 그러나 새 대화를 열면 처음부터 다시 시작입니다. 그 대화에서 한 설명은 존재하지 않는 것이 됩니다. AI에게 영속적으로 기억을 심을 수 있는 방법은 환경에 규칙을 두는 것뿐입니다.

다이얼식 옛 전화기 — 사진 2 · 다이얼식 전화기. 통화를 끊고 다시 걸면 지난 통화에서 한 말은 상대에게 남아 있지 않습니다. Berit Watkin · Wikimedia Commons · CC BY 2.0

도해 1 · 리셋을 막는 장치 — 제2장의 논지를 그림으로 옮긴 것

지시 파일은 이 리셋을 막는 장치입니다. AI가 작동하기 전에 알아야 할 것들은 역할, 금지 사항, 형식, 참고 자료입니다. 이것들을 한곳에 정리해 두면, AI는 그 기준에 맞춰 첫 문장부터 작동합니다.

AI에게 영속적으로 기억을 심을 수 있는 방법은 환경에 규칙을 두는 것뿐입니다.
제2장 · 저자

03TRANSLATION

개발자들이 오래전부터 써 온 에이전트 전용 지시 파일과 비개발자의 지시 파일을 한 표에 놓습니다. 내용은 달라도 역할은 같다는 점, 그리고 가장 자주 빠지는 항목이 무엇인지 짚습니다.

개발자의 AGENTS.md와 비개발자의 지시 파일

개발자들은 이 개념을 오래전부터 써 왔습니다. 하시모토의 고스티(Ghostty) 프로젝트에는 에이전트 전용 지시 파일(AGENTS.md)이 있습니다. 오픈AI 코덱스 팀도 같은 역할을 하는 파일을 운용합니다. AI가 코드를 쓸 때 지켜야 할 규칙, 사용해야 할 구조, 금지된 패턴이 그 파일에 담겨 있습니다.

비개발자의 지시 파일은 이것의 번역입니다. 코드 규칙 대신 업무 규칙이 들어갑니다.

서버 랙에 층층이 꽂힌 컴퓨터들 — 사진 3 · 서버 랙. 개발자의 지시 파일에는 코드 규칙이, 비개발자의 지시 파일에는 업무 규칙이 들어갑니다. Abigor · Wikimedia Commons · CC BY-SA 3.0

개발자가 지시 파일에 담는 것	비개발자가 지시 파일에 담는 것
코드베이스 구조와 레이어 순서	업무 역할과 전문 분야 정의
빌드 명령과 테스트 방법	출력 형식과 분량 기준
코딩 스타일 규칙	말투·톤·금지 표현 목록
프로젝트 디렉토리 구조	참고해야 할 자료와 위치
과거 실수를 방지하는 규칙	과거 수정 요청에서 추출한 규칙

표 2 · 개발자의 AGENTS.md와 비개발자의 지시 파일 — 제3장의 대응표

내용은 다릅니다. 역할은 같습니다. AI가 작동하기 전에 알아야 할 것들을 환경에 심어 두는 것입니다.

비개발자가 만드는 지시 파일에서 가장 자주 빠지는 항목은 "과거 실수를 방지하는 규칙"입니다. 처음 지시 파일을 만들 때는 긍정적 지시 위주로 채우게 됩니다. "이렇게 써라", "이 톤을 유지해라". 실무에서 AI를 쓰다 보면 금지 목록이 늘어납니다. "이것만은 하지 마라"는 규칙이 시간이 지날수록 지시 파일의 핵심이 됩니다.

편집자 주

표 2의 마지막 행 — 과거 실수를 방지하는 규칙 — 이 제5장(하시모토의 원칙)과 제7장의 원칙 5로 이어집니다. 저자가 이 챕터에서 가장 여러 번 되짚는 항목입니다.

PART II

두 가지 교훈과 한 가지 방법TWO LESSONS AND ONE METHOD

04MAP VS MANUAL

모든 것을 한 파일에 담으려는 흔한 실수를 오픈AI 코덱스 팀의 교훈으로 반박합니다. 100줄짜리 핵심 지도와 1,000페이지 매뉴얼의 차이가 핵심입니다.

오픈AI의 교훈 — 지도를 줘라, 매뉴얼을 주지 마라

지시 파일을 처음 만드는 사람이 흔히 저지르는 실수가 있습니다. 모든 것을 한 파일에 담으려는 것입니다. 역할 정의, 형식 규칙, 참고 자료, 예시 문장, 금지 표현, 업계 배경지식까지. 결과적으로 수천 자짜리 지시 파일이 만들어집니다.

오픈AI 코덱스 팀의 핵심 교훈이 이것을 반박합니다. "지도를 줘라, 1,000페이지 매뉴얼을 주지 마라." 팀은 처음에 에이전트 전용 지시 파일에 모든 규칙을 넣으려 했습니다. 결과는 오히려 성능 저하였습니다. 너무 많은 정보가 주어지면 AI는 정작 중요한 것을 놓칩니다.

해결책은 분리였습니다. 에이전트 전용 지시 파일은 약 100줄의 핵심 포인터 역할만 했습니다. 상세한 규칙과 참고 자료는 별도 문서에 두고, 지시 파일에서는 "더 자세한 내용은 여기를 참조하라"고만 적었습니다. 핵심 지도가 있고, 나머지는 필요할 때 찾는 구조입니다.

바닥에 쌓인 복사 용지 열다섯 묶음 — 사진 4 · 바닥에 쌓인 용지 더미. 수천 자짜리 지시 파일은 AI에게 이 더미를 통째로 읽으라는 것과 같습니다. Sage Ross (WMF), 2013 · Wikimedia Commons · CC BY-SA 3.0

비개발자에게 이것은 구체적인 원칙으로 바뀝니다.

비개발자 번역

개발자 — AGENTS.md는 목차입니다. 백과사전이 아닙니다.
비개발자 — 지시 파일은 AI에게 주는 업무 브리핑입니다. 회사 전체 규정집이 아닙니다.
실제로는 — 핵심 역할·금지 사항·형식을 담되, 자세한 참고 자료는 별도로 첨부합니다.

원문에서 '비개발자 번역'이라는 상자로 제시한 세 줄을 그대로 옮긴 것입니다.

도해 2 · 지도와 매뉴얼 — 제4장에 나온 오픈AI 코덱스 팀의 해결책

실제로 지시 파일이 지나치게 길어질 때 어떤 일이 생기는지 짚어 둘 필요가 있습니다. 지시 파일을 수백 줄로 채우면 AI는 그 내용을 전부 처리해야 합니다. 처리하는 내용이 많아질수록 정작 중요한 규칙이 묻힙니다. 오픈AI 팀이 "지도와 매뉴얼"의 차이를 강조한 이유가 여기 있습니다. 100줄짜리 핵심 지도가 1,000줄짜리 매뉴얼보다 AI에게 더 잘 작동합니다.

05GROWTH

처음부터 완벽할 필요가 없다는 하시모토의 원칙을 비개발자의 지시 파일에 적용합니다. 실수 하나가 규칙 한 줄이 되어 파일이 두꺼워지는 과정이 복리 효과의 실체입니다.

하시모토의 원칙 — 실수가 생기면 파일이 두꺼워집니다

지시 파일을 처음 만들 때 완벽할 필요가 없습니다. 하시모토의 원칙이 이것을 말해 줍니다.

고스티의 에이전트 전용 지시 파일 각 줄은 과거 에이전트가 저지른 실수를 방지하는 규칙입니다. AI가 무언가 잘못 처리할 때마다 규칙 한 줄이 추가됐습니다. 이 파일은 지금도 계속 늘어나고 있습니다. 처음부터 모든 규칙을 갖춘 것이 아니라, 실패를 쌓아 만든 구조입니다.

비개발자의 지시 파일도 같은 방식으로 성장합니다.

높이가 다르게 쌓인 동전 더미들 — 사진 5 · 쌓여 가는 동전. 처음에는 규칙이 5개도 안 되지만, 석 달이 지나면 40개가 넘습니다. Wikimedia Commons · CC0(저작자 표시 불필요)

AI가 한 일	지시 파일에 더하는 규칙
브랜드 톤을 벗어난 표현을 썼습니다	금지 표현 3개를 파일에 추가합니다
분량을 지키지 않았습니다	목표 분량 기준을 명시합니다
해시태그를 5개씩 달았습니다	"해시태그는 최대 3개" 규칙을 추가합니다
경쟁사 이름을 언급했습니다	"경쟁사명 직접 언급 금지" 규칙을 추가합니다

표 3 · 실수가 규칙이 되는 네 가지 예 — 제5장의 목록을 표로 옮긴 것

도해 3 · 두꺼워지는 지시 파일 — 제5장의 셈(5 → 20 → 40)을 그림으로 옮긴 것

처음에는 규칙이 5개도 안 됩니다. 한 달이 지나면 20개가 됩니다. 석 달이 지나면 40개가 넘습니다. 같은 AI를 쓰는데 석 달 전과 지금의 결과물 품질이 다르다면, 그것은 AI가 좋아진 것이 아닙니다. 지시 파일이 두꺼워진 것입니다.

이것이 챕터 2에서 설명한 하네스의 복리 효과의 실체입니다. 한 번의 실수가 영원히 반복되지 않는 규칙으로 바뀝니다. 오늘 추가한 규칙이 내일, 다음 달, 6개월 뒤에도 작동합니다.

같은 AI를 쓰는데 석 달 전과 지금의 결과물 품질이 다르다면, AI가 좋아진 것이 아닙니다. 지시 파일이 두꺼워진 것입니다.
제5장 · 저자

06SPLIT

하나의 만능 지시 파일이 낳는 '컨텍스트 오염'을 짚고, 필요한 지침을 필요한 때만 켜는 점진적 노출을 스킬과 업무별 프로젝트로 구현하는 법을 보입니다.

점진적 노출 — 스킬로 지시 파일을 분할하는 법

하나의 지시 파일로 모든 업무를 커버하려 하면 어떻게 되겠습니까. 랭체인(LangChain)의 비브(Viv)는 이것을 "컨텍스트 오염"이라고 표현했습니다. 인스타그램 캡션 작성 규칙과 투자 리서치 보고서 규칙이 같은 파일에 있다고 해 보겠습니다. 그러면 인스타그램 작업을 할 때도 리서치 규칙이 AI의 컨텍스트를 차지합니다.

해결책은 점진적 노출(progressive disclosure)입니다. 필요한 지침을 필요한 시점에만 활성화하는 것입니다. 랭체인의 스킬 개념이 이 원리를 구현합니다. 각 업무 유형에 맞는 지침을 별도 패키지로 저장해 두고, 해당 업무를 시작할 때만 그 패키지를 AI의 컨텍스트에 로드합니다.

비개발자 도구에서는 이렇게 구현됩니다. 클로드 코워크(Claude Cowork)의 스킬(Skills) 기능이 이 역할을 합니다. 지침·컨텍스트·도구를 하나의 패키지로 저장하고, 해당 업무를 시작할 때 호출합니다. 클로드 프로젝트(Claude Projects)에서도 같은 효과를 낼 수 있습니다. 업무 유형별로 별도 프로젝트를 만들고 각각에 다른 지시 파일을 적용하는 방식입니다.

크기가 다른 조절식 렌치 세 자루 — 사진 6 · 크기가 다른 렌치 세 자루. 한 자루로 모든 볼트를 죄려 하기보다, 일마다 맞는 것을 꺼내 씁니다. J.C. Fields, 2014 · Wikimedia Commons · CC BY-SA 3.0

도해 4 · 만능 파일과 업무별 파일 — 제6장의 구성 예를 그림으로 옮긴 것

실제로 적용하면 이런 구성이 됩니다. "인스타그램 캡션용" 프로젝트에는 SNS 톤과 해시태그 기준이 담긴 지시 파일을 둡니다. "고객 제안서용" 프로젝트에는 제안서 구조와 설득 언어 기준이 담긴 지시 파일을 둡니다. "리서치 보고서용" 프로젝트에는 출처 표기 방식과 요약 형식이 담긴 지시 파일을 둡니다. 각 업무를 시작할 때 해당 프로젝트를 열면 지시 파일이 자동으로 활성화됩니다.

하나의 만능 지시 파일보다, 업무 유형별로 분리된 지시 파일이 더 잘 작동합니다.

편집자 주

'랭체인의 비브(Viv)'는 원문에 이름만 나오고 직함이나 글의 제목은 없어 그대로 두었습니다. '컨텍스트 오염'과 '점진적 노출'은 원문의 용어입니다.

PART III

원칙과 실습PRINCIPLES AND WORKSHOP

07FIVE PRINCIPLES

지시 파일에 무엇을 담아야 하는지를 다섯 원칙으로 정리합니다. 역할을 구체적으로, 금지를 먼저, 형식을 수치로, 참고 자료는 직접, 실수는 규칙으로 — 예문과 함께 읽습니다.

비개발자 지시 파일 작성의 5가지 원칙

지시 파일에 무엇을 담아야 하는지를 다섯 가지 원칙으로 정리했습니다.

원칙 1. 역할을 구체적으로 정의합니다

"콘텐츠 마케터처럼 써 줘"는 모호합니다. "F&B 브랜드 전문 SNS 에디터로 일한다. 20~30대 여성을 타깃으로 하며, 따뜻하고 감각적인 톤을 유지한다"는 구체적입니다. 역할 정의는 이후 모든 출력의 기준이 됩니다. 역할 정의가 촘촘할수록 AI가 판단해야 하는 영역이 좁아집니다. AI가 스스로 결정하는 영역이 줄수록 결과의 일관성이 높아집니다.

원칙 2. 해야 할 것보다 하지 말아야 할 것을 먼저 정의합니다

"잘 써 줘"보다 "이 표현들은 절대 쓰지 마라: 혁신적, 프리미엄, 퀄리티, 럭셔리"가 더 강력합니다. 금지 목록은 즉시 효과가 납니다. AI가 쓸 수 없는 공간을 먼저 정의하면, 그 안에서 작동하는 AI의 행동이 좁아집니다. 실무에서는 "하지 마라" 목록이 "해라" 목록보다 효과가 빠르게 나타나는 경우가 많습니다.

원칙 3. 출력 형식을 구체적으로 지정합니다

길이, 구조, 포함해야 할 요소를 수치로 명시합니다. "짧게"가 아니라 "150자 이내"입니다. "해시태그 포함"이 아니라 "해시태그 3개, 브랜드 고유 태그 1개 필수 포함"입니다. 수치가 없으면 AI는 임의로 결정합니다. 형식을 명시할수록 수정 요청이 줄어드는 것을 빠르게 체감할 수 있습니다. 특히 "문단 수", "항목 수", "글자 수"를 명시하는 것이 효과가 큽니다.

공학용 계산기 — 사진 7 · 계산기. "짧게"가 아니라 "150자 이내" — 형식은 수치로 적어야 AI가 임의로 정하지 않습니다. Stefan-Xp · Wikimedia Commons · CC BY-SA 3.0

원칙 4. 참고 자료를 직접 포함하거나 위치를 명시합니다

브랜드 톤 가이드, 과거 잘 된 예시 문장, 경쟁사 참고 자료가 그것입니다. 이것들을 지시 파일에 직접 붙여 넣거나 "이 파일을 참조하라"고 경로를 적습니다. AI가 접근할 수 없는 자료는 없는 것과 같습니다. 특히 잘 된 결과물의 예시 문장 2~3개를 직접 넣어 두면 효과가 큽니다. AI는 추상적인 기준보다 구체적인 예시에서 패턴을 더 잘 학습합니다.

원칙 5. 실수가 발생할 때마다 규칙을 추가합니다

지시 파일은 완성된 문서가 아니라 살아 있는 문서입니다. AI가 실수할 때마다 규칙 한 줄을 추가합니다. 이것이 쌓이면 복리가 됩니다. 처음에는 10줄짜리 파일이 3개월 뒤에는 50줄짜리 방어막이 됩니다. 규칙을 추가할 때 "왜 이 규칙이 생겼는지"를 한 줄 주석으로 남겨 두면, 나중에 지시 파일을 수정할 때 맥락을 파악하기 쉽습니다.

원칙	모호한 지시	구체적인 지시
① 역할	"콘텐츠 마케터처럼 써 줘"	"F&B 브랜드 전문 SNS 에디터로 일한다. 20~30대 여성을 타깃으로 하며, 따뜻하고 감각적인 톤을 유지한다"
② 금지	"잘 써 줘"	"이 표현들은 절대 쓰지 마라: 혁신적, 프리미엄, 퀄리티, 럭셔리"
③ 형식	"짧게", "해시태그 포함"	"150자 이내", "해시태그 3개, 브랜드 고유 태그 1개 필수 포함"
④ 참고	(자료를 AI가 볼 수 없는 곳에 둠)	잘 된 예시 문장 2~3개를 직접 붙여 넣거나 "이 파일을 참조하라"고 경로를 적음
⑤ 실수 규칙	(처음 만든 그대로 둠)	실수마다 규칙 한 줄 추가 + "왜 생겼는지" 한 줄 주석. 10줄이 3개월 뒤 50줄로

표 4 · 다섯 원칙의 모호한 예와 구체적인 예 — 제7장의 예문을 나란히 놓은 것

AI가 스스로 결정하는 영역이 줄수록 결과의 일관성이 높아집니다.
제7장 · 저자

08WHY IT MATTERS

지시 파일 없이 AI를 쓰는 것은 매번 새 직원을 쓰는 것과 같다는 비유로, 설명과 수정에 쓰던 시간이 실제 업무로 돌아온다는 점을 말합니다.

왜 비개발자에게 중요한가

지시 파일 없이 AI를 쓰는 것은 매번 새 직원을 쓰는 것과 같습니다. 오늘 브랜드 톤을 설명했는데, 내일 새 대화를 열면 처음부터 다시 설명해야 합니다. 수정 요청을 반영했는데, 다음 프로젝트에서는 다시 나옵니다. 이 패턴이 반복되면 AI를 쓰는 시간보다 수정하는 시간이 더 길어집니다.

지시 파일을 갖춘 AI는 다릅니다. 처음 작동하는 순간부터 기준을 알고 있습니다. 설명에 쓰던 시간이 줄고, 수정에 쓰던 시간이 줄고, 그 시간이 실제 업무로 돌아옵니다.

이것은 도구를 바꾸는 것이 아닙니다. 도구가 작동하는 환경을 바꾸는 것입니다. 같은 클로드, 같은 챗GPT를 쓰면서도 결과가 달라집니다. 차이는 AI의 성능이 아니라 AI에게 무엇을 알려 줬는지에 있습니다.

말에 채운 마구의 세부 — 사진 8 · 말의 마구. 도구를 바꾸는 것이 아니라 도구가 작동하는 환경을 바꾸는 것 — 지시 파일은 하네스의 첫 부품입니다. Montanabw, 2017 · Wikimedia Commons · CC BY-SA 4.0

콘텐츠 제작자라면 브랜드별 지시 파일을 만들 수 있습니다. 1인 사업자라면 고객 응대, 제안서 작성, 리서치 보고서 각각에 지시 파일을 만들 수 있습니다. 교육자라면 수업 자료 작성, 학부모 메일, 평가 피드백 각각에 기준을 심을 수 있습니다. 업무 유형마다 하나씩입니다. 처음 한 번 만들면, 이후에는 그 기준이 자동으로 적용됩니다. AI에게 매번 "우리 브랜드는 이런 톤을 씁니다"라고 설명하는 일이 사라집니다. 그 시간이 실제 작업으로 돌아옵니다.

도해 5 · 업무 유형마다 하나씩 — 제8장이 든 세 직군의 지시 파일 구성

09WORKSHOP · 30 MIN

클로드 프로젝트를 바탕으로 지시 파일 하나를 실제로 만듭니다. 새 프로젝트 생성(3분), 초안 작성(15분), 테스트와 수정(10분)의 세 단계와 완성 기준, 클로드·챗GPT별 적용 팁이 이어집니다.

실습 — 나만의 AI 업무 매뉴얼 만들기(약 30분)

클로드 프로젝트(Claude Projects)를 기반으로 합니다. Claude.ai에 접속한 뒤 왼쪽 사이드바의 Projects 메뉴입니다. 챗GPT를 사용하는 경우도 같은 방식입니다. 설정(Settings) > 맞춤화(Customize ChatGPT), 또는 GPTs 빌더의 Instructions 입력란에 적용합니다.

준비물

Claude.ai 계정(무료 플랜 이상), 그리고 반복적으로 AI에게 맡기는 업무 한 가지입니다.

1단계. 새 프로젝트 생성(약 3분)

Claude.ai 왼쪽 사이드바에서 Projects → New Project를 선택합니다. 프로젝트 이름은 업무 유형으로 짓습니다. 예를 들어 "인스타그램 캡션", "고객 제안서", "주간 리포트"입니다. 하나의 프로젝트가 하나의 지시 파일입니다. 업무 유형이 섞이지 않게 합니다. 모든 업무를 하나의 프로젝트에 넣고 싶은 충동이 생기지만, 이는 "만능 파일의 함정"으로 이어집니다. 처음에는 가장 자주 쓰는 업무 하나로 시작합니다.

펼쳐 놓은 노트북 컴퓨터 — 사진 9 · 노트북. 실습에 필요한 것은 Claude.ai 계정과 반복해서 맡기는 업무 하나뿐입니다. Raimond Spekking · Wikimedia Commons · CC BY-SA 4.0

2단계. 지시 파일 초안 작성(약 15분)

Project Instructions 입력란에 아래 다섯 가지를 순서대로 채웁니다. 처음부터 완벽하게 채우려 하지 않아도 됩니다. 지금 당장 확실한 항목만 채우고, 나머지는 사용하면서 보완합니다.

# 역할
[구체적 역할 정의. 전문 분야, 타깃 독자, 톤]
예: "F&B 브랜드 SNS 에디터. 20~30대 여성 타깃. 따뜻하고 감각적인 어조."

# 형식
[출력물의 구조와 분량]
예: "본문 120~150자. 해시태그 3개(브랜드 고유 태그 1개 포함)."

# 금지
[절대 쓰지 말아야 할 표현이나 행동]
예: "금지 표현: 혁신적, 프리미엄, 최고급. 영어 표현 혼용 금지."

# 참고
[AI가 참조해야 할 자료나 기준]
예: "잘 된 예시: [예시 문장 1~2개 직접 붙여넣기]"

# 주의
[자주 발생하는 실수와 방지 규칙]
처음에는 비워도 됩니다. 실수가 생길 때마다 추가합니다.

지시 파일 견본 · 원문의 다섯 항목 틀을 그대로 옮긴 것. 대괄호 안은 채울 자리, '예:'는 원문의 예시

3단계. 테스트와 수정(약 10분)

지시 파일을 저장하고, 평소에 자주 하는 요청을 그대로 입력합니다. 결과를 확인합니다.

결과를 보니	이렇게 합니다
기대와 다른 부분이 있으면	지시 파일에서 해당 항목을 찾아 수정합니다. 없으면 항목을 추가합니다.
기대와 같다면	해당 결과를 "# 참고" 항목에 예시로 추가합니다.
지시 파일이 너무 길어져 AI가 혼란스러워 보이면	해당 업무와 직접 관련 없는 항목을 별도 프로젝트로 분리합니다.

표 5 · 3단계의 세 갈래 — 테스트 결과에 따라 지시 파일을 고치는 법

도해 6 · 실습의 세 단계와 완성 기준 — 제9장의 순서를 그림으로 옮긴 것

완성 기준 — 이 세 가지가 되면 실습은 끝입니다

AI가 역할에 맞는 톤으로 응답합니다.
지정한 형식(길이, 구조)을 지킵니다.
금지 표현이 출력에 나타나지 않습니다.

도구별 적용 — 원문의 두 가지 팁

클로드를 사용하는 경우 — Projects 기능은 무료 플랜에서도 사용할 수 있습니다. 단, 지시 파일 길이 제한이 있으므로 핵심 항목만 담고, 자세한 참고 자료는 대화 중에 별도로 첨부합니다.
챗GPT를 사용하는 경우 — 설정(Settings) > 맞춤화(Customize ChatGPT) 메뉴의 "ChatGPT가 어떻게 응답하기를 원하는가"(How would you like ChatGPT to respond?) 입력란에 같은 내용을 작성합니다. 특정 업무에 특화된 지시 파일이 필요하다면 My GPTs에서 새 GPT를 만들고 Instructions 항목에 입력합니다.

메뉴 이름과 무료 플랜 안내는 원문 서술 그대로이며, 서비스 화면은 바뀔 수 있습니다.

처음부터 완벽하게 채우려 하지 않아도 됩니다. 지금 당장 확실한 항목만 채우고, 나머지는 사용하면서 보완합니다.
제9장 · 저자

정리 체크리스트

지시 파일은 AI에게 주는 업무 매뉴얼입니다. AI는 알려 주지 않은 것은 모릅니다.
오픈AI 원칙 — 지도를 줘라, 1,000페이지 매뉴얼은 아니다. 핵심 규칙만 담고, 상세 자료는 링크나 첨부로 분리합니다.
하시모토 원칙 — 실수가 생길 때마다 규칙을 추가합니다. 지시 파일은 완성이 아니라 성장하는 문서입니다.
업무 유형마다 별도 지시 파일을 만듭니다. 하나의 만능 파일보다 여러 개의 전용 파일이 더 잘 작동합니다.
지시 파일의 5원칙 — ① 역할 정의 → ② 금지 사항 → ③ 출력 형식 → ④ 참고 자료 → ⑤ 실수 발생 시 규칙 추가.
지시 파일만으로는 AI의 행동을 완전히 통제할 수 없습니다. 다음 챕터에서는 AI의 행동 범위를 제한하는 '규칙 체크리스트'를 만듭니다.

토론 질문

여러분이 AI에게 매번 다시 설명하는 것은 무엇입니까? 그중 지시 파일의 다섯 항목(역할·형식·금지·참고·주의) 어디에 들어가겠습니까?
"하지 마라" 목록이 "해라" 목록보다 효과가 빠르다는 저자의 말에 동의하십니까? 여러분의 업무에서 첫 금지 표현 세 개는 무엇입니까?
하나의 만능 파일로 시작해 본 적이 있다면, 어떤 규칙이 다른 업무를 방해했습니까? 몇 개의 프로젝트로 나누는 것이 맞겠습니까?

READING RECORD – 모든 독자가 이 문서를 완독한 횟수

완독하셨습니까?

본문을 끝까지 읽으셨다면 아래 단추를 눌러 주십시오. 완독 1회가 서버에 기록되고, 이 기기에서 읽은 횟수도 함께 남습니다.

이 기기에서 0회

〔편집자 주〕

원문은 전자책 화면을 찍은 사진 여섯 장이며, 읽는 순서대로 다시 배열해 옮겼습니다. 둘째 화면(제1~3장)은 왼쪽 여백이 가려져 각 줄의 첫 글자가 보이지 않아 문맥으로 되살렸습니다(예: '한쪽은', '표현이', '다른 쪽은', '완성된다', '정해주지', '구체적인', '개발자들은', '코드베이스', '빌드', '코딩', '프로젝트', '과거').
원문의 서술체를 저자가 독자께 말씀드리는 시점으로 옮겼습니다. 이 챕터는 책의 2부에 속하며, 2부의 제목은 원문 화면에 없어 챕터 3의 설명("각 요소를 하나씩 설계하는 법")을 표지 정보란에 적었습니다.
외래어 표기 — OpenAI는 오픈AI, Hashimoto는 하시모토, Ghostty는 고스티, LangChain은 랭체인, Viv는 비브, Claude Cowork는 클로드 코워크, Claude Projects는 클로드 프로젝트, Skills는 스킬로 적었습니다. AGENTS.md, Claude.ai, Projects, Project Instructions, GPTs, Instructions처럼 화면의 메뉴·파일 이름은 그대로 두었습니다. '타겟'은 국립국어원 표기에 따라 '타깃'으로 적었습니다.
원문의 두 표(개발자·비개발자가 담는 것, 실수→규칙 목록)는 표 2·표 3으로, '🔄 비개발자 번역' 상자는 제4장의 개념 박스로, '💡' 팁 두 개는 제9장의 개념 박스로 옮겼습니다. 3단계의 '→' 세 줄은 표 5로 정리했습니다.
실습의 지시 파일 견본은 원문의 다섯 항목과 예문을 그대로 두었습니다.
수치 표기 — 150자, 해시태그 3개, 약 100줄, 1,000페이지, 5개·20개·40개, 10줄·50줄, 3분·15분·10분은 원문 그대로입니다.
사진은 모두 위키미디어 공용에서 라이선스를 확인한 파일이며, 원문에는 사진이 없습니다.

사진 출처표

번호	위치	대상	파일명 (Wikimedia Commons)	저작자 · 라이선스
표지	표지	책상 위 노트북	Laptop on a desk.jpg	CC0
사진 1	제1장	주사위	Dice.jpg	Gaz, 2004 · CC BY-SA 3.0
사진 2	제2장	다이얼식 전화기	Old telephone (5983560279).jpg	Berit Watkin · CC BY 2.0
사진 3	제3장	서버 랙	Servers in a Rack.jpg	Abigor · CC BY-SA 3.0
사진 4	제4장	복사 용지 더미	15 reams of paper stacked on the floor.jpg	Sage Ross (WMF), 2013 · CC BY-SA 3.0
사진 5	제5장	동전 더미	Stacks of Coins.jpg	CC0
사진 6	제6장	조절식 렌치 세 자루	Western Forge adjustable wrenches.jpg	J.C. Fields, 2014 · CC BY-SA 3.0
사진 7	제7장	공학용 계산기	Casio fx-991ES Calculator New.jpg	Stefan-Xp · CC BY-SA 3.0
사진 8	제8장	말의 마구 세부	Harness detail Arabian horse.jpg	Montanabw, 2017 · CC BY-SA 4.0
사진 9	제9장	노트북	Lenovo G500s laptop-2905.jpg	Raimond Spekking · CC BY-SA 4.0

『AI 하네스』 2부 챕터 4를 잡지형 교과서로 재구성한 문서입니다. 본문 리디바탕 15pt, 제목 Noto Serif KR, 숫자 Playfair Display, 라벨 JetBrains Mono. 도해 6점은 편집자가 그렸고, 사진 9점은 위키미디어 공용의 자유 이용 허락 파일입니다. 2026년 9월 14일.

글자 100% 줄 100% 서체