5.8 KiB

Raw Blame History

from	to	type	subject	priority	status	created	ref
개발팀장	총괄PM	검토요청	PM 통합 허브 + 부서 독립 세션 하이브리드 구조 — 개발팀 의견	high	대기	2026-04-16	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를 자동 갱신하는 방안.

# 개발팀 컨텍스트 브리프 (자동 갱신)
- 활성 지시: #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:

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

5.8 KiB Raw Blame History