# task-376.1 작업 보고서

- **작업 ID**: task-376.1
- **팀**: dev2
- **작업 요약**: 머지 판단 자동 감지 시스템 구축
- **소요 시간**: 6분

## 작업 내용

팀장의 보고서에서 머지 관련 의견/요청을 자동 감지하여 아누에게 전달하는 시스템 구축.

### 1. report_parser.py 수정
- `parse_report()`: merge_needed, merge_branch, merge_worktree 3개 필드 추가
- 긍정 패턴 감지: `merge 판단`, `머지 판단`, `merge 필요`, `머지 필요`, `아누에게 위임`, `아누 판단`
- 부정 패턴 우선: `머지 필요 없음`, `merge 불필요`, `필요없음` → merge_needed=False
- 브랜치명 추출: `task/task-\d+\.\d+-dev\d+` 패턴
- 워크트리 경로 추출: `/home/jay/projects/.+/.worktrees/.+` 패턴 (백틱/따옴표 내)
- `summarize_oneline()`: merge_needed=True이면 끝에 `| 🔀 머지 필요` 추가

### 2. DIRECT-WORKFLOW.md 수정
- Step 4.5 이후에 **보고서 필수 섹션 (Worktree 사용 시)** 추가
  - 머지 필요 여부, 브랜치, 워크트리 경로, 머지 의견 필수 기재
- Step 5 .done 파일에 merge_needed, merge_branch 필드 추가
  - worktree 생성 시: merge_needed=True, merge_branch 포함
  - worktree 미사용 시: merge_needed=False, merge_branch=None

### 3. 스펙 문서 작성
- `/home/jay/workspace/memory/specs/merge-detection-spec.md`
- 문제 정의, 감지 흐름도, 키워드 패턴, 아누 처리 절차, 테스트 시나리오 3개 포함

### 4. 테스트 작성 (TDD)
- `/home/jay/workspace/tests/test_report_parser.py` 신규 생성
- 10개 테스트 케이스 (요구 5개 + 추가 5개)

## 생성/수정 파일 목록
- `/home/jay/workspace/report_parser.py` (수정)
- `/home/jay/workspace/tests/test_report_parser.py` (신규)
- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` (수정)
- `/home/jay/workspace/memory/specs/merge-detection-spec.md` (신규)

## 테스트 결과
- **총 테스트**: 10
- **통과**: 10
- **실패**: 0
- **발견 버그**: 0건

## QC 자동 검증 결과
```json
{
  "task_id": "task-376.1",
  "overall": "PASS (조건부)",
  "checks": {
    "pyright_check": "PASS (0 errors)",
    "style_check": "PASS (black + isort OK)",
    "tdd_check": "PASS",
    "data_integrity": "PASS",
    "test_runner": "WARN - 기존 test_qc_integration.py 실패 (이번 작업 무관, 407 passed)",
    "file_check": "PASS (보고서/이벤트 파일 생성 후)"
  }
}
```

## 비고
- 기존 `parse_report()` 반환값에 하위 호환 필드 추가 방식 → 기존 호출자 영향 없음
- `test_runner` FAIL은 기존 `test_team_prompts.py` 실패로 이번 작업과 무관
- pyrightconfig.json이 토르에 의해 신규 생성됨 (pyright 설정)