note-writing

name	note-writing
description	Write lecture notes in Markdown (400-900 words) with Intro/Concept/Example/Pitfalls/Recap structure and cross-references to slides. Use when turning class beats into a study-ready note.md document. Triggered by the note-writer agent.

Note Writing — Learner-Facing Deep Text

note는 학습자가 정독하는 본문이다. slide는 요약, transcript는 듣기용, note는 눈으로 깊이 읽는 매체로 차별화한다.

구조 템플릿

# {class title}
> **LOs:** LO-X.Y, LO-X.Z
> **예상 읽기 시간:** N분

## Intro
학습자가 왜 이 내용을 알아야 하는지, 실세계 맥락.

## Concept
정의 → 속성/하위요소 → 왜 중요한가의 3단 구조.

## Example
구체적 코드 or 사례 (최소 1개).

## Pitfalls
흔한 오해 1~2개. 단순히 정답 반복 금지.

## Recap
3가지 핵심을 bullet로 재정리.

길이 가이드 (한국어 기준)

섹션	비중	한국어 글자 수 (총 1200자 기준)
Intro	10%	120자
Concept	40%	480자
Example	30%	360자
Pitfalls	15%	180자
Recap	5%	60자

영어면 400900 단어, 한국어면 8001600자.

Cross-reference 규칙

• Slide 참조: [slide 3] — 실제 존재하는 슬라이드 번호만
• 다른 class 참조: [S2.C1] — section.class 형태
• LO 참조: 맨 위 blockquote에 명시

예:

## Concept
서버 컴포넌트는 [slide 2]에서 본 것처럼 서버에서만 실행됩니다.
이 개념은 [S1.C2]에서 다룬 SSR과 다릅니다.

섹션별 작성 가이드

Intro (학습자 훅)

• 1~2 문장
• "왜 지금 이걸 배워야 하나" 제시
• 한 가지 구체 질문으로 끝나면 좋음

Concept (핵심)

• 정의 문장 1개 (두괄식)
• 3개 이하의 서브섹션 (###)
• 각 서브섹션마다 1~3 단락

Example

• 실행 가능한 코드 or 구체 시나리오
• 코드는 ~~~lang 블록
• 주석은 한국어 tone이면 한국어, formal tone이면 영어

Pitfalls

• 흔한 오해: 학습자가 실제로 할 법한 실수
• 해설: "정답은 X"가 아니라 "Y로 오해하기 쉬운 이유와 교정"

Recap

• 정확히 3개 bullet
• 각 bullet은 하나의 LO에 대응

톤 가이드

tone	문체	어휘
friendly	2인칭 "여러분", 단문, 가벼운 비유 OK	일상어 섞음
formal	3인칭/수동태 혼용, 장문 가능	용어 엄격
socratic	질문형 문장으로 개념 유도	결론 지연

금기

• slide.source.md 복사 (요약이 아니라 확장)
• transcript 복사 (듣기용과 읽기용 리듬이 다름)
• "자, 그럼", "이제" 같은 구어 전환 (speaker가 아니라 필자)

재실행 규칙

• 섹션 단위 diff 갱신 기본
• 전체 재작성은 사용자 명시 요청 시

체크리스트

• LO를 맨 위 blockquote에 명시했는가
• 5부 구조 유지
• 한국어 8001600자 (영어 400900 단어)
• slide/class cross-ref가 실제 존재 id인가
• Pitfalls이 정답 반복이 아니라 오해 교정인가
• Recap이 정확히 3개 bullet인가