AI 기초공사 4주차 · 마지막 회차 · 120분

반복하는 일
자동화하기

매번 시키는 걸 한 번만 적어둡니다. 그다음은 안 시켜도 돕니다.

4강 도입 · 준비

내 폴더를 열고, 없는 구조부터 채웁니다

빈 작업대 구조 만들기 · 단일 프롬프트

한 번 붙여넣으면 질문 없이 빈 파일과 안내문을 만듭니다.

① 내가

원하는 이름의 폴더를 직접 만듭니다. 이름을 AI에게 정하게 하지 않습니다.

② 앱에서

그 폴더를 Claude Code 또는 Codex의 프로젝트로 선택해 엽니다.

③ 한 번 복사

프롬프트가 열린 루트에 빈 구조만 만들고, 생성·재사용·건너뜀을 보고합니다.

전문 보기에서 읽고 복사 버튼으로 같은 문구를 붙여넣습니다.

빈 작업대 구조 만들기 · 복사되는 전문

지금 Claude Code 또는 Codex에서 프로젝트로 열어 둔 폴더에, AI 에이전트를 위한 작업대의 빈 구조만 만들어줘. 계획이나 질문으로 멈추지 말고, 만들 수 있는 파일을 바로 만든 뒤 결과만 짧게 알려줘.

[작업 범위]
- 현재 선택된 프로젝트 폴더의 실제 절대경로를 확인하고, 그 폴더를 작업대 루트로 사용해. 폴더 이름을 정하거나 위치를 바꾸거나, 그 안에 AI/·내자료/ 같은 상위 폴더를 다시 만들지 마.
- 루트가 확인되지 않으면 아무 파일도 만들지 말고 “폴더를 프로젝트로 다시 선택해야 함”과 확인한 경로만 보고해. 이 경우에도 질문하지 마.
- 기존 파일과 폴더를 먼저 확인해. 같은 역할의 것이 있으면 그대로 재사용하고, 덮어쓰기·이동·삭제·내용 교체를 하지 마. 충돌이 있으면 그 항목만 건너뛰고 끝에 보고해.
- 내 이름·직업·회사·프로젝트·자료 내용은 추측하지 마. 앱의 전역 설정을 바꾸거나 Obsidian 설치·연결을 시도하지 마. 비밀정보를 파일에 적지 마.

[만들 구조 — 모두 현재 프로젝트 폴더 바로 아래]
README.md
AGENTS.md
CLAUDE.md
00-INDEX.md
00-여기부터-읽어.md
skills/README.md
지식베이스/README.md
프로젝트/README.md
프로젝트/보관/README.md
_files/README.md

[각 파일에 넣을 최소 안내]
- README.md: 이 폴더는 AI와 사람이 함께 읽는 별도의 작업대다. 규칙, 지식, 진행 중인 일, 원본 자료를 파일로 남겨 새 세션과 다른 도구에서도 다시 찾는다. 위 구조의 역할과 시작할 때 읽는 순서를 간단히 적어.
- AGENTS.md: 작업 전에 루트 README.md와 현재 일에 관련된 문서를 확인한다. 기록된 사실의 출처를 밝히고, 없는 내용은 추측하지 않는다. 기존 파일은 함부로 덮어쓰거나 옮기지 않는다. 실제로 바꾼 파일을 보고한다. Codex가 이 내용을 직접 읽을 수 있도록 핵심 규칙을 본문에 적어.
- CLAUDE.md: 새 파일이면 @AGENTS.md 한 줄만 넣어 Claude Code가 같은 규칙을 읽게 해. 기존 파일은 보존해.
- 00-INDEX.md: 아직 자료가 없는 빈 목차임을 밝히고, 나중에 실제 문서만 연결하도록 안내해.
- 00-여기부터-읽어.md: 사람과 AI가 README → INDEX → 관련 문서 → 원본 순으로 찾도록 안내해. 근거가 없는 링크나 내용을 만들지 마.
- skills/README.md: 이 폴더는 나중에 SKILL.md로 반복 절차를 작성할 자리다. 이번에는 실제 스킬을 만들거나 설치하지 마.
- 지식베이스/README.md: 나중에 출처가 확인된 지식 문서를 채울 자리임을 적어. 지금은 개인 사실이나 예시 노트를 만들지 마.
- 프로젝트/README.md: 나중에 실제 일을 시작할 때 그 일의 폴더와 규칙을 만들 자리임을 적어. 가상의 프로젝트를 만들지 마.
- 프로젝트/보관/README.md: 끝난 일의 파일을 나중에 보관할 자리임을 적어. 지금 이동할 것은 없다.
- _files/README.md: 나중에 받은 PDF·표·그림 등 원본을 보존할 자리임을 적어. 실제 파일을 가져오거나 옮기지 마.

[끝낼 때]
질문 없이 현재 루트 경로, 실제 생성·재사용·건너뛴 파일 목록, 최상위 폴더 트리만 보여줘. 지식베이스의 실제 내용, 프로젝트, 스킬, 앱 설정은 이후 강사와 함께 채울 단계라고 한 줄로 구분해.

수강 이력별로 어디까지 되나요?

공통 · 없는 빈 파일과 안내문만 만듭니다. 기존 파일은 보존합니다.

1강만 · 2강 개인 맥락과 3강 실제 자료는 다음 단계

1~2강 · 3강 원본·근거 노트·INDEX 연결은 다음 단계

1~3강 · 빠진 구조만 보충, 기존 내용 점검은 별도

지금 확인할 것 · 생성·재사용·건너뛴 파일 목록과 폴더 트리

이전 강의 자료의 AI/는 당시 예시 경로입니다. 보충할 때는 지금 연 폴더로 읽습니다.

복습 1/3 · 1강

왜 AI에게 별도의 작업공간이 필요할까요?

대화가 끝나도 다시 읽을 수 있게

대화는 닫힐 수 있습니다. 파일로 남긴 규칙·자료·진행 상태는 다음 세션에도 남습니다.

① 지금 대화

말로만 부탁

“이름은 이렇게 쓰고, 이 자료를 먼저 봐.”

세션이 바뀌면 다시 설명해야 할 수 있습니다.

② 내가 고른 작업대

규칙과 자료를 파일로

README.md · AGENTS.md · CLAUDE.md

INDEX · 지식 · 진행 중인 일 · 원본을 같은 폴더에 둡니다.

오늘 2번에서는 이 구조의 빈 자리만 만듭니다.

③ 다음 세션

다시 읽고 이어서

Claude Code·Codex에서 같은 폴더를 열고 관련 파일을 읽게 합니다.

새 대화에서 읽은 파일과 모르는 것을 물어 확인합니다.

안쪽 정리 예시: 끝이 있는 일은 프로젝트/, 확인된 사실은 지식베이스/. 분류는 작업대를 채울 때 적용합니다.

복습 2/3 · 2강

이 규칙은 어디까지 따라올까요?

넓은 범위 → 좁은 범위

같은 문장도 어느 범위의 규칙인지에 따라 둘 자리가 달라집니다.

① 로컬 디바이스 전역

내 PC에서 공통

~/.claude/CLAUDE.md
~/.codex/AGENTS.md

여러 폴더에서 쓸 개인 지침의 예시. 오늘은 수정하지 않습니다.

② 작업대 루트

선택한 폴더 공통

AGENTS.md
CLAUDE.md

이 작업대에서 읽을 규칙. 2번 프롬프트가 빈 안내문을 만듭니다.

③ 프로젝트 폴더

해당 일에서만

실제 프로젝트를 시작할 때 그 폴더의 규칙 파일에 적습니다.

예: 이번 제안서의 대상·마감일. 지금은 가상 일을 만들지 않습니다.

④ 현재 세션

지금 요청

“이 문장만 짧게 고쳐줘”처럼 이번 대화에서만 쓸 내용입니다.

계속 쓸 규칙이 아니면 파일에 남기지 않습니다.

이 순서는 적용 범위의 넓이를 보여 줍니다. 도구마다 충돌 처리 방식은 다르므로 공통 우선순위로 외우지 않습니다.

복습 3/3 · 3강

그 답은 어느 파일을 보고 했나요?

원본에서 답의 근거까지

같은 폴더를 Obsidian에서는 보고 연결하고, Claude Code·Codex에서는 읽고 작업합니다.

① 원본

`_files/`

받은 PDF·표·그림을 원본 그대로 보존

② 근거 노트

읽은 내용

원본 경로·요약·출처·기준일을 명시

③ 찾는 길

`00-INDEX.md`

실제 노트만 [[링크]]로 연결

④ 답변

파일로 확인

AI에게 읽은 파일과 모르는 부분을 말하게 함

예: “9월 매입 조건이 뭐야?” → 회의록-대림상사-9월매입.md의 출처를 보고 답하기. 자료가 없으면 모른다고 답하기.

2~5번 도입·복습 한 장 정리의 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

오늘 · 120분

오늘 두 시간, 이렇게 갑니다

0:00 – 0:15

준비와 복습

처음 오신 분은 폴더를 만들면서, 세 주를 한 장씩 되짚습니다.

0:15 – 0:55

1부 — 스킬: 개념·이유·전후·실습

지난주에 만든 스킬을 실제로 도는 상태로 만듭니다.

0:55 – 1:40

2부 — 훅: 개념·이유·실습

지난주에 «다음 주»로 미뤄둔 그것. 걸고, 어겨보고, 오탐까지 봅니다.

1:40 – 2:00

마무리

네 주간 만든 것을 한 장으로. 질문.

오늘 목표는 하나 — 내가 안 시켰는데 AI가 알아서 하는 걸 직접 보고 가기.

갖고 가는 것 1

저절로 불려 나오는 스킬 한 개

새 대화에서 «이 파일 정리해줘» 한 마디로 도는 것까지 확인합니다.

갖고 가는 것 2

내 폴더에 걸린 훅 한 개

파일 이름 규칙을 기계가 지키게 합니다. 어기면 그 자리에서 걸립니다.

갖고 가는 것 3

막을까 알려만 줄까 판단

내 일에 어느 쪽이 맞는지 직접 두 번 돌려보고 고릅니다.

1부 · 스킬 · ① 개념

스킬은 자주 하는 일의 순서를 적은 파일입니다

1부 · 스킬

지난주에 «한 단어로 줄입니다» 라고 한 게 이겁니다

지난주까지

이 가상 메모로 회의록을 만들어줘.
1) 같은 주제의 노트가 있는지 봐줘
2) 메모에 없는 사실은 채우지 마
3) 실습노트 폴더에 저장해줘
4) 종류-대상-내용 으로 이름을 지어줘
5) 비슷한 파일이 있으면 먼저 알려줘
6) 저장 뒤 파일 경로와 쓴 사실을 보여줘

매번 복사해서 붙였습니다. 복사할 것이 어디 있는지도 기억해야 했습니다.

→

지금부터

“이 파일 정리해줘”

여섯 줄은 사라진 게 아니라 파일 한 장 안으로 들어갔습니다.

skills/노트정리/SKILL.md
---
name: note-organizer
description: 받은 메모로 회의록을 만들 때 사용한다
---
1) 같은 주제의 실습 노트를 찾는다
2) 메모에 없는 사실은 채우지 않는다
3) 종류-대상-내용 으로 이름을 짓는다
4) 기존 파일은 덮어쓰기 전에 알린다
5) 저장 경로와 쓴 사실을 보여준다

줄어든 건 글자 수가 아니라 내가 기억해야 하는 양입니다.

1부 · 스킬 · 제품별 적용

같은 SKILL.md, 읽는 위치는 다릅니다

Claude Code

작업대/.claude/skills/노트정리/SKILL.md

발견

name·description 확인

→

선택

본문 절차 읽기

예: “새 회의록 만들어줘”

description과 맞으면 → SKILL.md 절차를 읽고 → 파일명을 제안합니다.

프로젝트 폴더를 열어 작업할 때 이 설치본을 찾습니다.

Codex

작업대/.agents/skills/노트정리/SKILL.md

발견

이름·설명·경로 확인

→

선택

본문 절차 읽기

예: “새 회의록 만들어줘”

스킬의 이름·설명을 보고 → 선택 시 SKILL.md를 읽고 → 같은 절차로 제안합니다.

실행 폴더에서 저장소 루트까지 설치본을 찾습니다.

공통: description은 언제 쓸지 알리는 단서입니다. 직접 부를 수도 있습니다. 다른 제품의 발견 위치·선택 방식은 해당 제품에서 확인합니다.

1부 · 스킬

같은 파일인데, 두는 자리에 따라 갈립니다

작업대 = 지금 선택해 연 폴더
2026-09-22 Claude 실측

두는 자리	저절로 꺼내나	어떻게 부르게 되나
`작업대/skills/` 공통 원본	제품마다 다름 Claude 목록에는 안 뜸	사람이 지정해야 합니다 — «skills/노트정리/SKILL.md 를 읽고 그대로 해줘». 쓸 수는 있지만 매번 내가 기억해서 말해야 합니다.
`작업대/.claude/skills/` Claude용 복사본	예 목록에 뜸	Claude Code가 일을 보고 고릅니다. 이 폴더를 열 때만 뜨니 프로젝트 폴더에만 적용됩니다.
`~/.claude/skills/` Claude 전역 예시	예 어느 폴더에서나	어떤 폴더를 열어도 뜹니다. 일 가리지 않고 쓰는 것만 여기 둡니다 — 다 넣으면 고를 것이 많아져 엉뚱한 걸 꺼냅니다.

스킬 파일의 탄생과 설치

내 PC에는 원본 한 벌, 도구에는 읽을 수 있는 설치본

1부 · 스킬 · ② 왜·어떻게

직접 만들거나 가져와도, 설치와 시험은 같습니다

내 업무에서 직접 만들기

회의록 정리 스킬

내 파일 이름·확인 순서를 skills/노트정리/SKILL.md 원본에 적습니다.

출처 · 내가 해 온 절차
확인 · 없는 사실을 채우지 않는가?

내 규칙이 뚜렷할 때 유용합니다.

공개 스킬 가져오기

ELI5 설명 스킬

공개된 설치본을 가져오기 전에 본문·실행 명령·이용 조건을 읽습니다.

출처 · 공개 원본 저장소
확인 · 내 파일에 무엇을 실행하는가?

설명 방식을 빠르게 시험할 때 유용합니다.

두 경로가 합류하는 공통 절차

① 출처·내용 확인

본문·권한·실행 명령

→

② 내 도구에 설치

원본을 보존하고 프로젝트 설치본으로 복사

→

③ 새 대화에서 시험

같은 질문의 전후와 실제 발동 확인

ELI5 공개 예시: anthropics/claude-plugins-community · DreambigOu/ELI5. 설치 위치는 도구별로 다릅니다.

1부 · 스킬 · ③ 적용 예시

같은 질문, ELI5를 쓰면 설명이 어떻게 달라질까요?

고정 질문: “쇼핑 앱에서 본 운동화 광고가 왜 다른 앱에도 나와?” 아래는 시연용 예시 출력

적용 전

용어 중심 설명

“관심 신호와 광고 식별 정보가 광고 시스템에서 활용되어 맞춤형 광고가 노출됩니다.”

듣는 사람: “신호? 식별 정보? 중간 과정이 뭐지?”

→

ELI5 적용 후

그림으로 단계 설명

① 운동화에 관심

→

② 광고용 신호

→

③ 다른 앱의 광고

“가게에서 운동화를 본 흔적이 광고 추천에 쓰여, 다른 앱의 광고 자리에서도 운동화가 보일 수 있어요.”

작동 방식은 앱·설정마다 다를 수 있습니다.

강사 시연: 먼저 일반 답변을 받고 → ELI5 스킬을 설치한 새 대화에 같은 질문 → 쉬운 말·도식·이해도를 비교합니다.

영상 예시 잠깐 보기 ↗ 같은 질문에 설명 스킬을 적용한 전후를 보고 돌아옵니다.

1부 · 스킬

안 불려 나오는 이유는 셋뿐입니다

내 것이 어느 경우인지
다음 실습에서 찾습니다

이유	이렇게 보입니다	고칠 자리
자리가 아니다	스킬 이름을 물어보면 목록에 아예 없다	`작업대/skills/` 는 공통 원본입니다. Claude Code에서 자동 발동을 시험할 때만 `.claude/skills/`로 복사합니다. — Claude Code, 2026-09-22 실측
설명이 «언제»를 안 말한다	목록에는 있는데 한 번도 안 꺼낸다	`description` 한 줄을 고칩니다. «무엇을 한다»가 아니라 «언제 쓴다»로 시작합니다.
같은 대화에서 시험했다	되는 것처럼 보였는데 다음 날 안 된다	지금 대화는 이미 스킬 내용을 알고 있습니다. 시험은 새 대화에서만 유효합니다.

실습 1 · 시작 전

샘플 스킬을 프롬프트로 작업대에 준비합니다

세미클래스 강의 자료의 샘플 본문

→

로컬 skills/노트정리/SKILL.md

→

도구별 프로젝트 설치본

3주차 스킬이 있으면 보존합니다. 없다면 아래 프롬프트를 복사해 로컬 에이전트에게 붙여넣으세요.

샘플 스킬 원본 준비 · 설치 프롬프트

웹 자료의 본문을 프롬프트에 포함했습니다

기존 스킬은 보존

새 원본이 필요한 경우에만 SKILL.md를 만듭니다.

쓰는 도구에 설치

Claude Code 또는 Codex의 프로젝트 폴더에 복사합니다.

다음 장에서 확인

자동 발동은 새 대화에서 시험합니다.

샘플 스킬 원본 준비 · 설치 프롬프트 · 복사되는 전문

현재 Claude Code 또는 Codex에서 열어 둔 프로젝트 폴더를 먼저 확인해. 루트가 불명확하면 아무 파일도 만들지 말고 확인한 경로만 보고해.

이 폴더에 노트 정리 스킬의 공통 원본을 준비해줘. 아래 [SKILL.md 본문]은 세미클래스 강의 자료의 「노트 정리 샘플 스킬」에서 가져온 내용이야. 네가 웹 강의 자료를 읽을 수 있다고 가정하지 마.

1) skills/노트정리/SKILL.md가 이미 있으면 보존하고 그 파일을 사용해. 없으면 아래 본문 그대로 생성해.
2) 지금 실행 중인 도구가 Claude Code이면 원본을 보존하고 .claude/skills/노트정리/SKILL.md에 복사해. Codex이면 .agents/skills/노트정리/SKILL.md에 복사해. 도구가 불명확하면 설치는 건너뛰고 보고해. 전역 폴더는 건드리지 마.
3) 기존 설치본이 있으면 덮어쓰지 말고 차이를 보고해. 다른 파일은 이동·삭제하지 마.
4) 실제 생성·재사용·건너뛴 경로를 보여주고, 자동 발동은 다음 장의 새 대화 시험 전까지 확인되지 않았다고 말해.

[SKILL.md 본문]
---
name: note-organizer
description: 노트를 정리한다.
---

# 노트 정리

사용자가 회의록이나 노트 정리를 요청할 때 이 순서로 진행합니다.

1. 사용자가 제공한 메모와 같은 주제의 기존 노트를 읽습니다. 없으면 없다고 말합니다.
2. 메모에 없는 날짜·참석자·결론·수치는 지어내지 않습니다. 필요한 정보가 없으면 묻습니다.
3. 가상 실습 노트는 `종류-대상-내용.md` 형식으로 저장합니다. 현재 열린 폴더의 `실습노트/`를 사용합니다. 기존 작업대에 다른 실습노트 경로가 있으면 먼저 확인합니다.
실제 지식베이스에는 가상 내용을 넣지 않습니다.
4. 비슷한 파일이 있으면 덮어쓰기 전에 알려 줍니다.
5. 저장한 파일 경로와 메모에서 옮긴 사실을 짧게 보여 줍니다.
[본문 끝]

실습 1 · 13분

내 스킬을 불려 나오게 만듭니다

앞 장의 프롬프트로
원본과 설치본을 준비합니다

① 지금 상태 보기

목록에 있나부터

지금 자동으로 쓸 수 있다고 안내받은 스킬만 나열해줘.
파일 검색 결과로 목록을 채우지 마.

1) 내 노트 정리 스킬이 목록에 있나?
2) 없으면 이 작업대의 skills/에서 SKILL.md를 찾아줘.
   원본도 없다면 웹 강의 자료는 네가 읽을 수 있다고 가정하지 마.
   내가 먼저 샘플 본문을 복사해 작업대에 저장하도록 안내해줘.
3) skills/는 도구에 종속되지 않는 원본이다.
   Claude Code라면 원본을 보존하고 .claude/skills/로 복사할지 물어줘.
   다른 도구라면 그 도구의 공식 경로를 확인해줘.

복사 전 원본과 대상을 보여주고 내 허락을 받아.
원본을 삭제하거나 이동하지 마.

② 설명 한 줄 고치기

여기가 발동을 결정합니다

내 스킬의 description 한 줄을 고치고 싶어.
지금 줄은 「무엇을 하는지」만 적혀 있어서 AI 가 안 꺼내는 것 같아.

이렇게 해줘.
1) 지금 description 을 그대로 보여줘
2) 「언제 이 스킬을 꺼내 쓸지」가 앞에 오는 문장으로 세 가지 안을 만들어줘
   - 내가 실제로 할 만한 말을 그 안에 넣어줘
     (보기: «회의록 만들어줘», «이 파일 정리해줘»)
3) 내가 하나를 고르면 그걸로 바꿔 저장해줘
4) 바꾼 뒤 파일 맨 위 세 줄을 다시 보여줘

조건
- 본문(할 일·규칙)은 건드리지 마. 고치는 건 그 한 줄뿐이야
- 내 일과 상관없는 일반적인 표현으로 채우지 마

③ 새 대화에서 시험

여기서만 진짜 확인됩니다

실습용 가상 메모로 회의록 노트 하나 만들어줘.
대림상사와 9월 매입 물량을 논의했고, 단가는 아직 미확정이야.
다음 주에 단가를 재확인하기로 했어. 그 밖의 사실은 채우지 마.

(이 프롬프트는 반드시 «새 대화»에 붙여넣습니다.
 지금 대화는 이미 스킬 내용을 알고 있어서 시험이 되지 않습니다.)

보고 확인할 것
1) AI 가 스킬을 쓴다고 먼저 말하는가
2) 파일 이름이 «종류-대상-내용» 으로 나오는가
3) 어느 폴더에 넣었는가
4) 비슷한 노트가 있을 때 먼저 알려주는가

안 되면 본문이 아니라 description 을 다시 고칩니다.

1부 끝 · 2부 시작

여기까지는
“내가 시킬 때” 입니다

스킬은 부르면 옵니다. 그런데 부르는 것도 잊어버립니다.
안 불러도 오게 하는 것 — 훅.

2부 · 훅 · ① 개념

훅은 정해 둔 순간에 실행되는 검사입니다

2부 · 훅 · 이벤트 지도

훅 종류는 실행되는 순간으로 구분합니다

같은 파일명에서 PreToolUse는 쓰기 전 차단해 파일이 없고 PostToolUse는 쓰기 뒤 검사해 파일이 남는 Claude Code 실습 도식

2부 · 훅 · 제품별 적용

훅은 두 도구에 있습니다. 설정은 각각 다릅니다

Claude Code · 오늘 실습

작업대/.claude/settings.json

PreToolUse

Write 직전

→

검사 스크립트

파일명 확인

Claude 데스크톱 앱을 쓴다면 Code 탭에서 작업대를 열고, 뒤의 두 파일 실습을 진행합니다.

Codex · 대응 구조

작업대/.codex/hooks.json

PreToolUse

지원 도구 호출 직전

→

검사 스크립트

Codex 입력에 맞춰 확인

훅 정의를 /hooks에서 검토·신뢰해야 실행됩니다. Claude용 설정을 그대로 복사하지 않습니다.

오늘: 파일명 검사 코드는 Claude Code 사례로 시연합니다. Codex 사용자도 같은 개념을 보되, 설치·이벤트·권한은 자신의 실행 환경에서 확인합니다. 일반 ChatGPT 채팅에 로컬 훅 실행을 가정하지 않습니다.

훅 파일의 탄생과 실행 위치 · Claude Code 실습

설정 파일이 순간을 고르고, 검사 파일이 이름을 확인합니다

프로젝트 범위 · 오늘 실습의 스킬·훅 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

전역 범위 · 비교 예시의 스킬·훅 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

Claude Code·Codex 스킬 작성 규칙의 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

Claude Code·Codex 훅 작성 규칙의 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

Claude 데스크톱 Code 경로도의 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

ChatGPT 데스크톱 Codex 경로도의 파일 위치와 적용 흐름을 설명하는 1920×1080 그림

2부 · 훅 · Claude Code 예시

프롬프트 하나로 두 파일을 준비합니다

복사해 에이전트에게 붙여넣기

→

기존 설정 확인 · 변경안 승인

→

.claude/의 두 파일 생성

Claude Code 훅 준비 · 단일 프롬프트

settings.json과 check-name.py 본문 포함

설정 검사

기존 .claude/settings.json을 먼저 읽습니다.

변경안 승인

다른 훅을 보존하며 합칠 내용을 보여 줍니다.

두 파일 생성

에이전트가 작성·문법 검사하고 결과를 보고합니다.

Claude Code 훅 준비 · 단일 프롬프트 · 복사되는 전문

현재 Claude Code의 Code 탭에서 선택해 연 작업 폴더에, 오늘의 파일명 검사 훅을 준비해줘. 아래 두 파일의 내용을 이 프롬프트에 포함했으니 웹 강의 자료나 별도 파일을 네가 읽는다고 가정하지 마.

1) 현재 열린 프로젝트 루트를 확인해. 불명확하거나 Claude Code가 아니면 파일을 바꾸지 말고 이유를 보고해.
2) 기존 .claude/settings.json과 .claude/check-name.py가 있는지 먼저 읽어. 기존 설정·훅을 덮어쓰지 마. 새 설정을 합칠 수 있다면 변경안을 먼저 보여주고 내 확인을 받아. 충돌하면 그 파일은 건너뛰어.
3) 실습노트/가 없으면 현재 루트에 만들되, 기존에 정해 둔 실습노트 위치가 있으면 그것을 사용해.
4) 확인받은 뒤 .claude/ 아래 파일을 생성 또는 기존 설정에 병합해. JSON과 Python 문법을 검사하고, 실제 바꾼 파일·건너뛴 파일을 보고해. 테스트는 다음 장에서 진행해.

=== .claude/settings.json ===
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/check-name.py",
            "timeout": 10
          }
        ]
      }
    ]
  }
}
=== .claude/check-name.py ===
import sys, json, os, re

d = json.load(sys.stdin)
p = d.get("tool_input", {}).get("file_path", "")
n = os.path.basename(p)
parts = os.path.normpath(p).split(os.sep)

# 실습노트만 검사한다. 기존 지식베이스와 README·SKILL은 그대로 둔다
if "실습노트" not in parts or not n.endswith(".md") or n in ("README.md", "SKILL.md"):
    sys.exit(0)

# 종류-대상-내용 이면 통과
if re.match(r"^[^-\s]+-[^-\s]+-[^-\s]+\.md$", n):
    sys.exit(0)

print(f"파일 이름이 «종류-대상-내용» 규칙에 맞지 않습니다: {n}",
      file=sys.stderr)
sys.exit(2)
=== 파일 내용 끝 ===

실습 2 · 16분

걸고 → 일부러 어겨보고 → 멀쩡한 것도 넣어봅니다

두 번 다 통과해야
쓸 수 있는 훅입니다

① 설치 확인

실제로 준비됐는지 확인

앞 장의 프롬프트로 준비한 Claude Code 훅을 확인해줘.

1) 현재 프로젝트 루트와 .claude/settings.json,
   .claude/check-name.py 경로를 보여줘.
2) 기존 설정을 보존하면서 PreToolUse의 Write에
   파일명 검사기가 연결됐는지 확인해줘.
3) 검사 스크립트가 실습노트/ 안의 .md만 검사하고
   다른 문서에는 영향이 없는지 설명해줘.
4) 파일이 없거나 설정이 빠졌으면 임의로 채우지 말고
   앞 장의 설치 프롬프트를 다시 실행해야 한다고 알려줘.
5) 훅이 실제로 차단하는지는 다음 시험 전까지
   확인되지 않았다고 밝혀줘.

② 일부러 어겨보기

막히는지 봅니다

방금 걸어둔 훅이 진짜 도는지 시험해줘.

이렇게 해줘.
1) 오늘 만든 「실습노트/」에 규칙을 어긴 노트를 만들어봐
   - 회의록 9월.md        (띄어쓰기)
   - 회의록.md            (조각이 하나)
   - meeting-notes.md     (조각이 둘)
2) 각각에서 막혔는지, 막혔다면 어떤 문구가 나왔는지 보여줘
3) 막히지 않은 게 있으면 어디가 문제인지 찾아서 알려줘

조건
- 막혔다면 파일이 실제로 안 만들어졌는지 폴더를 확인해서 알려줘
- 다른 이름으로 바꿔서 다시 시도하지 마. 막히는 걸 보는 게 목적이야
- 내 진짜 노트는 건드리지 마

③ 오탐 보기 · 이름 바꾸기

멀쩡한 건 안 막혀야

이번엔 반대로 시험하고, 그다음 훅의 성격을 바꿔줘.

먼저 오탐을 보자.
1) 오늘 만든 「실습노트/」에 규칙에 맞는 노트를 만들어봐
   - 회의록-대림상사-9월매입.md
   - 견적서-한빛상사-10월.md
   이건 막히면 안 돼. 막히면 어디가 문제인지 알려줘
2) README.md·SKILL.md와 기존 지식베이스 문서는 검사에서 빠지는지 확인해줘
3) 시험용 노트 파일은 확인한 뒤 지워줘

그다음 성격을 바꿔보자.
4) settings.json 에서 「PreToolUse」 를 「PostToolUse」 로만 바꿔줘
5) 실습노트에 다시 규칙 어긴 이름으로 만들어봐 — 어떻게 달라지나?
6) 두 경우의 차이를 「막힌다 / 알려만 준다」 로 정리해줘
7) 실습노트에는 어느 쪽이 좋을지 물어봐줘

2부 · 훅

막을 것인가, 알려만 줄 것인가

아래 셋은 2026-09-22
실제로 돌려본 결과입니다

어떻게 뒀나	규칙 어긴 이름	규칙 맞는 이름	내 작업은
`PreToolUse` 쓰기 직전	막힘. 파일이 안 만들어지고, 내가 적어둔 문구가 AI 답변에 그대로 나옵니다.	통과 — 그냥 만들어집니다	멈춥니다. 이름을 고쳐야 넘어갑니다
`PostToolUse` 쓴 직후	안 막힘. 파일은 만들어지고, 어긋났다는 것만 알려줍니다.	통과 — 아무 말도 없습니다	안 멈춥니다. 나중에 고치면 됩니다

막는 쪽이 맞을 때

어긋난 파일이 쌓이면 골치인 것 — 거래처 자료, 세금 관련, 남과 같이 보는 폴더. 되돌리는 비용이 큰 쪽입니다.

알려만 주는 쪽이 맞을 때

일단 적어두는 게 먼저인 것 — 메모, 초안, _inbox/. 막히면 적기를 포기하게 됩니다.

2부 · 훅 · 다른 적용 예시

대화에서 정한 일도 잊지 않게 남길 수 있습니다

대화

“앞으로 회의록은
이 형식으로 쓰자.”

사람이 규칙을 확정

→

AI의 판단

확정된 결정인가?

확정 문장·출처·기록 후보를 구분

→

Stop 훅

형식과 중복 검사

조건을 통과한 후보만 기록

→

로컬 실습

결정-수업-로그.md

다음 대화에서 다시 찾음

핵심: 훅이 문장 뜻을 혼자 알아내는 것은 아닙니다. AI가 후보를 만들고, 훅은 정해 둔 조건을 검사합니다.

Stop은 AI의 매 응답 끝에 실행됩니다. 진짜 세션 종료 이벤트인 SessionEnd와 다릅니다.

2부 · 훅 · 판단 실습

세 문장 중 무엇을 기록할까요?

① 기록

“앞으로 회의록 파일명은
종류-대상-내용.md로 정합니다.”

확정한 규칙 · 출처가 있는 새 결정

결정-수업-로그.md에 한 줄 추가

② 건너뜀

“파일명 규칙을 바꾸면
어떨까요?”

제안일 뿐 · 확정 발화가 없음

기록하지 않음

③ 중복 건너뜀

“아까 정한 파일명 규칙
그대로 갑시다.”

이미 같은 결정을 기록함

새 줄을 만들지 않음

직접 해보기: 셋을 확정·제안·중복으로 분류한 뒤, 강의 자료의 결정 기록 훅 확장 실습에서 결과를 확인하세요. 팀 지식베이스에는 쓰지 않습니다.

2부 · 훅 · 복구

훅이 멀쩡한 파일까지 막으면?

① 증상

정상 이름이 차단

회의록-대림상사-9월매입.md를 쓰려는데 중단됐습니다.

기대 · 통과
관찰 · 차단, 파일 없음

→

② 원인 확인

설정과 검사기를 읽기

실제 파일명·오류 문구를 보고 settings.json과 check-name.py의 해당 규칙을 확인합니다.

점검 · 실행 경로, 입력, 정규식
판정 · 재현 뒤에 원인 확정

→

③ 승인 후 복구

이 훅만 고치기

다른 훅은 보존하고, 정상·위반 이름을 다시 시험합니다.

정상 · 파일 생성
위반 · 차단 또는 경고

고장 진단 · 복구 프롬프트

설정 파일 전체를 지우지 않습니다

현재 열린 폴더의 Claude Code 파일명 검사 훅이 정상 이름까지 막았어.
다른 훅과 기존 설정은 보존해. .claude/settings.json과 .claude/check-name.py를 읽고, 실제로 차단된 파일명·오류 문구·재현 결과를 먼저 보여줘.
원인을 찾으면 변경안을 보여주고 내 확인을 받아 해당 훅만 고쳐줘. 급히 멈춰야 한다면 이 훅 등록 항목만 비활성화하는 안을 제시해.
수정 후 규칙에 맞는 이름과 어긴 이름을 각각 시험하고, 파일이 생겼는지까지 보고해.

마무리

네 주 동안 작업대에 무엇이 남았나요?

1강 · 별도 작업대

세션이 끝나도 파일·규칙·자료가 남습니다.

2강 · 맥락의 범위

전역 → 루트 → 프로젝트 → 현재 요청을 구분합니다.

3강 · 답의 근거

원본·노트·INDEX를 실제 자료로 연결합니다.

4강 · 반복 절차

스킬을 설치하고 훅을 걸어 시험합니다.

선택한 폴더에 남는 것

선택한 폴더/
├── README.md · AGENTS.md · CLAUDE.md
│   └── 다시 읽을 작업대 규칙
├── 00-INDEX.md · 지식베이스/
│   └── 나중에 실제 자료로 채울 자리
├── _files/ · 프로젝트/
│   └── 원본과 진행 중인 일
├── skills/노트정리/SKILL.md
│   └── 반복 절차의 공통 원본
└── .claude/ 또는 .agents/
    └── 쓰는 도구의 설치·실행 설정

오늘 빈 구조만 만든 사람은 실제 자료와 개인 맥락을 앞으로 채웁니다.

마무리 · 과제

이번 주에는 이렇게 확인해 보세요

① 새 대화

같은 일을 사흘에 걸쳐 세 번

“이 파일 정리해줘”를 매번 새 대화에서 요청합니다.

확인할 결과
세 번 모두 스킬이 선택됐는지 기록합니다.

② 한 주 뒤

실습 폴더의 훅을 관찰

불편하면 에이전트에게 PostToolUse 변경을 요청합니다.

확인할 결과
실습노트/의 파일명과 경고 기록을 봅니다.

③ 다음 반복

세 번째 반복한 일을 스킬로

에이전트에게 절차 초안과 설치를 요청합니다.

확인할 결과
설치 경로와 새 대화의 스킬 목록을 봅니다.

AI 기초공사 4주차 · 끝

질문 시간

막힌 자리를 그대로 말해 주세요 — 화면 같이 보고 고칩니다.

오늘 쓴 프롬프트와 두 파일은 강의 화면의 강의 자료 에 그대로 있습니다.

반복하는 일자동화하기

빈 작업대 구조 만들기 · 단일 프롬프트

말로만 부탁

규칙과 자료를 파일로

다시 읽고 이어서

내 PC에서 공통

선택한 폴더 공통

해당 일에서만

지금 요청

_files/

읽은 내용

00-INDEX.md

파일로 확인

준비와 복습

1부 — 스킬: 개념·이유·전후·실습

2부 — 훅: 개념·이유·실습

마무리

발견

선택

발견

선택

회의록 정리 스킬

ELI5 설명 스킬

① 출처·내용 확인

② 내 도구에 설치

③ 새 대화에서 시험

용어 중심 설명

그림으로 단계 설명

① 운동화에 관심

② 광고용 신호

③ 다른 앱의 광고

세미클래스 강의 자료의 샘플 본문

로컬 skills/노트정리/SKILL.md

도구별 프로젝트 설치본

샘플 스킬 원본 준비 · 설치 프롬프트

① 지금 상태 보기

② 설명 한 줄 고치기

③ 새 대화에서 시험

여기까지는“내가 시킬 때” 입니다

PreToolUse

검사 스크립트

PreToolUse

검사 스크립트

복사해 에이전트에게 붙여넣기

기존 설정 확인 · 변경안 승인

.claude/의 두 파일 생성

Claude Code 훅 준비 · 단일 프롬프트

① 설치 확인

② 일부러 어겨보기

③ 오탐 보기 · 이름 바꾸기

“앞으로 회의록은이 형식으로 쓰자.”

확정된 결정인가?

형식과 중복 검사

결정-수업-로그.md

“앞으로 회의록 파일명은종류-대상-내용.md로 정합니다.”

“파일명 규칙을 바꾸면어떨까요?”

“아까 정한 파일명 규칙그대로 갑시다.”

정상 이름이 차단

설정과 검사기를 읽기

이 훅만 고치기

고장 진단 · 복구 프롬프트

같은 일을 사흘에 걸쳐 세 번

실습 폴더의 훅을 관찰

세 번째 반복한 일을 스킬로

질문 시간

반복하는 일
자동화하기

`_files/`

`00-INDEX.md`

여기까지는
“내가 시킬 때” 입니다

“앞으로 회의록은
이 형식으로 쓰자.”

“앞으로 회의록 파일명은
종류-대상-내용.md로 정합니다.”

“파일명 규칙을 바꾸면
어떨까요?”

“아까 정한 파일명 규칙
그대로 갑시다.”