# task-1858 완료 보고서

## SCQA

**S**: 교차검증 워크플로우 3문서(task-1837)의 Phase 1 기반 인프라가 부분 구현 상태로, gate_instructions.py가 존재하지만 dispatch.py/team_prompts.py에 연동되지 않았고, affected_files 겹침 감지, batch_id, 레벨 자동 추정이 미구현이었다.

**C**: 게이트 지시가 프롬프트에 삽입되지 않아 팀장이 레벨별 검증 요구사항을 인지할 수 없고, 병렬 위임 시 파일 충돌 감지가 불가능하며, 배치 완료 추적이 없어 전팀 동기화가 어려웠다.

**Q**: dispatch.py와 team_prompts.py에 교차검증 Phase 1 인프라(게이트 지시, 겹침 감지, batch_id, 레벨 추정)를 연동할 수 있는가?

**A**: 4개 영역 모두 구현 완료. dispatch.py에 6개 헬퍼 함수 추가 + 연동 코드 삽입, team_prompts.py에 gate_instructions 연동, CLI에 --batch-id 옵션 추가. 테스트 204건 전부 통과(25건 신규 + 179건 기존 회귀 없음).

## 작업 내용

### 1. gate_instructions.py 연동
- `team_prompts.py`에 `_format_gate_instructions` import 추가
- `_build_verification_section()`에서 level 문자열→정수 매핑(normal→2, critical→3, security→4) 후 게이트 지시 삽입

### 2. affected_files 겹침 감지
- `_parse_affected_files()`: task_desc에서 `affected_files:` 라인 파싱
- `_check_affected_files_overlap()`: task-timers.json의 running task와 교집합 확인
- `_warn_missing_affected_files()`: Lv.2+ affected_files 미기재 경고
- dispatch() 함수에서 프롬프트 생성 후 자동 호출, `_patch_timer_metadata`로 affected_files 저장

### 3. batch_id 필드
- dispatch() 시그니처에 `batch_id` 파라미터 추가
- CLI에 `--batch-id` 옵션 추가
- `check_batch_completion()`: batch_id 기준 전팀 완료 조회
- task-timers.json에 `_patch_timer_metadata`로 batch_id 저장

### 4. 레벨 자동 추정 경고
- `_estimate_task_level()`: 키워드/핵심파일/파일수 기반 권장 레벨 추정
- `_parse_task_level()`: task_desc에서 Lv.N 패턴 파싱
- 수동 레벨 < 추정 레벨 시 logger.warning 출력

## 생성/수정 파일 목록

- `/home/jay/workspace/dispatch.py` — 6개 함수 추가(750~935줄), 연동 코드 삽입, batch_id 파라미터 + CLI 옵션
- `/home/jay/workspace/prompts/team_prompts.py` — _format_gate_instructions import + _build_verification_section 수정
- `/home/jay/workspace/tests/test_team_prompts.py` — 게이트 지시 연동에 맞게 기존 테스트 assertion 수정

## 검증 결과

### 검증 시나리오 통과 현황 (6/6)
1. `--level normal` → 프롬프트에 "[G2 구현 게이트] 셀프 QC..." 포함 ✅
2. `--level critical` → 프롬프트에 "[G1 설계 게이트] 3문서 필수..." 포함 ✅
3. affected_files 겹침 시 경고 메시지 출력 ✅
4. batch_id 지정 시 task-timers.json에 저장 ✅
5. Lv.1인데 affected_files 5개면 경고 출력 ✅
6. 기존 dispatch 기능 회귀 없음 (179건 + 25건 = 204건 PASSED) ✅

### 테스트 결과
- `tests/test_dispatch_gate.py`: 25 passed (신규)
- `tests/test_dispatch.py`: 179 passed (기존, 회귀 없음)
- `tests/test_team_prompts.py`: 55 passed (기존, 1건 assertion 수정)
- pyright: 0 errors (기존 reportMissingImports 제외)

### 마아트 독립 검증 결과
- 판정: PASS (조건부)
- 발견 이슈 3건:
  1. (MEDIUM) `_estimate_task_level`: 핵심 파일 5개 이상이라도 첫 번째 매칭에서 Lv.2로 조기 반환 — 설계 의도 확인 필요
  2. (LOW) `_check_affected_files_overlap`/`check_batch_completion`: 읽기 시 file lock 미사용 — 병렬 dispatch 시 JSON 파싱 에러 가능성 (except로 흡수)
  3. (LOW) `_HIGH_LEVEL_KEYWORDS`: 리팩토링/마이그레이션 등 대규모 키워드 누락

## 모델 사용 기록
- 불칸(백엔드): Sonnet — dispatch.py 함수 구현 + 연동 코드
- 이리스(프론트엔드): Sonnet — team_prompts.py 게이트 지시 연동
- 마아트(QC): Sonnet — 독립 검증
- 헤르메스(팀장): Opus — 설계/분배/검토/통합

## 발견 이슈 및 해결
1. `test_team_prompts.py::test_normal_returns_selfcheck_only` 테스트 실패 — `assert "마아트" not in result`가 게이트 지시 삽입 후 깨짐
   - 해결: assertion을 `"마아트 독립 검증 필수" not in result`로 수정 (게이트 지시 내 마아트 참조는 정상)
2. tdd_check FAIL — 테스트가 task-1838에서 사전 작성되어 audit-trail에 이번 커밋으로 잡히지 않음
   - 사유: TDD로 사전 작성된 테스트로 정상적인 워크플로우. 범위 외 이슈 아님.
3. style_check WARN — black/isort 포매팅 불일치
   - 사유: 기존 파일의 포매팅 상태 유지. 별도 포매팅 작업 불필요 (노이즈 수준).

## 세션 통계
- 총 도구 호출: 22회

### 수정 파일 목록
- bash_cmd: 12회 (Bash)
- /home/jay/workspace/dispatch.py: 5회 (Edit)
- /home/jay/workspace/prompts/team_prompts.py: 2회 (Edit)
- /home/jay/workspace/memory/reports/task-1858.md: 1회 (Write)
- /home/jay/workspace/memory/tasks/task-1858.md: 1회 (dispatch)
- /home/jay/workspace/tests/test_team_prompts.py: 1회 (Edit)

### 도구 사용 현황
- Bash: 12회
- Edit: 8회
- Write: 1회
- dispatch: 1회