docs(agenda): 축 2 안건 신설 — 워크트리 에이전트 자동 동기화 (PD님 지시)
- 2026-04-15 Phase 1+2+3 검증 중 발견된 워크트리 .claude/agents/ 부서 에이전트 누락 문제의 근본 해결 안건 - 축 1(수동 복제)은 2026-04-15 본 PM 세션에서 실행 완료 (한시적) - 후보 A~E 설계안 정리, 추천: D(탐색 규칙 조사) 선행 + A(hook 확장) 기본 - PD님 결정 3항 대기: 착수 시점·후보 선정·선행 조사 허용 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
4335f2a9a2
commit
271812ec89
|
|
@ -0,0 +1,78 @@
|
||||||
|
---
|
||||||
|
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 설계 후보
|
||||||
|
|
||||||
|
### 후보 A — SessionStart hook 확장 (`scripts/agent_sync.sh`)
|
||||||
|
- 기존 `.claude/settings.json` 의 SessionStart 훅에 에이전트 복제 스크립트 추가
|
||||||
|
- 동작: cwd 기반 부서 판단 → 해당 부서 `.claude/agents/*.md` 를 cwd의 `.claude/agents/` 로 복사
|
||||||
|
- 장점: 기존 hook 체계와 일관, 구현 간단
|
||||||
|
- 단점: **hook은 세션이 이미 시작된 후 실행** → 그 세션의 이미 로드된 에이전트 목록은 갱신 안 됨 (다음 세션부터 유효). 첫 세션은 여전히 수동 필요.
|
||||||
|
|
||||||
|
### 후보 B — `setup_windows.ps1` 확장
|
||||||
|
- 기존 PC 셋업 스크립트에 워크트리 스캔·부서 에이전트 복제 단계 추가
|
||||||
|
- 장점: 세션과 무관하게 디스크 상태를 선제적으로 보장
|
||||||
|
- 단점: **Claude Code가 세션마다 새 워크트리를 생성** → setup 시점 이후 생성된 워크트리는 커버 못 함. 수시 재실행 필요.
|
||||||
|
|
||||||
|
### 후보 C — PowerShell 파일 감시자(FileSystemWatcher) 상주
|
||||||
|
- `기획실/.claude/worktrees/` 와 `개발실/.claude/worktrees/` 를 감시해 새 워크트리 생성 시 자동 복제
|
||||||
|
- 장점: 생성 즉시 자동 복제. 어떤 세션이든 첫 호출부터 부서 에이전트 가용.
|
||||||
|
- 단점: 상주 프로세스 필요. PC 재부팅 시 재시작·자동 서비스화 필요.
|
||||||
|
|
||||||
|
### 후보 D — Claude Code `.claude/agents/` 탐색 규칙 조사·활용
|
||||||
|
- 공식 문서 정독 + 실증으로 `.claude/agents/` 의 **상위 디렉토리 탐색/병합** 가능성 재확인
|
||||||
|
- 만약 Claude Code가 cwd 상위(예: `기획실/.claude/agents/`) 를 병합해 로드하는 옵션이 있다면 **복제 없이 해결 가능**
|
||||||
|
- 장점: 복제·동기화 불필요, 가장 깔끔
|
||||||
|
- 단점: Claude Code 버전·옵션·환경 의존. 현재 동작은 cwd만 로드로 보이지만 재확인 필요.
|
||||||
|
|
||||||
|
### 후보 E — 루트 `.claude/agents/` 에 전 부서 에이전트 통합
|
||||||
|
- 모든 부서 에이전트를 루트 `.claude/agents/` 에 모아 어느 세션에서든 접근 가능하게 함
|
||||||
|
- 장점: 복제·동기화 불필요
|
||||||
|
- 단점: **부서 격리 원칙 훼손** (개발실 세션에서 planning-lead 호출 가능해지는 등 혼재 우려)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 결정 필요 사항 (PD님)
|
||||||
|
|
||||||
|
1. **우선 순위**: 본 축 2를 언제 본격 착수할지 (이번 사이클 직후 / 다음 사이클 / 우선순위 낮음)
|
||||||
|
2. **후보 선정**: A~E 중 선호 경로. 저는 **D 선행 조사 후 A(D 불가 시 기본값)** 조합 추천
|
||||||
|
3. **선행 조사 허용 여부**: 후보 D를 위해 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님 결정 대기.
|
||||||
Loading…
Reference in New Issue