클래스 목록으로 돌아가기

Public CMS Preview

Claude Code 온보딩 워크샵 · 실제 통계로 HTML 보고서 만들기

맨 앞의 선택 발표는 Claude Code의 이유·설치·스킬을 다루는 별도 40분입니다. 본 실습은 00 준비에서 진단과 환경을 확인하고, 공식 통계로 이미지·한국 지도·Base64를 담은 단일 HTML 보고서를 만드는 120분 과정입니다. PDF·PPT·DOCX·HWPX·Figma 활용과 수업 후 지도·스킬 심화 학습도 제공합니다.

가입하고 워크샵 시작 · 기존 회원 이어하기 →

Modules

20

Steps

86

발표lesson

발표 · Claude Code를 쓰는 이유와 설치·스킬

발표 · 실습과 별도 · 0–40분 (40분) · 대화형 AI와 Claude Code의 차이, 작동 방식, 오늘 만들 결과물을 이해한다.

5 steps

Step 1

왜 Claude Code인가 (슬라이드 1–6)

published

Step 1

왜 Claude Code인가 (슬라이드 1–6)

발표 · 발표 · Claude Code를 쓰는 이유와 설치·스킬 · 8분

목표

대화형 AI와 Claude Code의 차이, 작동 방식, 오늘 만들 결과물을 이해한다.

시간

모듈 0–40분 중 이 단계 8분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 다운로드한 발표자료 HTML을 브라우저로 열고 전체화면(F)으로 본다.

2. 3번 슬라이드에서 채팅과 Claude Code의 차이를 비교한다. 클릭할 때마다 한 칸씩 나타난다.

3. 5번 루프(읽기→계획→실행→확인)에서 내가 개입하는 지점 세 곳을 찾는다.

완료 기준

채팅은 답을 받아 내가 옮기고, Claude Code는 내 폴더의 파일을 읽고 만들고 확인한다고 설명한다.

막히면

파일이 열리지 않으면 강사 화면으로 보고 슬라이드 번호만 따라간다. 발표 메모는 N 키로 열린다.

강사 진행 메모

슬라이드 1–2 오프닝 3분, 3–4 이유 3분, 5–6 원리와 오늘의 흐름 2분. 클릭 진행 슬라이드(3번)는 한 번에 한 칸씩 짚는다. 이 발표는 120분 실습에 포함되지 않는 별도 40분이다.

첨부파일

Claude Code 워크샵 발표자료 (HTML 22장)

내려받아 브라우저로 엽니다. 방향키·클릭으로 넘기고 F 전체화면, N 발표 메모. 슬라이드마다 애니메이션이 있습니다.

claude-code-workshop-deck.html

다운로드

이 발표의 위치

강사가 과정 맨 앞에서 진행하는 별도 40분 발표입니다. 120분 실습(00 준비 5분 + 실습 110분 + 휴식 5분)에는 포함되지 않습니다. 슬라이드 번호 순서대로 5개 Step으로 나눠 진행합니다.

Step 2

설치와 첫 세션 (슬라이드 7–10)

published

Step 2

설치와 첫 세션 (슬라이드 7–10)

발표 · 발표 · Claude Code를 쓰는 이유와 설치·스킬 · 10분

목표

Claude 데스크톱 앱 설치, Code 탭 화면 구성, 첫 세션 시작, 권한 모드를 이해한다.

시간

모듈 0–40분 중 이 단계 10분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 설치→로그인→Code 탭 순서를 확인한다. Code 탭은 Pro·Max·Team·Enterprise 구독이 필요하다.

2. 8번 슬라이드의 다섯 영역(세션 목록·대화 입력창·변경 보기·터미널·브라우저)을 실제 앱 화면과 비교한다.

3. 10번에서 Plan과 Manual 모드를 고르고 오늘은 이 두 모드로 시작하기로 정한다.

완료 기준

설치와 로그인이 끝났고 Code 탭에서 폴더 선택 화면을 볼 수 있다.

막히면

설치나 로그인이 막히면 강사 화면 또는 짝 실습으로 전환한다. 인증 오류는 로그아웃 후 다시 로그인한다.

강사 진행 메모

슬라이드 7(설치) 3분, 8(화면 투어) 3분, 9(첫 세션) 2분, 10(권한 모드) 2분. 설치·로그인은 수업 전에 마치도록 사전 안내한다. 슬라이드의 단계와 모드는 자동으로 순환하고 클릭하면 고정된다.

Step 3

좋은 요청과 프로젝트 규칙 (슬라이드 11–12)

published

Step 3

좋은 요청과 프로젝트 규칙 (슬라이드 11–12)

발표 · 발표 · Claude Code를 쓰는 이유와 설치·스킬 · 6분

목표

입력·목적·제약·완료 기준이 들어간 요청과 CLAUDE.md의 역할을 이해한다.

시간

모듈 0–40분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 11번에서 요청문이 타이핑된 뒤 색으로 구분되는 네 요소를 확인한다.

2. 내가 하는 업무 요청 하나를 같은 네 요소로 바꿔 말해 본다.

3. 12번에서 읽기 전용 폴더와 결과 폴더를 나누는 이유, CLAUDE.md가 항상 읽힌다는 점을 확인한다.

완료 기준

요청에 읽을 파일, 금지할 일, 멈출 지점이 들어 있다고 말하고 CLAUDE.md를 규칙 파일로 구분한다.

막히면

요청 만들기가 어려우면 11번의 요청문을 그대로 복사해 쓴다.

강사 진행 메모

슬라이드 11 3분, 12 3분. 처음 요청은 "읽기만 하고 파일은 바꾸지 마세요"로 시작하도록 강조한다. 실제 실습은 1번 실습 모듈에서 한다.

Step 4

스킬: 만들고, 설치하고, 고르기 (슬라이드 13–16)

published

Step 4

스킬: 만들고, 설치하고, 고르기 (슬라이드 13–16)

발표 · 발표 · Claude Code를 쓰는 이유와 설치·스킬 · 10분

목표

스킬이 무엇인지, 어디에 설치하고 어떻게 부르는지, 외부 스킬을 도입하기 전 무엇을 점검하는지 이해한다.

시간

모듈 0–40분 중 이 단계 10분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 13번의 SKILL.md 예시에서 name과 description의 역할을 찾는다. description이 언제 쓸지를 정한다.

2. 14번에서 프로젝트 설치 위치와 개인 설치 위치, 슬래시 호출 방식을 확인한다.

3. 16번의 설치 전 점검 네 가지(원본 저장소·실행 스크립트·라이선스·의존성)를 적어 둔다.

완료 기준

CLAUDE.md와 스킬과 MCP의 차이를 말하고, 외부 스킬을 설치하기 전에 점검할 네 가지를 안다.

막히면

용어가 낯설면 "스킬은 반복 업무의 작업 절차서"로만 이해하고 실습에서 직접 설치해 본다.

강사 진행 메모

슬라이드 13 3분, 14 2분, 15 2분, 16 3분. 외부 스킬은 코드를 실행할 수 있으므로 설치 전 원본을 직접 확인하게 한다. 이 수업의 설치 실습은 자체 제작 stat-brief로 하며 report-audit는 선택 모듈에서 다룬다.

Step 5

보고서·검수·적용 (슬라이드 17–22)

published

Step 5

보고서·검수·적용 (슬라이드 17–22)

발표 · 발표 · Claude Code를 쓰는 이유와 설치·스킬 · 6분

목표

HTML 보고서의 쓰임, 숫자 검수 원칙, 확장 기능, 내 업무 적용 계획을 정리하고 실습으로 넘어간다.

시간

모듈 0–40분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 17번에서 하나의 HTML이 공유·인쇄·재구성으로 이어지는 구조를 본다.

2. 18–19번에서 지역 내 비율의 분모와 근거 없는 원인 문장을 검수하는 방법을 확인한다.

3. 21번의 3단계 중 오늘 할 일 하나를 정하고 00 준비와 첫 실습으로 이동한다.

완료 기준

오늘 만들 결과물과 검수 기준을 말하고 첫 실습으로 이동할 수 있다.

막히면

시간이 부족하면 20번(확장 기능)을 건너뛰고 21번 업무 적용에서 마무리한다.

강사 진행 메모

슬라이드 17 1분, 18–19 2분, 20 1분, 21–22 2분. 36.1%·서울 39.9%·울산 31.6%는 지역 내 비율임을 반복한다. 발표 후 바로 00 준비 진단과 1번 실습으로 넘어간다.

다음 모듈: 00 준비 · 진단평가와 실습 준비 →
Module 00checkpoint필수

00 준비 · 진단평가와 실습 준비

준비 · 0–5분 (5분) · 현재 AI 활용 경험과 실습 준비 상태를 확인하고 같은 과정의 첫 실습으로 이동한다.

1 steps

Step 1

진단 저장하고 첫 실습 시작

published

Step 1

진단 저장하고 첫 실습 시작

준비 · 00 준비 · 진단평가와 실습 준비 · 5분

목표

현재 AI 활용 경험과 실습 준비 상태를 확인하고 같은 과정의 첫 실습으로 이동한다.

시간

모듈 0–5분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 가입 후 학습 화면의 진단 12문항에 현재 경험을 선택한다. 한 화면에서 답하며 정답을 맞히는 시험이 아니다.

2. Claude Code 설치·Claude 계정 로그인이 되어 있는지 확인한다. 설치가 안 되면 강사에게 바로 알린다.

3. 실습 ZIP을 내려받아 압축을 푼다. claude-kosis-lab 폴더와 inbox·assets·skill-kit·work·output 위치를 확인한다.

4. 진단 저장하고 첫 실습 시작을 누른다. 이 과정의 01 실습으로 이어진다.

완료 기준

12문항의 답변이 저장되고 통계 보고서 첫 실습이 열린다.

막히면

이미 가입했다면 로그인으로 계속한다. 환경 문제가 있으면 강사 화면 또는 짝 실습으로 진행한다.

강사 진행 메모

0–5분 준비. 설치·로그인은 사전에 완료하도록 안내한다. 진단은 AI 경험 자기보고 설문이다. 준비 시간을 넘기면 강사 화면·짝 실습으로 전환한다.

첨부파일

2024년 1인가구 통계 실습 ZIP

전사 CSV·출처 안내·지도·차트·자체 제작 스킬 3개·PLAN/ACT 규칙 템플릿·HTML 예시가 들어 있습니다. 공식 PDF는 공식 링크에서 직접 받으세요.

claude-kosis-lab.zip

다운로드
다음 모듈: 왜 HTML인가 · 실제 통계자료와 결과물 이해 →
Module 01lesson필수

왜 HTML인가 · 실제 통계자료와 결과물 이해

1부 · 5–15분 (10분) · 오늘 만들 2024년 1인가구 지역 비교 HTML 보고서의 범위를 안다.

3 steps

Step 1

완성 보고서와 원문 보기

published

Step 1

완성 보고서와 원문 보기

1부 · 왜 HTML인가 · 실제 통계자료와 결과물 이해 · 3분

목표

오늘 만들 2024년 1인가구 지역 비교 HTML 보고서의 범위를 안다.

시간

모듈 5–15분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. examples/report-complete.html을 열어 요약·지도·차트·표·출처를 찾는다.

2. 국가데이터처 원문 PDF의 인쇄 10쪽과 같은 수치인지 비교한다.

3. 원문 전체 77쪽을 복제하지 않고 핵심 질문 한 개에 맞춰 재구성한다.

완료 기준

한 HTML 파일에 출처와 2024년 기준이 표시된다고 말한다.

막히면

원문 PDF가 열리지 않으면 inbox/source-notes.md와 준비된 10쪽 화면을 본다.

강사 진행 메모

완성 예시는 강사가 먼저 보여주고 새 실습은 아직 시작하지 않는다.

오늘의 수업과 원자료

00 준비(0–5분)와 1–8번 실습(5–120분)은 휴식 포함 120분 워크샵입니다. 3번 모듈 뒤 55–60분 휴식 5분을 둡니다. 9번 클릭형 지도(60분), 10번 스킬 찾기·설치·활용(45분), 11번 PLAN/ACT·CLAUDE.md(25분), 12번 grill-me 설치·호출(20분), 13번 memory_bank 기록·이어가기(25분), 14번 이후 기존 교안은 수업 후 선택 학습입니다.

Claude Code 설치·로그인을 사전에 완료하고 실습 ZIP을 풀어 claude-kosis-lab 폴더를 프로젝트로 엽니다. 자체 제작 스킬은 35–55분에 함께 설치합니다. 필수 결과물은 output/one-person-report.html 하나입니다.

통계는 국가데이터처의 2025년 발표 자료 중 2024년 전국·17개 시도 표입니다. CSV는 원문 10쪽을 교육용으로 전사한 가공본이며 KOSIS 원본 다운로드 파일이 아닙니다. 원본 PDF는 이용 조건에 따라 재배포하지 않고 공식 페이지에서 확인합니다.

첨부파일

2024년 1인가구 통계 실습 ZIP

전사 CSV·출처 안내·지도·차트·자체 제작 스킬 3개·PLAN/ACT 규칙 템플릿·HTML 예시가 들어 있습니다. 공식 PDF는 공식 링크에서 직접 받으세요.

claude-kosis-lab.zip

다운로드

첨부파일

국가데이터처 공식 원문 PDF

「2025 통계로 보는 1인가구」 인쇄 10쪽. 공식 사이트에서 직접 다운로드합니다. 발표연도 2025, 사용 수치 기준연도 2024를 구분하세요.

2025-one-person-households-official.pdf

다운로드

첨부파일

Base64 한국 지도·차트 내장 완성 보고서

공식 수치로 새로 제작한 한국 지도와 차트를 HTML 안에 내장한 교육용 완성 예시입니다.

report-complete.html

다운로드
Step 2

숫자의 분모 확인

published

Step 2

숫자의 분모 확인

1부 · 왜 HTML인가 · 실제 통계자료와 결과물 이해 · 4분

목표

비율과 분포를 구분한다.

시간

모듈 5–15분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. inbox/2024-regional-households.csv의 단위가 천 가구와 %임을 찾는다.

2. 서울 39.9%는 서울 가구 중 1인가구의 비율임을 읽는다.

3. 서울 20.6%는 전국 1인가구 중 서울에 있는 가구의 몫으로 다른 지표임을 확인한다.

완료 기준

비교표에는 39.9%와 같은 지역 내 비율만 사용한다.

막히면

숫자가 혼동되면 PDF 10쪽 표 제목과 9쪽 분포 차트를 나란히 본다.

강사 진행 메모

2025는 보도자료 제목·발표연도, 실습 통계는 2024년 기준이다.

첨부파일

2024년 전국·17개 시도 전사 CSV

국가데이터처 보고서 인쇄 10쪽의 숫자를 교육용으로 전사한 파일입니다. KOSIS 원본 CSV가 아닙니다.

2024-regional-households.csv

다운로드
Step 3

자료 기반 요청 만들기

published

Step 3

자료 기반 요청 만들기

1부 · 왜 HTML인가 · 실제 통계자료와 결과물 이해 · 3분

목표

대상·목적·제약·완료 기준이 있는 요청을 구성한다.

시간

모듈 5–15분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 아래 계획 요청을 읽는다.

2. 원본 보존과 출처 표시 조건을 표시한다.

3. 새 파일은 다음 모듈에서 만든다.

Claude Code에 붙여넣기

inbox/source-notes.md와 inbox/2024-regional-households.csv를 읽고 전국과 시도별 1인가구 비율을 비교하는 HTML 보고서 계획을 제안해 주세요. 2024년 수치만 사용하고, 비율과 분포를 혼동하지 마세요. 출처가 없는 원인·정책 효과는 추정하지 말고 아직 파일을 만들지 마세요.

완료 기준

요청에 입력 파일, 독자, 기준연도, 금지할 추론이 있다.

막히면

길면 강사 요청문을 그대로 복사한다.

강사 진행 메모

본문 작성보다 원본 자료를 구분하는 습관이 핵심이다.

다음 모듈: Claude Code 첫 실행과 자료 정리 →
Module 02practice필수

Claude Code 첫 실행과 자료 정리

1부 · 15–35분 (20분) · Claude Code가 읽는 로컬 파일의 위치를 확인한다.

3 steps

Step 1

실습 폴더 열고 자료 목록 확인

published

Step 1

실습 폴더 열고 자료 목록 확인

1부 · Claude Code 첫 실행과 자료 정리 · 6분

목표

Claude Code가 읽는 로컬 파일의 위치를 확인한다.

시간

모듈 15–35분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. ZIP을 풀고 claude-kosis-lab 폴더에서 Claude Code를 실행한다.

2. inbox, assets, skill-kit, work, output 폴더를 찾는다.

3. 원본 CSV와 차트·지도 PNG는 읽기만 한다.

Claude Code에 붙여넣기

현재 프로젝트의 최상위 폴더와 inbox의 파일을 나열해 주세요. 2024-regional-households.csv의 열 이름과 행 수를 알려주세요. 파일을 바꾸거나 새 파일을 만들지 마세요.

완료 기준

전국+17개 시도 18행, 열 4개가 확인된다.

막히면

로그인 문제가 3분 넘으면 강사 화면/짝 실습으로 전환한다.

강사 진행 메모

사전 설치·로그인 완료 전제. 승인 화면은 실제 변경 대상과 명령을 읽는다.

첨부파일

2024년 1인가구 통계 실습 ZIP

전사 CSV·출처 안내·지도·차트·자체 제작 스킬 3개·PLAN/ACT 규칙 템플릿·HTML 예시가 들어 있습니다. 공식 PDF는 공식 링크에서 직접 받으세요.

claude-kosis-lab.zip

다운로드
Step 2

출처가 있는 첫 요약 파일

published

Step 2

출처가 있는 첫 요약 파일

1부 · Claude Code 첫 실행과 자료 정리 · 8분

목표

원자료를 읽고 근거가 남는 작업 파일을 만든다.

시간

모듈 15–35분 중 이 단계 8분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 계획 요청을 실행한다.

2. 아래 요청으로 work/first-summary.md를 만든다.

3. 전국 36.1%, 서울 39.9%, 대전 39.8%, 울산 31.6%를 원문과 대조한다.

Claude Code에 붙여넣기

inbox/source-notes.md와 inbox/2024-regional-households.csv를 읽어 work/first-summary.md를 만들어 주세요. 2024년 전국 비율, 상위 3개 지역, 낮은 2개 지역, 수치의 단위·분모·원문 10쪽을 적으세요. CSV에 없는 변화율·원인·정책 제안은 쓰지 마세요. inbox 원본은 수정하지 마세요.

완료 기준

요약 파일에 수치와 원문 링크가 있고 비율/분포가 구분된다.

막히면

파일이 없으면 현재 폴더와 저장 경로를 확인한다.

강사 진행 메모

첫 파일 생성 승인과 결과 확인을 각각 경험하게 한다.

Step 3

잘못된 해석 한 문장 고치기

published

Step 3

잘못된 해석 한 문장 고치기

1부 · Claude Code 첫 실행과 자료 정리 · 6분

목표

같은 파일의 일부만 수정하고 근거를 유지한다.

시간

모듈 15–35분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 요약에서 서울 비율 문장을 찾는다.

2. 전국 대비 분포처럼 읽히지 않도록 한 문장만 고친다.

3. 숫자 4개가 바뀌지 않았는지 비교한다.

Claude Code에 붙여넣기

work/first-summary.md에서 서울 39.9%의 분모를 서울의 전체 일반가구라고 분명하게 고쳐 주세요. 다른 수치와 출처는 바꾸지 마세요. 수정 전후 문장만 알려주세요.

완료 기준

서울 39.9%의 의미가 정확하고 다른 수치는 유지된다.

막히면

다른 값이 바뀌면 CSV와 원문 10쪽으로 복원한다.

강사 진행 메모

후속 요청은 재작성보다 제한된 수정으로 연습한다.

다음 모듈: 통계 원고 스킬 설치·실행 →
Module 03practice필수

통계 원고 스킬 설치·실행

1부 · 35–55분 (20분) · 자료 재구성 절차를 담은 SKILL.md를 이해한다.

3 steps

Step 1

스킬 지침 읽기

published

Step 1

스킬 지침 읽기

1부 · 통계 원고 스킬 설치·실행 · 5분

목표

자료 재구성 절차를 담은 SKILL.md를 이해한다.

시간

모듈 35–55분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. skill-kit/stat-brief/SKILL.md를 연다.

2. 입력·출력·수치 검증·금지할 해석을 찾는다.

3. 스킬은 자체 제작 교육 자료임을 확인한다.

Claude Code에 붙여넣기

skill-kit/stat-brief/SKILL.md를 읽고 입력, 출력, 수치 검수 규칙을 세 문장으로 설명해 주세요. 아직 설치하거나 실행하지 마세요.

완료 기준

스킬이 work/content.md를 만들고 숫자에 출처를 붙인다고 설명한다.

막히면

길면 입력·출력·금지사항만 확인한다.

강사 진행 메모

공식 내장 스킬로 소개하지 않는다.

첨부파일

통계 원고 스킬 원본

자체 제작 stat-brief 스킬. ZIP의 skill-kit에도 포함돼 있습니다.

SKILL.md

다운로드
Step 2

프로젝트 범위에 설치

published

Step 2

프로젝트 범위에 설치

1부 · 통계 원고 스킬 설치·실행 · 7분

목표

스킬을 현재 실습 폴더에만 배치한다.

시간

모듈 35–55분 중 이 단계 7분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 아래 요청으로 .claude/skills/stat-brief/SKILL.md를 만든다.

2. 파일과 frontmatter의 name을 확인한다.

3. Claude Code 세션을 다시 시작한다.

Claude Code에 붙여넣기

skill-kit/stat-brief/SKILL.md를 현재 프로젝트의 .claude/skills/stat-brief/SKILL.md로 복사해 주세요. 대상이 있으면 덮어쓰지 말고 알려주세요. 전역 스킬·다른 파일·패키지는 변경하지 마세요. 설치 경로와 name을 확인해 주세요.

완료 기준

프로젝트 스킬 파일이 존재하며 name이 stat-brief다.

막히면

스킬 목록에 없으면 경로를 확인하고 세션을 다시 연다.

강사 진행 메모

설치는 파일 배치만 한다. Git·Python·MCP를 추가하지 않는다.

Step 3

원고 생성과 출처 대조

published

Step 3

원고 생성과 출처 대조

1부 · 통계 원고 스킬 설치·실행 · 8분

목표

같은 통계로 HTML용 원고를 만든다.

시간

모듈 35–55분 중 이 단계 8분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. /stat-brief를 호출한다.

2. work/content.md의 수치·분모·출처를 CSV와 대조한다.

3. 결론은 관찰 사실까지만 쓴다.

Claude Code에 붙여넣기

/stat-brief inbox/2024-regional-households.csv inbox/source-notes.md

완료 기준

work/content.md에 보고서 제목, 핵심 발견, 비교표, 해석 한계, 출처가 있다.

막히면

호출이 안 되면 SKILL.md를 직접 읽고 같은 절차로 실행하도록 요청한다.

강사 진행 메모

55–60분은 휴식. 원고는 2부의 단일 입력이다.

휴식 55–60분

5분간 쉬고 돌아옵니다. 환경 문제는 강사에게 알려 주세요. 휴식 중 새 설치나 새 과제를 시작하지 않습니다.

다음 모듈: 왜 보고서를 HTML로 만드는가 →
Module 04lesson필수

왜 보고서를 HTML로 만드는가

2부 · 60–70분 (10분) · 내용과 표현을 나눠 생각한다.

3 steps

Step 1

원고·표·이미지의 역할

published

Step 1

원고·표·이미지의 역할

2부 · 왜 보고서를 HTML로 만드는가 · 4분

목표

내용과 표현을 나눠 생각한다.

시간

모듈 60–70분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. work/content.md와 완성 예시를 나란히 본다.

2. 핵심 수치, 비교표, 지도·차트 PNG, 출처가 HTML 어디에 놓였는지 찾는다.

3. 브라우저에서 읽고 인쇄 미리보기도 확인한다.

완료 기준

HTML이 내용·표·이미지·스타일을 한 문서로 묶는다고 설명한다.

막히면

태그 문법 강의는 생략한다.

강사 진행 메모

원문 PDF의 디자인을 복제하는 과제가 아니다.

Step 2

출력 형식별 쓰임

published

Step 2

출력 형식별 쓰임

2부 · 왜 보고서를 HTML로 만드는가 · 3분

목표

HTML을 기준 원고로 활용하는 경로를 안다.

시간

모듈 60–70분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 브라우저 인쇄→PDF를 확인한다.

2. PPT·DOCX는 목적별 재구성이라고 구분한다.

3. HWPX는 기관 양식에 핵심 내용을 다시 넣는 확장 예라고 이해한다.

완료 기준

HTML→PDF와 PPT/DOCX/HWPX 재구성의 차이를 설명한다.

막히면

실습 도구 설치나 변환은 후반 시연으로 넘긴다.

강사 진행 메모

모든 서식이 손실 없이 보존된다고 말하지 않는다.

Step 3

제작 범위 확정

published

Step 3

제작 범위 확정

2부 · 왜 보고서를 HTML로 만드는가 · 3분

목표

20분 안에 만들 보고서 구성 요소를 고정한다.

시간

모듈 60–70분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 제목·기준연도·3개 핵심 수치·지역 표·지도·차트·해석·출처만 남긴다.

2. 원인 분석, 지역 정책 처방, 실시간 데이터 갱신은 제외한다.

3. 지도와 차트는 먼저 상대경로로 연결한다.

Claude Code에 붙여넣기

work/content.md와 inbox/2024-regional-households.csv를 기준으로 output/one-person-report.html 제작 계획을 제안해 주세요. 기준은 2024년, 지역 내 1인가구 비율만 비교합니다. 제목·요약·지역 표·assets/region-chart.png와 assets/korea-one-person-map.png 이미지·출처를 넣고 CSS는 HTML 안에 두세요. 아직 파일은 만들지 마세요.

완료 기준

고정된 데이터/디자인 범위의 계획이 나온다.

막히면

계획이 크면 1열·정적 문서로 축소한다.

강사 진행 메모

2부는 같은 파일 한 개를 계속 개선한다.

다음 모듈: 실제 통계 HTML 보고서 만들기 →
Module 05practice필수

실제 통계 HTML 보고서 만들기

2부 · 70–90분 (20분) · 출처가 표시된 보고서 파일을 만든다.

3 steps

Step 1

첫 보고서 HTML 생성

published

Step 1

첫 보고서 HTML 생성

2부 · 실제 통계 HTML 보고서 만들기 · 9분

목표

출처가 표시된 보고서 파일을 만든다.

시간

모듈 70–90분 중 이 단계 9분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 아래 요청으로 output/one-person-report.html을 만든다.

2. 브라우저에서 열어 요약·표·지도·차트·출처를 확인한다.

3. 원문 수치 36.1·39.9·39.8·31.6을 대조한다.

Claude Code에 붙여넣기

work/content.md와 inbox/2024-regional-households.csv로 output/one-person-report.html을 만드세요. 제목은 2024년 1인가구 지역 비교 보고서입니다. 전국 36.1%, 서울 39.9%, 대전 39.8%, 울산 31.6%를 포함하고 17개 시도 표를 만드세요. ../assets/region-chart.png와 ../assets/korea-one-person-map.png를 각각 alt 설명과 함께 넣으세요. CSS는 style에 넣고 모바일과 인쇄를 고려하세요. 수치의 분모·단위·국가데이터처 원문 링크·인쇄 10쪽을 적으세요. 근거 없는 원인은 쓰지 마세요. 다른 파일은 수정하지 마세요.

완료 기준

HTML이 열리고 17개 지역 표, 지도, 차트, 원문 링크가 보인다.

막히면

생성이 지연되면 examples/report-starter.html을 복사해 이어간다.

강사 진행 메모

AI의 완료 보고만 믿지 않고 브라우저를 수강생이 직접 연다.

첨부파일

상대경로 지도·차트가 있는 시작 보고서

생성이 막히면 이 HTML을 사용합니다. ZIP과 함께 열어야 이미지가 표시됩니다.

report-starter.html

다운로드

첨부파일

공식 수치로 새로 만든 차트 PNG

국가데이터처 원문 10쪽의 공개 수치를 새로 시각화했습니다. Base64 실습에서 사용합니다.

region-chart.png

다운로드

첨부파일

2024년 1인가구 비율 한국 지도 PNG

17개 시도 공개 통계와 출처가 확인된 시도 경계로 새로 만든 인포그래픽입니다. Base64 실습에서 차트와 함께 내장합니다.

korea-one-person-map.png

다운로드
Step 2

표와 문장 디자인 수정

published

Step 2

표와 문장 디자인 수정

2부 · 실제 통계 HTML 보고서 만들기 · 7분

목표

같은 파일에서 읽기 어려운 부분만 개선한다.

시간

모듈 70–90분 중 이 단계 7분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 표의 단위와 모바일 너비를 확인한다.

2. 숫자 정렬, 글자 크기, 인쇄 여백만 수정한다.

3. 수치와 출처가 변하지 않았는지 확인한다.

Claude Code에 붙여넣기

output/one-person-report.html의 디자인만 수정해 주세요. 제목과 핵심 수치를 먼저 읽게 하고 표는 좁은 화면에서 가로 스크롤되게 하세요. 본문은 16px 이상, 표 숫자는 오른쪽 정렬하세요. 2024년 수치, 이미지 경로, 출처·해석 문장은 바꾸지 마세요.

완료 기준

디자인이 나아지고 사실 정보는 그대로다.

막히면

차이가 안 보이면 저장한 파일과 브라우저 주소를 확인한다.

강사 진행 메모

개인별 디자인 수정은 한 번만 한다.

Step 3

원문과 대조해 검수

published

Step 3

원문과 대조해 검수

2부 · 실제 통계 HTML 보고서 만들기 · 4분

목표

표의 숫자와 해석을 원자료로 검수한다.

시간

모듈 70–90분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 전국·서울·대전·경기·울산의 수치를 CSV와 대조한다.

2. 전국 36.1%의 분모와 지역별 비율의 분모를 확인한다.

3. KOSIS 화면의 최신 연도 숫자를 가져오지 않았는지 찾는다.

Claude Code에 붙여넣기

output/one-person-report.html의 모든 수치를 inbox/2024-regional-households.csv와 비교해 주세요. 불일치가 있으면 파일·행·원값·보고서값을 표로 제시하고, 근거 없는 인과 표현을 찾아주세요. 원본 CSV는 수정하지 마세요.

완료 기준

불일치 0건 또는 위치가 적힌 수정 목록이 나온다.

막히면

교차 검수가 오래 걸리면 5개 주요 행과 출처만 확인한다.

강사 진행 메모

CSV는 보고서 원문 10쪽에서 전사한 교육용 가공본임을 명시한다.

다음 모듈: Base64 이미지 내장과 단일 HTML →
Module 06practice필수

Base64 이미지 내장과 단일 HTML

2부 · 90–105분 (15분) · 상대경로 이미지가 폴더 이동 시 끊길 수 있음을 안다.

3 steps

Step 1

이미지 경로의 한계 확인

published

Step 1

이미지 경로의 한계 확인

2부 · Base64 이미지 내장과 단일 HTML · 4분

목표

상대경로 이미지가 폴더 이동 시 끊길 수 있음을 안다.

시간

모듈 90–105분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. HTML을 이미지 파일 없이 다른 폴더로 복사해 지도와 차트가 보이는지 확인한다.

2. ../assets/region-chart.png와 ../assets/korea-one-person-map.png 경로를 찾는다.

3. Base64가 이미지 바이트를 HTML 안에 넣는 방식임을 이해한다.

완료 기준

이동한 HTML에서 두 이미지가 안 보일 수 있는 이유를 설명한다.

막히면

브라우저 캐시가 남으면 새 탭이나 다른 폴더에서 확인한다.

강사 진행 메모

지도와 차트는 원본 PDF 그림 복사가 아닌 공개 수치로 새로 만든 PNG다.

첨부파일

공식 수치로 새로 만든 차트 PNG

국가데이터처 원문 10쪽의 공개 수치를 새로 시각화했습니다. Base64 실습에서 사용합니다.

region-chart.png

다운로드

첨부파일

2024년 1인가구 비율 한국 지도 PNG

17개 시도 공개 통계와 출처가 확인된 시도 경계로 새로 만든 인포그래픽입니다. Base64 실습에서 차트와 함께 내장합니다.

korea-one-person-map.png

다운로드
Step 2

지도·차트 PNG를 Base64로 내장

published

Step 2

지도·차트 PNG를 Base64로 내장

2부 · Base64 이미지 내장과 단일 HTML · 7분

목표

두 PNG를 data URI로 같은 HTML에 넣는다.

시간

모듈 90–105분 중 이 단계 7분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 아래 요청으로 img src만 바꾼다.

2. HTML의 data:image/png;base64, 접두부를 확인한다.

3. 지도·차트와 수치가 원래와 동일한지 확인한다.

Claude Code에 붙여넣기

assets/region-chart.png와 assets/korea-one-person-map.png를 Base64로 인코딩해 output/one-person-report.html의 각 img src에 data:image/png;base64,... 형태로 직접 넣어 주세요. 이미지 alt, 표, 수치, 출처, CSS는 변경하지 마세요. 원본 PNG와 CSV는 그대로 두세요. 인코딩 후 이미지 표시를 확인하고 파일 크기도 알려주세요.

완료 기준

두 img src가 data URI이고 지도와 차트가 표시된다.

막히면

수정에 실패하면 examples/report-complete.html에서 data URI 형식을 확인한다.

강사 진행 메모

Base64는 파일 크기가 늘어날 수 있음을 함께 설명한다.

첨부파일

Base64 한국 지도·차트 내장 완성 보고서

공식 수치로 새로 제작한 한국 지도와 차트를 HTML 안에 내장한 교육용 완성 예시입니다.

report-complete.html

다운로드
Step 3

진짜 단일 파일인지 확인

published

Step 3

진짜 단일 파일인지 확인

2부 · Base64 이미지 내장과 단일 HTML · 4분

목표

이미지 폴더 없이 HTML만 옮겨 검증한다.

시간

모듈 90–105분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 완성 HTML을 빈 폴더에 복사해 연다.

2. 지도·차트·표·한글·출처가 보이는지 확인한다.

3. 네트워크를 꺼도 화면이 구성되는지 점검한다.

Claude Code에 붙여넣기

output/one-person-report.html에 외부 이미지·CSS·글꼴·스크립트 참조가 남았는지 검사해 주세요. 지도와 차트 두 img 모두 data:image/png;base64로 시작해야 합니다. HTML만 복사해도 보이는지 확인 방법을 안내하고, 파일은 더 수정하지 마세요.

완료 기준

HTML 파일 하나만으로 지도·차트와 본문이 표시된다.

막히면

이미지가 깨지면 인코딩 범위와 data URI 접두부를 확인한다.

강사 진행 메모

원문 하이퍼링크는 참고 링크로 남아도 표시 자산의 외부 의존은 없다.

다음 모듈: PDF·PPT·DOCX·HWPX·Figma 활용 →
Module 07lesson필수

PDF·PPT·DOCX·HWPX·Figma 활용

2부 · 105–115분 (10분) · 브라우저 인쇄로 보이는 결과를 PDF로 저장한다.

3 steps

Step 1

HTML에서 PDF로

published

Step 1

HTML에서 PDF로

2부 · PDF·PPT·DOCX·HWPX·Figma 활용 · 3분

목표

브라우저 인쇄로 보이는 결과를 PDF로 저장한다.

시간

모듈 105–115분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 완성 HTML에서 인쇄 미리보기를 연다.

2. 지도·차트와 표가 페이지 경계에서 잘리지 않는지 확인한다.

3. PDF 저장은 선택 시연으로 마친다.

완료 기준

인쇄 미리보기에서 출처와 지도·차트가 보인다.

막히면

페이지가 길면 가로 표와 여백을 줄인다.

강사 진행 메모

PDF 수치도 원문을 다시 확인한다.

Step 2

PPT·DOCX·HWPX 재구성

published

Step 2

PPT·DOCX·HWPX 재구성

2부 · PDF·PPT·DOCX·HWPX·Figma 활용 · 4분

목표

같은 원고를 출력 목적별로 다시 설계한다.

시간

모듈 105–115분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. PPT: 핵심 발견 3장, DOCX: 제목·본문·표 구조를 설명한다.

2. HWPX: 기존 기관 양식에 검증된 수치와 출처를 넣는 흐름을 본다.

3. 변환 후 제목·표·출처·폰트를 재검수한다.

강사 시연 / 수업 후 활용 요청문

work/content.md와 output/one-person-report.html을 기준으로 이 내용을 3장 발표자료, Word 보고서, 기관 HWPX 양식에 각각 어떻게 재구성할지 목차와 검수표만 제안해 주세요. 실제 파일은 만들지 마세요. 2024년 수치와 출처를 유지하세요.

완료 기준

형식별 재구성안과 확인 항목이 있다.

막히면

도구가 없으면 완성 화면과 비교표로 시연한다.

강사 진행 메모

RHWP·관련 스킬은 도구 연결 시연 후보이며 무손실 변환은 보장하지 않는다.

형식별 활용 경로

형식재구성확인할 것
PPTX핵심 발견·차트·활용 한계의 3장 발표자료기준연도·숫자·출처·텍스트 넘침
DOCX제목·요약·지역 표가 있는 편집 문서제목 스타일·표·이미지
HWPX검증된 수치와 차트를 기존 기관 양식에 넣기기관 양식·표·쪽수·저장 후 재열기

RHWP·관련 AI 스킬은 가능한 연결 도구이지만 설치만으로 서식 보존이 보장되지는 않습니다. 이 구간은 변환 결과를 준비했을 때만 시연합니다.

Step 3

Figma 연결 범위

published

Step 3

Figma 연결 범위

2부 · PDF·PPT·DOCX·HWPX·Figma 활용 · 3분

목표

디자인 협업으로 확장할 때 파일과 레이어를 구분한다.

시간

모듈 105–115분 중 이 단계 3분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 완성 HTML 화면을 시안 참고 자료로 공유하는 흐름을 설명한다.

2. Figma의 디자인 컨텍스트로 새 HTML을 구현하는 반대 방향도 설명한다.

3. 자동 동기화라고 소개하지 않는다.

완료 기준

Figma 연동은 별도 도구·계정 조건과 검수가 필요하다고 말한다.

막히면

연결 환경이 없으면 흐름도만 사용한다.

강사 진행 메모

이 수업 필수 결과물은 HTML 한 파일이다.

Figma 연결 흐름

HTML 화면 → 캡처·연계 도구 → Figma 프레임·텍스트·이미지 레이어

반대 방향은 Figma 디자인 컨텍스트 → AI의 새로운 HTML/CSS 구현입니다. 두 방향은 원본 자동 동기화가 아닙니다. 강사가 계정·도구를 사전 확인하지 못했으면 이 흐름으로 설명합니다.

다음 모듈: 검수·공유 준비와 업무 적용 →
Module 08lesson필수

검수·공유 준비와 업무 적용

2부 · 115–120분 (5분) · 제출 전 핵심 수치를 확인한다.

3 steps

Step 1

수치 최종 체크

published

Step 1

수치 최종 체크

2부 · 검수·공유 준비와 업무 적용 · 2분

목표

제출 전 핵심 수치를 확인한다.

시간

모듈 115–120분 중 이 단계 2분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 전국 36.1, 서울 39.9, 대전 39.8, 울산 31.6을 확인한다.

2. 2024 기준·천 가구·출처 링크를 확인한다.

완료 기준

근거 없는 원인 문장이 없다.

막히면

해석이 의심되면 관찰 사실만 남긴다.

강사 진행 메모

결과물을 공식 통계 간행물로 오해받지 않게 교육용 재구성을 표시한다.

Step 2

파일 하나 검증

published

Step 2

파일 하나 검증

2부 · 검수·공유 준비와 업무 적용 · 2분

목표

단일 HTML의 이식성을 확인한다.

시간

모듈 115–120분 중 이 단계 2분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 지도·차트 img의 Base64 여부를 확인한다.

2. 파일을 빈 폴더에서 열어 본다.

3. 브라우저 인쇄 미리보기를 확인한다.

완료 기준

별도 이미지 파일 없이 보고서를 볼 수 있다.

막히면

파일이 너무 크면 이미지 해상도를 점검한다.

강사 진행 메모

ZIP은 원자료·연습용이고 최종 제출물은 HTML이다.

Step 3

내 업무에 적용

published

Step 3

내 업무에 적용

2부 · 검수·공유 준비와 업무 적용 · 1분

목표

다음 적용 자료를 고른다.

시간

모듈 115–120분 중 이 단계 1분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 회사 자료 하나를 고른다.

2. 민감 정보 여부와 공개 가능 범위를 확인한다.

3. HTML 결과물과 출처 검수 기준을 한 줄로 적는다.

완료 기준

본인 업무 자료와 검수 기준이 하나씩 정해진다.

막히면

개인 자료를 오늘 업로드할 필요는 없다.

강사 진행 메모

질문은 수업 후 보충 학습으로 연결한다.

다음 모듈: 심화 · 클릭하면 움직이는 한국 지도 만들기 →
Module 09practice

심화 · 클릭하면 움직이는 한국 지도 만들기

3부 · 0–60분 (60분) · 눌러 보고 기능을 부품 단위로 나눈다.

7 steps

Step 1

완성된 인터랙티브 지도 뜯어보기

published

Step 1

완성된 인터랙티브 지도 뜯어보기

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 6분

목표

눌러 보고 기능을 부품 단위로 나눈다.

시간

모듈 0–60분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. examples/report-complete.html을 열고 지도의 여러 지역과 순위 목록을 눌러 본다.

2. 눌렀을 때 바뀌는 것을 5가지 이상 적는다. (강조, 순위, 숫자, 게이지, 막대 등)

3. 화면을 지도·상세 패널·순위 목록 세 부품으로 나누고, 지금 선택된 지역을 기억하는 곳이 한 군데임을 확인한다.

Claude Code에 붙여넣기

examples/report-complete.html을 읽고 한국 지도 인포그래픽 부분만 분석해 주세요. 지도, 상세 패널, 순위 목록이 각각 어떤 데이터를 쓰는지, 지역을 클릭하면 어떤 순서로 화면이 바뀌는지 표로 정리해 주세요. 파일은 수정하지 마세요.

완료 기준

부품 3개와 클릭 후 변화 5개 이상을 말할 수 있다.

막히면

화면이 열리지 않으면 강사 화면을 보며 같은 표를 채운다.

강사 진행 메모

이 단계는 만들지 않고 읽기만 한다. "클릭 → 상태 변경 → 화면 갱신"이라는 흐름 한 줄을 판서한다.

첨부파일

인터랙티브 지도 완성 보고서

클릭하면 인구와 그래프가 움직이는 지도가 들어 있는 완성 예시입니다. 브라우저로 열어 눌러 보세요.

report-complete.html

다운로드
Step 2

지도 데이터 이해: SVG 경로와 통계 연결

published

Step 2

지도 데이터 이해: SVG 경로와 통계 연결

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 8분

목표

지도가 그림이 아니라 지역별 도형 데이터임을 이해한다.

시간

모듈 0–60분 중 이 단계 8분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. assets/korea-sido-paths.json을 열어 regions의 name, d, lx, ly를 확인한다.

2. d는 SVG path 좌표이고 lx, ly는 지역 이름 글자 위치임을 알아둔다.

3. JSON의 17개 지역 이름이 inbox/2024-regional-households.csv의 지역 열과 같은지 대조한다.

Claude Code에 붙여넣기

assets/korea-sido-paths.json과 inbox/2024-regional-households.csv를 읽어 주세요. 1) viewBox와 각 항목(name, d, lx, ly)의 뜻을 초보자 말로 설명하고 2) 두 파일의 지역 이름 17개가 정확히 일치하는지 확인해 주세요. 3) 지도 경계는 2023년, 통계는 2024년이라는 점을 주의 문구로 제안해 주세요. 파일은 바꾸지 마세요.

완료 기준

지역 이름 17개가 두 파일에서 일치하고 경계 연도와 통계 연도의 차이를 설명한다.

막히면

이름이 하나라도 다르면 CSV 이름(서울, 부산 등)을 기준으로 JSON을 고치지 말고 Claude에게 불일치 목록만 요청한다.

강사 진행 메모

GeoJSON 원본(약 1.8MB)은 사용하지 않는다. 좌표를 단순화해 만든 경로 파일만 준다. 좌표 변환 원리는 "위도·경도를 화면 좌표로 옮긴 그림" 정도로 설명한다.

첨부파일

시도 경계 SVG 경로 JSON

2023년 시도 경계를 단순화한 17개 지역의 SVG 경로와 글자 위치입니다. 통계는 2024년 기준입니다.

korea-sido-paths.json

다운로드
Step 3

지도 그리기와 비율별 색상

published

Step 3

지도 그리기와 비율별 색상

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 10분

목표

17개 시도가 색으로 구분되는 정적 지도를 만든다.

시간

모듈 0–60분 중 이 단계 10분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. work/map-lab.html 한 파일에 SVG 지도를 만든다.

2. 비율을 4구간(34% 미만, 34–36, 36–38, 38 이상)으로 나눠 진할수록 높게 칠한다.

3. 범례와 지역 이름 글자를 넣고 서울과 울산의 색이 다른지 확인한다.

Claude Code에 붙여넣기

assets/korea-sido-paths.json과 inbox/2024-regional-households.csv를 사용해 work/map-lab.html 파일 하나를 만들어 주세요. 조건: 1) 각 지역을 SVG path로 그리고 지역 이름을 표시 2) 1인가구 비율을 34% 미만, 34–36%, 36–38%, 38% 이상 4구간의 파란색으로 칠하기 3) 범례 표시 4) 데이터는 스크립트 안의 객체 한 곳에 두기 5) 외부 라이브러리와 외부 이미지 없이 만들기. 아직 클릭 기능은 넣지 마세요.

완료 기준

17개 지역이 4가지 색으로 칠해지고 서울이 진한색, 울산이 연한색이다.

막히면

색이 모두 같으면 데이터 객체의 키와 path의 지역 이름이 일치하는지 Claude에게 확인시킨다.

강사 진행 메모

색 구간 기준을 수강생이 직접 바꿔 보게 하면 지도 색이 즉시 달라져 이해가 빠르다.

Step 4

클릭하면 상세 패널이 바뀌게

published

Step 4

클릭하면 상세 패널이 바뀌게

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 10분

목표

선택 상태 하나로 지도와 패널을 함께 바꾼다.

시간

모듈 0–60분 중 이 단계 10분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 지도 옆에 상세 패널을 추가한다. (지역명, 순위, 비율, 1인가구 수, 전체 가구 수)

2. 지역을 클릭하면 selected 상태가 바뀌고 패널과 지도 강조가 함께 바뀌게 한다.

3. "전국으로" 버튼으로 전국 평균 화면으로 돌아오게 한다.

Claude Code에 붙여넣기

work/map-lab.html을 이어서 수정해 주세요. 지도에서 지역을 클릭하면 오른쪽 패널이 그 지역의 순위, 1인가구 비율, 1인가구 수(천 가구), 전체 일반가구 수(천 가구)를 보여주게 해 주세요. 선택된 지역은 굵은 테두리로 강조하고, "전국으로" 버튼을 누르면 전국 36.1% 화면으로 돌아가게 해 주세요. 선택 처리는 select(name) 함수 하나로 만들고 애니메이션은 아직 넣지 마세요.

완료 기준

서울을 누르면 39.9%·1위, 울산을 누르면 31.6%·17위가 표시되고 "전국으로" 버튼이 동작한다.

막히면

클릭해도 안 바뀌면 브라우저 콘솔의 오류 문구를 그대로 Claude에게 붙여 넣는다.

강사 진행 메모

선택 상태를 여러 곳에 흩뿌려 저장하면 나중에 화면이 어긋난다. select 함수 한 곳에서 모두 갱신하는 구조를 강조한다.

Step 5

숫자·게이지·막대에 움직임 넣기

published

Step 5

숫자·게이지·막대에 움직임 넣기

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 12분

목표

값이 부드럽게 변하는 애니메이션을 추가한다.

시간

모듈 0–60분 중 이 단계 12분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 비율과 가구 수가 이전 값에서 새 값으로 올라가거나 내려가는 카운트업을 넣는다.

2. 도넛 게이지와 전체·1인가구 막대가 CSS transition으로 늘어나게 한다.

3. 전국 평균 대비 차이를 좌우 막대로 보여주고, 시스템에서 모션 줄이기를 켠 경우 애니메이션을 끈다.

Claude Code에 붙여넣기

work/map-lab.html에 움직임을 추가해 주세요. 1) 숫자가 이전 값에서 새 값으로 약 0.8초 동안 올라가는 카운트업 2) 비율만큼 채워지는 도넛 게이지 3) 전체 가구 대비 1인가구 막대가 늘어나는 효과 4) 선택한 지역이 살짝 커졌다 돌아오는 효과 5) 전국 평균 대비 차이(예: 서울 +3.8%p)를 좌우 막대로 표시. 시스템에서 모션 줄이기를 켠 사용자는 애니메이션 없이 바로 값이 바뀌게 해 주세요. 라이브러리 없이 CSS transition과 requestAnimationFrame만 사용하세요.

완료 기준

서울에서 울산으로 바꿀 때 숫자·게이지·막대가 함께 움직이고 서울은 전국보다 3.8%p 높다고 나온다.

막히면

움직임이 어색하면 "0.8초, 처음 빠르고 끝에서 느려지게"처럼 시간과 느낌을 말로 지정해 다시 요청한다.

강사 진행 메모

애니메이션은 이해를 돕는 정도로만 쓴다. 지속시간을 1초 이내로 유지하고 모션 줄이기 설정을 꼭 확인시킨다.

Step 6

순위 목록·툴팁·키보드 접근

published

Step 6

순위 목록·툴팁·키보드 접근

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 9분

목표

작은 지역도 고를 수 있고 마우스 없이도 쓰게 만든다.

시간

모듈 0–60분 중 이 단계 9분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 17개 시도를 높은 순으로 정렬한 순위 목록을 만들고 눌러서 지역을 선택하게 한다.

2. 지도 위에 마우스를 올리면 지역명과 비율이 툴팁으로 나오게 한다.

3. Tab과 Enter로 지역을 선택하게 하고 화면 폭이 좁으면 1열로 바꾼다.

Claude Code에 붙여넣기

work/map-lab.html에 다음을 추가해 주세요. 1) 1인가구 비율이 높은 순서로 17개 시도 순위 목록. 항목을 누르면 지도와 같은 select 함수로 지역이 선택되고 막대 길이가 비율을 나타냄 2) 마우스를 올리면 지역명과 비율 툴팁 3) 지도의 각 지역을 Tab으로 이동하고 Enter나 Space로 선택하며 aria-label에 지역명과 비율 표시 4) 화면 폭 760px 이하에서는 지도와 패널을 세로 1열로 배치.

완료 기준

서울처럼 작은 지역도 순위 목록으로 선택할 수 있고 Tab+Enter로 선택할 수 있다.

막히면

모바일 배치가 깨지면 개발자 도구의 모바일 화면(폭 375px)을 보며 어떤 부분이 넘치는지 말해 준다.

강사 진행 메모

서울·인천·세종처럼 작은 지역은 지도에서 누르기 어렵다는 점이 순위 목록이 필요한 이유임을 짚는다.

Step 7

보고서에 합치고 단일 HTML로 검증

published

Step 7

보고서에 합치고 단일 HTML로 검증

3부 · 심화 · 클릭하면 움직이는 한국 지도 만들기 · 5분

목표

만든 지도를 보고서에 넣어 파일 하나로 완성한다.

시간

모듈 0–60분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. output/one-person-report.html의 PNG 지도 부분을 work/map-lab.html의 지도로 바꿔 output/one-person-report-interactive.html로 저장한다.

2. 지도의 CSS와 스크립트가 보고서 안에 함께 들어갔는지 확인한다.

3. 빈 폴더에 파일 하나만 복사해 열고, 서울 39.9·대전 39.8·울산 31.6·전국 36.1을 눌러 확인한다.

Claude Code에 붙여넣기

work/map-lab.html의 지도 기능을 output/one-person-report.html의 기존 PNG 지도 자리에 넣어 output/one-person-report-interactive.html로 새로 저장해 주세요. 원래 보고서 파일은 수정하지 마세요. 지도 CSS와 스크립트는 같은 HTML 안에 두고 외부 파일과 인터넷 주소에 의존하지 않게 해 주세요. 끝나면 서울·대전·울산·전국의 화면 수치를 CSV와 대조해 알려 주세요.

완료 기준

파일 하나만 다른 폴더에서 열어도 지도 클릭과 애니메이션이 동작하고 대표 수치 4개가 CSV와 일치한다.

막히면

합치다 깨지면 examples/report-complete.html을 기준으로 삼아 차이만 Claude에게 비교시킨다.

강사 진행 메모

완성본은 지도를 이미지가 아닌 SVG로 넣었기 때문에 Base64 이미지가 필요 없다는 점을 설명한다. 인쇄 미리보기까지 확인하면 마무리다.

다음 모듈: 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 →
Module 10practice

선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기

4부 · 0–45분 (45분) · 스킬을 반복 업무용 절차로 설명하고 프롬프트·CLAUDE.md·MCP와 구분한다.

5 steps

Step 1

스킬은 어떤 문제를 푸는가

published

Step 1

스킬은 어떤 문제를 푸는가

4부 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 · 6분

목표

스킬을 반복 업무용 절차로 설명하고 프롬프트·CLAUDE.md·MCP와 구분한다.

시간

모듈 0–45분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. skill-kit/stat-brief/SKILL.md를 열어 이름, 호출 조건(description), 작업 순서, 완료 기준을 찾는다.

2. 한 번만 할 일은 요청문, 이 프로젝트의 상시 규칙은 CLAUDE.md, 반복 절차는 스킬로 나눠 본다.

3. 스킬이 외부 데이터나 도구 연결 자체를 제공하는 것은 아님을 확인한다.

Claude Code에 붙여넣기

skill-kit/stat-brief/SKILL.md와 CLAUDE.md를 읽고 이 실습에서 일회성 요청문, 상시 프로젝트 규칙, 스킬, 외부 도구 연결이 각각 맡을 일을 4행 표로 설명해 주세요. 파일은 수정하지 마세요.

완료 기준

스킬은 필요할 때 불러 쓰는 SKILL.md 기반 절차이며, 데이터 접근 권한 자체가 아니라는 점을 설명한다.

막히면

용어가 어렵다면 “매번 설명할 절차를 저장한 사용 설명서”로 다시 말한다.

강사 진행 메모

WikiDocs의 정의는 설명 자료로 사용하고 설치 경로·호출 방식은 Claude Code 공식 문서와 대조한다.

첨부파일

2024년 1인가구 통계 실습 ZIP

전사 CSV·출처 안내·지도·차트·자체 제작 스킬 3개·PLAN/ACT 규칙 템플릿·HTML 예시가 들어 있습니다. 공식 PDF는 공식 링크에서 직접 받으세요.

claude-kosis-lab.zip

다운로드

읽을 자료

이 교안의 설명은 자료를 요약해 새로 쓴 것입니다. 위키독스의 별 표시는 인기도 기준이며 품질·안전 판정이 아닙니다.

Step 2

목록에서 내 업무에 맞는 스킬 고르기

published

Step 2

목록에서 내 업무에 맞는 스킬 고르기

4부 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 · 9분

목표

위키독스 목록을 실제 입력·산출물·의존성에 따라 고른다.

시간

모듈 0–45분 중 이 단계 9분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 위키독스 목차에서 글쓰기, HTML 디자인, 슬라이드, PDF, 스킬 제작, 설치 전 검사 항목을 찾아본다.

2. 아래 추천표에서 내 업무에 맞는 후보 두 개를 골라 “입력 → 산출물 → 추가 설치 → 검수”를 적는다.

3. 별 표시는 인기도 요약일 뿐 품질이나 안전 보증이 아님을 확인한다.

Claude Code에 붙여넣기

다음 스킬 후보 중 내 업무에 맞는 두 개를 골라 주세요: huashu-design, lecture-slide-make, markdown-to-pdf, humanizer, skill-creator, SkillSpector. 내 업무는 2024년 1인가구 HTML 보고서를 정확하게 재구성·발표하는 것입니다. 각 후보의 입력, 산출물, 필요한 도구, 보고서 수치·출처 검수 지점을 짧은 표로 정리하고 아직 설치하지 마세요.

완료 기준

후보 두 개를 이유와 함께 고르고 HTML 보고서에 바로 적용 가능한지 구분한다.

막히면

목록이 길면 HTML 디자인과 발표자료 두 항목만 비교한다.

강사 진행 메모

외부 스킬은 사용처 소개다. 저장소·라이선스·스크립트·의존성을 확인하지 않고 일괄 설치하지 않는다.

보고서 작업에 연결해 볼 스킬 7개

후보언제 유용한가설치 전 확인소개·원본
huashu-designHTML 시안·발표 덱의 디자인 방향을 비교할 때참조·스크립트 폴더 전체와 내보내기 의존성가이드 · 원본
lecture-slide-make같은 원고로 편집 가능한 교육용 PPTX를 만들 때Python, python-pptx·Pillow, 폰트와 슬라이드 검수가이드 · 원본
markdown-to-pdf별도 Markdown 원고를 PDF로 출력할 때Node.js·Chrome 필요. 이번 HTML 보고서는 브라우저 인쇄가 우선가이드 · 원본
humanizer기계적인 홍보 문장 초안을 다듬을 때영어 중심 패턴이며 숫자·출처 보존을 별도 확인가이드 · 원본
korean-writing-style한국어 보고서의 번역투를 점검할 때원본 저장소의 이용 허락·Windows 검사 명령 확인가이드 · 원본
skill-creator반복 업무를 우리 팀의 스킬로 만들 때Claude Code 플러그인 묶음과 평가 도구 조건가이드 · 원본
SkillSpector외부 스킬을 설치하기 전 위험 신호를 살필 때정적 검사 도구이며 기본 LLM 분석의 전송 범위가이드 · 원본

수업에서 실제 설치하는 것은 ZIP에 든 자체 제작 report-audit입니다. 위 후보는 목적과 의존성을 비교해 한 개를 고릅니다. 원본 저장소를 검토하기 전 자동 설치 명령을 실행하지 않습니다.

Step 3

프로젝트 스킬 설치와 호출 확인

published

Step 3

프로젝트 스킬 설치와 호출 확인

4부 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 · 10분

목표

검토된 자체 스킬을 Windows PowerShell에서 프로젝트 범위로 설치한다.

시간

모듈 0–45분 중 이 단계 10분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 실습 ZIP의 skill-kit/report-audit/SKILL.md를 읽고 파일 변경·외부 전송 지시가 없는지 확인한다.

2. 아래 PowerShell 두 명령으로 .claude/skills/report-audit/SKILL.md에 복사한다.

3. Claude Code의 /skills에서 report-audit를 찾고, 보이지 않으면 /reload-skills 후 다시 확인한다.

PowerShell 명령 → Claude Code 확인

PowerShell에서 다음을 차례로 실행하세요.
New-Item -ItemType Directory -Force -Path ".claude/skills/report-audit"
Copy-Item -LiteralPath "skill-kit/report-audit/SKILL.md" -Destination ".claude/skills/report-audit/SKILL.md" -Force
설치 뒤 Claude Code에서 /skills를 열어 report-audit가 있는지 확인하세요. 처음 만든 상위 skills 폴더라 보이지 않으면 /reload-skills를 실행하세요.

완료 기준

.claude/skills/report-audit/SKILL.md가 있고 /report-audit 호출이 인식된다.

막히면

CLI가 없으면 강사의 화면에서 경로와 SKILL.md 머리말을 확인하고, 보고서 검수 절차만 따라 한다.

강사 진행 메모

개인 설치는 사용자 홈의 ~/.claude/skills, 프로젝트 설치는 현재 폴더의 .claude/skills다. 이 수업은 다른 프로젝트에 영향을 주지 않는 프로젝트 설치를 쓴다.

첨부파일

보고서 검수용 report-audit 스킬 원본

실습 ZIP의 skill-kit에도 있는 자체 제작 SKILL.md입니다. 프로젝트 범위로 설치합니다.

SKILL.md

다운로드

설치 위치와 확인

  • 프로젝트만: 현재 실습 폴더의 .claude/skills/report-audit/SKILL.md — 이 수업에서 사용합니다.
  • 내 모든 로컬 프로젝트: 사용자 홈의 ~/.claude/skills/<이름>/SKILL.md — 공유 PC에서는 쓰지 않습니다.
  • 외부 저장소는 같은 이름이라도 내용과 스크립트가 다를 수 있습니다. SKILL.md, 동봉 파일, 실행 명령을 먼저 읽습니다.
  • 설치 뒤 Claude Code의 /skills 목록과 /report-audit 호출로 인식 여부를 확인합니다. 새로 만든 상위 폴더가 잡히지 않으면 /reload-skills를 실행합니다. 공식 설치·호출 안내.
Step 4

같은 보고서를 스킬 없이, 스킬로 검수

published

Step 4

같은 보고서를 스킬 없이, 스킬로 검수

4부 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 · 13분

목표

스킬을 쓰는 이유를 결과의 재현성과 누락 항목으로 확인한다.

시간

모듈 0–45분 중 이 단계 13분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 먼저 일반 요청으로 output/one-person-report.html의 오류를 찾아 보되 파일을 고치지 않는다.

2. 다음으로 /report-audit를 명시 호출해 work/report-audit.md를 만든다.

3. 두 결과에서 2024 기준, 지역 내 비율의 분모, 출처, 17개 지역, 외부 표시 자산 여부가 모두 확인됐는지 비교한다.

두 요청을 별도 메시지로 실행

먼저 일반 요청: output/one-person-report.html의 오류를 확인해 주세요. 수정하지 마세요.
다음은 별도 메시지로 실행: /report-audit output/one-person-report.html
두 결과를 비교해 기준연도·지역 내 비율의 분모·공식 출처·17개 시도·단일 HTML 표시 자산 중 빠진 항목을 알려주세요.

완료 기준

work/report-audit.md에 확인 항목, 근거 파일, 통과/확인 필요, 수정 제안이 있고 원본 HTML·CSV는 그대로다.

막히면

스킬 호출이 안 되면 SKILL.md를 직접 읽어 같은 검수 항목으로 요청한다.

강사 진행 메모

정답은 “스킬이 항상 더 좋다”가 아니라, 동일 기준을 다음 보고서에도 재사용할 수 있다는 점이다. 오류가 없으면 없는 대로 기록한다.

Step 5

외부 스킬을 들일 때의 결정

published

Step 5

외부 스킬을 들일 때의 결정

4부 · 선택 · 스킬을 찾고 설치해 보고서 검수에 쓰기 · 7분

목표

관심 있는 외부 스킬 하나의 설치 방식과 검수 계획을 만든다.

시간

모듈 0–45분 중 이 단계 7분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 추천표에서 후보 하나를 골라 원본 저장소의 SKILL.md, scripts, 라이선스, 의존성, 설치 위치를 확인한다.

2. 가이드북의 macOS/WSL2 명령을 Windows PowerShell에 그대로 붙여 넣지 않고 환경에 맞는 절차를 고른다.

3. 설치 전후 같은 작은 과제를 실행하고 수치·출처·파일 변경 범위를 비교한다.

Claude Code에 붙여넣기

내가 고른 외부 스킬의 원본 저장소 링크를 읽고 설치 전 점검표를 만들어 주세요. SKILL.md, 동봉 스크립트, 외부 전송, 의존성, 라이선스, 프로젝트/개인 설치 위치, 시험할 작은 작업을 포함하세요. 검토 단계에서는 설치나 실행을 하지 마세요.

완료 기준

선택한 스킬의 “쓸 일/안 쓸 일/설치 조건/시험 과제”를 한 장으로 설명한다.

막히면

외부 저장소가 없거나 라이선스·필수 파일이 불명확하면 소개만 하고 설치 후보에서 제외한다.

강사 진행 메모

설치는 선택 과제로 남긴다. 책의 명령은 참고 예시이며 원본 저장소와 현재 Claude Code 동작을 확인한다.

외부 스킬을 실제로 들일 때

1. 위키독스는 찾기와 1차 비교에 사용하고, 최신 설치 명령과 라이선스는 원본 저장소에서 확인합니다.

2. SKILL.md와 scripts/, 외부 전송, 필요한 패키지를 읽습니다. 스킬은 파일 수정이나 명령 실행을 지시할 수 있습니다.

3. 먼저 프로젝트 범위에서 작은 공개 자료로 시험하고, 출력 수치·출처·파일 변경 내역을 검수합니다.

4. 책은 macOS CLI와 Windows WSL2를 기준으로 설명합니다. 수업의 PowerShell 명령은 자체 제작 report-audit에만 적용됩니다. 외부 스킬의 Bash 명령을 그대로 복사하지 않습니다.

Claude Code 공식 문서 · 위키독스 가이드북

다음 모듈: 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 →
Module 11practice

추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정

5부 · 0–25분 (25분) · 앱 권한 모드와 Markdown 협업 규약을 구분한다.

5 steps

Step 1

실제 Plan 모드와 PLAN/ACT 규약 구분

published

Step 1

실제 Plan 모드와 PLAN/ACT 규약 구분

5부 · 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 · 4분

목표

앱 권한 모드와 Markdown 협업 규약을 구분한다.

시간

모듈 0–25분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 현재 프로젝트 폴더가 claude-kosis-lab인지 확인한다.

2. Claude Code에서 실제 Plan 모드를 선택한다. CLI와 데스크톱의 메뉴 표기는 버전에 따라 다를 수 있다.

3. ACT는 수업에서 정한 실행 단계 이름이며 “act” 입력만으로 권한이 바뀌지 않음을 확인한다.

Claude Code에 붙여넣기

현재 폴더의 CLAUDE.md를 읽고 이 프로젝트의 계획·승인·실행 규칙을 설명해 주세요. 지금은 Plan 모드에서 검토만 합니다. 파일을 만들거나 수정하지 마세요.

완료 기준

Plan은 앱의 실제 모드, ACT는 승인 후 실행을 뜻하는 협업 규약이라고 설명한다.

막히면

Plan 선택 메뉴가 다르면 공식 문서와 현재 앱 메뉴를 대조한다. 텍스트로 PLAN만 쓰고 실제 모드가 바뀌었다고 판단하지 않는다.

강사 진행 메모

기존 작업공간 규칙 교안을 Claude Code 공식 permissions/desktop 문서와 대조했다. 우회 권한 모드는 이 실습에서 사용하지 않는다.

첨부파일

PLAN/ACT·grill-me 설정 파일 포함 실습 ZIP

templates/CLAUDE-plan-act.md와 skill-kit/grill-me/SKILL.md가 포함된 최신 실습 자료입니다. 기존 규칙과 스킬을 비교하고 설치하세요.

claude-kosis-lab.zip

다운로드

실제 모드와 규칙 파일

PLAN/ACT는 수업에서 사용하는 협업 절차 이름입니다. Claude Code의 실제 Plan 권한 모드와 구분하고, 실행은 계획 검토 후 Manual 모드와 도구 승인으로 진행합니다. CLAUDE.md는 프로젝트 지침 컨텍스트이며 권한 차단을 강제하는 설정이 아닙니다.

공식 권한 설정 · 데스크톱 모드 · CLAUDE.md와 프로젝트 지침

Step 2

기존 CLAUDE.md를 읽고 규칙 변경 계획

published

Step 2

기존 CLAUDE.md를 읽고 규칙 변경 계획

5부 · 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 · 5분

목표

규칙 원본을 보존하며 프로젝트 목적·입력·출력·검증 조건을 정한다.

시간

모듈 0–25분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. templates/CLAUDE-plan-act.md와 현재 CLAUDE.md를 나란히 읽는다.

2. inbox·assets 원본 보존, work·output 저장, 숫자·출처 검수 조건을 찾는다.

3. 규칙 파일 전체 교체가 아니라 기존 내용에 합칠 변경안을 요청한다.

Claude Code에 붙여넣기

CLAUDE.md와 templates/CLAUDE-plan-act.md를 읽어 기존 규칙을 보존하는 병합안을 제안해 주세요. 입력·목적·제약·완료 기준과 PLAN→승인→ACT→검증 절차를 포함하세요. 기존 규칙과 충돌하는 부분은 표시하고 아직 파일은 수정하지 마세요.

완료 기준

변경할 CLAUDE.md 문장, 유지할 기존 규칙, 승인할 범위가 표시된다.

막히면

CLAUDE.md가 없으면 현재 앱에서 프로젝트 지침이 어떻게 로드되는지 확인하고 프로젝트 루트의 CLAUDE.md 생성안을 먼저 검토한다.

강사 진행 메모

CLAUDE.md는 지침 컨텍스트이며 강제 권한 설정이 아니다. AGENTS.md 로드는 버전·Project instructions 설정에 따라 달라지므로 이 실습은 CLAUDE.md를 사용한다.

첨부파일

CLAUDE.md에 합칠 PLAN/ACT 규칙 템플릿

기존 CLAUDE.md를 덮어쓰지 말고 병합안을 검토한 뒤 프로젝트에 반영합니다.

CLAUDE-plan-act.md

다운로드
Step 3

승인 후 규칙 저장하고 새 세션에서 확인

published

Step 3

승인 후 규칙 저장하고 새 세션에서 확인

5부 · 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 · 6분

목표

검토한 범위만 저장하고 규칙이 다음 세션에도 인식되는지 확인한다.

시간

모듈 0–25분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 앞 단계 병합안의 변경 파일과 내용을 읽고 승인할 항목을 정한다.

2. 계획을 승인한 뒤 실제 앱 모드를 Manual로 전환하고 저장 요청을 실행한다. 도구 승인 화면도 읽는다.

3. 새 세션에서도 같은 폴더를 열고 실제 파일을 읽어 규칙을 확인한다.

Claude Code에 붙여넣기

검토한 CLAUDE.md 병합 계획을 승인합니다. 해당 파일의 승인한 규칙만 반영해 주세요. 기존 규칙과 원본 자료는 보존하고 다른 파일은 수정하지 마세요. 변경 전후의 차이와 적용한 경로를 알려주세요.

완료 기준

실제 CLAUDE.md에 규칙이 저장됐고 새 세션에서 원본 보존·승인 범위를 설명한다.

막히면

규칙을 못 찾으면 작업 폴더와 파일 이름을 확인한다. 메모장 저장 시 CLAUDE.md.txt가 되지 않았는지도 확인한다.

강사 진행 메모

승인 문장만으로 Plan 모드가 해제된다고 설명하지 않는다. 규칙을 이해했다고 답하는 것과 실제 저장한 파일을 확인하는 것을 구분한다.

Step 4

보고서 한 문단으로 PLAN→ACT 검증

published

Step 4

보고서 한 문단으로 PLAN→ACT 검증

5부 · 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 · 6분

목표

변경 범위를 작게 제한해 계획·승인·실행·검수를 경험한다.

시간

모듈 0–25분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. output/one-person-report.html이 없으면 examples/report-complete.html을 읽고 새 output 파일을 만드는 계획으로 바꾼다.

2. 실제 Plan 모드에서 “읽을 때 주의할 점” 한 문단만 고치는 계획을 요청한다.

3. 계획을 검토하고 Manual로 전환해 승인한 범위만 실행한 뒤 수치·출처를 대조한다.

Claude Code에 붙여넣기

output/one-person-report.html의 “읽을 때 주의할 점” 문단만 비개발자가 읽기 쉽게 바꾸는 계획을 제안해 주세요. 2024년, 36.1%, 39.9%, 31.6%, 17개 시도 표, 이미지와 출처는 유지하세요. 먼저 대상 문장·수정 범위·검증 방법·멈출 조건을 설명하고 승인 전에는 HTML을 수정하지 마세요.

완료 기준

계획 때는 HTML이 그대로이며 승인 후 한 문단만 바뀐다. 숫자·표·이미지·출처가 유지된다.

막히면

여러 영역을 바꾸는 계획이면 문단 한 개로 줄인다. 수치가 달라졌으면 변경을 완료로 처리하지 않고 원자료와 다시 대조한다.

강사 진행 메모

계획 문서 생성까지 허용하려면 그 경로를 따로 승인한다. 이 단계의 초기 요청은 검토만 하며 작업 파일을 만들지 않는다.

Step 5

진행 기록을 남기고 다음 세션으로 이어가기

published

Step 5

진행 기록을 남기고 다음 세션으로 이어가기

5부 · 추가 · PLAN/ACT와 CLAUDE.md 프로젝트 규칙 설정 · 4분

목표

파일 기반 기록으로 승인 범위와 다음 행동을 이어받는다.

시간

모듈 0–25분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 승인한 계획, 바뀐 파일, 검증 결과, 미확인 사항을 확인한다.

2. 기록 파일 두 개만 저장하도록 요청한다.

3. 새 세션에서 기록을 읽고 다음 작업의 계획만 요청한다.

Claude Code에 붙여넣기

지금 승인한 계획과 실제 변경 파일·검증 결과를 work/plan.md에 정리하고, 미확인 사항과 다음 행동은 work/next-actions.md에 저장해 주세요. 이 두 기록 파일의 작성만 승인합니다. HTML과 원본 자료는 더 수정하지 마세요.

완료 기준

새 세션이 두 기록 파일을 읽고 다음 계획을 제안하며 이전 승인 범위를 자동 확대하지 않는다.

막히면

기록이 장문이면 완료·미완료·다음 작업 3개 항목으로 줄인다. 기록 파일은 필요한 때 직접 읽어야 한다.

강사 진행 메모

work/plan.md와 memory_bank 폴더가 자동으로 모두 로드된다고 설명하지 않는다. 경로를 명시해 읽도록 요청한다.

다음 모듈: 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 →
Module 12practice

추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기

6부 · 0–20분 (20분) · 답을 대신 쓰는 요청과 판단 기준을 좁히는 질문 인터뷰를 구분한다.

4 steps

Step 1

grill-me의 역할과 수업용 스킬 읽기

published

Step 1

grill-me의 역할과 수업용 스킬 읽기

6부 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 · 4분

목표

답을 대신 쓰는 요청과 판단 기준을 좁히는 질문 인터뷰를 구분한다.

시간

모듈 0–20분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. skill-kit/grill-me/SKILL.md를 읽는다. 이 자료는 기존 USLab 질문 교안을 재구성한 수업용 스킬이다.

2. 한 번에 질문 하나, 사용자 답 대기, 사실·해석·제안 구분을 찾는다.

3. 현재 보고서의 독자·공유 목적 중 먼저 정할 한 가지를 고른다.

Claude Code에 붙여넣기

skill-kit/grill-me/SKILL.md를 읽고 일반 보고서 작성 요청과 무엇이 다른지 3개 항목으로 설명해 주세요. 아직 스킬을 설치하거나 보고서를 수정하지 마세요.

완료 기준

grill-me는 보고서 결론을 대신 정하지 않고 내 판단 기준을 하나씩 묻는다고 설명한다.

막히면

공격적인 표현이 부담되면 “판단 기준 인터뷰”라고 부르고 같은 절차를 따른다.

강사 진행 메모

기존 claude-code-onboarding-grill-me의 한 질문씩 진행·다음 액션 절차와 USLab 로컬 스킬 원문을 참고했다. 외부 저장소 설치나 공식 내장 기능으로 소개하지 않는다.

첨부파일

PLAN/ACT·grill-me 설정 파일 포함 실습 ZIP

templates/CLAUDE-plan-act.md와 skill-kit/grill-me/SKILL.md가 포함된 최신 실습 자료입니다. 기존 규칙과 스킬을 비교하고 설치하세요.

claude-kosis-lab.zip

다운로드
Step 2

프로젝트에 설치하고 인식 확인

published

Step 2

프로젝트에 설치하고 인식 확인

6부 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 · 6분

목표

현재 프로젝트 범위에서만 스킬을 설치한다.

시간

모듈 0–20분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. ZIP을 최신 버전으로 받고 실습 폴더에서 실행한다. 원본 SKILL.md를 먼저 읽는다.

2. 기존 .claude/skills/grill-me가 있으면 덮어쓰지 말고 비교한다. 없을 때 아래 PowerShell 명령을 실행한다.

3. Claude Code의 /skills 목록과 /grill-me 호출로 인식을 확인한다. 새 폴더 인식 문제가 있으면 /reload-skills 또는 새 세션을 확인한다.

PowerShell 터미널에서 설치

Get-Location
if (!(Test-Path -LiteralPath "skill-kit/grill-me/SKILL.md")) { throw "압축을 푼 claude-kosis-lab 폴더에서 실행하세요." }
if (Test-Path ".claude/skills/grill-me/SKILL.md") { throw "기존 grill-me 스킬을 먼저 비교하세요." }
New-Item -ItemType Directory -Force -Path ".claude/skills/grill-me" | Out-Null
Copy-Item -LiteralPath "skill-kit/grill-me/SKILL.md" -Destination ".claude/skills/grill-me/SKILL.md"

완료 기준

프로젝트 .claude/skills/grill-me/SKILL.md가 있고 /grill-me가 사용자 답을 기다리는 질문 하나를 낸다.

막히면

CLI 명령과 Claude 슬래시 요청을 한 창에 함께 넣지 않는다. Test-Path 결과보다 현재 폴더 이름과 skill-kit 존재 여부를 확인한다.

강사 진행 메모

공유 PC에서 홈 범위 설치를 하지 않는다. disable-model-invocation: true로 명시적으로 호출할 때만 이 인터뷰를 시작한다.

첨부파일

수업용 grill-me SKILL.md

기존 USLab 질문 진행 절차를 재구성했습니다. 프로젝트 .claude/skills/grill-me에 설치합니다.

SKILL.md

다운로드

설치 후 Claude Code에서 입력 · 먼저 /skills로 목록 확인

/grill-me examples/report-complete.html을 읽고 이 보고서의 공유 목적을 한 질문씩 정리해 주세요. 파일은 수정하지 마세요.

설치 명령과 호출을 나눠 실행

위 복사 블록의 PowerShell 부분만 터미널에서 실행합니다. /skills와 /grill-me ...는 Claude Code 채팅창에 각각 입력합니다. 공유 PC의 홈 경로에 설치하지 않고 이번 프로젝트에서만 설치합니다. /reload-skills가 제공되지 않거나 인식이 안 되면 같은 프로젝트로 새 세션을 열어 확인합니다.

Claude Code 공식 스킬 설치·호출 안내

Step 3

질문·답변 두 번과 사실/해석 구분

published

Step 3

질문·답변 두 번과 사실/해석 구분

6부 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 · 6분

목표

두 차례 질문으로 독자와 보고서 범위를 좁힌다.

시간

모듈 0–20분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 첫 질문에 실제 독자와 공유 목적을 답한다.

2. 다음 질문에 확실한 수치와 이번 자료로 말할 수 없는 원인을 구분해 답한다.

3. 질문이 여러 개면 한 개로 줄이고, 추천 답은 검토한 뒤 선택한다.

Claude Code에 붙여넣기

/grill-me examples/report-complete.html과 inbox/source-notes.md를 읽어 보고서를 누구에게 어떤 목적으로 공유할지 먼저 질문 하나만 해 주세요. 질문 이유와 근거가 있는 추천 답을 짧게 쓰고 내 답을 기다리세요. 수치 검수와 판단 기준을 사실·해석·제안으로 구분하고 파일은 수정하지 마세요.

완료 기준

한 번에 질문 하나씩 두 차례 답하고, 지역 비율과 원인 추정이 서로 다르다고 설명한다.

막히면

답이 이미 정해져 있으면 스킬을 억지로 쓰지 않고 직접 작성 요청으로 돌아간다. 출처 없는 추천 답은 근거를 묻는다.

강사 진행 메모

“추천대로”는 해당 질문의 답이지 파일 수정·외부 공유 승인이라는 뜻이 아니다. 답변 대기 없이 결과물을 완성하면 다시 인터뷰 범위를 제한한다.

Step 4

질문 기록과 다음 행동 저장

published

Step 4

질문 기록과 다음 행동 저장

6부 · 추가 · grill-me 스킬 설치와 질문으로 판단 기준 정하기 · 4분

목표

인터뷰에서 드러난 기준을 작업 기록으로 남긴다.

시간

모듈 0–20분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 질문 두 개와 내 답, 합의한 독자·범위를 확인한다.

2. 저장할 두 파일과 승인 범위를 명시한다.

3. 다음 세션에서 규칙과 질문 기록을 읽어 계획 단계로 이어간다.

Claude Code에 붙여넣기

방금 질문과 내 답을 work/grill-log.md에 정리하고, 확인된 판단 기준·미확인 사항·다음 행동 3개를 work/decision.md에 저장해 주세요. 이 두 파일의 작성만 승인합니다. 통계 원본과 HTML은 수정하지 말고 외부로 전송하지 마세요.

완료 기준

질문 로그·판단 기준 파일이 있으며 각 다음 행동에 확인할 자료 또는 완료 기준이 있다.

막히면

이름이 다른 파일에 자동 저장했다면 요청한 경로와 비교한다. 보고서 수정과 공유는 다음 계획에서 따로 검토한다.

강사 진행 메모

기존 보충 모듈의 decisions/next_actions.md 교안은 심화 업무 적용 참고로 보존한다. 이번 실습은 work/ 아래에 기록을 모은다.

다음 모듈: 추가 · memory_bank로 기록하고 새 세션에서 이어가기 →
Module 13practice

추가 · memory_bank로 기록하고 새 세션에서 이어가기

7부 · 0–25분 (25분) · 규칙, 내장 기억, 수업용 작업 기록의 역할을 구분한다.

5 steps

Step 1

CLAUDE.md·auto memory·memory_bank 구분

published

Step 1

CLAUDE.md·auto memory·memory_bank 구분

7부 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기 · 4분

목표

규칙, 내장 기억, 수업용 작업 기록의 역할을 구분한다.

시간

모듈 0–25분 중 이 단계 4분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. CLAUDE.md는 프로젝트 지침, auto memory는 Claude가 관리하는 기억, memory_bank는 우리가 만든 기록 폴더로 구분한다.

2. templates/memory-bank/README.md에서 네 파일의 역할을 읽는다.

3. 폴더 이름만으로 모두 자동 로드되지 않으며 실제 읽은 경로를 확인해야 함을 이해한다.

Claude Code에 붙여넣기

CLAUDE.md와 templates/memory-bank/README.md를 읽고 규칙 파일과 작업 기록의 차이를 설명해 주세요. 이 폴더는 템플릿이며 현재 진행 상태로 취급하지 마세요. 아직 파일을 만들거나 수정하지 마세요.

완료 기준

규칙·현재 상태·작업 이력·결정 이유를 각각 어디에 남길지 말한다.

막히면

/memory 화면은 앱 버전에 따라 다를 수 있다. 공식 문서와 비교하고 이 수업은 경로를 명시해 읽는 방법으로 진행한다.

강사 진행 메모

memory_bank는 수업에서 쓰는 파일 구성이다. 전용 플러그인이나 내장 auto memory 설치로 소개하지 않는다.

첨부파일

메모리뱅크 템플릿 포함 최신 실습 ZIP

templates/memory-bank에 네 기록 파일과 읽기 안내가 있습니다. 기존 기록과 비교하고 반영하세요.

claude-kosis-lab.zip

다운로드

첨부파일

memory_bank 파일 구성·읽기 안내

projectbrief·activeContext·progress·decisionLog의 역할과 새 세션에서 이어가는 방법입니다.

README.md

다운로드

무엇을 어디에 기록하나요?

파일기록할 내용
CLAUDE.md반복해서 지킬 규칙과 기록을 읽는 절차
memory_bank/projectbrief.md독자·목적·입력·완료 기준
memory_bank/activeContext.md현재 목표·승인 범위·미확인·다음 행동
memory_bank/progress.md날짜별 실제 변경·검증·미완료
memory_bank/decisionLog.md결정·이유·근거·다시 검토할 조건

memory_bank는 수업용 파일 구성이며 내장 auto memory와 다릅니다. 폴더명만으로 모든 파일이 자동 로드되지 않습니다. 이 실습은 경로를 명시해 읽고 실제 근거를 확인합니다. Claude Code 공식 기억·지침 문서

Step 2

기존 기록을 확인하고 네 파일 작성 계획

published

Step 2

기존 기록을 확인하고 네 파일 작성 계획

7부 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기 · 5분

목표

확인한 정보만 짧은 기록으로 남길 계획을 세운다.

시간

모듈 0–25분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 실제 Plan 모드에서 기존 memory_bank와 템플릿을 비교한다.

2. projectbrief·activeContext·progress·decisionLog에 넣을 정보를 구분한다.

3. 기존 work/plan.md와 work/decision.md가 있다면 참고하되 원본 기록을 이동하거나 삭제하지 않는다.

Claude Code에 붙여넣기

현재 CLAUDE.md, inbox/source-notes.md와 실제 존재하는 work/plan.md, work/next-actions.md, work/decision.md를 읽어 주세요. 없는 파일은 없다고 표시하세요. templates/memory-bank의 예시를 참고해 memory_bank/projectbrief.md, activeContext.md, progress.md, decisionLog.md의 작성 또는 병합 계획을 제안하세요. 확인한 내용만 쓰고 승인·검증 결과를 추측하지 마세요. 기존 파일은 보존하고 아직 수정하지 마세요.

완료 기준

네 파일의 작성 대상·근거·미확인 항목과 기존 파일 유지 범위가 표시된다.

막히면

기록이 없는 신규 프로젝트라면 목적·입력만 확인하고 진행과 결정은 아직 미확인이라고 적는 계획으로 바꾼다.

강사 진행 메모

전체 대화 복사 대신 다음 사람이 이어갈 정보만 남긴다. 빈 템플릿의 대괄호를 사실로 받아들이지 않게 한다.

Step 3

승인 후 기록 저장·CLAUDE.md에 읽기 규칙 연결

published

Step 3

승인 후 기록 저장·CLAUDE.md에 읽기 규칙 연결

7부 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기 · 6분

목표

기존 기록과 규칙을 보존하며 명시적인 읽기·갱신 절차를 만든다.

시간

모듈 0–25분 중 이 단계 6분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 작성·병합 계획을 읽고 승인할 범위를 고른다.

2. 실제 Manual 모드에서 네 기록 파일만 저장하도록 요청한다.

3. CLAUDE.md에는 필요한 기록을 먼저 읽고 완료 후 갱신하는 짧은 지침을 따로 검토해 추가한다.

Claude Code에 붙여넣기

검토한 memory_bank 네 파일의 작성·병합 계획을 승인합니다. 승인한 기록 파일만 반영하고 기존 내용은 보존하세요. HTML과 원본 자료는 수정하지 마세요. 이어서 CLAUDE.md에 “새 작업은 memory_bank/projectbrief.md와 memory_bank/activeContext.md를 먼저 읽고, 관련 progress.md와 decisionLog.md는 필요할 때 읽는다. 승인한 작업 후 실제 변경·검증·미완료·다음 행동을 갱신한다”라는 지침을 합칠 변경안을 보여 주세요. CLAUDE.md는 추가 검토 전 수정하지 마세요.

완료 기준

네 실제 기록 파일이 있고, CLAUDE.md 병합안을 별도 승인·저장한 뒤 실제 차이를 확인한다.

막히면

기존 지침과 충돌하면 합의가 필요한 문장을 표시하고 기록 파일만 저장한 상태에서 멈춘다.

강사 진행 메모

규칙 병합안 확인 후 “검토한 읽기·갱신 지침만 CLAUDE.md에 반영해 주세요”라고 별도로 요청한다. 전체 템플릿을 강제로 덮어쓰지 않는다.

Step 4

새 세션에서 읽고 다음 계획만 제안

published

Step 4

새 세션에서 읽고 다음 계획만 제안

7부 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기 · 5분

목표

대화 이력이 없는 세션도 근거 파일로 현재 상태를 이어받는지 확인한다.

시간

모듈 0–25분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 새 세션에서 같은 claude-kosis-lab 프로젝트를 연다.

2. 기록 경로를 명시해 읽도록 하고 현재 목표·완료·미완료를 설명하게 한다.

3. 다음 행동 하나의 계획만 받고 이전 승인 범위를 자동 확대하지 않는지 확인한다.

Claude Code에 붙여넣기

CLAUDE.md, memory_bank/projectbrief.md와 memory_bank/activeContext.md를 먼저 읽고 필요한 progress.md와 decisionLog.md를 확인해 주세요. 실제 읽은 파일 경로, 현재 목표, 완료·미완료, 미확인 사항, 다음 행동 하나를 요약하세요. 기록과 실제 output 파일이 충돌하면 충돌을 표시하세요. 지금은 다음 작업의 계획만 제안하며 파일은 수정하지 마세요.

완료 기준

실제 읽은 경로와 근거를 말하고, 없는 기록·실행하지 않은 검증·새 승인을 만들어내지 않는다.

막히면

기억한다고 답하기만 하면 파일별 근거를 요청한다. 최신 기록과 실제 파일이 다르면 확인이 필요한 상태로 남긴다.

강사 진행 메모

다음 세션에서 바로 이어지는 것이 완료 기준이다. memory_bank를 만들었다는 사실만으로 실습을 끝내지 않는다.

Step 5

작업 뒤 갱신·오래된 기록 정리

published

Step 5

작업 뒤 갱신·오래된 기록 정리

7부 · 추가 · memory_bank로 기록하고 새 세션에서 이어가기 · 5분

목표

현재 상태를 짧게 유지하고 실제 작업·결정 이력을 누적한다.

시간

모듈 0–25분 중 이 단계 5분. 설명·시연·실습·오류 대응을 포함합니다.

따라 하기

1. 앞선 PLAN/ACT 실습에서 실제 변경한 한 문단과 검증 결과를 확인한다.

2. activeContext는 현재 상태로 갱신하고 progress는 날짜별 이력으로 추가한다.

3. 독자·범위 결정이 실제로 바뀐 경우에만 decisionLog에 이유를 추가한다.

Claude Code에 붙여넣기

기록과 실제 output/one-person-report.html을 비교해 이미 완료한 작업·실행한 검증·미완료를 구분해 주세요. memory_bank/activeContext.md의 현재 상태와 다음 행동을 갱신하고 progress.md에 날짜·변경 파일·실제 검증·미완료를 추가하세요. 사용자 답으로 확인된 새 결정이 있을 때만 decisionLog.md에 근거를 추가하세요. 이 기록 파일의 갱신만 승인하며 HTML·통계 원본·기존 이력은 변경하지 마세요. 실제 보고서가 없으면 없다고 기록하세요.

완료 기준

현재 기록과 이력의 역할이 구분되고 다음 행동에 확인할 자료·완료 기준이 있다.

막히면

진행하지 않은 작업이 완료로 적혔으면 근거를 대조해 바로잡는다. 개인정보·비밀키·대화 전체를 복사하지 않는다.

강사 진행 메모

도입은 네 파일이면 충분하다. 제품 맥락·기술 맥락 등 별도 파일은 기록이 커질 때 확장한다.

다음 모듈: 업무 진단과 준비물 →
Module 14checkpoint

업무 진단과 준비물

약 25분 · 처리하고 싶은 업무를 고르고, 2시간 실습에 필요한 자료와 설치 상태를 확인합니다.

3 steps

Step 1

이 온보딩의 목표

published

Step 1

이 온보딩의 목표

업무 진단과 준비물

이 온보딩의 목표

이 수업은 Claude Code 사용법을 추상적으로 배우는 시간이 아닙니다.

각자 지금 처리하고 싶은 업무 하나를 가져와 2시간 안에 Claude Code 작업공간으로 바꾸는 실습입니다.

오늘의 한 줄 목표

내 자료를 넣고,
판단 기준을 만들고,
다음 액션까지 정리한다.

2시간 완료 경로 (필수 14 Step)

복사용 프롬프트

Module 1. 업무 진단과 준비물 (3 Step, ~25분)
Module 2. 2H Quick Build (6 Step, ~75분)
Module 3. grill-me와 다음 액션 (4 Step, ~20분)

Part 2·Part 3는 2시간 이후 필요할 때 찾아보는 참고 자료입니다. 온보딩 완료 기준에 포함되지 않습니다.

완료 기준

  • 내 업무 문제 1개가 정해져 있다.
  • 실습 폴더와 inbox가 만들어져 있다.
  • 내 자료가 1차 목록화되어 있다.
  • grill-me 첫 질문과 두 번째 질문까지 진행했다.
  • next_actions.md가 남아 있다.
Step 2

처리하고 싶은 업무 진단

published

Step 2

처리하고 싶은 업무 진단

업무 진단과 준비물

처리하고 싶은 업무 진단

40H 워크샵의 서비스 아이디어 진단처럼, Claude Code 온보딩도 먼저 “내가 처리하고 싶은 업무”를 고릅니다.

이 스텝은 읽는 설명으로 끝내지 않고, 별도 진단 화면에서 진행합니다.

진단 열기

처리하고 싶은 업무 진단 시작하기

진단 화면에서는 다음 순서로 진행합니다.

복사용 프롬프트

1. 직접 생각한 업무가 있는지, 예시에서 고를지 선택
2. 처리하고 싶은 업무를 한두 문장으로 작성
3. 가장 가까운 업무 유형 선택
4. 가진 자료와 원하는 산출물 작성
5. Quick Build starter pack과 첫 grill-me 프롬프트 확인

업무 유형

복사용 프롬프트

A. 의사결정이 필요하다
B. 자료를 정리하고 지식베이스화하고 싶다
C. 딜 조건/제안 전략/계약 리스크를 정리하고 싶다
D. 견적서/문의/고객 데이터를 분석하고 싶다
E. 제안서/보고서/기획안을 반복해서 만든다
F. 논문/리서치/학습자료를 구조화하고 싶다
G. 회의록/고객 대화를 액션으로 바꾸고 싶다
H. 반복 업무를 자동화하거나 나중에 앱으로 만들고 싶다

진단 후 남는 것

복사용 프롬프트

업무 유형
Quick Build starter pack
가져올 자료 목록
원하는 산출물
첫 grill-me 질문 방향
작업공간 초기화 프롬프트
진단 결과, Quick Build starter pack, 초기 프롬프트 예시

진단 화면을 못 여는 경우

복사용 프롬프트

나는 Claude Code 온보딩에서 처리할 업무를 고르려고 해.
아래 후보 중 나에게 맞는 유형을 진단해줘.

1. 지금 가장 처리하고 싶은 업무:
2. 가진 자료:
3. 언제까지 필요한지:
4. 최종 산출물:
5. 막히는 이유:

위 내용을 기준으로 업무 유형을 추천하고, 2시간 온보딩에서 어디까지 하면 좋은지 정리해줘.
Step 3

사전 준비 체크

published

Step 3

사전 준비 체크

업무 진단과 준비물

사전 준비 체크

Claude Code 작업공간을 안정적으로 만들기 위해 가장 먼저 확인할 항목은 Git입니다.

필수 준비

Claude Desktop
Claude Code 사용 가능 계정 또는 Max 상태
Git 설치
실습에 사용할 업무 자료 10~100개

권장 준비

복사용 프롬프트

민감정보 제거본
회의록 또는 메모 1~3개
PDF/PPT/Excel/HWP 중 실제 업무 파일
오늘 최종적으로 받고 싶은 산출물 1개

아직 뒤로 미루는 것

Python, HWP 대량 처리, GitHub, MCP, Cowork, Plugin은 첫 온보딩의 필수 조건이 아닙니다.

필요하면 Part 2 기능 모듈에서 따로 배웁니다.

다음 모듈: 2H Quick Build →
Module 15practice

2H Quick Build

약 75분 · 내 노트북에서 Claude Code 작업공간을 만들고, inbox에 실제 자료를 넣어 1차 분류합니다.

6 steps

Step 1

강사 실제 프로젝트 먼저 보기

published

Step 1

강사 실제 프로젝트 먼저 보기

2H Quick Build

강사 실제 프로젝트 먼저 보기

처음부터 기능 설명을 길게 하지 않습니다.

먼저 강사의 실제 작업공간을 보고, 수강생이 오늘 만들 결과를 머릿속에 그립니다.

보여줄 것

폴더 구조
AGENTS.md 또는 CLAUDE.md
memory_bank
inbox
DATA_INVENTORY.md
context_summary.md
decision_log.md
next_actions.md

메시지

Claude Code는 채팅창이 아니라 업무 폴더를 함께 운영하는 작업공간입니다.

강사가 설명할 포인트

채팅은 대화가 끝나면 맥락이 흩어지기 쉽다.
작업공간은 파일과 폴더에 맥락이 남는다.
Claude Code는 이 폴더를 보면서 다음 작업을 이어간다.
중요한 것은 멋진 프롬프트가 아니라 좋은 작업공간 구조다.

수강생이 봐야 할 감각

복사용 프롬프트

내 자료가 흩어져 있지 않고 한 폴더에 들어간다.
Claude가 그 폴더의 구조를 이해한다.
다시 열어도 어디서 이어갈지 알 수 있다.
Step 2

Claude Code와 Git 확인

published

Step 2

Claude Code와 Git 확인

2H Quick Build

Claude Code와 Git 확인

확인 순서

1. Claude Desktop 실행
2. Code 창 진입
3. 계정/Max/사용량 확인
4. Git 설치 여부 확인
5. 실습 폴더 위치 정하기

Git이 없을 때

Windows에서는 Git 설치 후 Claude Desktop을 다시 열어야 할 수 있습니다.

실습 중 막히면 이 문장을 기준으로 처리합니다.

복사용 프롬프트

로컬 세션에서 Git이 필요하다고 나왔습니다.
Windows용 Git 설치부터 진행하고, 설치 후 Claude Desktop Code 창을 다시 열겠습니다.

왜 Git을 먼저 확인하나

파일 변경 이력 · 되돌리기 · GitHub 연동

복사용 프롬프트

Claude Code가 파일을 만들고 고칠 때 변경 이력이 남아야 한다.
잘못 수정했을 때 되돌릴 수 있어야 한다.
나중에 GitHub에 올릴 수 있어야 한다.

설치 확인 명령

powershell

git --version
Git이 없을 때 — 설치 후 Claude Desktop Code 창을 다시 연다

버전이 나오면 통과입니다.

버전이 나오지 않으면 Part 2의 Git/GitHub 설정 모듈을 먼저 열어 설치합니다. 2시간 온보딩에서는 GitHub push까지 꼭 하지 않아도 됩니다. 오늘의 목표는 로컬 작업공간이 안전하게 만들어지는 것입니다.

Step 3

작업공간 초기화

published

Step 3

작업공간 초기화

2H Quick Build

작업공간 초기화

새 폴더를 만들고 Claude Code에게 오늘의 목적을 말합니다.

업무 진단을 이미 마쳤다면 진단 결과의 starter pack과 초기 프롬프트를 그대로 붙여 넣어도 됩니다.

초기화 프롬프트

이 폴더는 내가 처리하고 싶은 업무를 정리하고 의사결정하는 Claude Code 작업공간입니다.

목표:
- 내 자료를 inbox에 넣고 1차 분류한다.
- 업무 유형에 맞는 기준 md를 만든다.
- grill-me로 판단 기준을 뽑는다.
- 다음 액션을 next_actions.md로 남긴다.

다음 폴더와 파일을 만들어줘.
- AGENTS.md 또는 CLAUDE.md
- memory_bank/
- inbox/
- sources/
- knowledge_base/
- decisions/
- outputs/
- templates/
- DATA_INVENTORY.md
- knowledge_base/context_summary.md
- decisions/next_actions.md

총 20줄 · 펼치기를 누르면 전체 코드를 볼 수 있습니다.

제안서·보고서형 starter pack 작업공간 폴더 구조

각 폴더의 의미

복사용 프롬프트

inbox/: 아직 정리하지 않은 자료를 일단 넣는 곳
sources/: 원본 자료와 변환 자료를 나눠 보관하는 곳
knowledge_base/: Claude가 반복해서 참고할 짧은 요약과 색인
decisions/: 판단 기준, grill-me 로그, 결정 기록
outputs/: 제안서, 보고서, 체크리스트 같은 제출용 결과물
templates/: 다음에 재사용할 md 양식
memory_bank/: 이 작업공간의 장기 맥락

AGENTS.md 또는 CLAUDE.md에 들어갈 내용

복사용 프롬프트

이 작업공간의 목적
자료를 다룰 때의 보안 원칙
바로 결론내리지 말고 먼저 질문할 것
출처 없는 요약을 만들지 말 것
민감정보 가능성이 있으면 표시할 것
next_actions.md를 계속 갱신할 것
Step 4

inbox에 실제 자료 넣기

published

Step 4

inbox에 실제 자료 넣기

2H Quick Build

inbox에 실제 자료 넣기

초보자에게 가장 쉬운 진입은 정교한 폴더링이 아니라 inbox입니다.

원칙

일단 inbox에 넣는다.
Claude Code가 목록화한다.
그 다음 분류 기준을 정한다.

자료 투입 후 프롬프트

복사용 프롬프트

inbox에 오늘 실습할 자료를 넣었습니다.
파일 목록을 확인하고, 파일명/확장자/추정 내용/업무 관련도 기준으로 DATA_INVENTORY.md 초안을 업데이트해줘.

아직 내용을 깊게 분석하지 말고, 먼저 어떤 자료가 있는지 목록화와 1차 분류만 해줘.
OK TO UPLOAD vs DO NOT UPLOAD

좋은 자료 예시

복사용 프롬프트

제안서 초안
회의 녹취 또는 회의록
견적서/문의 내역
기존 회사소개서
PDF 보고서
Excel 데이터
HWP 행정/공공 문서
고객 요구사항 메모

넣지 말아야 할 자료

복사용 프롬프트

민감정보가 그대로 들어 있는 원본
비밀번호/계정 정보
계약상 외부 처리 금지 자료
동의 없이 공유하면 안 되는 개인정보

민감한 자료는 Part 2의 보안 폴더 운영에서 private/redacted로 나눕니다.

Step 5

업무 유형별 starter pack 적용

published

Step 5

업무 유형별 starter pack 적용

2H Quick Build

업무 유형별 starter pack 적용

진단 결과에 따라 starter pack을 고릅니다.

매핑

의사결정형 -> decision_brief.md, option_matrix.md, risk_register.md
자료 지식베이스형 -> DATA_INVENTORY.md, document_index.md, context_summary.md
딜/제안 전략형 -> deal_brief.md, stakeholder_map.md, offer_structure.md, reference_terms.md
견적/상품화형 -> quote_data_inventory.md, service_category_map.md, ratecard_questions.md
제안서형 -> proposal_brief.md, evidence_pack_index.md, response_matrix.md
연구형 -> research_question.md, paper_index.md, literature_map.md
회의/고객대화형 -> meeting_log_index.md, action_items.md, signal_taxonomy.md
자동화형 -> workflow_inventory.md, repeat_task_map.md, automation_candidate.md

총 8줄 · 펼치기를 누르면 전체 코드를 볼 수 있습니다.

프롬프트

복사용 프롬프트

내 업무 유형은 [유형]입니다.
이 유형에 맞는 starter pack md 파일을 templates/와 decisions/에 만들어줘.
각 파일에는 빈 양식과 작성 예시를 함께 넣어줘.

starter pack의 목적

starter pack은 완성 문서가 아닙니다.

수강생의 머릿속 기준을 끌어내기 위한 빈 양식입니다. Claude가 알아서 결론내리기 전에 어떤 기준으로 봐야 하는지 정하는 장치입니다.

체크

내 업무 유형과 starter pack이 맞는가?
빈 양식만 있는가, 작성 예시도 있는가?
다음 grill-me 질문으로 이어지는가?
Step 6

자료 1차 분류와 context_summary

published

Step 6

자료 1차 분류와 context_summary

2H Quick Build

자료 1차 분류와 context_summary

자료를 모두 읽으려고 하지 말고, 먼저 업무 판단에 필요한 맥락을 요약합니다.

프롬프트

DATA_INVENTORY.md를 바탕으로 지금 업무 문제를 이해하는 데 필요한 자료를 우선순위로 나눠줘.

출력:
1. knowledge_base/context_summary.md
2. knowledge_base/source_priority.md
3. decisions/open_questions.md

기준:
- 당장 판단에 필요한 자료
- 나중에 참고할 자료
- 읽기 전에 변환이 필요한 자료
- 민감정보 확인이 필요한 자료

주의

context_summary.md는 길면 실패합니다. 모든 내용을 넣는 파일이 아니라, Claude가 다음 작업을 시작할 때 읽을 수 있는 짧은 맥락 파일입니다.

권장 길이:

복사용 프롬프트

처음에는 1~2페이지
자료가 많아져도 3~5페이지 이내
긴 내용은 document_index.md나 개별 요약 파일로 분리

Claude에게 모든 자료를 계속 다 읽히는 것이 목표가 아닙니다. 작업 시작 전에 읽어야 할 "짧은 브리핑 문서"를 만드는 것이 목표입니다.

중간 점검

여기까지 오면 설치 수업이 아니라 실제 업무 작업공간이 생긴 상태입니다.

복사용 프롬프트

작업 폴더가 있다.
inbox에 내 자료가 있다.
DATA_INVENTORY.md가 있다.
context_summary.md 초안이 있다.
starter pack이 선택되었다.

다음 단계는 바로 결론을 내지 않습니다. 자료의 중요도와 판단 기준을 사람에게서 끌어내기 위해 grill-me로 전환합니다.

다음 모듈: grill-me와 다음 액션 →
Module 16checkpoint

grill-me와 다음 액션

약 20분 · 자료 우선순위와 의사결정 기준을 grill-me로 끌어내고 next_actions.md를 남깁니다.

4 steps

Step 1

바로 의사결정하지 않기

published

Step 1

바로 의사결정하지 않기

grill-me와 다음 액션

바로 의사결정하지 않기

자료가 많을 때 Claude가 혼자 무엇이 중요한지 알 수 없습니다.

그래서 먼저 내 업무의 판단 기준을 끌어내야 합니다.

좋은 질문은 좋은 작업공간에서 나옵니다. inbox, context_summary, starter pack이 준비된 뒤에는 "무엇을 물어야 할지"가 훨씬 선명해집니다.

전환 프롬프트

바로 결론을 내리지 말고 grill-me 모드로 전환해줘.

목표는 이 자료를 어떤 기준으로 우선순위화하고 판단해야 하는지 정하는 것입니다.
한 번에 여러 질문을 하지 말고, 가장 중요한 질문부터 하나씩 해줘.

Claude Code + ChatGPT 조합 (선택)

전략·딜·제안처럼 추론이 중요한 업무라면 Claude Code로 자료와 맥락을 정리한 뒤, 정리된 md를 ChatGPT에 넘겨 더 강한 추론을 받는 방식도 유효합니다. 온보딩에서는 Claude Code 작업공간 구축에 집중합니다.

Step 2

첫 질문과 두 번째 질문

published

Step 2

첫 질문과 두 번째 질문

grill-me와 다음 액션

첫 질문과 두 번째 질문

온보딩의 성공 기준은 완벽한 분석이 아닙니다.

첫 질문과 두 번째 질문을 통해 내 머릿속 기준이 밖으로 나오기 시작하면 성공입니다.

진행 방식

Claude가 질문한다.
내가 답한다.
Claude가 답을 요약한다.
다음 질문으로 넘어간다.

저장 프롬프트

복사용 프롬프트

지금까지의 grill-me 질문과 내 답변을 decisions/first_grill_log.md로 정리해줘.
내 답변에서 드러난 판단 기준은 decisions/priority_rules.md로 따로 저장해줘.
Step 3

next_actions.md 만들기

published

Step 3

next_actions.md 만들기

grill-me와 다음 액션

next_actions.md 만들기

2시간 실습의 마지막 산출물은 다음 액션입니다.

프롬프트

지금까지 만든 DATA_INVENTORY.md, context_summary.md, priority_rules.md, first_grill_log.md를 바탕으로 next_actions.md를 만들어줘.

형식:
1. 오늘 확인한 업무 문제
2. 현재 가진 자료
3. 가장 먼저 처리할 자료 3개
4. 다음에 물어볼 grill-me 질문 3개
5. 필요한 Part 2 기능 모듈
6. 혼자 이어갈 30분 액션
7. 멘토링에서 확인받을 질문
Step 4

온보딩 완료 기준

published

Step 4

온보딩 완료 기준

grill-me와 다음 액션

온보딩 완료 기준

설치가 끝났다고 완료가 아닙니다.

완료 기준

내 업무 유형을 골랐다.
내 자료를 inbox에 넣었다.
자료가 1차 목록화되었다.
내 기준을 grill-me로 끌어내기 시작했다.
next_actions.md가 생겼다.

다음 선택

복사용 프롬프트

필요한 기능을 Part 2에서 배운다.
비슷한 사례를 Part 3에서 본다.
멘토링에서 실제 자료 기반으로 이어간다.
다음 모듈: Part 2 상세 설정과 기능별 레시피 →
Module 17lesson

Part 2 상세 설정과 기능별 레시피

선택 · 2시간 이후 필요할 때만 여는 레시피. Python, Node.js, GitHub, HWP/PDF/Excel 처리 환경을 차근차근 구축합니다.

11 steps

Step 1

Part 2를 쓰는 방법

published

Step 1

Part 2를 쓰는 방법

Part 2 기능별 레시피

Part 2를 쓰는 방법

Part 1은 빠른 성공 경험입니다.

Part 2는 그 다음에 필요한 세부 설정과 기능을 친절하게 채우는 선택 참고 구간입니다. 2시간 온보딩 완료 기준에 포함되지 않습니다.

2시간 온보딩에서는 일부러 많은 설치를 하지 않습니다. 처음부터 Python, Node.js, GitHub, HWP 파서, 자동화 스크립트를 모두 넣으면 수강생이 "내 업무가 잡히는 느낌"을 얻기 전에 설치 문제로 지칩니다.

그래서 순서를 이렇게 나눕니다.

전체 순서

Part 1: 빠르게 내 업무 작업공간을 만든다.
Part 2: 필요한 설치와 파일 처리 능력을 보강한다.
Part 3: 비슷한 사례를 보고 템플릿을 가져온다.

Part 2에서 반드시 다루는 것

복사용 프롬프트

Git / GitHub
Python / 가상환경 / pip 패키지
Node.js 20+ / npm
PDF / DOCX / PPTX / Excel / CSV
HWP / HWPX 우회 처리
DATA_INVENTORY / document_index / context_summary
민감정보 / 보안 / redacted 폴더
결과물 저장 / commit / push

추천 프롬프트

복사용 프롬프트

내 next_actions.md를 읽고, 지금 필요한 Part 2 기능 모듈을 우선순위 1~5로 추천해줘.
각 모듈을 왜 지금 배워야 하는지도 설명해줘.

완료 기준

복사용 프롬프트

내 업무자료를 Claude Code가 읽을 수 있는 형태로 바꾸는 방법을 안다.
파일 포맷별로 막혔을 때 우회 경로를 안다.
작업 결과를 Git/GitHub에 저장할 수 있다.
다음에 비슷한 자료가 와도 같은 구조로 반복할 수 있다.
Step 2

Git과 GitHub 설정하기

published

Step 2

Git과 GitHub 설정하기

Part 2 기능별 레시피

Git과 GitHub 설정하기

Git은 개발자만 쓰는 도구가 아닙니다.

Claude Code 작업공간에서는 Git이 "변경 이력 저장 장치" 역할을 합니다. 잘못 수정했을 때 되돌리고, 오늘 만든 기준과 산출물을 안전하게 남기기 위해 필요합니다.

GitHub는 그 이력을 온라인에 보관하는 공간입니다. 기본은 private 저장소로 운영합니다.

개념

Git: 내 컴퓨터 안의 변경 이력 저장 도구
Commit: 지금 상태를 저장하는 스냅샷
GitHub: Git 기록을 온라인에 보관하는 서비스
Push: 내 컴퓨터의 commit을 GitHub에 올리는 작업

설치 확인

powershell

git --version

버전이 나오면 설치되어 있는 것입니다.

설치되어 있지 않으면 Windows에서는 아래 명령을 사용할 수 있습니다.

powershell

winget install --id Git.Git -e

설치 후에는 Claude Desktop과 터미널을 다시 여는 편이 안전합니다.

작업공간에서 첫 저장

git init
git status
git add .
git commit -m "init claude code workspace"

GitHub 연결

처음에는 GitHub 웹에서 private repository를 직접 만드는 방식이 가장 쉽습니다.

복사용 프롬프트

1. GitHub.com 접속
2. New repository
3. Repository name 입력
4. Private 선택
5. README, .gitignore, License는 만들지 않음
6. Create repository

그 다음 GitHub가 보여주는 remote 명령을 Claude Code 작업공간에서 실행합니다.

Claude Code 프롬프트

이 폴더를 Git으로 초기화하고, 현재 작업공간 상태를 첫 commit으로 저장해줘.
GitHub private repository에 연결하는 순서를 초보자도 이해할 수 있게 안내해줘.

완료 기준

복사용 프롬프트

git status를 실행할 수 있다.
첫 commit이 만들어졌다.
GitHub private repository에 push할 준비가 되었다.
Step 3

Python 설치와 가상환경 만들기

published

Step 3

Python 설치와 가상환경 만들기

Part 2 기능별 레시피

Python 설치와 가상환경 만들기

Python은 2시간 온보딩 필수는 아닙니다.

하지만 Part 2부터는 PDF, Excel, 대량 파일 목록화, 웹 수집, 자동화 스크립트에 필요합니다.

언제 필요한가

PDF 텍스트를 안정적으로 뽑고 싶을 때
Excel/CSV를 표로 분석하고 싶을 때
폴더 안 파일 100개를 한 번에 목록화하고 싶을 때
반복 업무를 스크립트로 만들고 싶을 때

설치 확인

powershell

python --version
py --version
pip --version

Python이 없으면 Windows에서는 아래 명령을 사용할 수 있습니다.

powershell

winget install Python.Python.3.13

설치할 때는 "Add python.exe to PATH"가 켜져 있어야 합니다. winget 설치 후에도 터미널을 새로 열어야 합니다.

프로젝트 가상환경 만들기

가상환경은 이 작업공간만을 위한 Python 패키지 방입니다. 전역 Python을 더럽히지 않기 위해 사용합니다.

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip

PowerShell에서 실행 권한 오류가 나면 현재 세션에서만 아래 명령을 실행합니다.

powershell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\.venv\Scripts\Activate.ps1

기본 패키지 설치

powershell

pip install pandas openpyxl pdfplumber pypdf python-docx beautifulsoup4 requests tabulate

requirements.txt 저장

powershell

pip freeze > requirements.txt

Claude Code 프롬프트

복사용 프롬프트

이 작업공간에서 Python 가상환경을 만들고, PDF/Excel/DOCX 자료 자산화에 필요한 기본 패키지를 설치하는 순서를 안내해줘.
설치가 끝나면 requirements.txt를 만들고, README.md에 실행 방법을 기록해줘.

완료 기준

복사용 프롬프트

python --version이 동작한다.
.venv가 생성되었다.
pip install이 성공했다.
requirements.txt가 남았다.
Step 4

Node.js와 npm 설치하기

published

Step 4

Node.js와 npm 설치하기

Part 2 기능별 레시피

Node.js와 npm 설치하기

Node.js는 모든 업무에 필요한 것은 아닙니다.

하지만 Claude Code를 더 넓게 쓰다 보면 Node 기반 도구, 웹 자동화, 프론트엔드 미리보기, MCP/CLI 도구, 문서 변환 도구를 만나게 됩니다.

특히 HWP/HWPX 문서를 hwp-mcp로 읽으려면 Node.js 20 이상이 필요합니다.

그래서 Part 2에서 기본 확인을 해둡니다.

설치 확인

node -v
npm -v

Node.js 버전이 20 이상이면 통과입니다.

복사용 프롬프트

v20.x.x 이상
v22.x.x 이상

18 이하라면 hwp-mcp에서 문제가 날 수 있으니 업데이트합니다.

설치되어 있지 않거나 20 미만이면 Windows에서는 LTS 버전을 설치합니다.

powershell

winget install OpenJS.NodeJS.LTS

설치 후 터미널을 새로 열고 다시 확인합니다.

npm 프로젝트 초기화가 필요한 경우

업무 자동화나 웹 도구를 만들 때만 사용합니다.

powershell

npm init -y

언제 Node.js가 필요한가

복사용 프롬프트

웹페이지 스크래핑 또는 자동화 도구를 쓸 때
프론트엔드 결과물을 미리 볼 때
Node 기반 CLI 도구를 설치할 때
MCP/플러그인/문서 변환 도구가 Node를 요구할 때

Claude Code 프롬프트

복사용 프롬프트

이 작업공간에서 Node.js가 필요한지 판단해줘.
필요하다면 npm 프로젝트를 만들고, package.json에 어떤 스크립트를 넣으면 좋을지 제안해줘.
필요하지 않다면 지금은 설치 확인만 하고 넘어가도 된다고 기록해줘.

완료 기준

복사용 프롬프트

node -v와 npm -v가 동작한다.
node -v가 v20 이상이다.
Node가 필요한 업무인지 아닌지 판단했다.
필요한 경우 package.json이 생성되었다.
Step 5

자료 폴더 구조와 inventory 만들기

published

Step 5

자료 폴더 구조와 inventory 만들기

Part 2 기능별 레시피

Part 2부터는 inbox만으로 부족합니다.

자료가 많아지면 원본 보관용, 처리 결과용, Claude가 읽는 요약용을 분리해야 합니다.

권장 폴더 구조

sources/
  raw/
    pdf/
    hwp/
    hwpx/
    docx/
    pptx/
    excel/
    web/
    meeting/
  processed/
    markdown/
    csv/
    text/
knowledge_base/
  DATA_INVENTORY.md
  document_index.md
  context_summary.md
  source_priority.md
private/
redacted/
outputs/
scripts/

총 23줄 · 펼치기를 누르면 전체 코드를 볼 수 있습니다.

핵심 원칙

복사용 프롬프트

raw는 원본 보관용이다.
processed는 Claude가 읽기 좋은 변환본이다.
knowledge_base는 짧고 반복 참조 가능한 요약본이다.
private에는 민감한 원본을 둔다.
redacted에는 익명화한 공유 가능 자료를 둔다.

DATA_INVENTORY.md 컬럼

복사용 프롬프트

ID
파일명
원본 경로
파일 유형
추정 내용
업무 관련도
민감정보 여부
처리 상태
다음 처리 방법

Claude Code 프롬프트

복사용 프롬프트

sources/raw 아래 자료를 훑어서 knowledge_base/DATA_INVENTORY.md를 만들어줘.
파일을 깊게 분석하기 전에 파일명, 확장자, 추정 내용, 민감정보 가능성, 처리 우선순위를 먼저 정리해줘.
HWP처럼 바로 읽기 어려운 파일은 실패로 숨기지 말고 "변환 필요"로 표시해줘.

완료 기준

복사용 프롬프트

원본과 변환본 폴더가 분리되었다.
DATA_INVENTORY.md가 있다.
변환 실패 파일도 상태가 기록되어 있다.
Step 6

PDF/DOCX/PPTX 읽기

published

Step 6

PDF/DOCX/PPTX 읽기

Part 2 기능별 레시피

PDF/DOCX/PPTX 읽기

PDF, Word, PowerPoint는 업무자료에서 가장 자주 만나는 형식입니다.

목표는 원본을 완벽하게 예쁘게 재현하는 것이 아니라, Claude Code가 판단에 쓸 수 있는 텍스트와 구조를 뽑는 것입니다.

Python 패키지

pip install pdfplumber pypdf python-docx

PPTX는 처음에는 Claude Code가 직접 읽을 수 있는 범위에서 처리하고, 필요하면 별도 패키지를 추가합니다.

처리 순서

1. sources/raw/pdf 또는 docx에 원본을 둔다.
2. 파일명을 의미 있게 정리한다.
3. 텍스트 추출을 시도한다.
4. sources/processed/markdown에 md로 저장한다.
5. document_index.md에 문서 목적과 핵심 섹션을 기록한다.
6. context_summary.md에는 전체 업무와 연결되는 내용만 짧게 남긴다.

Claude Code 프롬프트

복사용 프롬프트

sources/raw/pdf와 sources/raw/docx 자료를 읽고, 각 문서별로 processed/markdown에 요약 md를 만들어줘.
각 md에는 원본 파일명, 핵심 목적, 중요한 문장, 업무 판단에 필요한 내용, 불확실한 부분을 구분해줘.
그 다음 knowledge_base/document_index.md를 업데이트해줘.

완료 기준

복사용 프롬프트

원본별 md 변환본이 생겼다.
document_index.md에 문서 목적이 정리되었다.
context_summary.md가 너무 길어지지 않았다.
Step 7

Excel/CSV 자산화하기

published

Step 7

Excel/CSV 자산화하기

Part 2 기능별 레시피

Excel/CSV 자산화하기

Excel은 그대로 Claude에게 던지기보다, 시트 구조와 컬럼 의미를 먼저 정리하는 편이 안전합니다.

성과표, 고객 리스트, 예산표, 견적서, 설문 결과, 캠페인 데이터는 모두 이 흐름으로 처리합니다.

Python 패키지

pip install pandas openpyxl tabulate

처리 순서

복사용 프롬프트

1. sources/raw/excel에 xlsx/csv 파일을 둔다.
2. 파일별 시트 목록을 확인한다.
3. 각 시트의 컬럼명과 행 수를 정리한다.
4. 개인정보/민감 숫자 여부를 표시한다.
5. 필요한 경우 csv로 변환해 sources/processed/csv에 저장한다.
6. table_summary.md를 만든다.
7. 이 데이터로 답할 수 있는 질문과 답할 수 없는 질문을 구분한다.

Claude Code 프롬프트

복사용 프롬프트

sources/raw/excel의 파일을 확인하고, 파일별 시트명, 컬럼명, 행 수, 추정 의미를 정리해줘.
개인정보나 민감한 숫자가 있을 수 있으면 표시하고, 바로 분석하지 말고 먼저 table_summary.md와 data_questions.md를 만들어줘.

완료 기준

복사용 프롬프트

시트와 컬럼 의미가 정리되었다.
민감정보 여부가 표시되었다.
분석 가능한 질문과 불가능한 질문이 나뉘었다.
Step 8

hwp-mcp 등록하기

published

Step 8

hwp-mcp 등록하기

Part 2 기능별 레시피

hwp-mcp 등록하기

목표

HWP/HWPX 문서를 읽기 위한 MCP 도구를 등록합니다.

한컴오피스 내보내기 방식은 이 과정의 표준 경로로 쓰지 않습니다. HWP/HWPX는 hwp-mcp를 통해 Claude Code 작업공간에서 읽을 수 있게 설정하는 것을 기준으로 합니다.

설명

hwp-mcp는 MCP 호환 AI 도구에서 HWP/HWPX 문서를 읽고 다룰 수 있게 해주는 서버입니다.

Node.js 20 이상이 필요합니다.

사전 확인

node -v
npm -v

확인 기준:

복사용 프롬프트

node -v가 v20 이상이어야 합니다.
npm -v가 정상 출력되어야 합니다.

Node.js가 20 미만이면 먼저 "Node.js와 npm 설치하기" 스텝으로 돌아가 업데이트합니다.

프로젝트에 등록할 때의 원칙

1. 공식 GitHub 저장소의 README를 기준으로 설치한다.
2. Claude Code 또는 MCP 설정 파일에 hwp-mcp 서버를 등록한다.
3. sources/raw/hwp 또는 sources/raw/hwpx에 샘플 문서를 넣는다.
4. 먼저 파일 목록과 메타데이터만 확인한다.
5. 추출 실패 시 실패 상태를 DATA_INVENTORY.md에 기록한다.

수강생 프롬프트

복사용 프롬프트

hwp-mcp를 이 프로젝트에서 사용할 수 있게 설정해줘.

참고 저장소:
https://github.com/treesoop/hwp-mcp

조건:
- Node.js 20 이상인지 먼저 확인해줘.
- 한컴오피스 변환 방식은 사용하지 말아줘.
- MCP 설정에 hwp-mcp를 등록하는 순서를 안내해줘.
- sources/raw/hwp와 sources/raw/hwpx 폴더를 만들고, 테스트 파일을 어디에 넣어야 하는지 알려줘.
- 성공/실패 여부를 DATA_INVENTORY.md에 기록하는 방식까지 만들어줘.

완료 기준

복사용 프롬프트

Node.js 20 이상이 확인되었다.
hwp-mcp 등록 방법이 프로젝트 README 또는 setup note에 기록되었다.
sources/raw/hwp와 sources/raw/hwpx 폴더가 있다.
HWP/HWPX 테스트 파일의 처리 상태가 DATA_INVENTORY.md에 기록된다.
Step 9

HWP/HWPX 처리하기

published

Step 9

HWP/HWPX 처리하기

Part 2 기능별 레시피

HWP/HWPX 처리하기

HWP는 실습에서 가장 자주 막히는 포맷입니다.

그래서 목표를 "한 번에 완벽 추출"로 잡지 않습니다. 목표는 원본을 안전하게 보관하고, hwp-mcp로 읽을 수 있는지 확인한 뒤 처리 상태를 명확하게 남기는 것입니다.

표준 우선순위

1. Node.js 20 이상 확인
2. hwp-mcp 등록 확인
3. sources/raw/hwp 또는 sources/raw/hwpx에 원본 보관
4. hwp-mcp로 파일 목록과 텍스트 추출 테스트
5. 성공/실패 상태를 DATA_INVENTORY.md에 명시
6. 실패 시 파일 손상, 암호, 미지원 구조 등 이유를 기록

폴더

복사용 프롬프트

sources/raw/hwp/
sources/raw/hwpx/
sources/processed/markdown/
sources/processed/text/
knowledge_base/DATA_INVENTORY.md

왜 실패 기록이 중요한가

HWP 변환 실패를 숨기면 Claude가 없는 내용을 상상할 수 있습니다.

따라서 실패한 파일은 반드시 이렇게 표시합니다.

복사용 프롬프트

처리 상태: 변환 실패
이유: hwp-mcp 읽기 실패 / 암호 / 손상 / 표 구조 복잡 / 미지원 구조
다음 액션: 파일 상태 확인, 다른 샘플로 재테스트, 수동 요약 필요 여부 판단

Claude Code 프롬프트

복사용 프롬프트

sources/raw/hwp와 sources/raw/hwpx 파일을 확인해줘.
먼저 DATA_INVENTORY.md에 파일 목록과 처리 상태를 기록해줘.
hwp-mcp를 사용해서 읽을 수 있는 파일과 실패한 파일을 구분해줘.
한컴오피스 변환 방식은 사용하지 말아줘.
성공한 파일만 sources/processed/markdown에 요약 md로 저장하고, 실패 파일은 실패 이유와 다음 액션을 기록해줘.

완료 기준

복사용 프롬프트

HWP 원본이 raw에 보관되었다.
hwp-mcp로 읽을 수 있는 파일이 확인되었다.
실패 파일은 실패 이유와 다음 액션이 기록되었다.
Step 10

민감정보와 보안 폴더 운영

published

Step 10

민감정보와 보안 폴더 운영

Part 2 기능별 레시피

민감정보와 보안 폴더 운영

Claude Code 작업공간은 편하지만, 모든 자료를 그대로 넣으면 안 됩니다.

수강생이 실제 회사 자료를 가져오는 과정에서는 보안 기준을 먼저 정해야 합니다.

폴더 분리

private/: 원본 민감 자료, 외부 공유 금지
redacted/: 이름/연락처/금액 등 제거한 실습용 자료
knowledge_base/: Claude가 반복 참조해도 되는 요약
outputs/: 제출용 산출물

확인해야 할 민감정보

복사용 프롬프트

개인 이름
연락처
이메일
주민번호/사업자번호
계약 금액
고객사명
비공개 전략
계약서 조항
의료/제약/임상 관련 민감정보

Claude Code 프롬프트

복사용 프롬프트

이 작업공간의 DATA_INVENTORY.md를 보고 민감정보 가능성이 있는 파일을 표시해줘.
원본은 private에 두고, 실습이나 공유에 쓸 수 있는 redacted 버전을 만들기 위한 체크리스트를 privacy_checklist.md로 만들어줘.
민감정보를 임의로 삭제하지 말고, 어떤 항목을 사람이 확인해야 하는지 표시해줘.

완료 기준

복사용 프롬프트

private와 redacted가 분리되었다.
민감정보 가능성이 표시되었다.
외부 공유 가능한 자료와 불가능한 자료가 구분되었다.
Step 11

산출물 제작과 GitHub 저장

published

Step 11

산출물 제작과 GitHub 저장

Part 2 기능별 레시피

산출물 제작과 GitHub 저장

Part 2의 마지막은 결과를 남기는 것입니다.

설치와 변환만 하고 끝나면 다시 흩어집니다. 반드시 결과물을 md로 저장하고 Git으로 남깁니다.

대표 산출물

knowledge_base/context_summary.md
knowledge_base/document_index.md
knowledge_base/table_summary.md
decisions/priority_rules.md
decisions/risk_register.md
outputs/proposal_outline.md
outputs/meeting_brief.md
outputs/deal_checklist.md
decisions/next_actions.md

저장 순서

powershell

git status
git add .
git commit -m "update knowledge base and next actions"
git push

Claude Code 프롬프트

복사용 프롬프트

오늘 만든 knowledge_base, decisions, outputs를 점검해줘.
비어 있는 파일, 너무 긴 파일, 출처가 없는 요약, 민감정보 가능성이 있는 내용을 찾아줘.
정리 후 Git commit 메시지를 제안하고, GitHub에 push하기 전 체크리스트를 만들어줘.

완료 기준

복사용 프롬프트

업무 산출물이 outputs 또는 decisions에 남았다.
next_actions.md가 갱신되었다.
Git commit이 만들어졌다.
필요하면 GitHub private repo에 push했다.
다음 모듈: Part 3 사례 라이브러리 →
Module 18lesson

Part 3 사례 라이브러리

선택 · 비슷한 업무 사례를 읽고, 제공 템플릿을 내 작업공간에 가져와 응용합니다.

6 steps

Step 1

사례 라이브러리를 쓰는 방법

published

Step 1

사례 라이브러리를 쓰는 방법

Part 3 사례 라이브러리

사례 라이브러리를 쓰는 방법

Part 3는 따라 하기 숙제가 아니라, 내 업무에 적용할 템플릿을 고르는 라이브러리입니다.

사례 포맷

사례 인트로
어떤 문제였나
어떤 자료를 넣었나
어떤 기준 md를 만들었나
어떤 grill-me 질문을 썼나
어떤 산출물이 나왔나
내 업무에 적용하는 방법
제공 템플릿
추가로 배워야 할 Part 2 기능

적용 원칙

복사용 프롬프트

사례를 그대로 복사하지 않는다.
내 업무 유형과 자료 상태에 맞게 템플릿만 가져온다.
적용 후 next_actions.md를 다시 갱신한다.
Step 2

사례 1: 딜 메이킹·제안 전략 작업공간

published

Step 2

사례 1: 딜 메이킹·제안 전략 작업공간

Part 3 사례 라이브러리

사례 1: 딜 메이킹·제안 전략 작업공간

언제 쓰나

제안 조건, 계약 구조, 레퍼런스 조건, 리스크 방어, 이해관계자 설득을 함께 설계해야 할 때 사용합니다.

입력 자료

제안서 초안
고객 미팅 녹취
가격/단계/범위 메모
이해관계자별 입장
레퍼런스 사용 조건
계약 리스크 메모

템플릿

복사용 프롬프트

deal_brief.md
stakeholder_map.md
offer_structure.md
risk_register.md
reference_terms.md
red_team_review.md
next_actions.md

grill-me 질문

복사용 프롬프트

이 딜에서 우리가 잃으면 가장 아픈 것은 무엇인가?
무상/할인 조건을 받아도 반드시 남겨야 할 권리는 무엇인가?
상대가 제안서를 재사용하거나 짜깁기할 가능성은 어디에 있는가?
이번 딜이 실패해도 다음 영업 자산으로 남길 수 있는 것은 무엇인가?
Step 3

사례 2: 의사결정 OS

published

Step 3

사례 2: 의사결정 OS

Part 3 사례 라이브러리

사례 2: 의사결정 OS

언제 쓰나

선택지는 많은데 무엇을 먼저 해야 할지 정리되지 않을 때 사용합니다.

입력 자료

회의록
아이디어 메모
고객 요구사항
비용/일정 제약
리스크 메모

템플릿

복사용 프롬프트

decision_brief.md
option_matrix.md
risk_register.md
priority_rules.md
decision_log.md
Step 4

사례 3: 자료 지식베이스화

published

Step 4

사례 3: 자료 지식베이스화

Part 3 사례 라이브러리

사례 3: 자료 지식베이스화

언제 쓰나

회사 자료가 PDF, PPT, Excel, HWP, 회의록으로 흩어져 있을 때 사용합니다.

입력 자료

사내 문서
제안서
보고서
회의록
고객 자료
정책/가이드

템플릿

복사용 프롬프트

DATA_INVENTORY.md
document_index.md
context_summary.md
source_priority.md
privacy_checklist.md
Step 5

사례 4: 견적·상품화 분석

published

Step 5

사례 4: 견적·상품화 분석

Part 3 사례 라이브러리

사례 4: 견적·상품화 분석

언제 쓰나

견적서, 문의 내역, 포트폴리오 요청, 상담 기록이 쌓여 있는데 상품 구조가 정리되지 않았을 때 사용합니다.

입력 자료

과거 견적서
고객 문의 메일
서비스 소개서
가격표
프로젝트 결과물

템플릿

복사용 프롬프트

quote_data_inventory.md
service_category_map.md
ratecard_design.md
pricing_questions.md
proposal_followup.md
Step 6

사례 5~8: 확장 사례

published

Step 6

사례 5~8: 확장 사례

Part 3 사례 라이브러리

사례 5~8: 확장 사례

온보딩 이후에는 아래 사례로 확장합니다.

제안서/RFP 응답 공장

proposal_brief.md
evidence_pack_index.md
response_matrix.md
red_team_review.md

회의록/고객 대화 인텔리전스

복사용 프롬프트

meeting_log_index.md
signal_taxonomy.md
weekly_brief.md
action_items.md

논문/리서치 작업공간

복사용 프롬프트

research_question.md
paper_index.md
literature_map.md
unknowns.md

반복 업무 자동화 준비

복사용 프롬프트

workflow_inventory.md
repeat_task_map.md
automation_candidate.md
script_spec.md

마무리

온보딩은 시작점입니다.

다음 단계는 내가 고른 업무 유형에 맞는 사례를 읽고, 템플릿을 내 업무 폴더에 적용하는 것입니다.