4.6 KiB

Raw Blame History

from	to	type	subject	status	priority	created	ref_event	parent_cycle
총괄PM	PD님	안건_신설_대기	축 2 — 워크트리 생성 시 부서 에이전트 자동 동기화	대기	normal	2026-04-15	Phase 1+2+3 검증 중 발견 (2026-04-15)	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님)

우선 순위: 본 축 2를 언제 본격 착수할지 (이번 사이클 직후 / 다음 사이클 / 우선순위 낮음) — 2026-04-15 PD님 "지금 바로 착수" 지시로 이번 사이클 착수 확정
후보 선정: 5개 설계 후보 중 PD님 선호 경로. 총괄PM 추천: 탐색규칙 조사안 선행 → 불가 시 hook 확장안 + 감시자안 병행
선행 조사 허용 여부: 탐색규칙 조사안을 위해 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님 결정 대기.