---
from: 총괄PM
to: PD님
type: 안건_신설_대기
subject: 축 2 — 워크트리 생성 시 부서 에이전트 자동 동기화
status: 대기
priority: normal
created: 2026-04-15
ref_event: Phase 1+2+3 검증 중 발견 (2026-04-15)
parent_cycle: C22·C19-3-4·Phase1~3 사이클
---

# 축 2 안건 — 워크트리 `.claude/agents/` 자동 동기화

## 배경

2026-04-15 Phase 1+2+3 구축 완료 후 부서 세션 동기화 검증 과정에서 발견:

- Claude Code가 세션 시작 시 **cwd의 `.claude/agents/` 만** 로드한다.
- Claude Code가 자동 생성하는 워크트리 하위 `.claude/agents/` 에는 **`pm-general.md` 만 자동 배치**되고 부서 에이전트(`개발실/.claude/agents/*.md`, `기획실/.claude/agents/*.md`)는 누락된다.
- 결과: 부서 세션에서 `planning-lead`, `개발실장` 등의 서브에이전트를 `Task` 툴로 호출할 수 없음 ("Available agents" 목록에 부재).

**잠정 해결(축 1)**: 2026-04-15 본 PM 세션이 다음 2개 워크트리에 부서 에이전트 수동 복제:
- `기획실/.claude/worktrees/confident-mendel/.claude/agents/`
- `개발실/.claude/worktrees/gracious-driscoll/.claude/agents/`

**한계**: 워크트리는 Claude Code가 세션별로 자동 생성·제거하므로 수동 복제는 지속 불가. **자동화(축 2)가 근본 해결책**.

---

## 축 2 설계 후보 (2026-04-15 C22 준수·설명적 이름으로 확정, 이후 변경 금지)

### hook 확장안 — SessionStart hook 확장 (`scripts/agent_sync.sh`)
- 기존 `.claude/settings.json` 의 SessionStart 훅에 에이전트 복제 스크립트 추가
- 동작: cwd 기반 부서 판단 → 해당 부서 `.claude/agents/*.md` 를 cwd의 `.claude/agents/` 로 복사
- 장점: 기존 hook 체계와 일관, 구현 간단
- 단점: **hook은 세션이 이미 시작된 후 실행** → 그 세션의 이미 로드된 에이전트 목록은 갱신 안 됨 (다음 세션부터 유효). 첫 세션은 여전히 수동 필요.

### setup 확장안 — `setup_windows.ps1` 확장
- 기존 PC 셋업 스크립트에 워크트리 스캔·부서 에이전트 복제 단계 추가
- 장점: 세션과 무관하게 디스크 상태를 선제적으로 보장
- 단점: **Claude Code가 세션마다 새 워크트리를 생성** → setup 시점 이후 생성된 워크트리는 커버 못 함. 수시 재실행 필요.

### 감시자안 — PowerShell 파일 감시자(FileSystemWatcher) 상주
- `기획실/.claude/worktrees/` 와 `개발실/.claude/worktrees/` 를 감시해 새 워크트리 생성 시 자동 복제
- 장점: 생성 즉시 자동 복제. 어떤 세션이든 첫 호출부터 부서 에이전트 가용.
- 단점: 상주 프로세스 필요. PC 재부팅 시 재시작·자동 서비스화 필요.

### 탐색규칙 조사안 — Claude Code `.claude/agents/` 탐색 규칙 조사·활용
- 공식 문서 정독 + 실증으로 `.claude/agents/` 의 **상위 디렉토리 탐색/병합** 가능성 재확인
- 만약 Claude Code가 cwd 상위(예: `기획실/.claude/agents/`) 를 병합해 로드하는 옵션이 있다면 **복제 없이 해결 가능**
- 장점: 복제·동기화 불필요, 가장 깔끔
- 단점: Claude Code 버전·옵션·환경 의존. 현재 동작은 cwd만 로드로 보이지만 재확인 필요.

### 루트 통합안 — 루트 `.claude/agents/` 에 전 부서 에이전트 통합
- 모든 부서 에이전트를 루트 `.claude/agents/` 에 모아 어느 세션에서든 접근 가능하게 함
- 장점: 복제·동기화 불필요
- 단점: **부서 격리 원칙 훼손** (개발실 세션에서 planning-lead 호출 가능해지는 등 혼재 우려)

---

## 결정 필요 사항 (PD님)

1. **우선 순위**: 본 축 2를 언제 본격 착수할지 (이번 사이클 직후 / 다음 사이클 / 우선순위 낮음) — 2026-04-15 PD님 "지금 바로 착수" 지시로 **이번 사이클 착수 확정**
2. **후보 선정**: 5개 설계 후보 중 PD님 선호 경로. 총괄PM 추천: **탐색규칙 조사안 선행 → 불가 시 hook 확장안 + 감시자안 병행**
3. **선행 조사 허용 여부**: 탐색규칙 조사안을 위해 PM 세션이 Claude Code 공식 문서와 실증 실험을 진행해도 될지 (토큰 소비 수반)

---

## 관련
- `feedback_automation_trust.md` (본 축 1 발견 경위에서 저의 "외관 판정" 오류 자진 보고)
- C19-3-4 (자동화 영역 담당 검증 의무)
- C22 (용어 일관: "축 1 / 축 2" 명칭 유지)
- C5 (정직성: 축 1은 즉시·한시적 해결, 축 2가 근본 해결임을 명시)
- Phase 1+2+3 사이클 최종 단계의 후속 과제

## 처리 이력
- 2026-04-15: 안건 신설·main 반영. PD님 결정 대기.
