comm(req): 프로세스 고도화 3대 문제 개선안 — 개발실→PM 검토요청 (PD님 직접 지시)
- 문제1 반영시차: git_fetch_throttle.sh 자동 merge 추가안 - 문제2 소통부재: 변경요약 자동출력 + C21 정식화 촉진안 - 문제3 완료잔류: stale_check.sh 상태 불일치 감지 + P21 점검단계 추가안 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
f595a06f3e
commit
6300f799b4
|
|
@ -0,0 +1,140 @@
|
|||
---
|
||||
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 등록 + 테스트까지 개발실 재량으로 진행 가능.
|
||||
Loading…
Reference in New Issue