code-lessonlisted

# Code Lesson 세션에서 변경된 코드를 분석해서, 유저가 기술적으로 배울 수 있는 포인트를 쉽게 설명한다. ## 핵심 원칙 **초등학생도 이해할 수 있게.** - 전문 용어를 쓰면 반드시 비유로 풀어준다 - "이건 뭐냐면..." 톤으로 설명 - 코드 → 비유 → 왜 이렇게 하는지 순서 ## 플로우 1. **변경 감지**: `git diff HEAD~1` 또는 세션에서 변경한 파일 목록 파악 2. **분석**: 변경된 코드에서 배울 만한 포인트 추출 - 사용된 디자인 패턴 - 새로운 라이브러리/API 사용법 - 구조적 결정 (왜 이렇게 나눴는지) - 에러 처리 방식 - 성능 관련 선택 3. **설명**: 각 포인트를 쉽게 설명 4. **기록**: `.learnings/` 디렉토리에 저장 ## 설명 형식 각 학습 포인트마다: ``` ### [포인트 제목] **파일**: `경로/파일명` (라인 N-M) **뭐냐면**: 한 줄 요약 **비유로 설명하면**: 일상적인 비유로 풀어쓴 설명 **코드에서 보면**: ```코드 조각``` **왜 이렇게 했냐면**: 이유 설명 **이걸 알면 좋은 이유**: 실무에서 어디에 쓰이는지 ``` ## 배울 포인트 판단 기준 기록할 것: - 처음 등장하는 패턴/기술 (이 프로젝트에서) - 구조적으로 중요한 결정 - 실수하기 쉬운 부분과 해결 방법 - 라이브러리의 비직관적인 사용법 기록하지 않을 것: - 단순 변수명 변경, 포맷팅 - 이미 설명한 적 있는 패턴 (`.learnings/`에서 확인) - 설정 파일 변경 ## 저장 경로: `<프로젝트>/.learnings/YYYY-MM-DD.md` 파일 형식: ```markdown # Code Lessons — YYYY-MM-DD ## HH:MM ### [포인트 제목] (위 설명 형식) --- ``` 날짜별 파일에 append. `.learnings/`가 없으면 생성. `.gitignore`에 `.learnings/`가 없으면 추가할지 유저에게 물어본다. ## 유저 레벨 감지 memory에 유저 정보가 있으면 레벨에 맞춰 조절: - 초보: 모든 개념을 비유로 설명 - 중급: 패턴 이름 + 왜 선택했는지 - 고급: 트레이드오프, 대안 비교 중심