---
task_id: task-1888
type: context
scope: task
created: 2026-04-16
updated: 2026-04-16
status: in-progress
---

# 맥락 노트: task-1888

**task**: task-1888

---

## 결정 근거

### 1. cmd_finish 내부에 코드 삽입하되 헬퍼 함수로 분리
- 핵심 로직(파싱/수정/분류)을 독립 함수로 분리하여 테스트 용이성 확보
- cmd_finish()는 호출 오케스트레이션만 담당

### 2. Week 1-2 수집 모드 우선
- 처음부터 자동 수정을 활성화하면 오분류 위험
- COLLECT_MODE 플래그로 수집만 수행, 실제 수정은 비활성

### 3. Claude CLI subprocess 호출 방식
- _auto_fix_high_comments()에서 claude --print 명령을 subprocess로 호출
- 수집 모드에서는 프롬프트만 생성하고 실행하지 않음

## 참조 자료

- worktree_manager.py: `/home/jay/workspace/scripts/worktree_manager.py` (904줄)
- 기존 테스트: `/home/jay/workspace/scripts/tests/test_worktree_manager.py`
- 태스크 명세: `/home/jay/workspace/memory/tasks/task-1888.md`

## 주의사항

- worktree_manager.py 대용량 → offset/limit 분할 읽기 필수
- GitHub API 호출에 gh CLI 사용 (rate limit 주의)
- 수정 후 즉시 커밋 (micro-commit 규칙)
- 기존 테스트 회귀 방지: 새 코드가 기존 cmd_finish() 동작을 변경하지 않도록 주의