사규를 한 장에 다 적어 주면 — 박학한 신입. 직무기술서·업무 절차서·코드 문서로 나눠 주면 — 그 분야 전문가. 오늘은 지식을 ‘구조’로 나눠 전문가를 만듭니다. Hand over the whole rulebook on one page — a well-read rookie. Split it into role specs, procedures, and code docs — a domain expert. Today we split knowledge into ‘structure’ to make an expert.
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]
분명 빠뜨린 건 없는데, ‘모든 걸 조금씩 아는 신입’처럼 느껴집니다. 문제는 ‘적었느냐’가 아니라 ‘어떻게 구조화했느냐’.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.’
리뷰어·작성자·보안 점검자가 한 파일에 섞여 어느 관점도 또렷하지 않다.Reviewer, writer, security checker all mixed in one file — no lens is sharp.
한 덩어리는 매 세션 통째로 컨텍스트를 먹는다 — 지금 안 쓰는 지식까지.One heap eats the whole context every session — even what you aren't using.
반복 ‘절차’도 매번 풀어 설명해야 한다 — 묶어둔 단위가 없다.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 code context.
.claude/agents/ · 관점·페르소나· lens·persona.claude/skills/ · 재사용 가능한 작업 묶음· a reusable bundle of workdocs/·README·주석 · 이 코드베이스만의 사실comments · facts unique to this codebase[출처: docs.anthropic.com/en/docs/claude-code/sub-agents] · [출처: docs.anthropic.com/en/docs/claude-code/skills] Claude Code는 서브에이전트(역할·도구·프롬프트)와 스킬(재사용 가능한 절차 묶음)을 파일로 정의한다. 정확한 디렉터리·형식·명칭은 발표 시점 공식 문서가 진실(2026-06 기준). → 지식은 쌓지 말고 그릇에 나눠 담는다.[source: docs.anthropic.com/en/docs/claude-code/sub-agents] · [source: docs.anthropic.com/en/docs/claude-code/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.
.claude/agents/에 code-reviewer(엄격·꼼꼼) · doc-writer(친절·구조적)In .claude/agents/: code-reviewer (strict·thorough) · doc-writer (friendly·structured)[추론] 한 프롬프트에 역할을 다 섞으면 관점이 평균값으로 흐려진다(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.
.claude/skills/에 release — 이름·언제 쓰는지·단계가 한 곳에In .claude/skills/: release — name·when to use·steps in one place[출처: docs.anthropic.com/en/docs/claude-code/skills] 스킬은 모델이 특정 작업에 필요할 때 불러 쓰는 재사용 가능한 지침·절차 묶음이다. 정확한 형식·발동 방식은 발표 시점 공식 문서가 진실(2026-06 기준). → 반복되는 ‘절차’는 스킬로 한 번만 묶는다.[source: docs.anthropic.com/en/docs/claude-code/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.
| 종류Kind | 그릇Vessel | 예Example |
|---|---|---|
| 전역 규칙·컨벤션Global rules·conventions | CLAUDE.md |
“한국어로 답·들여쓰기 2칸”“answer in Korean·2-space indent” |
| 역할·관점Role·lens | 에이전트 파일agent file | “엄격한 코드 리뷰어”“the strict code reviewer” |
| 반복 절차Repeated procedure | 스킬 파일skill file | “릴리스·QA 루틴”“release·QA routine” |
| 코드베이스 고유 사실Codebase-specific fact | docs/·README·주석comments |
“왜 이 함수가 이렇게 생겼나”“why this function looks this way” |
종류가 그릇을 정한다 — 다 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.
[추론] s02·s03·s06 콜백 — 역할은 분포를 좁히고(전문 관점), 스킬은 절차를 재사용하며(컨텍스트 절약), 코드 문서는 추측 대신 사실을 준다(환각↓). 셋이 합쳐 ‘박학한 신입’을 ‘전문가’로 바꾼다. → 구조는 깊이를 만든다.[inference] s02·s03·s06 callback — role narrows the distribution (expert lens), the skill reuses procedure (context saved), the docs give facts not guesses (fewer hallucinations). Together they turn the well-read rookie into an expert. → Structure makes the depth.
[추론] s02 콜백 — 한 덩어리는 매번 통째로 로드되지만, 그래프는 입구(CLAUDE.md)만 항상 두고 가지(에이전트·스킬·docs)는 필요할 때 펼친다(점진적 공개). 구조화의 숨은 이득 = 컨텍스트 절약. → 색인을 두고 깊이는 가지에.[inference] s02 callback — one heap loads in whole every time, but a graph keeps only the entry (CLAUDE.md) always open and unfolds branches (agents·skills·docs) when needed (progressive disclosure). Structuring's hidden payoff = context saved. → Keep the index light, put depth in the branches.
구조화의 비용이 회수되는 건 ‘반복될 때’뿐 — 한 번 쓸 건 그냥 말로.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.
[추론] 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, code context=S07/08, file vs prompt=S10, graph entry=S09). → Know the principles and the checklist memorizes itself.
[출처: docs.anthropic.com/en/docs/claude-code/sub-agents] Claude Code는 서브에이전트·스킬을 명령·도구로 생성·관리할 수 있다. 정확한 명령·생성 흐름은 발표 시점 공식 문서가 진실(2026-06 기준). → 구조는 한 번에 짜는 게 아니라 반복을 보고 키운다.[source: docs.anthropic.com/en/docs/claude-code/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.
[추론] 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.
한 단어로: 쌓기 → 구조화. (박학한 신입 → 분야 전문가)In one word: piling → structuring. (well-read rookie → domain expert)
다음 강 예고 — 프로젝트 설계법, 시작하기 전에 설계한다.Next up — Project Design, design before you start.
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]