---
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 정신에 부합.