---
name: study_engineering-note
description: "사용자가 대화 중 질문했거나 새로 배운 내용(기술/엔지니어링)을 Notion의 엔지니어링 문서에 정리해서 페이지로 추가합니다. 출처 링크 포함, 정해진 양식(제목/요약/정리/예시/방안)에 맞춰 작성하고 필요시 하위 페이지 구조 제안 후 승인받아 생성합니다. Triggers on: 'engineering note', '노션에 정리', '엔지니어링 노트', '공부한 거 정리', 'notion 페이지 추가', '배운 거 정리', '학습 정리', 'study note', '몰랐던 거 정리'."
---

# 📚 Study — Engineering Note to Notion

사용자가 대화 중 질문했거나 새로 알게 된 기술적 개념·엔지니어링 지식을 **Notion 엔지니어링 문서**에 체계적으로 정리하여 페이지로 추가합니다.

## 대상 Notion 페이지

**엔지니어링 문서 루트 (부모 페이지)**:
- URL: https://www.notion.so/299d0264df7c80d5982bdf4d2f4d9d07
- Page ID: `299d0264df7c80d5982bdf4d2f4d9d07`

---

## 실행 순서

### 1. 🔍 정리할 주제 수집

사용자의 요청에서 "정리할 주제"를 파악합니다. 소스는 다음 중 하나:

- **이번 대화에서 사용자가 물어본 질문** (예: "git rebase가 뭐야?" → "Git Rebase" 주제)
- **이번 대화에서 사용자가 명시한 특정 주제** (예: "HTTP/3 정리해줘")
- **여러 질문이 한 번에 있을 경우** → 주제별로 분리

### 2. 🔬 정보 조사 및 출처 수집

각 주제에 대해:
- `WebSearch` 또는 `WebFetch` 로 최신 정보 확보 (공식 문서 우선)
- 대화 중 이미 Claude가 답변한 내용도 포함
- **모든 정보의 출처 URL을 기록** (공식 docs, MDN, RFC, GitHub, 논문 등)

### 3. 🧱 페이지 구조 결정

**기본 템플릿 (단일 페이지)**:
```
📄 {제목}

## 📌 요약
{2~3문장으로 핵심 설명}

## 🔎 구체적인 정리
{개념, 원리, 동작 방식을 상세히}

## 🎯 시나리오 예시
{실제 사용 맥락 / 언제 필요한가 / 문제 상황}

## 💻 사용 방법 및 코드 예시
```{언어}
// 실제 동작하는 예제 코드
```

## 🏗 구체적인 엔지니어링 방안
- 선택지 비교 (A vs B vs C)
- 트레이드오프
- 베스트 프랙티스

## 🧾 최종 요약
{한 문단으로 take-away}

## 🔗 출처
- [공식 문서 제목](URL)
- [참고 블로그](URL)
- ...
```

> **섹션 가감 규칙**: 주제 성격에 따라 불필요한 섹션은 생략, 필요한 섹션은 추가 (예: "이력/변천사", "성능 비교표", "주의사항" 등)

### 4. 🌳 하위 페이지 필요성 판단

주제가 크거나 복수 하위 개념을 포함하면 하위 페이지 구조를 **먼저 제안**:

```
예시:
📄 Git Internals
  ├─ 📄 Objects (Blob, Tree, Commit, Tag)
  ├─ 📄 Refs (Branches, Tags, HEAD)
  ├─ 📄 Index / Staging Area
  └─ 📄 Packfiles & GC
```

→ **사용자에게 이 구조가 맞는지 확인 후 진행**.
단순 주제는 하위 없이 단일 페이지로 바로 생성.

### 5. 📤 Notion 페이지 생성

승인되면 `notion-create-pages` 로 페이지 생성:
- **parent**: `299d0264df7c80d5982bdf4d2f4d9d07` (엔지니어링 문서 루트)
- **title**: 주제명
- **content**: 위 템플릿 형식의 마크다운

하위 페이지가 있으면 각 하위도 같은 방식으로 생성 (parent = 방금 만든 상위 페이지 ID).

### 6. ✅ 결과 보고

사용자에게 전달:
- 생성된 Notion 페이지 URL
- 페이지 구조 (하위 페이지가 있는 경우 트리로)
- 다음에 추가 정리할 주제가 있는지 물음

---

## 작성 원칙

1. **출처 필수**: 검증 불가한 주장은 쓰지 않음. 모든 섹션에 근거 링크.
2. **코드는 실행 가능하게**: 복붙 가능한 완성된 예제.
3. **한국어 기본**: 전문 용어는 영문 병기 (예: "가비지 컬렉션 (Garbage Collection, GC)").
4. **중복 방지**: 새 페이지 생성 전 `notion-search` 로 동일 제목 기존 페이지 확인.
5. **하위 페이지 생성/분리 전 승인**: 구조 변경이 큰 경우 반드시 사용자 승인 받고 진행.

## 주의사항

- Notion MCP 연결 필수 (`mcp__1d857b2d-*__notion-*` 계열 도구 사용)
- 부모 페이지 접근 권한 확인 (`notion-fetch` 로 먼저 확인 가능)
- 이미 존재하는 페이지는 `notion-update-page` 로 내용 보강, 새로 만들지 않음
- 민감 정보(API 키, 비밀번호 등)는 절대 페이지에 포함하지 않음