From 610d25fb9b49d2998ce6e7cc745bc93da60bab88 Mon Sep 17 00:00:00 2001 From: swrring Date: Thu, 16 Apr 2026 12:14:01 +0900 Subject: [PATCH] =?UTF-8?q?comm(req):=20PM=20=ED=86=B5=ED=95=A9=20?= =?UTF-8?q?=ED=97=88=EB=B8=8C=20+=20=EB=B6=80=EC=84=9C=20=EB=8F=85?= =?UTF-8?q?=EB=A6=BD=20=EC=84=B8=EC=85=98=20=ED=95=98=EC=9D=B4=EB=B8=8C?= =?UTF-8?q?=EB=A6=AC=EB=93=9C=20=EA=B5=AC=EC=A1=B0=20=E2=80=94=20=EA=B0=9C?= =?UTF-8?q?=EB=B0=9C=EC=8B=A4=20=EC=9D=98=EA=B2=AC=20=EC=A0=9C=EC=B6=9C=20?= =?UTF-8?q?(PD=EB=8B=98=20=EA=B2=80=ED=86=A0=20=EC=9A=94=EC=B2=AD)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 보고 시점: 이벤트 드리븐 (상태 전환 시만 push) - Agent 컨텍스트 단절: CONTEXT_BRIEF.md 자동 갱신안 + 역할 분리 권고 - 기술 보완: P22↔P19 역할 분리 / inbox_scan 확장 / CONTEXT_BRIEF 선택적 구현 Co-Authored-By: Claude Opus 4.6 (1M context) --- .../2026-04-16_하이브리드구조_개발실의견.md | 127 ++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 공유/소통/개발실→PM/2026-04-16_하이브리드구조_개발실의견.md diff --git a/공유/소통/개발실→PM/2026-04-16_하이브리드구조_개발실의견.md b/공유/소통/개발실→PM/2026-04-16_하이브리드구조_개발실의견.md new file mode 100644 index 0000000..58483cb --- /dev/null +++ b/공유/소통/개발실→PM/2026-04-16_하이브리드구조_개발실의견.md @@ -0,0 +1,127 @@ +--- +from: 개발실장 +to: 총괄PM +type: 검토요청 +subject: PM 통합 허브 + 부서 독립 세션 하이브리드 구조 — 개발실 의견 +priority: high +status: 대기 +created: 2026-04-16 +ref: PD님 제안 (PM 허브 + 부서 독립 세션 하이브리드) +--- + +# PM 통합 허브 + 부서 독립 세션 하이브리드 — 개발실 의견 + +--- + +## 1. 보고·공유 시점과 범위 + +### 1-1. PM 허브에 보고해야 하는 시점 + +| 시점 | 보고 방식 | 근거 | +|------|----------|------| +| **PD님 지시 수령 즉시** | PD 지시 로그 등록 + push | C13 (4단계 가시화) | +| **활성 지시 상태 전환 시** (착수·완료·보류) | PD 지시 로그 갱신 + push | C13 | +| **타 부서 영향 있는 변경 push 시** | 소통 허브 알림 파일 1건 | C18 (대상 세션 도달) | +| **코어룰·헌법급 변경 시** | 소통 허브 + 조직공지 | C10-6 (3중 전파) | + +### 1-2. PM 허브에 보고하지 않아도 되는 범위 + +- 부서 내부 실무 진행 (개발실장↔팀장↔commands 간 위임·작업) +- PD님이 부서 세션에서 직접 지시하고 완결한 건 (PM에 사후 요약만) +- 커밋 단위의 세부 코드 변경 (git log이 SOT) + +### 1-3. 핵심 원칙 + +> **"PM 허브는 의사결정 로그와 부서 간 조율의 SOT. 부서 실무의 SOT는 부서 세션 자체."** + +PM에 모든 것을 보고하면 C14(토큰 최소화) 위반. 반대로 PM을 생략하면 C13 위반. **상태 전환 이벤트**만 push하는 이벤트 드리븐 방식이 적정선. + +--- + +## 2. Agent 호출 시 컨텍스트 단절 최소화 + +### 2-1. 문제 본질 + +PM 세션이 Agent 도구로 개발실장을 호출하면 **새 서브프로세스**가 생성된다. 이 서브프로세스는 개발실 영속 대화의 컨텍스트(진행 중인 작업, 이전 논의, 의사결정 이력)를 전혀 모른다. + +### 2-2. 개선안: 컨텍스트 브리핑 파일 자동 생성 + +**개발실이 push할 때마다 `개발실/CONTEXT_BRIEF.md`를 자동 갱신**하는 방안. + +```markdown +# 개발실 컨텍스트 브리프 (자동 갱신) +- 활성 지시: #1(Tier1 잔여), #3(시뮬레이터), #5(Phase0-C) ... +- 최근 결정: OI-3 확정, OI-5 폐기 +- 차단 요인: #2 서버 보류 +- 최근 커밋 5건: (git log --oneline -5) +``` + +PM 세션이 Agent 호출 시 프롬프트에 `개발실/CONTEXT_BRIEF.md 읽은 뒤 작업하라`고 지시하면, 서브에이전트가 최소한의 컨텍스트를 확보한 상태에서 작업 가능. + +**장점**: 별도 인프라 불필요, git push hook(`scripts/context_brief.sh`)으로 자동화 가능 +**한계**: 영속 대화의 "대화 흐름" 자체는 전달 불가 — 팩트(상태·결정·차단요인)만 전달 + +### 2-3. 운용 권고: 역할 분리 + +| PM 허브에서 Agent 호출이 적합한 경우 | 부서 영속 대화에서 직접 작업이 적합한 경우 | +|-----------------------------------|-----------------------------------------| +| 현황 조회 (읽기 전용) | 설계 의사결정 | +| 단건 파일 생성·수정 | 다단계 구현 작업 | +| 교차 검토 (타 부서 산출물 검증) | 기존 작업의 후속 진행 | + +PM 허브의 Agent 호출은 **조회·단건 작업**에 한정하고, **연속적 작업은 PD님이 부서 세션에 직접 진입**하는 것이 컨텍스트 보존 면에서 우월. + +--- + +## 3. 기술적 보완 사항 + +### 3-1. 결정 로그(P22)와 기존 PD 지시 로그의 관계 정리 + +P22 결정 로그가 신설되면, 기존 PD 지시 로그(P19)와 역할이 중첩될 수 있다. + +**개발실 제안**: +- **P19 (PD 지시 로그)**: PD님이 직접 지시한 작업의 진행 상태 트래킹 (활성/아카이브) +- **P22 (결정 로그)**: 부서 세션에서 내려진 **의사결정 팩트**만 기록 (결정 내용 + 근거 + 영향 범위) +- 둘은 **보완 관계**. P19는 "무엇을 하고 있는가", P22는 "무엇이 결정되었는가" + +### 3-2. 소통 허브 inbox_scan.sh 확장 + +현행 `inbox_scan.sh`는 SessionStart 시점에만 실행된다. PM 허브가 브로드캐스팅 역할을 하려면: + +- **PM→개발실/ 채널에 파일이 생기면** 개발실 세션이 다음 UserPromptSubmit hook에서 감지할 수 있도록 `git_fetch_throttle.sh`에 inbox 스캔 로직 추가 +- 현행: fetch + merge만 +- 개선: fetch + merge + **신규 inbox 파일 감지 시 1줄 알림** + +### 3-3. CONTEXT_BRIEF.md 자동 갱신 구현 (선택) + +PM 허브의 Agent 호출이 빈번해질 경우에만 필요. 현 시점에서는 PD님이 부서 세션에 직접 진입하는 패턴이 주류이므로, **구현 우선순위는 낮음**. + +구현 시 `scripts/context_brief.sh`: +```bash +#!/bin/bash +# pre-push hook 또는 커밋 후 자동 실행 +REPO_ROOT=$(git rev-parse --show-toplevel) +LOG="$REPO_ROOT/공유/PD_지시_트래킹/개발실_PD_지시_로그.md" +BRIEF="$REPO_ROOT/개발실/CONTEXT_BRIEF.md" + +echo "# 개발실 컨텍스트 브리프" > "$BRIEF" +echo "최종 갱신: $(date +%Y-%m-%d)" >> "$BRIEF" +echo "" >> "$BRIEF" +echo "## 활성 지시" >> "$BRIEF" +grep "진행중\|보류\|대기" "$LOG" | head -10 >> "$BRIEF" +echo "" >> "$BRIEF" +echo "## 최근 커밋" >> "$BRIEF" +git log --oneline -5 >> "$BRIEF" +``` + +--- + +## 요약 + +| 검토 항목 | 개발실 의견 | +|----------|-----------| +| **보고 시점·범위** | 이벤트 드리븐 — 상태 전환 시만 push (C13 준수 + C14 최소화) | +| **Agent 컨텍스트 단절** | CONTEXT_BRIEF.md 자동 갱신안 제시. 단, 연속 작업은 PD님 직접 진입이 우월 | +| **기술 보완** | P22↔P19 역할 분리 명확화 / inbox_scan UserPromptSubmit 확장 / CONTEXT_BRIEF 선택적 구현 | + +개발실은 본 하이브리드 구조에 **찬성**. PD님이 부서 세션에 직접 진입하여 빠르게 추진하시는 현행 패턴이 가장 효율적이며, PM 허브는 부서 간 조율·브로드캐스팅에 집중하는 것이 C14 정신에 부합.