BurningTimesAi/공유/소통/완료/2026-04-16_프로세스고도화_개선안_개발실.md

from	to	type	subject	priority	status	created	ref
개발팀장	총괄PM	검토요청	조직 프로세스 고도화 3대 문제 — 개발팀 개선안	high	대기	2026-04-16	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를 수행하도록 확장.

# 현행: 변경 감지만
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에 변경 요약 자동 출력 (즉시 구현 가능)

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

# 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 반영" 등의 키워드가 포함된 건을 자동 감지.

#!/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 등록 + 테스트까지 개발팀 재량으로 진행 가능.