Study Engineering 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 키, 비밀번호 등)는 절대 페이지에 포함하지 않음

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [JoNaYeon](https://github.com/JoNaYeon)
- **Source:** [JoNaYeon/claude-code-skills](https://github.com/JoNaYeon/claude-code-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.