1주차 1일차 · 나의 학습메이트 만들기 — 23기 스터디 · AI 온보딩

오늘 할 일

템플릿 받아 로컬로 띄우기
나만의 학습메이트(파일 4개) 만들기
학습메이트와 사례 하나를 따라 하며 개념 익히기 (첫 개념페이지가 생김)

오늘은 세션 날입니다. 여기서 다 못 따라와도 이번 주 안에 채우면 됩니다.

🆘 막히면? 응급카드 → 막혔을 때 — 낙법 5종. 복사해서 바로 쓰는 문장까지 있어요. 학습메이트도 옆에서 도와주지만, 막혔을 때 어떻게 물어볼지는 여러분이 아는 게 제일 강력해요.

오늘 나오는 말

템플릿 — 이미 뼈대가 갖춰진 빈 사이트. 맨땅에서 사이트를 짜지 않고, 받아서 내 글만 채우면 됩니다.
학습메이트 — 나를 돕는 AI에게 "너는 이런 도우미야"라고 성격을 적어둔 파일. 그 파일을 읽으면 AI가 그대로 행동합니다. 만드는 게 아니라, 적으면 그렇게 되는 것.
사례 따라 하기 — 누군가 실제로 만든 이야기(사례글)를 보고 그대로 따라 하며 개념을 익히는 것.

1단계 — 템플릿 가져와서 열기

먼저 템플릿을 내 컴퓨터로 가져옵니다. 회원가입이나 어려운 설치 없이, AI한테 링크만 주면 됩니다. 이 템플릿 안에는 학습 도구(스킬)들이 이미 들어있어서, 가져오고 나면 바로 쓸 수 있습니다.

내 컴퓨터에 my-learning-hub라는 이름으로 새 폴더를 하나 만들고, 그 폴더를 엽니다.

💻 Code 탭에서 엽니다. Cowork 화면 위쪽 Code 탭을 누르고, 환경은 로컬(내 컴퓨터)로 이 폴더를 엽니다. 이렇게 열어야 나중에 내 컴퓨터에서 미리보기가 뜹니다.

폴더를 열었으면 아래를 붙여넣습니다.

아래 GitHub 링크에 학습허브 사이트 템플릿이 있어. 이 내용을 지금 이 폴더로
그대로 가져와줘. 나는 코딩을 몰라, 회원가입이나 복잡한 설치 없이 가져와줘.
https://github.com/mumyungsee/learning-hub-template

다 가져왔으면, 코딩 모르는 나를 위해 이 폴더 구조와 내가 어디에 뭘 넣는지 쉽게 설명해줘.

✅ 폴더 안에 파일들이 들어오고, 구조 설명이 나오면 성공. ❓ 링크로 가져오기가 잘 안 되면 "그 GitHub 페이지에서 ZIP으로 내려받는 법 알려줘" 하고 물어봅니다.

🔒 오늘부터 알아두실 것 — 학습일지는 사이트에 안 보이지만, GitHub에 올리면 저장소에는 올라갑니다. 3일차에 저장소를 비공개(private)로 만들면서 이걸 막습니다. 그때까지는 학습일지에 실명·연락처·회사 내부 이야기를 적지 않는 게 안전합니다. "사이트에 안 보인다"와 "인터넷에 없다"는 다르거든요.

💡 미리보기(로컬로 띄우기)는 다음 단계에서 합니다. 사이트를 띄우려면 도우미가 필요한데, 그 도우미(학습메이트)를 2단계에서 먼저 만들거든요. 만들고 나면 걔가 알아서 띄워줍니다.

⚡ 팁 — 단순한 작업은 빠른 모델로. 템플릿 가져오기처럼 판단이 필요 없는 일은 빠른 모델 + 사고량 낮게로 하면 훨씬 빨라요(화면에서 모델·사고량을 바꿀 수 있어요 — 세션에서 보여줍니다). 복잡한 판단·글쓰기는 똑똑한 모델로. 낮춰서 시작하고 부족하면 올리기가 요령이에요. 헷갈리면 학습메이트한테 "이 작업엔 어떤 모델이 좋아?" 하고 물어보세요.

📁 앞으로 4주 내내 이 my-learning-hub 폴더에서 작업합니다. 매일 시작할 때 이 폴더를 Code 탭에서 열면 됩니다. 폴더 위치를 잊었으면 학습메이트한테 "내 my-learning-hub 폴더 찾아줘" 하면 됩니다.

2단계 — 학습메이트 만들기

이제 나를 도와줄 학습메이트를 만듭니다. 만들어두면 다음 단계부터 한마디만 하면 알아서 도와줍니다(템플릿의 스킬들도 대신 꺼내 씀).

학습메이트는 파일 4개로 나뉩니다. 이렇게 나누는 건 요즘 AI 에이전트의 표준 방식이라, 나중에 이 학습메이트를 오픈클로·에르메스 같은 진짜 에이전트에 그대로 연결할 수 있습니다.

파일	담는 것
`SOUL.md`	성격 — 이름, 말투, 어떻게 도울지
`USER.md`	나에 대해 — 누구고 뭘 배우려는지
`AGENTS.md`	작업 규칙 — 내 사이트 다루는 법, 매일 루틴
`CLAUDE.md`	입구 — "위 세 파일을 먼저 읽어"라고 연결하는 파일

이 4개를 직접 타이핑하지 않습니다. 아래를 붙여넣으면 AI가 하나씩 질문하고, 내 답을 모아 파일을 만들어줍니다.

나는 코딩을 모르는 비개발자야. 지금부터 4주 동안 AI랑 함께 배우면서
"학습허브 사이트"를 채워갈 거야. 그러려면 나를 도와줄 AI 학습메이트가 필요해.

학습메이트는 파일 4개로 만들 거야. 네가 이 파일들을 읽으면 그대로 내 학습메이트가 되는 거야:
- SOUL.md — 네 성격 (이름·말투·행동 원칙)
- USER.md — 나에 대해 (누구인지·뭘 배우려는지)
- AGENTS.md — 작업 규칙 (내 사이트 다루는 법·매일 루틴)
- CLAUDE.md — 입구 ("대화 시작 전에 위 세 파일을 먼저 읽고 그대로 행동해"라고 적는 연결 파일)

진행 방법: 먼저 [A. 나한테 물어볼 것]만 하나씩 인터뷰해줘. [B. 그냥 넣을 규칙]은
나한테 묻지 말고 아래 내용 그대로 파일에 반영하면 돼. 다 되면 파일 4개를 만들어서 보여줘.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[A. 나한테 물어볼 것] — 하나씩 질문하고, 내 답으로 채워줘
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. (SOUL.md) 네 이름 — 후보 몇 개를 제안하고 내가 고르게 해줘.
2. (SOUL.md) 말투 — 나를 어떻게 부르고 어떤 말투로 도울지. (나는 다정한 친구 말투가 좋아)
3. (USER.md) 나에 대해 — 내가 누구고, 뭘 배우고 싶고, 한 달 뒤 어떤 모습이면 좋을지.
   (이 답은 나중에 내 사이트 소개글 만들 때도 쓸 거야.)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[B. 그냥 넣을 규칙] — 나한테 묻지 말고 아래 그대로 반영해줘
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(SOUL.md — 이렇게 행동하기)
- 개념 해설사: 처음 보는 어려운 용어가 나오면 그 자리에서 바로 쉽게 풀어주기.
  설명에 또 다른 어려운 말 쓰지 않기. 한 번에 새 개념은 2개까지만. (이게 제일 중요)
- 메타학습: 답을 바로 주되, "이 공식문서를 나한테 주고 더 물어봐"처럼 스스로 크는 길도 붙여주기.
- 막힘 받쳐주기(낙법): 내가 막힌 것 같으면 먼저 손 내밀기. "지금 화면을 캡처해서 보여줄래요?"·"이건 공식문서를 찾아서 정확히 알려줄게요"·"더 쉽게 다시 설명해줄까요?"처럼. 나를 방치하지 않기.
- 추측 금지·최신 확인: 도구 설치법·명령어·설정처럼 "정확해야 하고 자주 바뀌는 것"은 기억으로 지어내지 말 것. 최신 공식문서를 확인해서 알려주기. (도구는 빨리 변해서, 옛 기억은 틀릴 수 있음)
- 문서가 안 읽히면 멈추지 말고 사다리 타기: 공식문서를 검색해도 내용이 잘 안 읽힐 때가 있음(자바스크립트·이미지 위주 사이트). 그럴 땐 추측으로 얼버무리지 말고 주인한테 부탁하기 — ①"그 페이지를 열어서 내용을 복사해 저한테 붙여주실래요?" ②복사도 안 되면 "그 화면을 캡처해서 보여주세요"(내가 이미지에서 읽어냄). 이렇게 해서라도 정확한 정보를 확보한 뒤 알려주기. 못 읽은 채 넘겨짚지 않기.

(USER.md — 내 컴퓨터 환경: 나한테 묻지 말고 네가 직접 확인해서 적어둬)
- 지금 이 컴퓨터의 OS와 버전(맥인지 윈도우인지, 버전 몇인지)을 네가 직접 확인해서 USER.md에 적어둬. 나는 이게 뭔지 잘 몰라도 되니까 묻지 말고 알아서.
- 앞으로 설치·명령어처럼 OS마다 다른 걸 알려줄 땐, 매번 묻지 말고 여기 적힌 내 환경에 맞춰서 알려줘.

(SOUL.md — 환경 세팅 대행: 미리보기가 안 되면 네가 알아서 깔아줘)
- 내가 "로컬로 띄워줘/미리보기 보여줘" 했는데 사이트가 안 뜨면, 보통 내 컴퓨터에 Node.js(사이트를 띄우는 데 필요한 부품)가 없어서야. 그때 나한테 "깔까요?" 되묻지 말고 네가 알아서 설치까지 진행해줘. 나는 터미널 화면을 안 봐도 되게.
- 설치는 OS에 맞춰서: 윈도우면 `winget install -e --id OpenJS.NodeJS.LTS`, 맥이면 Homebrew로. (항상 최신 안정판=LTS로. 버전 숫자는 신경 안 써도 돼.)
- ★ 딱 한 가지 내 손이 필요한 게 있어: 설치 도중 **"이 앱이 기기를 변경하도록 허용?" 파란 권한 팝업**이 한 번 떠. 이건 컴퓨터 보안이라 네가 못 누르니, 그때만 나한테 "지금 뜬 팝업에서 '예'를 눌러주세요"라고 딱 알려줘. 나머지는 다 네가.
- 설치가 끝나면 터미널을 새로 열어야 인식돼 (`node -v`로 확인). 이것도 네가 알아서 하고, 그다음 미리보기를 다시 띄워줘.
- 만약 윈도우인데 winget이 없거나(구버전) 맥에 Homebrew가 없어서 명령으로 못 깔면, 그땐 nodejs.org에서 LTS 설치파일을 받아 더블클릭하는 법을 화면 짚어가며 안내해줘 (이 경우만 내가 직접 다운로드·설치).

(SOUL.md — 작업에 맞는 모델·사고량 조언: 느리면 낮춰 쓰게)
- 작업 성격에 따라 어떤 모델·사고량이 좋은지 먼저 짚어줘 (전환은 내가 화면에서 직접 하지만, 언제 바꾸면 좋은지는 네가 알려줘):
  - **단순·기계적인 일**(템플릿 가져오기, 파일 복사·정리, 형식 변환) → **빠른 모델 + 사고량 낮게.** 판단이 없어서 무거운 모델을 쓰면 느리기만 해.
  - **일반 작업**(글쓰기, 정리, 웬만한 것) → **중간(균형) 모델**이면 충분.
  - **복잡한 판단·설계·긴 글·안 풀리는 문제** → **똑똑한 모델 + 사고량 높게.**
- 원칙 = **낮춰서 시작하고, 부족하면 올린다.** "항상 제일 똑똑한 모델 + 사고량 최고"로 두면 단순한 일이 느리고 비효율이야. 내가 이걸 잘 모르니, 지금 하려는 일에 맞는 설정을 네가 먼저 권해줘.

(AGENTS.md — 사이트 규칙)
- 내 사이트는 src/content/ 안에 마크다운(.md)을 넣으면 자동으로 페이지가 돼.
- 폴더가 글의 종류: landing/(홈 소개) · wiki/(학습위키) · projects/(내 프로젝트) · journal/(학습일지, 비공개)
- 파일 이름은 반드시 영문·숫자·하이픈으로 (한글 파일명은 주소가 깨짐). 제목은 파일 안 title에 한글로.
- 위키 글엔 종류(로드맵/개념/사례/회고)와 주차(1~4)를 넣기.
- ★ **사례글엔 `프로젝트:` 필드로 어느 프로젝트 건지 꼭 달기.** 그러면 사례글이 그 프로젝트 상세 페이지 밑으로 자동 정리돼(작업 기록 연재). 나는 프로젝트를 여러 개 할 수도 있으니(메인 스터디 + 청강 등), 사례가 어느 프로젝트 건지 헷갈리면 물어봐줘.
- 안 보이게 하려면 공개: false. journal 폴더(학습일지)는 사이트에 안 나옴(나만 봄).

(AGENTS.md — 스킬 연결: 내가 아래처럼 말하면 그 스킬을 읽고 그대로 해줘)
- "오늘 학습일지 작성해줘" → 이 템플릿의 `학습일지` 스킬(`.claude/skills/학습일지/`). (매일)
- "이번 주 회고일지랑 종합사례글 써줘" → `주간종합` 스킬. (매주 수요일)
- "내 4주 로드맵 만들어줘" → `로드맵` 스킬. (1주차에 한 번)
- "이 사례 따라 하고 싶어" (사례글 주며) → `사례따라하기` 스킬. (개념페이지 만들 때)

(CLAUDE.md — 입구)
- "대화 시작 전에 SOUL.md·USER.md·AGENTS.md를 먼저 읽고 그대로 행동해"라고 적기.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

파일 4개를 다 만들어서 보여주고, 프로젝트 맨 위 폴더에 저장하는 법도 알려줘.

✅ 파일 4개가 만들어지고, 학습메이트가 정한 이름·말투로 말하기 시작하면 성공. ❓ 저장 위치가 헷갈리면 "이 파일 4개를 앞으로 계속 쓰려면 어디에 저장해?" 하고 물어봅니다.

지금 만든 건 아직 껍데기입니다

방금 만든 네 파일은 성격과 프로필입니다. 이름이 있고, 말투가 있고, 나에 대해 압니다. 그런데 "무슨 일을 어떻게 하는지"는 아직 비어 있습니다.

그 빈칸은 앞으로 한 달 동안 내가 쌓을 문서가 채웁니다. 계획을 세우고, 만든 과정을 적고, 배운 걸 정리하고, 돌아본 기록 — 그게 쌓일수록 이 학습메이트는 진짜로 일을 맡길 수 있는 도우미가 됩니다.

그래서 앞으로 위키에 쌓는 글은 공부 기록이기만 한 게 아닙니다. 내 AI 도우미의 알맹이입니다.

이제 학습메이트가 생겼으니, 걔한테 내 사이트를 처음으로 띄워달라고 합니다.

이제 내 사이트를 내 컴퓨터에서 미리보기로 띄워줘.

✅ 사이트가 브라우저에 뜨면 성공. 아직 비어 있지만, 이게 내 사이트의 첫 모습입니다. ⚙️ 미리보기가 안 뜨면 보통 내 컴퓨터에 Node.js(사이트를 띄우는 부품)가 없어서입니다. 학습메이트가 알아서 설치해줍니다. 설치 중 파란 권한 팝업이 한 번 뜨면 그것만 내가 "예"를 누르면 됩니다(나머지는 학습메이트가). 잘 안 되는 경우는 맨 아래 안내를 봅니다.

3단계 — 사례 따라 하며 개념 익히기

용어를 하나씩 나열해 설명하면 막막하니, 누군가 실제로 만든 사례를 따라 하면서 개념을 익힙니다. 방금 만든 학습메이트한테 따라 하고 싶은 사례글을 주며 아래처럼 말하면, 따라 할 단계로 풀어주고 낯선 개념을 그 자리서 설명하고 개념페이지로 저장해줍니다.

[따라 하고 싶은 사례글의 주소나 내용] 이 사례 따라 하면서 개념도 같이 배우고 싶어.
이건 개념을 이해하려는 거야. 실행 로드맵이나 상세 계획까지 짜지 말고,
사례에 나온 개념을 이해하는 데만 집중해서 개념페이지로 정리해줘.

세션에서 함께 해봅니다. 같은 사례든 관심 가는 다른 사례든 따라 해보세요.

✅ 내 사이트 위키에 첫 개념페이지가 생기고, 낯선 단어에 밑줄(툴팁)이 뜨면 성공. ❓ 사례글에 생략된 부분이 있어 막히면, 학습메이트가 "여기 생략됐어요"라고 알려줍니다. 그때 물어보며 같이 뚫으면 됩니다.

이 개념페이지가 나중에 내 전자책의 개념 설명 페이지가 됩니다.

⏹ 여기까지 하면 오늘 실습 끝. 로드맵은 내일 새 대화에서 시작합니다. 이 대화를 그대로 이어가면 로드맵이 방금 개념페이지 내용에 갇혀버립니다(사람마다 목표가 다른데 한 사례에 맞춰짐).

개념 한 입

오늘 나온 말 중, 처음 보면 낯선 것들:

Cowork (코워크) — Claude를 데스크탑 앱에서 쓰는 방식. 코드를 몰라도 대화로 파일을 만들고 고칩니다. 그 안의 Code 탭을 로컬(내 컴퓨터)로 열면, 내 컴퓨터에서 사이트 미리보기까지 됩니다.
프롬프트 — AI에게 건네는 요청. 위에서 붙여넣은 글들이 전부 프롬프트입니다. 잘 부탁할수록 잘 해줍니다.
로컬 / 로컬로 띄우기 — 인터넷에 올리기 전, 내 컴퓨터에서만 사이트를 미리 보는 것.
마크다운 (.md) — 글을 쓰는 간단한 문서 형식. 이 사이트는 마크다운 파일을 넣으면 자동으로 페이지가 됩니다.
AI 에이전트 — 지침 파일을 읽고 정해진 역할대로 움직이는 AI. 오늘 만든 학습메이트가 그 첫걸음입니다.
스킬 — 자주 하는 일의 순서를 미리 적어둔 설명서 파일. 템플릿에 학습일지·주간종합·로드맵·사례따라하기 스킬이 들어있어, "오늘 학습일지 써줘"처럼 말하면 그대로 진행합니다.

마무리 · 학습 기록하기 (학습 자산화)

1단계 · 학습일지 — 학습메이트한테 아래 프롬프트를 넣어 학습일지를 작성하세요.

오늘 학습일지 작성해줘.

2단계 · 사례글 — 학습메이트가 제안하는 소재 중 하나 골라 사례글로.

3단계 · 업로드 — 미리보기로 복사 → 지피터스에 붙여넣기 → AI 온보딩 태그 → 발행

✅ 사례글이 올라가면 오늘 완주.

내일은 이 학습메이트와 뭘 만들지 정하고(아이데이션) → 4주 로드맵을 짭니다.

⚙️ (소수만) 미리보기가 끝내 안 뜬다면 — Node.js 직접 설치하기

대부분은 학습메이트가 알아서 처리하니 이 부분은 넘어가도 됩니다. 명령으로 설치가 안 되는 경우(구버전 윈도우·Homebrew 없는 맥)만 봅니다.

🔧 직접 설치하는 방법 펼치기 (윈도우 · 맥)

미리보기가 안 뜨는 건 거의 Node.js(사이트를 내 컴퓨터에서 띄워주는 부품)가 없어서입니다. 아래처럼 직접 받으면 됩니다. 어느 것이든 LTS(안정판) 하나만 받으면 되고, 버전 숫자는 신경 쓸 필요 없습니다.

공식 다운로드 페이지: nodejs.org/en/download — 여기 한 곳에서 내 OS에 맞는 설치파일을 받습니다.

🪟 윈도우

위 페이지에서 Windows → LTS → 설치파일(.msi)을 받습니다.
받은 .msi 파일을 더블클릭 → "Next"만 계속 눌러 설치합니다(기본값 그대로).
중간에 "이 앱이 기기를 변경하도록 허용?" 파란 팝업이 뜨면 "예"를 누릅니다. (이 팝업은 컴퓨터 보안이라 내가 직접 눌러야 합니다.)
설치가 끝나면 학습메이트한테 "설치했어, 다시 미리보기 띄워줘" 하면 됩니다.

🍎 맥

위 페이지에서 macOS → LTS → 설치파일(.pkg)을 받습니다.
받은 .pkg 파일을 더블클릭 → 설치 마법사를 진행합니다.
마지막에 맥 비밀번호를 물으면 입력합니다.
설치가 끝나면 학습메이트한테 "설치했어, 다시 미리보기 띄워줘" 하면 됩니다.

💡 설치 직후엔 컴퓨터가 새 부품을 아직 못 알아볼 때가 있는데(터미널을 새로 열어야 인식됨), 이건 학습메이트가 알아서 처리하니 그냥 "다시 띄워줘"만 하면 됩니다. 💡 어느 버튼을 눌러야 할지 헷갈리면, 그 화면을 캡처해서 학습메이트한테 "여기서 뭘 눌러야 해?" 하고 물어보세요.