128 lines
5.8 KiB
Markdown
128 lines
5.8 KiB
Markdown
---
|
|
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 정신에 부합.
|