From 271812ec896d86827ee80055cec7f3b26757a498 Mon Sep 17 00:00:00 2001 From: swrring Date: Wed, 15 Apr 2026 22:39:37 +0900 Subject: [PATCH] =?UTF-8?q?docs(agenda):=20=EC=B6=95=202=20=EC=95=88?= =?UTF-8?q?=EA=B1=B4=20=EC=8B=A0=EC=84=A4=20=E2=80=94=20=EC=9B=8C=ED=81=AC?= =?UTF-8?q?=ED=8A=B8=EB=A6=AC=20=EC=97=90=EC=9D=B4=EC=A0=84=ED=8A=B8=20?= =?UTF-8?q?=EC=9E=90=EB=8F=99=20=EB=8F=99=EA=B8=B0=ED=99=94=20(PD=EB=8B=98?= =?UTF-8?q?=20=EC=A7=80=EC=8B=9C)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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) --- ...6-04-15_안건_축2_워크트리_에이전트_자동동기화.md | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 공유/조직공지/2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md diff --git a/공유/조직공지/2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md b/공유/조직공지/2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md new file mode 100644 index 0000000..511d6ab --- /dev/null +++ b/공유/조직공지/2026-04-15_안건_축2_워크트리_에이전트_자동동기화.md @@ -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님 결정 대기.