---
task_id: task-1882
type: context
scope: task
created: 2026-04-16
updated: 2026-04-16
status: completed
---

# 맥락 노트: task-1882

**task**: task-1882

---

## 결정 근거

### team_prompts.py 직접 수정 불필요
- dispatch.py에서 build_prompt() 호출 후 프롬프트 후처리로 Large-File Protocol을 삽입
- 이 방식이 기존 아키텍처와 일관성 유지 (file_size_warnings, sanitize 게이트 등 동일 패턴)
- 모든 팀 유형(direct/glm/marketing/etc)에 자동 적용

### Symbol Existence Check의 workspace_root 동적 패턴
- 기존 코드는 `/home/jay/workspace/` 경로를 하드코딩
- 테스트에서 tmp_path 사용 시 매칭 불가 → 패턴을 workspace_root 기반으로 동적 생성
- `_build_file_path_patterns(workspace_root)` 함수로 분리

### File-Touch Ratio의 git diff 범위
- HEAD~5 (최근 5커밋)으로 설정
- 테스트에서는 subprocess를 monkeypatch로 mock

## 참조 자료

- 기존 verifier 패턴: `teams/shared/verifiers/scope_check.py`
- QC 규칙: `teams/shared/QC-RULES.md`
- 테스트 패턴: `tests/test_three_docs_check.py`

## 주의사항

- dispatch.py 대형 파일(3036줄) → offset/limit 필수
- qc_verify.py에 B/C verifier 동시 등록 시 import 충돌 주의 (알파벳 순 정렬)
- 이리스 작업 중 API 529 에러 발생 → 헤르메스가 타입 에러 수정
