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
-
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.
-
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.
-
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.
-
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.
-
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.
아래 두 요청을 각각 새 대화에서 보내고, 같은 데이터에 대해 출력이 어떻게 달라지는지 확인해 봐.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.
먼저 절차를 한 번 정의하고, 그 다음 달에는 한 줄로 재호출해 보는 연습이야.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.
- 실습 ① 두 페르소나 비교: 요청 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.
- 실습 ② 절차 정의 후 재호출: 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.
- 분류 퀴즈: 아래 다섯 가지를 보고 어느 그릇에 두면 좋을지 스스로 판단해 보자. "모든 답변은 존댓말로" → "우리 매장 반품 기준은 영수증 기준 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.