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

# 계획서: task-1837_5.2

**task**: task-1837_5.2
**목표**: auto_merge.py에 Graduated Auto-Gate 3-Layer (L1 Batch Watchdog, L2 Pre-flight Check, L3 Integration Test) 구현
**승인**: 아누 2026-04-16 "시스템3문서 Phase 5.2 항목"
**근거**: 병렬 위임 완료 후 자동 통합 검증 파이프라인 필요

---

## 목표

- batch_id 기준으로 전팀 .done 완료를 자동 감지 (L1)
- git merge --no-commit 시뮬레이션으로 충돌 사전 검증 (L2)
- pytest integration 테스트 자동 실행 및 결과 보고 (L3)
- systemd timer로 1분 주기 자동 실행

## 범위

### 포함
- auto_merge.py에 BatchWatchdog, PreFlightCheck, IntegrationTestRunner, GraduatedAutoGate 클래스 추가
- --graduated CLI 플래그 추가
- systemd user unit 파일 (timer + service + install.sh)
- 통합 테스트 12건

### 제외 (다음 페이즈 이후)
- 실제 systemd 등록/활성화 (install.sh 스크립트 제공만)
- 시맨틱 충돌 분석 (기계적 충돌만 검증)

## 위임 계획

- L1/L2/L3 + CLI 구현: **스바로그(백엔드)** — 핵심 로직 담당
- systemd 유닛 파일: **스바로그(백엔드)** — 인프라 설정
- 통합 테스트: **벨레스(테스터)** — 12건 테스트 커버리지

## 검증 기준

- 테스트: `pytest tests/integration/test_graduated_auto_gate.py -v` → 12 passed
- 기존 테스트: `pytest tests/integration/test_batch_completion.py -v` → 6 passed (회귀 없음)
- 스모크: `python3 scripts/auto_merge.py --graduated --dry-run` → 정상 JSON 출력
- 하위호환: `python3 scripts/auto_merge.py --dry-run` → 기존 동작 유지