---
name: study-notes
description: inbox/의 공부 필기(공부-*.txt)를 templates/공부노트.md 양식으로 정리해 notes/에 공부 노트로 저장한다. "공부 노트 정리해 줘", "강의 필기 정리", "책 읽은 거 정리" 같은 요청이나 inbox/공부-*.txt 를 정리해 달라고 할 때 쓴다. 회의 메모는 meeting-notes, 회고 메모는 weekly-review 를 쓴다.
---

# study-notes — 공부 필기 → 공부 노트

## 언제 쓰나

- 강의·책·영상을 보고 적은 `inbox/공부-YYYY-MM-DD-주제.txt`를 공부 노트로 정리할 때
- 예: "10/28 프롬프트 강의 필기 공부 노트로 만들어 줘"

## 읽을 파일 (순서대로)

1. `CLAUDE.md` — 이 폴더의 정리 규칙 5개
2. `templates/README.md` — 양식 사용법과 점검표
3. `templates/공부노트.md` — 쓸 양식
4. 원본 필기 `inbox/공부-YYYY-MM-DD-주제.txt` — **읽기만 한다. 절대 고치지 않는다.**

## 쓸 양식

`templates/공부노트.md`를 그대로 복사해 `{{ }}` 자리만 채운다. 칸 이름·순서(1. 한 줄 요약 → 2. 핵심 내용 → 3. 새로 안 말 → 4. 주의할 것 → 5. 질문할 것 → 6. 해볼 것 → 7. 해본 결과)를 바꾸지 않는다.

칸별로 채우는 법:

- **머리말** — 출처·분량·원본 메모 경로. 메모에 없으면 `(메모에 없음)`.
- **1. 한 줄 요약** — 필기 전체를 한 문장으로.
- **2. 핵심 내용** — 3~7개, 필기를 베끼지 말고 쉬운 말로 다시 쓴다. 필기에 있는 예가 있으면 붙인다.
- **3. 새로 안 말** — 필기에 나온 용어와 뜻을 표로. 뜻이 필기에 없으면 지어내지 말고 뜻 칸에 `(메모에 없음)` — 이 용어는 5번 질문할 것에도 올린다.
- **4. 주의할 것** — 필기에 적힌 틀리기 쉬운 점.
- **5. 질문할 것** — 필기에 적힌 모르는 것·물음표. 없으면 양식 주석대로 `(없음)`.
- **6. 해볼 것** — 필기에 적힌 적용 계획을 `- 언제: 무엇을` 형태로. 언제가 메모에 없으면 `- (메모에 없음): 무엇을`.
- **7. 해본 결과** — 양식 주석대로 처음엔 `(아직 안 해 봄)`. 필기 안에 해 본 결과가 적혀 있을 때만 날짜와 함께 채운다.
- 쓸 게 없는 칸은 지우지 않고 `(메모에 없음)`이라고 쓴다.

날짜: 제목은 양식대로 `2026-10-28(화)`, 본문은 `10/28(화)`처럼 월/일 + 괄호 요일. 요일은 달력으로 확인한다(`date -j -f %Y-%m-%d 2026-10-28 +%a`).

**메모에 없는 내용은 지어내지 않는다.** "내 말로" 다시 쓰는 것은 표현만 바꾸는 것이지, 필기에 없는 지식을 보태는 것이 아니다.

## 저장 위치

- `notes/공부-YYYY-MM-DD-주제.md` (날짜·주제는 원본 필기 파일명에서)
- 예: `inbox/공부-2026-10-28-프롬프트-강의.txt` → `notes/공부-2026-10-28-프롬프트-강의.md`
- 같은 이름의 파일이 이미 있으면 덮어쓰기 전에 사용자에게 묻는다.

## 끝나고 확인할 점검표

저장한 파일을 다시 열고 위에서부터 확인한다. 하나라도 ✗면 고친 뒤 다시 확인한다.

**공통**
- [ ] 칸 이름과 순서가 양식과 같다 (지운 칸이 없다 — 쓸 게 없으면 `(메모에 없음)`)
- [ ] `{{`가 하나도 남아 있지 않다 (`grep -n '{{' notes/공부-....md` 결과가 비어 있음)
- [ ] 날짜에 요일이 붙어 있고, 파일명 날짜와 제목 날짜가 같다
- [ ] 숫자·이름·날짜를 원본 필기와 한 번 대조했다
- [ ] 필기에 없는 내용을 지어내지 않았다
- [ ] `inbox/` 원본을 고치지 않았다 (`git status inbox/`에 이번 작업으로 생긴 변경이 없음)

**공부 노트**
- [ ] 핵심 내용을 베끼지 않고 쉬운 말로 썼고, 3개 이상이다 (필기에 3개가 안 되면 있는 만큼 쓰고 사용자에게 알린다)
- [ ] 필기에 나온 모르는 말은 전부 '새로 안 말' 표에 뜻과 함께 있다
- [ ] 해볼 것이 "언제 · 무엇을" 할 수 있는 행동이다 ("잘 써 보기" ✗ → "월요일 인스타 글에 역할+형식 넣기" ✓)
- [ ] 해본 결과가 `(아직 안 해 봄)`이거나, 필기에 적힌 날짜·결과다

마지막으로 사용자에게 저장 경로와, `(메모에 없음)`으로 남긴 칸 목록을 알려 준다.