교육 영상 · 셀프 재생Learning video · self-running

RULE No.8

기억 설계 II · 지식을 구조화하면 Claude가 전문가가 된다 · 시작을 누르면 음성과 함께 슬라이드가 자동 재생됩니다. Memory Design II · structure knowledge and Claude becomes an expert · Press start and slides advance with narration.

1·2 언어 전환 · ← → 수동 이동 · Space 재생/정지1·2 language · ← → navigate · Space play/pause
기억 설계 II · No.8
01 / 14 목차Index
  이동 · F 전체화면 · RULE №8 · STRUCTURE KNOWLEDGE   navigate · F fullscreen · RULE №8 · STRUCTURE KNOWLEDGE [email protected]
일시정지Paused
0 / 0
Home
교육 세션 · 지식을 구조화하라Learning session · structure your knowledge

RULE No.8

지식을 구조화하면
Claude가 전문가가 된다.
Structure knowledge,
and Claude becomes an expert.

사규를 한 장에 다 적어 주면 — 박학한 신입. 직무기술서·업무 절차서·업무 문서로 나눠 주면 — 그 분야 전문가. 이 강을 마치면, 한 덩어리 메모를 역할·절차·업무 문서 세 그릇으로 나눠 반복 업무 전문가 Claude를 만들 수 있습니다. Hand over the whole rulebook on one page — a well-read rookie. Split it into role specs, procedures, and business docs — a domain expert. After this session, you can split a one-pile memo into three vessels — role, procedure, and business docs — to build a repeat-task expert Claude.

As of 2026-06 · 디렉터리·파일명·명령은 바뀝니다 — ‘지식을 구조로 나눠 전문성을 만든다’는 원리는 남습니다. [추론]As of 2026-06 · directories, filenames, and commands change — but the principle, ‘split knowledge into structure to build expertise,’ stays. [inference]

구조 · STRUCTURESTRUCTURE
1막 — 박학한 신입Act 1 — The well-read rookie

CLAUDE.md에 다 적었는데, 왜 아직 ‘전문가’가 아닐까?You wrote it all in CLAUDE.md — so why isn't it an ‘expert’ yet?

# CLAUDE.md
보고 형식 · 용어 정의
+ 월별 마감 절차
+ 데이터 출처 규칙
+ 경영진 보고 주의사항 …
// ← 한 덩어리로 계속 길어지는 메모
# CLAUDE.md
report format · term definitions
+ monthly close procedure
+ data source rules
+ executive report notes …
// ← one heap, growing longer and longer

분명 빠뜨린 건 없는데, ‘모든 걸 조금씩 아는 신입’처럼 느껴집니다. 문제는 ‘적었느냐’가 아니라 ‘어떻게 구조화했느냐’.Nothing's missing, yet it feels like ‘a rookie who knows a bit of everything.’ The problem isn't ‘did you write it’ — it's ‘how did you structure it’.

[추론] s07 콜백 — 적어두기는 휘발을 막았지만, 한 덩어리로 쌓으면 깊이가 안 생긴다. 지식의 양이 아니라 형태가 전문성을 정한다. → 오늘은 ‘쌓기’에서 ‘구조화’로.[inference] s07 callback — writing it down stopped the evaporation, but piling it in one heap gives no depth. It's not the amount of knowledge but its shape that decides expertise. → Today: from ‘piling’ to ‘structuring.’

1막 — 한 덩어리의 한계Act 1 — Limits of one big pile

지식을 ‘한 더미’로 쌓으면, 세 가지를 잃는다.Pile knowledge into one heap and you lose three things.

① 관점 흐려짐① Lens goes foggy

리뷰어·작성자·보안 점검자가 한 파일에 섞여 어느 관점도 또렷하지 않다.Reviewer, writer, security checker all mixed in one file — no lens is sharp.

② 항상 다 짊어짐② Carried whole

한 덩어리는 매 세션 통째로 컨텍스트를 먹는다 — 지금 안 쓰는 지식까지.One heap eats the whole context every session — even what you aren't using.

③ 재사용 안 됨③ No reuse

반복 ‘절차’도 매번 풀어 설명해야 한다 — 묶어둔 단위가 없다.Even a repeated ‘procedure’ must be spelled out each time — no bundled unit.

[추론] s02·s07 콜백 — 한 덩어리 메모는 휘발은 막지만, 관점이 섞이고·항상 통째로 로드되고·절차 단위가 없다. → 평면 더미를 역할·절차·업무 근거 문서로 나눈다.[inference] s02·s07 callback — a one-heap memo stops evaporation, but lenses mix, it always loads whole, and there's no procedure unit. → Split the flat heap into roles, procedures, and work-doc context.

2막 — 지식을 담는 세 그릇Act 2 — Three vessels for knowledge

구조화 = 지식을 세 그릇에 나눠 담는 것.Structuring = sorting knowledge into three vessels.

CLAUDE.md
한 덩어리다 쌓아둔 메모
CLAUDE.md
one heapeverything piled in
역할 — 에이전트Role — agents
.claude/agents/ · 관점·페르소나· lens·persona
절차 — 스킬Procedure — skills
.claude/skills/ · 재사용 가능한 작업 묶음· a reusable bundle of work
업무 근거 문서Work-doc truth
업무 메모·정책 문서 · 우리 매장·회사 고유의 사실work memos·policy docs · facts unique to our store/company

[출처: code.anthropic.com/docs/en/sub-agents] · [출처: code.anthropic.com/docs/en/skills] Claude Code는 서브에이전트(역할·도구·프롬프트)와 스킬(재사용 가능한 절차 묶음)을 파일로 정의한다. 정확한 디렉터리·형식·명칭은 발표 시점 공식 문서가 진실(2026-06 기준). → 지식은 쌓지 말고 그릇에 나눠 담는다.[source: code.anthropic.com/docs/en/sub-agents] · [source: code.anthropic.com/docs/en/skills] Claude Code defines subagents (role·tools·prompt) and skills (reusable procedure bundles) as files. Exact directories, formats, and names are whatever the official docs say at presentation time (as of 2026-06). → Don't pile knowledge — sort it into vessels.

2막 — 더미 vs 구조 ① 역할Act 2 — Pile vs structure ① roles

한 명에게 다 시키지 말고, 역할별 전문가를 두라.Don't make one do it all — define a specialist per role.

Before / 한 덩어리Before / one heap
만능 프롬프트 하나가 “매출 분석도 하고, 재고 파악도 하고, 경영진 보고도 쓰고, 이상 탐지도 하고 …”One all-purpose prompt that “analyzes sales, checks inventory, writes the executive report, flags anomalies …”
→ 관점이 섞여 평균값으로 흐려진다→ lenses mix, fogging toward an average
After / 역할별 에이전트After / agent per role
.claude/agents/sales-analyst(트렌드·수치 집중) · report-writer(경영진 친화·구조적)In .claude/agents/: sales-analyst (trend·numbers focused) · report-writer (exec-friendly·structured)
→ 일에 맞는 전문가를 호출 (이름은 예시)→ summon the specialist that fits (names are examples)

[추론] 한 프롬프트에 역할을 다 섞으면 관점이 평균값으로 흐려진다(s06 분포 콜백 — 여러 의도=넓은 분포). 에이전트 파일은 역할별로 분포를 좁혀 ‘전문가 관점’을 고정. → 관점이 중요하면 역할로 나눈다.[inference] Mix all roles in one prompt and the lens fogs toward an average (s06 distribution callback — many intentions = wide distribution). An agent file narrows the distribution per role, locking in the expert's lens. → When perspective matters, split by role.

2막 — 더미 vs 구조 ② 절차Act 2 — Pile vs structure ② procedures

반복 ‘절차’를 매번 풀어 말하지 말고, 스킬로 묶어라.Don't spell out a repeated procedure each time — pack it into a skill.

Before / 매번 절차 낭독Before / reciting steps
”월 마감 보고할 때: 매출 피벗 만들고, 전월 대비 계산하고, 이상 항목 표시하고, 요약 작성하고 …””For the monthly close: build the sales pivot, calculate MoM change, flag anomalies, write the summary …”
→ 세션마다 처음부터 다시→ again, from scratch, every session
After / 스킬로 묶음After / packed into a skill
.claude/skills/monthly-close — 이름·언제 쓰는지·단계가 한 곳에In .claude/skills/: monthly-close — name·when to use·steps in one place
→ 다음부턴 “마감 보고 스킬 써줘” 한 줄→ from then on, one line: “use the monthly-close skill”

[출처: code.anthropic.com/docs/en/skills] 스킬은 모델이 특정 작업에 필요할 때 불러 쓰는 재사용 가능한 지침·절차 묶음이다. 정확한 형식·발동 방식은 발표 시점 공식 문서가 진실(2026-06 기준). → 반복되는 ‘절차’는 스킬로 한 번만 묶는다.[source: code.anthropic.com/docs/en/skills] A skill is a reusable bundle of instructions the model pulls in when a task needs it. Exact format and how it triggers are whatever the official docs say at presentation time (as of 2026-06). → A repeated ‘procedure’ gets packed into a skill, once.

2막 — 무엇을 어디에Act 2 — What goes where

지식의 ‘종류’가, 둘 ‘그릇’을 정한다.The kind of knowledge decides which vessel it goes in.

종류Kind 그릇Vessel Example
전역 규칙·컨벤션Global rules·conventions CLAUDE.md “한국어로 답·들여쓰기 2칸”“answer in Korean·2-space indent”
역할·관점Role·lens 에이전트 파일agent file ”꼼꼼한 매출 분석가””the thorough sales analyst”
반복 절차Repeated procedure 스킬 파일skill file ”재고 마감·주간 보고 루틴””inventory close·weekly report routine”
우리 회사·매장 고유 사실Company/store-specific fact 업무 메모·정책 문서work memo·policy doc ”왜 이 카테고리만 마진율 기준이 다른가””why this category has a different margin standard”

종류가 그릇을 정한다 — 다 CLAUDE.md에 넣지 마라.The kind decides the vessel — don't stuff it all in CLAUDE.md.

[추론] s07 콜백 — s07이 ‘대화창 vs 파일’(위치)이었다면, s08은 ‘어느 파일·어느 그릇’(구조). 모든 걸 CLAUDE.md에 욱여넣으면 다시 한 덩어리. → 종류별로 그릇을 고른다.[inference] s07 callback — if s07 was ‘the chat box vs a file’ (location), s08 is ‘which file, which vessel’ (structure). Stuff it all into CLAUDE.md and it's one heap again. → Pick a vessel by kind.

3막 — 왜 구조가 전문성인가Act 3 — Why structure makes expertise

구조는 셋을 동시에 한다 — 관점 고정·절차 재사용·맥락 정확.Structure does three things at once — fix the lens, reuse the steps, ground the context.

세 그릇역할·절차·업무 근거 문서Three vesselsrole·procedure·work-doc truth
역할 → 관점 고정Role → fix the lens
한 관점으로만 보게 해 분포를 전문가 영역으로 좁힘see through one lens only; narrows the distribution to the expert zone
절차 → 재사용Procedure → reuse
필요할 때만 불러와 매번 설명·재학습 안 함 (컨텍스트 절약)pulled in only when needed; no re-explaining (context saved)
업무 근거 문서 → 정확Work-doc truth → accuracy
우리 회사·매장의 사실을 추측 대신 근거로 (추측 ↓)our company/store facts as grounds, not guesses (fewer guesses)

[추론] s02·s03·s06 콜백 — 역할은 분포를 좁히고(전문 관점), 스킬은 절차를 재사용하며(컨텍스트 절약), 업무 문서는 추측 대신 사실을 준다(추측↓). 셋이 합쳐 ‘박학한 신입’을 ‘전문가’로 바꾼다. → 구조는 깊이를 만든다.[inference] s02·s03·s06 callback — role narrows the distribution (expert lens), the skill reuses procedure (context saved), the work docs give facts not guesses (fewer guesses). Together they turn the well-read rookie into an expert. → Structure makes the depth.

3막 — 지식이 연결되는 모양Act 3 — How knowledge connects

CLAUDE.md는 창고가 아니라 색인이다 — 필요한 그릇을 가리키기만 한다.CLAUDE.md isn’t a warehouse — it’s an index that points to the right vessel.

CLAUDE.md
색인·입구어디에 뭐가 있는지 가리킴
창고가 아님
CLAUDE.md
index·entrypoints to where things are
not a warehouse
에이전트agents
역할·페르소나 — 필요할 때만 꺼낸다role·persona — pull out only when needed
스킬skills
반복 절차 — 이름만 부르면 불러온다repeated procedure — call by name to load
업무 문서work docs
회사·매장 고유 사실 — 추측 대신 근거company/store facts — grounds, not guesses

[추론] s02 콜백 — 한 덩어리는 매번 통째로 로드된다. 그러나 색인(CLAUDE.md)이 각 그릇을 가리키면, 필요한 것만 꺼내 쓸 수 있어 컨텍스트를 아낀다. 구조화의 숨은 이득 = 컨텍스트 절약. → CLAUDE.md는 가볍게 색인으로, 깊이는 각 그릇에.[inference] s02 callback — one heap loads whole every time. But an index (CLAUDE.md) that points to each vessel lets you pull only what’s needed, saving context. Structuring’s hidden payoff = context saved. → Keep CLAUDE.md light as an index; put depth in each vessel.

3막 → 4막 다리 · 핵심 분기Bridge to Act 4 · the core fork

반복·안정·공유면 ‘파일’로,
일회·즉흥·실험이면 ‘프롬프트’로.
Repeated, stable, shared → file.
One-off, ad-hoc, experimental → prompt.

여러 번 쓴다 ↔ 이번만 쓴다used many times ↔ used just this once 안정적이다 ↔ 자주 바뀐다it's stable ↔ it changes often 팀·미래의 나와 공유 ↔ 아직 실험 중shared with team·future-me ↔ still experimenting

구조화의 비용이 회수되는 건 ‘반복될 때’뿐 — 한 번 쓸 건 그냥 말로.The cost of structuring pays off only ‘when it repeats’ — say a one-off out loud.

[추론] s07 콜백·확장 — s07이 ‘대화창 vs 파일’이었다면 s08은 ‘프롬프트 vs 구조화 파일’. 구조를 만드는 데도 비용이 든다 → 반복·안정·공유될 때만 파일로 승격. 일회성을 구조화하면 과설계. → 다음: 무엇을 구조화할지 체크.[inference] s07 callback·extension — if s07 was ‘chat box vs file,’ s08 is ‘prompt vs structured file.’ Building structure costs too → promote to a file only when repeated·stable·shared. Structure a one-off and it's over-engineering. → Next: checks for what to structure.

4막 — 전문가로 만들기 전 5점검Act 4 — Five checks to make an expert

이 5가지로, 박학한 신입을 분야 전문가로 바꾼다.These five turn a well-read rookie into a domain expert.

  1. 1
    역할이 섞였나?Are roles mixed? → 관점이 여럿이면 에이전트로 분리 (역할 1개당 파일 1개)→ many lenses → split into agents (one file per role)
  2. 2
    절차가 반복되나?Does a procedure repeat? → 다단계 작업은 스킬로 묶기 (이름·언제·단계)→ pack multi-step work into a skill (name·when·steps)
  3. 3
    업무의 ‘왜’가 적혔나?Is the work ‘why’ written down? → 고유 사실·결정 이유를 업무 메모·정책 문서에 (추측 막기)→ unique facts·decisions in work memos·policy docs (block guessing)
  4. 4
    파일인가 프롬프트인가?File or prompt? → 반복·안정·공유=파일, 일회·실험=프롬프트 (과설계 금지)→ repeated·stable·shared = file, one-off·experimental = prompt (no over-engineering)
  5. 5
    입구가 가리키나?Does the entry point? → CLAUDE.md가 색인처럼 어디에 뭐가 있는지 가리키나→ does CLAUDE.md point, like an index, to where things are

[추론] 5항목은 각각 슬라이드 03~10의 원리와 1:1 대응(역할=S05/08, 절차=S06/08, 업무 문서=S07/08, 파일vs프롬프트=S10, 그래프 입구=S09). → 원리를 알면 체크리스트가 외워진다.[inference] The five map one-to-one onto the principles of slides 03–10 (role=S05/08, procedure=S06/08, work-doc=S07/08, file vs prompt=S10, graph entry=S09). → Know the principles and the checklist memorizes itself.

4막 — 구조를 키우는 법Act 4 — Growing the structure

처음부터 다 나누지 말고, 반복이 보일 때 그릇을 만든다.Don't split everything upfront — make a vessel when repetition appears.

> /agents

역할이 두 번째 반복될 때 ✓
그때 에이전트로 승격
// 처음엔 CLAUDE.md 하나로 충분
> /agents

when a role repeats a 2nd time ✓
promote it to an agent then
// at first, one CLAUDE.md is plenty
짧고 단일 책임 — 에이전트=한 역할, 스킬=한 절차short, single-responsibility — agent = one role, skill = one procedure 안 쓰는 그릇은 지운다 — 구조도 정리 대상delete vessels you don't use — structure is also for tidying

[출처: code.anthropic.com/docs/en/sub-agents] Claude Code는 서브에이전트·스킬을 명령·도구로 생성·관리할 수 있다. 정확한 명령·생성 흐름은 발표 시점 공식 문서가 진실(2026-06 기준). → 구조는 한 번에 짜는 게 아니라 반복을 보고 키운다.[source: code.anthropic.com/docs/en/sub-agents] Claude Code can create and manage subagents·skills via commands·tools. Exact commands and creation flow are whatever the official docs say at presentation time (as of 2026-06). → Structure isn't built in one shot — grow it as repetition shows.

4막 — 한 줄로 굳히기Act 4 — Lock it into one line

그래서 — 반복되는 지식은, 종류대로 그릇에 담아라.So — sort repeated knowledge into vessels by kind.

전문가 Claude = [역할은 에이전트] + [절차는 스킬] + [업무 근거는 업무 문서] + [입구는 CLAUDE.md]
  → 단, 반복·안정·공유될 때만
Expert Claude = [roles in agents] + [procedures in skills] + [work grounds in work docs] + [entry in CLAUDE.md]
  → but only when repeated·stable·shared

[추론] Rule No.7(매번 설명하지 마라)과 Rule No.8(구조화하라)의 교차점 — 적어두기에서 ‘구조 있게 적어두기’로. 단, 일회성은 그냥 프롬프트(과설계 금지). → 알면, 무엇을 어느 그릇에 담을지 보인다.[inference] Where Rule No.7 (don't re-explain) meets Rule No.8 (structure it) — from writing it down to writing it down with structure. But a one-off stays a prompt (no over-engineering). → Once you know it, you see what goes in which vessel.

닫으며 — 지식을 구조화하라Closing — structure your knowledge

지식에 구조를 주면,
도구가 전문가가 된다.
Give knowledge a structure,
and the tool becomes an expert.

한 단어로: 쌓기 → 구조화. (박학한 신입 → 분야 전문가)In one word: piling → structuring. (well-read rookie → domain expert)

다음 강 예고 — 프로젝트 설계법, 시작하기 전에 설계한다.Next up — Project Design, design before you start.

RULE No.8

As of 2026-06 · 디렉터리·파일 형식은 바뀌어도 ‘지식을 종류대로 구조화하면 전문성이 생긴다’는 원리는 남습니다. [추론]As of 2026-06 · directories and file formats change, but the principle — structure knowledge by kind and expertise emerges — stays. [inference]

강의 노트Lecture notes

8강 · 기억 설계 IILesson 8 · Memory Design II

Rule No.8 — 지식을 구조화하면 Claude가 전문가가 된다Rule No.8 — Structure knowledge, and Claude becomes an expert

강의 요약Summary

새 직원이 들어왔을 때, 회사 규칙을 종이 한 장에 빼곡히 적어서 건네주면 그 사람은 "모든 걸 조금씩 아는 박학한 신입"이 됩니다. 그런데 같은 지식을 직무기술서, 업무 절차서, 업무 정책 문서로 나눠서 주면 어느새 "그 분야 전문가"처럼 일하기 시작합니다. 지식의 양은 같지만 형태가 달라진 겁니다. Claude도 똑같습니다. 7강에서 우리는 반복 설명을 파일로 옮겨 휘발을 막았습니다. 이번 강은 거기서 한 발 더 나아가, 그 지식을 어떻게 나눠 담느냐의 문제를 다룹니다.When a new hire starts, hand them the company rules crammed onto a single page and they become "a well-read rookie who knows a little about everything." Give them the same knowledge split into a role spec, a procedures manual, and work policy documents, and they begin working like "a domain expert." Same amount of knowledge, different shape. Claude is no different. In Lesson 7 we moved repeated explanations into a file to stop the evaporation. This lesson takes one step further: how you split that knowledge into the right vessels.

많은 분들이 CLAUDE.md 한 파일에 보고 형식, 업무 용어, 월별 마감 절차, 데이터 출처 규칙을 전부 쌓아 둡니다. 스크롤이 길어지는데, 정작 Claude는 그 분야 전문가가 아니라 "똑똑한 신입"처럼 느껴지죠. 문제는 적었느냐가 아니라 어떻게 구조화했느냐입니다. 지식의 양이 아니라 형태가 전문성을 정합니다. 이 강에서는 그 한 더미를 세 개의 그릇으로 나누는 법을 다룹니다. 역할(에이전트), 절차(스킬), 업무 근거 문서 — 이 세 그릇입니다.Many people pile report formats, business terms, monthly close procedures, and data source rules all into one CLAUDE.md. The scroll keeps growing, but Claude still feels like "a smart rookie" rather than a domain expert. The problem isn't whether you wrote it down — it's how you structured it. It's not the amount of knowledge that makes expertise; it's the shape. This lesson covers how to split that one heap into three vessels: role (agent), procedure (skill), and work-doc truth.

한 더미로 쌓으면 세 가지를 잃습니다. 관점이 흐려지고, 매 세션 전부를 짊어지며, 반복되는 절차도 매번 처음부터 설명해야 합니다. 세 그릇으로 나누면 정반대가 됩니다. 역할은 관점을 고정하고, 스킬은 컨텍스트를 아끼며, 업무 문서는 추측 대신 사실을 줍니다. 단, 구조를 만드는 데도 비용이 들기 때문에 반복되고 안정적이고 공유할 내용에만 파일을 만드세요. 한 번 쓰고 끝날 일은 그냥 프롬프트로 두는 것이 과설계를 피하는 길입니다.Pile it into one heap and you lose three things: the lens goes foggy, you carry everything every session, and repeated procedures still need spelling out every time. Split into three vessels and the reverse happens: role fixes the lens, skills save context, and work docs give facts instead of guesses. That said, structure costs something too — so only build files for what repeats, stays stable, and gets shared. Leaving one-off things as prompts is how you avoid over-engineering.

중요한 한 가지 — CLAUDE.md는 창고가 아니라 색인입니다. 역할이 필요하면 에이전트를, 절차가 필요하면 스킬을, 회사 고유 사실이 필요하면 업무 문서를 가리키는 역할만 맡기세요. 처음부터 완벽한 구조를 짜려 하지 말고, 같은 역할이나 절차가 두 번째 반복되는 게 보일 때 그릇으로 승격하세요. 구조도 살아 있는 문서처럼, 반복이 보일 때마다 조금씩 키워 가는 겁니다.One key point: CLAUDE.md is not a warehouse — it's an index. Let it point to agents when a role is needed, to skills when a procedure is needed, to work docs when a company-specific fact is needed. Don't try to build the perfect structure upfront. Promote something to a vessel the second time you see the same role or procedure repeat. Grow the structure like a living document — a little more each time repetition appears.

핵심 개념 5가지Five key concepts

  1. 01

    세 그릇 — 역할(에이전트)·절차(스킬)·업무 근거 문서Three vessels — role (agent), procedure (skill), work-doc truth

    한 더미였던 지식을 세 종류로 나눠 담으면 전문성이 생깁니다. 첫째, 역할은 에이전트 파일에 둡니다. "꼼꼼한 매출 분석가"나 "경영진 친화 보고자"처럼 관점과 페르소나를 한 파일에 고정하면, 그 파일을 부를 때마다 동일한 렌즈로만 봅니다. 입력이 출력의 분포를 정한다는 7강 원리 — 한 관점으로 좁히면 분포가 전문가 영역으로 좁혀집니다. 둘째, 절차는 스킬 파일에 둡니다. "월 마감 보고"처럼 반복되는 다단계 작업을 한 번 묶어 두면, 다음부터 한 줄로 불러쓸 수 있습니다. 셋째, 우리 매장이나 회사에만 있는 고유한 사실 — 왜 이 카테고리만 마진율 기준이 다른지 — 은 업무 메모나 정책 문서에 둡니다. Claude가 빈칸을 추측으로 메우는 대신 근거를 보고 답하게 됩니다.Split the one heap into three kinds and expertise emerges. First, roles go in agent files. Fix a lens like "the thorough sales analyst" or "the exec-friendly report writer" into one file, and every time you summon that file it sees through that single lens — narrowing the output distribution to the expert zone, exactly as Lesson 7's distribution principle predicts. Second, procedures go in skill files. Bundle a repeated multi-step task like "monthly close report" once, and from then on you call it in one line. Third, facts unique to your store or company — why this particular category has a different margin standard — go in work memos or policy documents, so Claude answers from grounds rather than filling gaps by guessing.

  2. 02

    CLAUDE.md 입구 — 창고가 아니라 색인CLAUDE.md as the entry point — index, not warehouse

    많은 분들이 역할도, 절차도, 업무 사실도 전부 CLAUDE.md 한 파일에 욱여넣습니다. 그러면 다시 한 더미가 됩니다. CLAUDE.md는 모든 걸 담는 창고가 아니라, 어디에 뭐가 있는지 가리키는 색인이어야 합니다. "역할은 에이전트 파일에, 월 마감 절차는 스킬에, 마진율 기준은 정책 문서에" — 이렇게 가리키기만 하면, Claude는 그 세션에 필요한 그릇만 꺼내 씁니다. 한 덩어리는 매 세션 통째로 컨텍스트를 먹지만, 색인이 각 그릇을 가리키면 필요한 것만 꺼내 쓸 수 있어 Rule No.2 "컨텍스트를 지켜라"와 곧장 이어집니다. CLAUDE.md는 가볍게, 깊이는 각 그릇에 두세요.Many people stuff roles, procedures, and work facts all into one CLAUDE.md — which turns it right back into one heap. CLAUDE.md should be an index that points to where things are, not a warehouse that holds everything. "Roles are in the agent file, the monthly-close procedure is in the skill, the margin standard is in the policy doc" — just point, and Claude pulls only the vessel needed for that session. One heap loads the entire context every session; an index pointing to vessels loads only what's needed, which ties directly to Rule No.2, protect the context. Keep CLAUDE.md light; put the depth in each vessel.

  3. 03

    파일인가 프롬프트인가 — 과설계의 함정File or prompt — the over-engineering trap

    모든 걸 파일로 만들어야 할까요. 아닙니다. 구조를 만드는 데도 비용이 들기 때문입니다 — 파일을 만들고, 유지하고, 관리해야 합니다. 그 비용이 회수되는 건 오직 반복될 때뿐입니다. 세 가지 기준을 보세요. 여러 번 쓸 거냐, 안정적이냐, 팀이나 미래의 나와 공유할 거냐. 이 세 가지를 통과하면 파일로 만드세요. 반대로 이번 한 번만 쓰고, 자주 바뀌고, 아직 실험 중이면 그냥 프롬프트로 두세요. 지난 강에서 지식의 위치가 비용을 정한다고 했다면, 오늘은 지식의 형태도 비용입니다. 한 번 쓸 걸 굳이 파일로 구조화하면 과설계입니다.Should you turn everything into a file? No — structure costs something too. You have to create the file, maintain it, manage it. That cost pays back only when it repeats. Check three things: will you use it many times, is it stable, will you share it with the team or future-you? Pass all three and make a file. Otherwise — one-off, changes often, still experimental — just leave it as a prompt. If Lesson 7 said the location of knowledge sets the cost, today says the shape of knowledge is a cost too. Structure a one-off into a file for no reason, and that's over-engineering.

  4. 04

    왜 구조가 전문성을 만드나 — 3원리Why structure makes expertise — three principles

    세 그릇이 각각 하나씩의 원리로 전문성을 만듭니다. 역할은 분포를 좁힙니다 — 에이전트가 한 관점으로만 보게 하니 출력이 전문가 영역으로 수렴합니다. 스킬은 컨텍스트를 아낍니다 — 절차를 필요할 때만 불러오니 매번 설명하거나 다시 로드할 필요가 없습니다. 업무 문서는 추측을 없앱니다 — 우리 회사만의 사실을 적어두면 Claude가 빈칸을 그럴듯하게 메우는 경향(1강의 할루시네이션)이 줄어듭니다. 이 셋이 합쳐져 박학한 신입을 분야 전문가로 바꿉니다. 구조가 깊이를 만드는 겁니다.Each of the three vessels makes expertise through its own principle. Role narrows the distribution — an agent constrained to one lens converges output to the expert zone. Skill saves context — pulling a procedure only when needed means no re-explaining, no re-loading. Work doc eliminates guessing — writing your company's unique facts down reduces the tendency to fill blanks with plausible-sounding answers (the hallucination from Lesson 1). Together these three turn the well-read rookie into a domain expert. Structure is what makes the depth.

  5. 05

    작게 시작해 키운다 — 두 번째 반복이 보일 때 승격Start small, grow it — promote when you see the second repeat

    처음부터 완벽한 구조를 설계하려 하지 마세요. 처음엔 CLAUDE.md 하나로 충분합니다. 같은 역할이나 같은 절차가 두 번째로 반복되는 게 보일 때, 그때 그릇으로 승격하세요. 그릇은 두 가지 원칙만 지키면 됩니다. 짧고 단일 책임으로 — 에이전트는 한 역할만, 스킬은 한 절차만 담습니다. 안 쓰는 그릇은 지웁니다 — 구조도 정리 대상입니다. 한 번에 완벽하게 짜려 하지 말고, 반복이 보일 때마다 조금씩 키우세요. 메모리를 살아 있는 문서처럼 키우던 것처럼, 구조도 살아 있는 그래프로 가꾸는 겁니다.Don't try to design the perfect structure from day one. One CLAUDE.md is enough at first. When you see the same role or the same procedure repeat a second time — that's when you promote it to a vessel. Keep just two rules for vessels: short and single-responsibility — an agent holds one role, a skill holds one procedure. Delete vessels you don't use — structure is for tidying too. Don't try to build it perfectly in one shot; grow it each time repetition shows up. Just as you grew memory like a living document, grow structure like a living graph.

실습 예제 — 코드 없이 구조 만들기Exercise — build structure without code

같은 매출 데이터를 두 가지 관점으로 요청해 출력 차이를 확인하고, 반복 절차를 한 번 정의해 한 줄로 재호출하는 연습입니다. 코드도, 설정 파일도 필요 없습니다 — 아래 지시문을 Claude 대화창에 그대로 붙여 넣어 시작하세요. 리테일 실무자가 매달 반복하는 두 가지 — 관점이 다른 분석 요청과 월 마감 보고 절차 — 를 소재로 합니다.Practice requesting the same sales data from two different lenses to see the output difference, then defining a repeated procedure once and calling it back in a single line. No code, no config files — paste the instructions below straight into a Claude chat to start. The subject is two things retail practitioners repeat every month: analysis requests with different lenses, and the monthly close report procedure.

실습 ① — 두 페르소나 비교 (Claude 대화창에 붙여넣기)Exercise ① — two-persona comparison (paste into Claude chat)

아래 두 요청을 각각 새 대화에서 보내고, 같은 데이터에 대해 출력이 어떻게 달라지는지 확인해 봐.Send each of the two requests below in a separate new chat and see how the output differs for the same data.

요청 A — 냉정한 비즈니스 애널리스트 페르소나Request A — cold business analyst persona

너는 냉정한 비즈니스 애널리스트야. 수치와 트렌드만 보고, 긍정적 해석은 자제하며, 리스크와 이상 항목을 먼저 지적해. 이번 달 매출이 지난 달보다 12% 올랐고, 반품률은 8%에서 11%로 올랐어. 이 데이터를 분석해 줘.You are a cold business analyst. Focus only on numbers and trends, avoid positive spin, and call out risks and anomalies first. This month's sales rose 12% vs last month, and the return rate climbed from 8% to 11%. Analyze this data.

요청 B — 경영진 친화 보고자 페르소나Request B — exec-friendly reporter persona

너는 경영진 친화적인 보고자야. 성과를 긍정적으로 프레이밍하고, 복잡한 수치는 단순화하며, 행동 가능한 결론을 한두 줄로 요약해. 이번 달 매출이 지난 달보다 12% 올랐고, 반품률은 8%에서 11%로 올랐어. 이 데이터를 분석해 줘.You are an exec-friendly reporter. Frame results positively, simplify complex numbers, and summarize actionable conclusions in one or two lines. This month's sales rose 12% vs last month, and the return rate climbed from 8% to 11%. Analyze this data.

성공 기준: A와 B의 첫 문장이 실제로 다른 관점에서 시작하는지 확인한다. 페르소나(관점)만 바꿨는데 출력 분포가 달라지면, 역할이 전문성을 만드는 원리가 작동한 것이다.Success criterion: check that the first sentence of A and B genuinely starts from a different lens. If changing only the persona shifts the output distribution, the principle — role makes expertise — is working.

실습 ② — 월 마감 절차 정의 후 한 줄 재호출Exercise ② — define monthly close procedure, then call it in one line

먼저 절차를 한 번 정의하고, 그 다음 달에는 한 줄로 재호출해 보는 연습이야.First define the procedure once, then practice calling it back in a single line the following month.

1단계 — 절차 정의Step 1 — define the procedure

지금부터 우리 매장의 "월 마감 보고" 절차를 함께 만들 거야. 이 절차는 매달 말 내가 "월 마감 보고 해줘"라고 한 마디만 해도 네가 전체 흐름을 알고 진행할 수 있도록 한 번만 정리해 두는 거야. 절차는 다음 네 단계야: (1) 이번 달 매출과 전월 대비 증감률 계산, (2) 반품률 이상 여부 확인 (기준: 10% 초과시 플래그), (3) 카테고리별 상위 3개 품목 정리, (4) 경영진 보고용 한 줄 요약 작성. 이 절차를 "월 마감 보고 절차"라는 이름으로 기억해 두고, 다음에 내가 "월 마감 보고 해줘"라고만 해도 이 네 단계를 전부 진행해 줘.We're going to define our store's "monthly close report" procedure together. The goal is for you to know the whole flow so that next month I only have to say "do the monthly close report" and you can run through everything. The procedure has four steps: (1) calculate this month's sales and month-over-month change rate, (2) check return rate for anomalies (flag if over 10%), (3) list the top 3 items by category, (4) write a one-line summary for the executive report. Remember this as "monthly close report procedure," and the next time I just say "do the monthly close report," run all four steps.

2단계 — 한 줄 재호출 (다음 대화에서)Step 2 — one-line recall (in the next conversation)

월 마감 보고 해줘. (데이터: 매출 4,200만 원, 전월 3,800만 원, 반품률 9%, 상위 품목: 런닝화 320켤레 / 등산화 210켤레 / 캐주얼화 185켤레)Do the monthly close report. (Data: sales ₩42M, last month ₩38M, return rate 9%, top items: running shoes 320 pairs / hiking boots 210 pairs / casual shoes 185 pairs)

성공 기준: 절차를 다시 설명하지 않았는데 네 단계가 전부 실행되면, 반복 절차를 한 번 묶어 두는 것이 효과가 있다는 증거다.Success criterion: if all four steps run without re-explaining the procedure, that's evidence that bundling a repeated procedure once actually works.

  1. 실습 ① 두 페르소나 비교: 요청 A와 B를 각각 새 대화창에서 보낸다. 반환된 두 분석의 첫 문장이 실제로 다른 관점에서 시작하는지 확인한다. 수치는 같은데 강조점이나 어조가 달라지면 성공이다. 이것이 역할이 분포를 좁히는 원리다.Exercise ①, two-persona comparison: send Request A and B each in a new chat. Check that the first sentence of each analysis genuinely starts from a different lens. Same numbers, different emphasis or tone — that's success. This is the principle of role narrowing the distribution.
  2. 실습 ② 절차 정의 후 재호출: 1단계에서 절차를 정의한 대화에서, 2단계 한 줄 재호출을 그 대화 안에서 이어서 보낸다. 네 단계가 절차 재설명 없이 전부 실행되면 성공이다. 반복 절차를 한 번 묶어 두는 것의 효과를 직접 확인하는 것이다.Exercise ②, procedure recall: in the same conversation where you defined the procedure in Step 1, send the one-line Step 2 recall. If all four steps run without re-explaining the procedure, that's success — direct confirmation that bundling a repeated procedure once actually works.
  3. 분류 퀴즈: 아래 다섯 가지를 보고 어느 그릇에 두면 좋을지 스스로 판단해 보자. "모든 답변은 존댓말로" → "우리 매장 반품 기준은 영수증 기준 14일" → "월 마감 보고 4단계 절차" → "냉정한 매출 분석가 페르소나" → "이번 주 프로모션 상품 목록". 정답 기준: 전역 규칙은 CLAUDE.md, 고유 사실은 업무 문서, 반복 절차는 스킬, 역할·페르소나는 에이전트, 자주 바뀌는 것은 파일 대신 그때그때 프롬프트.Classification quiz: for each of the five items below, decide which vessel it belongs in. "All replies in polite form" → "Our store's return policy: 14 days from receipt" → "Monthly close report, 4-step procedure" → "Cold sales analyst persona" → "This week's promotion product list." Answer key: global rules to CLAUDE.md, unique facts to work docs, repeated procedures to skills, roles/personas to agents, and fast-changing items stay as ad-hoc prompts instead of files.

전체 대본Full transcript

1 · RULE No.81 · Opening — Rule No.8

새 직원이 들어왔다고 해볼게요. 회사 규칙을 종이 한 장에 빼곡히 적어서 건네주면, 그 사람은 "모든 걸 조금씩 아는 박학한 신입"이 됩니다. 그런데 같은 지식을 직무기술서, 업무 절차서, 업무 정책 문서로 나눠서 주면, 어느새 "그 분야 전문가"처럼 일하기 시작해요. 차이는 지식의 양이 아니라 지식의 형태였습니다. 오늘은 룰 넘버 에이트, "지식을 구조화하면 Claude가 전문가가 된다"를 가지고, 지식을 구조로 나눠서 Claude를 도메인 전문가로 만드는 법을 다뤄보겠습니다. 이 강을 마치면, 한 덩어리 메모를 역할, 절차, 업무 문서 세 그릇으로 나눠 반복 업무에서 전문가 Claude를 만들 수 있게 됩니다.Say a new employee joins. If you hand them the company rules crammed onto a single page, they become a "well-read rookie who knows a little about everything." But give them the same knowledge split into a role spec, a procedures manual, and work policy documents, and suddenly they start working like "a domain expert." The difference wasn't the amount of knowledge — it was its shape. Today, under Rule Number Eight — "structure knowledge, and Claude becomes an expert" — we'll cover how to split knowledge into structure and turn Claude into a domain expert. By the end, you'll be able to split a one-big-pile memo into three vessels — role, procedure, and work docs — and build an expert Claude for recurring work.

2 · CLAUDE.md에 다 적었는데, 왜 전문가가 아닐까?2 · Hook — wrote it all, yet still not an expert?

지난 시간엔 매번 반복하던 설명을 클로드 닷 엠디에 한 번 적어서, 세션이 끝나도 사라지지 않게 휘발을 막았죠. 그래서 많은 분들이 이렇게 합니다. 보고 형식, 업무 용어, 월별 마감 절차, 데이터 출처 규칙, 경영진 보고 주의사항을 전부 클로드 닷 엠디 한 파일에 차곡차곡 쌓아요. 스크롤이 점점 길어지죠.Last time, we took the explanations you kept repeating and wrote them once into CLAUDE.md, so they wouldn't vanish when the session ended — we stopped the evaporation. So a lot of people do this: they pile report formats, business terms, monthly close procedures, data source rules, and executive report notes all into one CLAUDE.md file, stacking it up. The scroll just keeps getting longer.

그런데 다 적었는데도, Claude가 그 분야 전문가가 아니라 "모든 걸 조금씩 아는 똑똑한 신입"처럼 느껴진 적 없으세요? 분명 빠뜨린 건 없는데, 깊이가 안 나옵니다. 여기서 핵심은요. 문제는 적었느냐가 아니라, 어떻게 구조화했느냐예요. 지식의 양이 아니라 형태가 전문성을 정합니다. 그래서 오늘은 '쌓기'에서 '구조화'로 한 단계 올라가 보겠습니다.And yet, even after writing it all down, have you ever felt Claude was less a domain expert and more a "smart rookie who knows a bit about everything"? Nothing's missing, but the depth just isn't there. Here's the key: the problem isn't whether you wrote it, it's how you structured it. It's not the amount of knowledge that decides expertise — it's the shape. So today we step up, from "piling it on" to "structuring it."

3 · 평면 더미의 3가지 한계3 · Three limits of the flat heap

한 더미로 쌓으면 구체적으로 세 가지를 잃습니다. 첫째, 관점이 흐려져요. 코드를 깐깐하게 보는 리뷰어의 시각, 친절하게 쓰는 문서 작성자의 시각, 빈틈을 찾는 보안 점검자의 시각이 한 파일에 다 섞이면, 어느 관점도 또렷하지 않게 됩니다. 둘째, 항상 다 짊어져요. 한 덩어리는 매 세션마다 통째로 컨텍스트를 먹습니다. 지금 이 작업에 안 쓰는 지식까지 전부요. 룰 넘버 투, 컨텍스트를 지켜라가 여기서 깨지는 거죠.Pile it into one heap and you lose three things, specifically. First, the lens goes foggy. The strict reviewer's view of code, the friendly documentation writer's view, the security checker's hunt for gaps — mix them all in one file and no single lens stays sharp. Second, you carry it all, always. One heap eats the whole context every single session — including knowledge you aren't using for this task at all. That's where Rule Number Two, protect your context, breaks down.

셋째, 재사용이 안 됩니다. 똑같은 절차를 반복하는데도, 묶어둔 단위가 없으니까 매번 처음부터 풀어서 설명해야 해요. 중요한 건, 이게 Claude의 버그가 아니라는 점입니다. 지식을 구조 없이 한 더미로 쌓은 결과일 뿐이에요. 그러니 해법도 분명합니다. 이 평면 더미를 역할, 절차, 그리고 업무 근거 문서로 나누는 거예요.Third, there's no reuse. You repeat the very same procedure, but with no bundled unit, you have to spell it out from scratch every time. The important thing is, this isn't a bug in Claude. It's just the result of piling knowledge into one heap with no structure. So the fix is just as clear: split that flat heap into roles, procedures, and work-doc context.

4 · 구조화의 세 그릇 — 역할·절차·업무 근거 문서4 · Three vessels — role, procedure, work-doc truth

그럼 구조화가 뭐냐. 한마디로, 한 더미였던 지식을 세 개의 그릇에 나눠 담는 겁니다. 첫 번째 그릇은 역할이에요. Claude Code에서는 이걸 에이전트, 정확히는 서브에이전트라는 별도 정의 파일로 둘 수 있어요. 닷 클로드 슬래시 에이전츠 폴더 안에, 관점이나 페르소나를 담습니다. 두 번째 그릇은 절차예요. 이건 스킬이라는 파일로 두는데, 닷 클로드 슬래시 스킬즈 폴더 안에, 재사용 가능한 작업 묶음을 담습니다.So what is structuring? In a word, it's taking what was one heap and sorting it into three vessels. The first vessel is role. In Claude Code, you can put this in a separate definition file called an agent — more precisely, a subagent. Inside the dot-claude-slash-agents folder, you hold the lens or persona. The second vessel is procedure. This goes in a file called a skill, inside the dot-claude-slash-skills folder, holding a reusable bundle of work.

세 번째 그릇은 업무 근거 문서예요. 업무 메모, 정책 문서에, 우리 매장이나 회사에만 있는 고유한 사실을 담습니다. 예를 들어 왜 이 카테고리만 마진율 기준이 다른지 같은 것들이죠. 정리하면, 역할은 에이전트로, 절차는 스킬로, 우리 회사의 업무 근거는 업무 문서로. 한 가지만 짚을게요. 역할 폴더인 닷 클로드 슬래시 에이전츠 같은 정확한 경로나 파일 형식, 명령어는 버전마다 바뀔 수 있어요. 발표 시점의 공식 문서가 진실입니다. 외워야 할 건 경로가 아니라 원리예요. 지식은 쌓지 말고, 그릇에 나눠 담는다.The third vessel is work-doc truth. In work memos and policy documents, you hold the facts unique to our store or company — things like why this particular category has a different margin standard. To sum up: roles go in agents, procedures go in skills, and our company's work grounds go in work docs. One caveat: exact folder names like the role folder dot-claude-slash-agents, the file format, the commands — these can change by version. The official docs at the time you present are the truth. What you memorize isn't the path, it's the principle: don't pile knowledge up, sort it into vessels.

5 · Before/After ① — 한 덩어리 vs 역할별 에이전트5 · Before/After ① — one heap vs role-based agents

첫 번째 비포 애프터입니다. 비포, 한 덩어리부터 볼게요. 만능 프롬프트 하나가 매출 분석도 하고, 재고 파악도 하고, 경영진 보고도 쓰고, 이상 탐지도 하고, 이걸 동시에 다 하려고 합니다. 지난 강 기억하시죠. 입력이 출력의 분포를 정합니다. 한 프롬프트에 여러 의도를 다 섞어 넣으면, 분포가 넓어지면서 관점이 평균값으로 흐려져요. 어느 것도 깐깐하지 않고, 어느 것도 친절하지 않은, 밍밍한 결과가 나옵니다.First before-and-after. Let's start with the before — one heap. A single all-purpose prompt tries to analyze sales, check inventory, write the executive report, and flag anomalies, all at once. Remember last session: the input decides the output's distribution. Cram many intentions into one prompt and the distribution widens, so the lens fogs toward an average. You get a bland result — nothing strict, nothing friendly.

이제 애프터예요. 닷 클로드 슬래시 에이전츠 폴더에 역할별 에이전트를 둡니다. 예를 들어 매출 분석가는 수치와 트렌드에 집중하는 관점으로 고정하고, 리포트 작성자는 경영진 친화적이고 구조적인 관점으로 고정해요. 그러면 일에 맞는 전문가를 골라서 부를 수 있죠. 에이전트 파일은 역할별로 분포를 좁혀서, 전문가의 관점을 딱 고정해 줍니다. 그러니 관점이 중요한 일이라면, 한 명에게 다 시키지 말고 역할로 나누세요. 이름은 예시일 뿐이고요.Now the after. In the dot-claude-slash-agents folder, you place an agent per role. For instance, fix the sales analyst to a numbers-and-trends lens, and the report writer to an exec-friendly, structured one. Then you can summon the specialist that fits the job. The agent file narrows the distribution per role, locking in the expert's lens. So when a job hinges on perspective, don't make one do it all — split by role. And the names are just examples.

6 · Before/After ② — 매번 절차 설명 vs 스킬로 묶기6 · Before/After ② — re-explaining procedure vs skill bundle

두 번째 비포 애프터예요. 이번엔 절차입니다. 비포, 매번 절차를 낭독하는 장면이에요. 월 마감 보고할 때마다 이렇게 설명하죠. 매출 피벗 만들고, 전월 대비 계산하고, 이상 항목 표시하고, 요약 작성하고. 문제는 이 다단계 절차를 세션이 바뀔 때마다 처음부터 다시 풀어 설명해야 한다는 거예요. 묶어둔 단위가 없으니까요.Second before-and-after. This time it's procedure. The before: reciting the steps every time. For each monthly close, you explain like this — build the sales pivot, calculate month-over-month change, flag anomalies, write the summary. The problem is, this multi-step procedure has to be spelled out from scratch whenever the session changes. There's no bundled unit.

애프터를 볼게요. 닷 클로드 슬래시 스킬즈 폴더에 먼슬리 클로즈라는 이름으로 절차를 묶습니다. 부를 이름, 언제 쓰는지, 그리고 단계들이 한곳에 모여 있어요. 그러면 다음부턴 "마감 보고 스킬 써줘" 한 줄이면 끝납니다. 스킬은 모델이 그 작업이 필요할 때 불러 쓰는, 재사용 가능한 지침 묶음이에요. 역시 정확한 형식이나 발동 방식은 발표 시점 공식 문서가 진실입니다. 핵심은, 반복되는 절차는 스킬로 한 번만 묶는다.Now the after. In the dot-claude-slash-skills folder, you pack the procedure under the name "monthly-close." The name to call it, when to use it, and the steps all sit in one place. From then on, one line — "use the monthly-close skill" — and you're done. A skill is a reusable bundle of instructions the model pulls in when that work is needed. Again, the exact format and how it triggers are whatever the official docs say at presentation time. The point: a repeated procedure gets packed into a skill, once.

7 · 한 장 비교 — 무엇을 어디에 두나7 · One-page map — what goes where

그럼 어떤 지식을 어느 그릇에 담아야 할까요. 한 장으로 정리했습니다. 첫째, 전역 규칙이나 컨벤션, 예를 들어 한국어로 답해라, 들여쓰기는 두 칸이다 같은 건 클로드 닷 엠디에 둡니다. 둘째, 꼼꼼한 매출 분석가나 리포트 작성자처럼 역할이나 관점은 에이전트 파일에 둬요. 셋째, 재고 마감이나 주간 보고 루틴처럼 반복되는 절차는 스킬 파일에 둡니다. 넷째, 왜 이 카테고리만 마진율 기준이 다른지처럼 우리 매장이나 회사에만 있는 고유한 사실은 업무 메모나 정책 문서에 둡니다.So which knowledge goes in which vessel? Here it is on one page. First, global rules or conventions — like "answer in Korean" or "indent with two spaces" — go in CLAUDE.md. Second, a role or lens, like "the thorough sales analyst" or "the report writer," goes in an agent file. Third, repeated procedures, like an inventory close or weekly reporting routine, go in a skill file. Fourth, facts unique to our store or company — like why this particular category has a different margin standard — go in work memos or policy documents.

지난 시간이 대화창에 쓸 거냐, 파일에 쓸 거냐, 그러니까 위치 문제였다면, 오늘은 어느 파일, 어느 그릇이냐, 구조 문제예요. 여기서 흔한 실수가, 이걸 다 클로드 닷 엠디에 욱여넣는 겁니다. 그러면 다시 한 덩어리가 되어버려요. 그러니 기억하세요. 지식의 종류가 그릇을 정합니다. 다 클로드 닷 엠디에 넣지 마세요.If last time was "the chat box or a file" — a question of location — today it's "which file, which vessel" — a question of structure. A common mistake here is stuffing it all into CLAUDE.md, which just turns it back into one heap. So remember: the kind of knowledge decides the vessel. Don't put it all in CLAUDE.md.

8 · 왜 통하나 — 구조가 전문성을 만드는 3원리8 · Why it works — three principles behind expertise

오늘의 첫 번째 핵심입니다. 왜 구조가 전문성을 만드는 걸까요. 구조는 세 가지를 동시에 해내거든요. 첫째, 역할은 관점을 고정합니다. 에이전트가 한 관점으로만 보게 하니까, 출력의 분포가 전문가 영역으로 좁혀져요. 지난 강의 분포 이야기랑 정확히 이어집니다. 둘째, 절차는 재사용됩니다. 스킬은 필요할 때만 불러오니까, 매번 설명하거나 다시 학습할 필요가 없어요. 그만큼 컨텍스트를 아낍니다. 룰 넘버 투랑 이어지죠.Today's first peak. Why does structure make expertise? Because structure does three things at once. First, role fixes the lens. An agent sees through one lens only, so the output's distribution narrows to the expert zone — exactly the distribution point from last session. Second, procedure gets reused. A skill is pulled in only when needed, so there's no re-explaining and no re-learning, which saves that much context. That ties straight back to Rule Number Two.

셋째, 업무 근거 문서는 정확함을 줍니다. 업무 메모나 정책 문서에 우리 회사·매장만의 사실을 적어두면, Claude가 추측으로 메우는 대신 근거를 보고 답해요. 우리가 첫 강에서 봤던 할루시네이션, 그러니까 빈칸을 그럴듯하게 메우는 그 경향이 줄어듭니다. 정리하면, 역할은 분포를 좁히고, 스킬은 컨텍스트를 아끼고, 업무 문서는 추측 대신 사실을 줘요. 이 셋이 합쳐져서, 박학한 신입을 전문가로 바꿉니다. 구조가 깊이를 만드는 거예요.Third, work-doc truth gives accuracy. Write our company's and store's unique facts into work memos and policy documents, and Claude answers from grounds instead of filling gaps by guessing. That hallucination from our first session — the tendency to fill a blank with something plausible — drops. To sum up: role narrows the distribution, the skill saves context, and the work docs give facts instead of guesses. Together, these three turn the well-read rookie into an expert. Structure is what makes the depth.

9 · 지식 그래프 — 파일들이 서로를 부른다9 · Knowledge graph — files point to each other

여기서 구조화의 숨은 이득이 하나 더 나옵니다. 클로드 닷 엠디는 창고가 아니라 색인이에요. 모든 걸 거기 다 담으려 하지 말고, 어디에 뭐가 있는지 가리키는 역할만 맡기세요. 예를 들어 역할이 필요하면 에이전트를, 절차가 필요하면 스킬을, 회사 고유 사실이 필요하면 업무 문서를 가리키는 거죠. 그러면 필요한 그릇만 꺼내 쓸 수 있어요.Here a hidden benefit of structuring shows up. CLAUDE.md is not a warehouse — it's an index. Don't try to put everything there; just give it the job of pointing to where things are. For example, when a role is needed, point to agents; when a procedure is needed, point to skills; when a company-specific fact is needed, point to work docs. That way you pull out only the vessel you actually need.

이게 왜 좋냐면요. 한 덩어리는 매 세션 통째로 다 로드됩니다. 안 쓰는 것까지요. 그런데 색인이 각 그릇을 가리키면, 필요한 것만 꺼내 쓸 수 있어 컨텍스트를 아낍니다. 룰 넘버 투랑 이어지죠. 구조화의 숨은 이득은 컨텍스트 절약이에요. 그러니 클로드 닷 엠디는 가볍게 색인으로 두고, 깊이는 각 그릇에 두세요.Why is that good? One heap loads in whole, every session — including what you don't use. But when an index points to each vessel, you can pull only what's needed, saving context. That ties back to Rule Number Two. The hidden payoff of structuring is context saved. So keep CLAUDE.md light as an index, and put the depth in each vessel.

10 · 언제 파일로, 언제 프롬프트로10 · When to file, when to prompt

자, 그럼 모든 걸 다 파일로 만들어야 할까요. 아닙니다. 여기 이 강 전체를 묶는 핵심 분기가 있어요. 세 가지를 보세요. 여러 번 쓸 거냐, 이번만 쓸 거냐. 안정적이냐, 자주 바뀌냐. 팀이나 미래의 나와 공유할 거냐, 아직 나 혼자 실험 중이냐. 반복되고, 안정적이고, 공유할 거면 파일로 만드세요. 반대로 이번 한 번만 쓰고, 자주 바뀌고, 아직 실험 중이면 그냥 프롬프트로 말하세요.So, should you turn everything into a file? No. Here's the core fork that ties this whole session together. Look at three things. Will you use it many times, or just this once? Is it stable, or does it change often? Will you share it with the team or future-you, or are you still experimenting alone? If it's repeated, stable, and shared — make it a file. If it's one-off, changes often, and still experimental — just say it in a prompt.

왜냐하면 구조를 만드는 데도 비용이 들거든요. 파일을 만들고, 유지하고, 관리해야 하니까요. 그 비용이 회수되는 건 오직 반복될 때뿐이에요. 지난 강에서 지식의 위치가 비용을 정한다고 했죠. 오늘은 거기서 한 발 더 나가서, 지식의 형태도 비용입니다. 한 번 쓸 걸 굳이 파일로 구조화하면, 그건 과설계예요. 다음은, 그럼 무엇을 구조화해야 할지 점검하는 다섯 가지입니다.Because structure costs something too — you have to create the file, maintain it, manage it. That cost pays off only when it repeats. Last session we said the location of knowledge sets the cost. Today we go one step further: the shape of knowledge is a cost too. Structure a one-off into a file for no reason, and that's over-engineering. Next up: five checks for what's actually worth structuring.

11 · 도메인 전문가 Claude 만들기 5체크11 · Five checks for domain-expert Claude

자, 오늘의 두 번째 완성형입니다. 박학한 신입을 분야 전문가로 바꾸는 다섯 가지 점검이에요. 첫째, 역할이 섞였나? 한 프롬프트에 관점이 여럿이면 에이전트로 분리하세요. 역할 하나당 파일 하나가 원칙입니다. 둘째, 절차가 반복되나? 매번 푸는 다단계 작업이라면 스킬로 묶으세요. 이름, 언제 쓰는지, 단계를 함께요. 셋째, 업무의 '왜'가 적혀 있나? 우리 매장이나 회사만의 사실이나 결정 이유를 업무 메모, 정책 문서에 적어서 추측을 막으세요.Alright, today's second peak. Five checks that turn the well-read rookie into a domain expert. One: are roles mixed? If one prompt holds many lenses, split them into agents — one file per role is the rule. Two: does a procedure repeat? If it's multi-step work you spell out every time, pack it into a skill — with its name, when to use it, and the steps. Three: is the work's "why" written down? Put your store's or company's unique facts and the reasons behind decisions into work memos and policy documents, to block guessing.

넷째, 파일인가 프롬프트인가? 반복되고 안정적이고 공유할 거면 파일로, 일회성이고 실험 중이면 프롬프트로. 과설계는 금물이에요. 다섯째, 입구가 가리키나? 클로드 닷 엠디가 창고가 아니라, 색인처럼 어디에 뭐가 있는지 가리키고 있나 보세요. 재밌는 건, 이 다섯 가지가 앞에서 본 원리와 하나씩 정확히 짝을 이룬다는 거예요. 역할은 5강, 8강, 절차는 6강과 8강, 이런 식으로요. 그래서 원리를 알면, 이 체크리스트는 저절로 외워집니다.Four: file or prompt? Repeated, stable, shared goes to a file; one-off and experimental stays a prompt. No over-engineering. Five: does the entry point? Check whether CLAUDE.md is an index pointing to where things are, not a warehouse. Here's the fun part: these five map exactly, one by one, onto the principles we just saw — role to sessions 5 and 8, procedure to 6 and 8, and so on. So once you know the principles, this checklist memorizes itself.

12 · 구조화 운용 — 작게 시작해 키운다12 · Operating structure — start small, grow it

그럼 구조는 처음부터 다 짜야 할까요. 아니에요. 작게 시작해서 키우는 겁니다. 처음엔 클로드 닷 엠디 하나로 충분해요. 그러다 같은 역할이나 같은 절차가 두 번째로 반복되는 게 보이면, 그때 그릇으로 승격하세요. 에이전트는 슬래시 에이전츠 같은 명령으로 만들 수 있고요. 물론 정확한 명령이나 생성 흐름은 발표 시점 공식 문서가 진실입니다.So should you build the whole structure upfront? No. You start small and grow it. At first, one CLAUDE.md is plenty. Then, when you notice the same role or the same procedure repeating a second time, that's when you promote it to a vessel. You can create an agent with a command like slash-agents — and of course, the exact command and creation flow are whatever the official docs say at presentation time.

키울 때 두 가지 원칙만 지키세요. 첫째, 그릇은 짧고 단일 책임으로. 에이전트는 한 역할만, 스킬은 한 절차만 담습니다. 지난 강에서 메모는 짧고 구체적으로 적으라고 했던 것과 같은 원리예요. 둘째, 안 쓰는 그릇은 지웁니다. 구조도 정리 대상이에요. 메모리가 한 번 쓰고 끝이 아니라 키우는 거였던 것처럼, 구조도 살아 있는 그래프로 가꾸는 겁니다. 한 번에 완벽하게 짜려 하지 말고, 반복을 보고 키우세요.As you grow it, keep just two principles. First, vessels stay short and single-responsibility — an agent holds one role, a skill holds one procedure. Same principle as last session, where we said keep memos short and specific. Second, delete vessels you don't use — structure is also for tidying. Just as memory wasn't write-once but something you grow, structure is a living graph you tend. Don't try to build it perfectly in one shot — grow it as the repetition shows up.

13 · 한 줄 공식13 · One-line formula

오늘 배운 다섯 가지를 한 줄 공식으로 정리해볼게요. 전문가 Claude는, 역할은 에이전트에, 절차는 스킬에, 업무 근거는 업무 문서에, 그리고 입구는 클로드 닷 엠디에. 단, 반복되고 안정적이고 공유될 때만요. 지난 강의 룰 넘버 세븐, 매번 설명하지 말고 적어두라와 오늘의 룰 넘버 에이트, 구조화하라가 바로 여기서 만납니다. 그냥 적어두기에서, 구조 있게 적어두기로요. 일회성은 그냥 프롬프트로. 과설계는 금물입니다. 이 공식을 알면, 무엇을 어느 그릇에 담을지가 보입니다.Let me lock today's five into one formula. Expert Claude is: roles in agents, procedures in skills, work grounds in work docs, and the entry in CLAUDE.md — but only when it's repeated, stable, and shared. Last session's Rule Number Seven, "don't re-explain, write it down," and today's Rule Number Eight, "structure it," meet right here — from just writing it down, to writing it down with structure. A one-off stays a prompt; no over-engineering. Once you know this formula, you can see what goes in which vessel.

14 · RULE No.814 · Closing — Rule No.8

오늘 한 단어만 가져가신다면, 쌓기에서 구조화로, 입니다. 같은 지식이라도 한 더미로 쌓으면 박학한 신입이지만, 역할과 절차와 업무 근거 문서로 구조를 주면 분야 전문가가 돼요. 디렉터리 이름이나 파일 형식은 앞으로 바뀌겠지만, 지식을 종류대로 구조화하면 전문성이 생긴다는 이 원리는 그대로입니다. 자, 우리는 지난 두 강에서 지식을 적어두고, 구조화하는 법을 배웠어요. 다음 시간에는 한 걸음 더 나가서, 일을 시작하기 전에 먼저 설계하는 법, 프로젝트 설계법을 다뤄보겠습니다.If you take one word from today, it's: from piling to structuring. The same knowledge, piled into one heap, is a well-read rookie — but give it structure, with roles, procedures, and work-doc truth, and it becomes a domain expert. Directory names and file formats will change down the road, but this principle — structure knowledge by kind and expertise emerges — stays the same. Over the last two sessions, we learned to write knowledge down and to structure it. Next time, we go one step further: how to design before you start the work — Project Design.