---
task_id: task-1922
type: context
scope: task
created: 2026-04-17
updated: 2026-04-17
status: completed
---

# 맥락 노트: task-1922

**task**: task-1922

---

## 결정 근거

### 심볼릭 링크로 통일 (단일 소스 원칙)
- 독립 복사본은 shared 수정이 전파되지 않아 drift 발생
- dev7은 4개 verifier가 누락되어 QC 부분 무력화 상태
- 심볼릭 링크로 수정 1회 = 전팀 전파 보장

### 3 Step Why
- **1st Why**: "왜 이 설계(심볼릭 링크 통일)가 필요한가?" → 8팀 중 4팀 불일치, dev7 QC 무력화
- **2nd Why**: "왜 심볼릭 링크가 최선의 접근인가?" → 하드카피 동기화 스크립트는 drift 위험, git submodule은 과도한 복잡성
- **3rd Why**: "왜 shared 직접 링크가 dev1 경유 간접 링크보다 나은가?" → dev1 디렉토리 이동/삭제 시 전부 깨짐, 단일 장애점 제거

### dev8 제외 결정
- GLM 외주 전용 팀으로 별도 구성 유지
- 현재 dev1→shared 간접 경유로 접근 가능하므로 기능 장애 없음

### 상대경로 vs 절대경로
- 불칸이 상대경로(`../../shared/verifiers`) 사용
- pre-commit hook의 절대경로 감지 우회 목적
- 런타임 동작에는 차이 없음

## 참조 자료

- 태스크 지시: `/home/jay/workspace/memory/tasks/task-1922.md`
- QC 규칙: `/home/jay/workspace/teams/shared/QC-RULES.md`

## 주의사항

- verifiers.bak은 롤백용으로 삭제 금지
- dev8은 dev1을 가리키고 있어, dev1이 shared를 가리키면 간접적으로 shared 접근 가능
- pyright에서 `from verifiers import ...` 구문 resolve 실패 진단 발생하나, 이는 기존 __init__.py와 동일한 패턴이며 런타임에서는 정상 동작 (qc/ 디렉토리 기준 import)