---
from: 개발팀장
to: 총괄PM
type: 검토요청
subject: 조직 프로세스 고도화 3대 문제 — 개발팀 개선안
priority: high
status: 대기
created: 2026-04-16
ref: PD님 식별 3대 문제 (문서 반영 시차 / 세션 간 소통 부재 / 완료 항목 잔류)
---

# 조직 프로세스 고도화 3대 문제 — 개발팀 개선안

> PD님이 식별하신 3대 문제에 대한 개발 관점 근본 원인 분석 + 실현 가능한 개선안.
> 총괄PM이 기획팀 의견과 교차 검토 후 통합안 구성 예정.

---

## 문제 1: 문서 반영 시차

### 근본 원인

- 현행 `git_fetch_throttle.sh`(UserPromptSubmit hook)는 5분 간격으로 **fetch + 알림**까지만 수행하고 **merge는 하지 않음**
- SessionStart hook에 자동 merge가 추가(`f595a06`)되었으나, **세션 도중에는 fetch만** → 변경을 "알기만" 하고 반영은 수동
- PD님이 "세션 갱신"을 직접 지시해야만 merge가 발생하는 구조

### 개선안: UserPromptSubmit hook에 자동 merge 추가

**변경 대상**: `scripts/git_fetch_throttle.sh`

현행 fetch 후 `origin/main`과 `HEAD`의 SHA 비교 시, 차이가 있으면 **자동 fast-forward merge**를 수행하도록 확장.

```bash
# 현행: 변경 감지만
if [ "$LOCAL_SHA" != "$REMOTE_SHA" ]; then
  echo "⚡ 변경 감지"
fi

# 개선: 감지 + 자동 merge
if [ "$LOCAL_SHA" != "$REMOTE_SHA" ]; then
  git merge origin/main --no-edit --ff-only 2>/dev/null
  if [ $? -eq 0 ]; then
    echo "⚡ 자동 동기화 완료"
  else
    echo "⚠️ 자동 merge 불가 — 수동 세션 갱신 필요"
  fi
fi
```

**설계 근거**:
- `--ff-only`: 충돌 가능성 있는 경우 자동 skip → 안전
- 5분 throttle 유지 → 성능 영향 없음
- C14 부합: 추가 토큰 소비 0, 스크립트 수정 수 줄

---

## 문제 2: 세션 간 소통 부재

### 근본 원인

- 6축 소통 허브(`공유/소통/`)가 구축되어 있으나 **실제 활용이 거의 없음**
- 결정사항·노하우가 PD 지시 로그·일일보고에 묻혀 있어 타 세션이 **어디를 봐야 하는지** 모름
- "이것을 알려줘야 한다"는 **발신 동기**가 규칙화되지 않음 (C21이 아직 초안 상태)

### 개선안: 2단계 접근

#### 2-A. SessionStart hook에 변경 요약 자동 출력 (즉시 구현 가능)

세션 시작 시 "마지막 확인 이후 무엇이 바뀌었는지"를 커밋 로그에서 자동 추출하여 출력.

```bash
# SessionStart hook 추가 항목 (scripts/change_digest.sh)
LAST_SEEN=$(cat "$THROTTLE_DIR/last_seen_sha" 2>/dev/null)
CURRENT=$(git rev-parse HEAD)
if [ -n "$LAST_SEEN" ] && [ "$LAST_SEEN" != "$CURRENT" ]; then
  echo "📋 [변경 요약] 마지막 확인 이후:"
  git log --oneline "$LAST_SEEN".."$CURRENT" 2>/dev/null | head -10
fi
echo "$CURRENT" > "$THROTTLE_DIR/last_seen_sha"
```

**효과**: 별도 발신 파일 없이 **커밋 메시지 자체가 소통 채널** 역할. inbox 파일 생성 오버헤드 없음.

#### 2-B. C21 정식화 촉진 (규칙 차원)

- C21(작업 완료 즉시 공유)을 초안에서 **정식 프로젝트 규칙으로 격상**
- 핵심 추가 조항: "타 부서에 영향 있는 변경을 push할 때, 소통 허브에 1-line 알림 파일 필수"
- `inbox_scan.sh`가 수신 세션 시작 시 자동 알림하므로, **발신만 하면 수신은 자동**

---

## 문제 3: 완료 항목 잔류

### 근본 원인

- PD 지시 로그 상태 갱신이 **수동 의존** — 작업 완료 시점에 로그 갱신을 잊으면 "진행중"으로 잔류
- 본 세션에서 방금 정비한 6건이 정확히 이 패턴 (main 반영 완료인데 상태 미갱신)
- 일일보고에서 "완료" 보고 + PD 지시 로그 상태 갱신이라는 **이중 관리** 구조

### 개선안: 상태 불일치 자동 감지 스크립트

**신규 스크립트**: `scripts/stale_check.sh`

PD 지시 로그에서 "진행중"인 항목 중, 산출물·사후조치 열에 "완료" "main 반영" 등의 키워드가 포함된 건을 자동 감지.

```bash
#!/bin/bash
# PD 지시 로그 상태 불일치 감지
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
LOG="$REPO_ROOT/공유/PD_지시_트래킹/${1}_PD_지시_로그.md"
[ ! -f "$LOG" ] && exit 0

STALE=$(grep -n "진행중" "$LOG" | grep -i "완료\|main 반영\|main 병합\|push 완료")
if [ -n "$STALE" ]; then
  COUNT=$(echo "$STALE" | wc -l)
  echo "⚠️ [상태 점검] 완료 추정이나 '진행중'인 항목 ${COUNT}건 감지 — 상태 갱신 검토 필요"
fi
```

**P21 세션 갱신 프로토콜에 점검 단계 추가**:

| 기존 단계 | 추가 |
|----------|------|
| 5. PD 지시 로그 현황 | **5-α. 상태 불일치 감지** — `stale_check.sh` 실행 |

세션 갱신 때마다 "완료인데 진행중으로 남은" 항목이 자동으로 표면화.

---

## 종합

| 문제 | 근본 원인 | 개선안 | 구현 규모 |
|------|----------|--------|----------|
| **1. 반영 시차** | fetch만, merge 안 함 | `git_fetch_throttle.sh`에 `--ff-only` 자동 merge 추가 | 기존 스크립트 수 줄 수정 |
| **2. 소통 부재** | 발신 습관 부재 + 변경 요약 없음 | SessionStart에 변경 요약 출력 + C21 정식화 | 신규 스크립트 1건 + 규칙 격상 |
| **3. 완료 잔류** | 상태 갱신 수동 의존 | `stale_check.sh` 자동 감지 + P21 점검 단계 추가 | 신규 스크립트 1건 |

**C14 준수**: 3건 모두 기존 hook 인프라 위에 최소 변경. 신규 파일 최대 2건(`change_digest.sh`, `stale_check.sh`), 나머지는 기존 스크립트 수정.

**개발팀 즉시 착수 가능**: 총괄PM 통합안 승인 시, 스크립트 구현 + hook 등록 + 테스트까지 개발팀 재량으로 진행 가능.
