# current_status.md

> 본 파일은 작업 맥락을 다음 세션·다른 PC로 이어가기 위한 로그다.
> Claude Code는 작업 시작 시 본 파일을 가장 먼저 읽고, 작업 종료 시 반드시 누적 업데이트한다.
> 본 파일은 `.gitignore`에 포함되어 git에 커밋되지 않는다.

---

## [2026-05-16 작업 1회차 - 전체 코드 구현 완료]

### 완료된 작업
- **단계 0-1**: 프로젝트 기반 파일 생성
  - `package.json` (4개 의존성: @anthropic-ai/sdk, rss-parser, nodemailer, dotenv)
  - `.env.example` (9개 변수 예시)
  - `.gitignore`에 `current_status.md` 추가
- **단계 0-2**: 공통 유틸 3개
  - `src/lib/logger.js` — KST 타임스탬프 + 모듈명 형식 로그
  - `src/config.js` — 환경변수 로드/검증/기본값/타입변환, 누락 시 친절 메시지 출력
  - `src/lib/claude.js` — Anthropic SDK 래퍼 (callClaude, callClaudeJSON), 재시도 1회, JSON 코드펜스 자동 추출
- **단계 1**: `src/fetcher.js` — Google News RSS 키워드별 호출, 24h 필터, 키워드 태깅
- **단계 2**: `src/deduplicator.js` — 자카드 유사도 (URL 일치 + 제목 유사도), 정규화/불용어 제거/그룹화
- **단계 3**: `src/evaluator.js` — Claude API 배치 평가, PRD §5.3 프롬프트, 파싱 실패 시 재시도
- **단계 4**: `src/selector.js` — 키워드별 라운드 로빈 균등 배분
- **단계 5**: `src/summarizer.js` — Claude API 배치 요약 + 활용 코멘트
- **단계 6**: HTML 템플릿 2종
  - `src/templates/daily.js` — 카드형 (키워드 뱃지, 3줄 요약, 활용 코멘트 강조 박스)
  - `src/templates/empty.js` — 안내형 (통계 + 차선 후보 1건)
- **단계 7**: `src/mailer.js` — Nodemailer Gmail SMTP 발송
- **단계 8**: `src/index.js` — 전체 파이프라인 조립 (0개 분기 포함)
- **단계 9**: `.github/workflows/daily.yml` — cron UTC 22:00, workflow_dispatch
- `npm install` 완료 (44개 패키지)

### 진행 중 작업
- 없음 (전체 구현 완료)

### 다음 단계
1. `.env` 파일 작성 후 로컬 실행 테스트 (`node src/index.js`)
2. GitHub push + Secrets 등록 + Actions workflow_dispatch 수동 실행 테스트
3. 메일 수신 확인 후 필요시 HTML 디자인 미세 조정

### 미결정 이슈
- 없음

---

## [2026-05-16 작업 0회차 - 프로젝트 킥오프]

### 완료된 작업
- 프로젝트 기획 완료
- `PRD.md` v1.0 확정
  - 미결정 이슈 2건 모두 해결 (적합 0개 시 안내 메일 발송 / 모델 환경변수화)
  - `INSTRUCTOR_PROFILE` 환경변수 신설 (다른 강사 재사용성 강화)
- `CLAUDE.md` 작성 완료 (작업 규칙)
- `README.md` 작성 완료 (사용자 가이드)
- 아직 코드는 작성하지 않음

### 진행 중 작업
- 없음 (코드 작성 시작 직전 단계)

### 다음 단계
1. **공통 유틸 먼저 작성** (기반 다지기)
   - `src/config.js` (환경변수 로드 + 검증)
   - `src/lib/logger.js` (콘솔 로그 통합)
   - `src/lib/claude.js` (Claude API 래퍼)
2. `package.json` + `.env.example` + `.gitignore` 생성
3. PRD §9 단계별 개발 순서 따라 RSS 수집기부터 작성

### 미결정 이슈
- 없음

### 참고
- PRD §9 개발 순서 따르기: fetcher → deduplicator → evaluator → 0개 분기 → summarizer → templates → mailer → 전체 연결 → GitHub Actions → README 검증
- 첫 번째 작업 권장: §0단계 공통 유틸 3개 먼저