---
task_id: task-1837_5.3
type: plan
scope: task
created: 2026-04-17
updated: 2026-04-17
status: completed
---

# 계획서: task-1837_5.3

**task**: task-1837_5.3
**목표**: 효과 측정 프레임워크 설계 + 수집 스크립트 구현
**승인**: 아누 2026-04-17 "시스템3문서 Phase 5.3 dispatch"
**근거**: /home/jay/workspace/memory/tasks/task-1837_5.3.md

---

## 목표

7개 핵심 지표를 정의한 metrics-framework.md 문서와, task-timers.json/git log/reports에서 데이터를 수집하여 JSON으로 저장하는 collect_metrics.py 스크립트를 완성한다.

## 범위

### 포함
- 7개 지표 정의 문서 (metrics-framework.md)
- 수집 스크립트 (collect_metrics.py): M-1~M-3, M-5~M-7 자동 수집
- JSON 출력 형식 정의 및 저장
- weekly-report.py에서 호출 가능한 함수 인터페이스

### 제외 (다음 페이즈 이후)
- M-4 (레벨 자동 추정 정확도): task 파일 YAML 파싱 필요 → 운영 데이터 축적 후
- M-5 상세 (Gemini PR 코멘트 파싱): GitHub API 연동 필요 → 별도 작업
- 대시보드 UI 연동
- 기준선(baseline) 자동 산출 로직

## 위임 계획

- 지표 정의 문서: **엔키(백엔드)** — 데이터 소스 이해 + 계산 공식 설계
- 수집 스크립트: **엔키(백엔드)** — Python 스크립트 + subprocess 활용

## 검증 기준

- metrics-framework.md 존재: `ls memory/specs/metrics-framework.md` → 파일 존재
- collect_metrics.py 실행: `python3 scripts/collect_metrics.py --dry-run` → JSON 출력
- JSON 저장: `python3 scripts/collect_metrics.py` → `memory/daily/metrics-YYYY-MM-DD.json` 생성
- pyright 에러 0건: `pyright scripts/collect_metrics.py` → 0 errors