BurningTimesAi/공유/소통/완료/2026-04-17_업무공유체계_점검_PM조직관점.md

184 lines
13 KiB
Markdown
Raw Normal View History

feat(core): P27 신설 + 3축 감사 체계 (dev/plan-auditor) + hook 확장 (PD님 조직 생명급 지시) PD님 직접 지시 "세션 전환 시 업무 맥락 초기화 재발 방지 + 모든 에이전트 교차 검증 동기화 체계 구축" 대응. ## 추가·변경 사항 ### 규칙 - P27 신설 — 조직 업무 공유·기록 체계 일관성 보장 (7 하위 조항) - P27-1: 3축 감사 체계 (pm/dev/plan-auditor) - P27-2: Agent 호출 이력 기록 의무 - P27-3: 세션 전환 시나리오 A~D 복원 보장 - P27-4: SOT 경계 (중복 기록 금지) - P27-5: 자동화 hook 체계 정리 - P27-6: 위반 처분 - P27-7: 연관 규칙·에이전트 - C31-1-D 체크리스트 확장 — PD 지시 로그 비고란 실독 의무 + verify_log_paths.sh 결과 확인 + Agent 호출 이력 확인 3항 추가 ### 에이전트 신설 - .claude/agents/dev-auditor.md — 개발팀 전담 감사 (기술 결정·API 변경 이력 특화) - .claude/agents/plan-auditor.md — 기획팀 전담 감사 (밸런스 이력·기각안·차기 프로젝트 참고 자료 특화) ### 스크립트 신설 - scripts/postuse_log_reminder.sh — PostToolUse hook, md 변경 시 대화로그 부재 리마인더 - scripts/session_end_audit.sh — SessionEnd hook, 기록 누락·Live 잔류·미커밋·경로 부재 감사 - scripts/verify_log_paths.sh — PD 지시 로그 활성 테이블 산출물 경로 실존 감사 ### 소통·설정 - 공유/소통/README.md 9축 확장 (감사관 3종 채널 추가) + YAML 필수 7필드 체크리스트 강화 - .claude/settings.json PostToolUse·SessionEnd hook 추가 - 공유/소통/dev-auditor→PM/·plan-auditor→PM/ 디렉토리 신설 ### 팀 검토 보고서 수령 - 개발팀장·클라이언트팀장·서버팀장·기획팀장·pm-auditor 5개 에이전트 교차 검증 완료 - 공유/소통/{각팀}→PM/2026-04-17_업무공유체계_점검_*.md 5건 ### 대화로그 - 공유/대화로그/조직운영/2026-04-17.md — 조직생명급_공유체계_구축 체크포인트 + 6 엔트리 append Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-17 06:12:36 +00:00
---
from: pm-auditor
to: 총괄PM
type: 감사보고
subject: 업무 공유·기록 체계 전수 점검 (PM 조직 메타 관점)
priority: high
status: 작성완료
created: 2026-04-17
ref: P26, C31, C13, C29-4, PD님 직접 지시(2026-04-17 메타 점검)
관련_선행감사: 공유/소통/pm-auditor→PM/2026-04-17_감사보고_팀기록체계_전수점검.md (팀 기록 품질 관점)
---
# 업무 공유·기록 체계 전수 감사 (PM 조직 메타 관점)
## 0. 서문 — 본 감사자의 상태 (C23 실측 고지)
**본 에이전트는 `.claude/agents/pm-auditor.md` 역할 주입을 받은 `general-purpose` 서브에이전트이다.** settings.json의 agent 목록에 pm-auditor가 정식 등록되지 않은 상태로, PM이 `Task(subagent_type='pm-auditor')` 호출 시 general-purpose로 폴백되는 구조적 제약 속에서 감사 수행. 이 제약 자체가 본 보고 2축 핵심 논점이다.
## 1. 결론 요약
| 시나리오 | 현 체계 복원 가능성 | 구멍 |
|---------|------------------|------|
| A. PM 세션 재시작 (같은 날) | **양호** | pm_context_restore.sh + 대화로그 + PD 지시 로그 3중 |
| B. 새 PC clone 후 재개 | **양호** | setup + git pull + SessionStart hook 연쇄 |
| C. 1주일+ 공백 후 재개 | **취약** | 대화로그 최근 2일만 자동 로드. 중간 결정·맥락은 수동 탐색 부담 |
| D. PM 교체 (다른 Claude 인스턴스) | **취약** | "현재 어디까지 논의했나"를 나타내는 **세션 상태 스냅샷** 부재 |
**메타 결론**: **"진행 중 작업의 현재 순간 상태"를 표현하는 단일 SOT가 없다.** PD 지시 로그는 항목 단위, 대화로그는 결정 단위, 소통 채널은 통신 단위. 셋 다 누적형이라 "지금 이 순간 PM이 어디에 서 있는가"를 30초 내 파악할 문서가 부재.
---
## 2. 7축 메타 감사 실측
### 2-1. PM 세션 전환 시 맥락 유지 (P21-5B·P24·pm_context_restore.sh 효과성)
**실측**:
- `scripts/pm_context_restore.sh` (69줄, 2026-04-17 신설): 당일·전일 대화로그 목록 출력 + 당일 로그 부재 시 P24 위반 경고 + 최근 커밋 10건 표시
- SessionStart hook에 5단계 체인 등록 확인 (git fetch → inbox_scan → change_digest → live_session_load → pm_context_restore)
- 당일(2026-04-17) 조직운영 로그 존재: `공유/대화로그/조직운영/2026-04-17.md`
**#28 Unity MCP 누락 사건 재분석 (어느 단계가 실패했는가)**:
1. PD 지시 로그 #28 비고란에 "Unity MCP 활용 방향으로 전환" 1줄 기록됨 — **로그 기록은 정상**
2. pm_context_restore.sh는 대화로그·커밋만 노출 — **PD 지시 로그 활성 항목을 hook이 스캔하지 않음**
3. PM이 수동으로 PD 지시 로그를 Read하지 않으면 비고란 변경 감지 불가 — **수동 의존 구조**
4. C31-1-D(세션 시작 맥락 복원) 체크리스트가 "PD 지시 로그 활성 테이블 Read"를 명시하지 않음 — **체크리스트 공백**
**결론**: pm_context_restore.sh는 **대화로그·커밋 축만 커버**하며, **PD 지시 로그 비고란 변경은 사각지대**. 활성 테이블 스캔 스크립트 신설 필요.
### 2-2. pm-auditor 자체의 한계
**실측 한계**:
1. **settings.json agent 미등록**`general-purpose`로 폴백되어 에이전트 정의의 model(opus) 지정이 무력화. 감사 깊이 저하 우려
2. **모드 A(응답 발신 직전 교차 검증) 실행 불가** — PM이 응답을 작성 중 발신 전에 pm-auditor를 호출하려면 동기식 tool call이 필요하나, 현재 Task 도구는 비동기 일회성 호출. **"발신 직전"이 구조적으로 불가**
3. **메타 인식 한계** — 본 감사자는 "PM이 놓친 것"을 보지만, **"PM과 pm-auditor가 함께 놓친 것"은 포착 불가** (재귀 감사자 부재)
4. **스스로의 신설 당일 등록 지연** — 2026-04-17 신설 → 다음 세션까지 정식 호출 불가한 구조적 결함이 신설 당일 노출됨
### 2-3. PM ↔ 팀장 Agent 호출의 정보 손실
**실측**:
- PM이 Agent 호출 시 프롬프트는 응답 본문에 포함되나, **"PD님이 방금 지시한 원문"이 그대로 전달되는가**는 PM 재량
- Agent 응답 수령 시 PM이 요약 과정에서 **C22(용어 일관) 위반**으로 원 용어 변형 사례가 과거 발생 (memory 참조: `feedback_role_play_vs_real_call.md` 계열)
- Agent 호출 이력이 대화로그에 **자동 기록되지 않음** — PM이 수동으로 P24 엔트리 작성 시에만 기록
- **Task 호출 기록의 감사 추적성 부재** — 어떤 Agent에 어떤 프롬프트를 보냈는지 git 커밋·파일로 영구 보존되지 않음
### 2-4. 규칙 체계 자체의 정합성 (C1~C31, P1~P26 전수)
**모순·공백·중복 발견**:
| # | 이슈 | 관련 규칙 | 성격 |
|---|------|---------|------|
| 1 | **C13 vs C29-4 vs P19 vs P24** 역할 경계 모호 — "완료 기록"을 4곳에 중복 기재해야 한다고 읽힘 | C13, C29-4, P19, P24 | 중복·C14-4 위반 소지 |
| 2 | P24 "기록 시점 3가지 트리거"와 C29-4 "완료 시점 필수 기록 4종"이 **어느 쪽이 상위인지 불명확** | P24, C29-4 | 모순 |
| 3 | C31-1-D 체크리스트가 "PD 지시 로그 활성 테이블 Read"를 명시하지 않음 | C31-1-D | 공백 (#28 사건 원인) |
| 4 | **Agent 호출 이력 기록 의무가 어느 규칙에도 없음** | 전무 | 공백 |
| 5 | C27 "PM이 Agent 결과 수령 직후 로그 갱신 확인"은 **확인 방법(스크립트·체크리스트)이 미규정** | C27 | 구현 공백 |
| 6 | P21-5B "최근 2일 대화로그 Read"가 시나리오 C(1주+ 공백)에 대응 불가 | P21-5B | 시나리오 커버리지 공백 |
### 2-5. 기록 채널의 일관성 (C14-4 준수 여부)
**채널별 동일 정보 중복 기재 실태**:
- **완료 이벤트 1건이 최대 5곳 기록** 필요: PD 지시 로그(완료 아카이브 이동) + 대화로그(#완료 태그 엔트리) + 소통 채널(status 갱신 + 완료 폴더 이동) + Live 더미(세션 공유 전까지) + git 커밋 메시지
- 이는 C14-4(참조 무결성 — 중복 기재 금지)와 **형식상 충돌**. 다만 각 채널 목적이 달라 "정보의 다른 측면"이라 주장 가능
- **실제 문제**: 5곳 중 2~3곳만 기록되는 부분 갱신이 빈발. 선행 감사(2026-04-17_감사보고_팀기록체계_전수점검.md)에서 소통 채널 완료 폴더 이동 전면 방치 적발됨
**단일 SOT 부재**: "PD 지시 #N의 현재 상태"를 알려면 최소 2곳(PD 지시 로그 + 소통 채널)을 교차 확인해야 함.
### 2-6. 세션 전환 시나리오별 복원 가능성
| 시나리오 | 현 체계 | 구멍 |
|---------|--------|------|
| A (당일 재시작) | SessionStart hook 5단계 | 없음 |
| B (새 PC) | setup 스크립트 + git pull + hook | 없음 |
| C (1주일+ 공백) | 대화로그·커밋 수동 탐색 | **자동 요약 부재** — 중간 기간 결정·방향 전환을 놓치기 쉬움 |
| D (PM 교체) | CLAUDE.md + SKILL.md + 대화로그 | **"현재 진행 중 논의의 temperature"**(PD님과의 밀착도·미해결 안건·긴급도)가 비정형 |
### 2-7. 자동화 강제력
**현재 자동화**:
- SessionStart hook 5단계 (pull·inbox·digest·live·context)
- UserPromptSubmit hook 3단계 (throttle·hold·live)
- PreToolUse auto_approve
**자율 준수 의존 영역 (강제 전환 가능)**:
1. **C31 체크리스트 수동 수행** → PM 응답 발신 전 **체크리스트 파일 Write 강제** hook 가능
2. **P24 대화로그 기록** → 세션 종료 시점 파일 부재 검출 hook은 있으나 **Write까지 강제는 아님**
3. **PD 지시 로그 갱신** → Agent 응답 수령 시 자동 상태 동기화 스크립트 부재
---
## 3. 구체 개선안 (A·B·C·D — C25 위계)
### A. 즉시 착수 (PM 재량, 규칙·스크립트 신설)
1. **A-1. `scripts/pd_log_active_scan.sh` 신설** — 세션 시작 시 PD 지시 로그 활성 테이블을 파싱하여 비고란·산출물 경로 최신 변경 요약 출력. **SessionStart hook 체인에 추가**. (구현 난이도: 낮음. 효과: #28 사건 재발 차단. 해결 시나리오: D·C-부분)
2. **A-2. C31-1-D 체크리스트 보강** — "PD 지시 로그 활성 테이블 전수 Read"를 명시 항목으로 추가. (난이도: 낮음. 효과: 수동 의존 시에도 경로 명시. 해결: A)
3. **A-3. `scripts/agent_call_log.sh` 신설** — Task 도구 호출 시 프롬프트·응답 요지를 `공유/대화로그/조직운영/`에 자동 append. (난이도: 중. 효과: 2-3번 공백 해소. 해결: D)
4. **A-4. pm-auditor settings.json 정식 등록** — agent 목록 추가로 opus 모델 적용·Task 호출 정상화. (난이도: 낮음. 효과: 본 감사자 정상화. 해결: 즉시)
5. **A-5. 감사 결과 `memory/feedback_pm_context_hook_gap.md` 신설** — 본 보고 핵심 교훈 영구 보존. (난이도: 낮음. 효과: 노하우 축적. 해결: 재발 방지)
### B. PM 조율 (팀장 Agent 확인 필요)
1. **B-1. 기록 채널 역할 경계 재정의** — C13/C29-4/P19/P24 중복을 "1차 기록지 + 2차 교차 참조" 구조로 단일화. 각 팀장 의견 수렴 후 SKILL.md 개정. (난이도: 중. 효과: 부분 갱신 방치 패턴 차단. 해결: 2-5)
2. **B-2. "세션 상태 스냅샷" 단일 SOT 신설**`공유/세션_현황.md` 한 파일에 "현재 PD님과 논의 중인 안건·미해결 결정·차단 요인"을 3항목으로 압축 유지. PM이 응답 발신 전후 자동 갱신. (난이도: 중-상. 효과: 시나리오 D 해결. 해결: D)
### C. PD님 실질 결정 사항 (C29 엄격 — 진짜 PD님만 결정 가능한 것)
1. **C-1. 본 감사 보고 수용·반려** — 개선안 A·B 착수 여부 최종 의사
2. **C-2. 시나리오 C(1주일+ 공백) 대응 우선순위** — 현재 조직 운영 빈도상 시나리오 C가 발생하는가, 방어 투자 필요한가에 대한 방향
### D. pm-auditor 자체 개선 (본 에이전트 정의 갱신 안건)
1. **D-1. 감사 영역 5종으로 확장** — 기존 4종(로그 추적·규칙 준수·PM 재량 추적·프로세스 개선)에 **"규칙 체계 정합성 메타 감사"** 추가. 본 보고 2-4축이 근거
2. **D-2. 자기 한계 명시 절 신설** — pm-auditor.md에 "본 감사자가 구조적으로 포착 불가한 영역" 섹션 추가
3. **D-3. 모드 A(응답 발신 직전) 포기 또는 재설계** — 기술적 불가이므로, 대안으로 **"응답 초안 작성 후 발신 전 Task 동기 호출"** 프로토콜 명문화
---
## 4. 다른 팀 Agent 보고 교차 검증 포인트 (PM용 체크리스트)
5개 팀장·감사관 보고 수령 시 PM이 교차 확인할 핵심 축:
| 교차 축 | 확인 포인트 | 불일치 시 대응 |
|--------|----------|-------------|
| #28 Unity MCP 전환 인지 | 개발팀장·기획팀장이 Unity MCP 방향을 동일 용어로 인지하는가 (C22) | PM이 통합 재전파 |
| 서버 Critical 보안 3건 상태 | 서버팀장·개발팀장 보고 간 "보류 사유·재개 트리거" 일치성 | SKILL.md 갱신 필요성 판단 |
| 시뮬 축 단일화(Python 폐기) | 모든 팀장이 "교차 검증 축 Unity MCP 단일"을 확인하는가 | 잔여 Python 참조 색출 지시 |
| 대화로그 작성 당사자 | 팀장 Agent별 P24 준수율 자체 평가 vs 본 감사자의 실측 | 허위 자가 평가 색출 |
| Agent 호출 이력 정합성 | 각 팀장이 "오늘 PM이 나에게 호출한 프롬프트 요지" 기억 | Agent 정보 손실 증거 |
| 규칙 중복 인식 | C13/C29-4/P19/P24 중 "혼란스러운 규칙"을 팀장들이 지목하는가 | B-1 개선안 긴급도 산정 |
**PM 통합 시 자기 점검**:
- [ ] 5개 보고 중 **같은 사실을 다르게 서술한 항목** 식별했는가
- [ ] 팀 간 **책임 경계 분쟁** 소지 발견 시 PD님 결정 안건화했는가
- [ ] 본 감사자(pm-auditor)가 지적한 **구조적 구멍 6종**(2-4표)이 팀 보고에서도 간접 증거로 나타나는가
---
## 5. 감사 메타 자평 (본 감사자의 한계 자진 고지)
**본 감사에서 확신 있게 말하지 못한 것**:
- 시나리오 C 발생 빈도 — 조직 운영 이력이 2026-04-14 개시라 **통계적으로 불확실**
- pm-auditor settings.json 등록의 **기술적 선행 조건** — 다른 agent 등록 이력 미검증 (일단 파일 존재 확인만 수행)
- B-2 "세션 현황 SOT" 신설이 C14-4(중복 기재 금지)를 재위반하는가 — **설계 논의 필요**
**본 감사자가 구조적으로 포착 불가한 것**:
- PD님의 미언어화 의도 (PM의 뉘앙스 해석 정확성)
- PM과 pm-auditor가 함께 누락한 영역 (재귀 감사자 부재)
- PM 응답 발신 직전의 실시간 교차 검증 (비동기 제약)
---
## 6. 후속 조치 요청
**PM에게**:
1. A-1~A-5 착수 여부 본 세션 내 결정
2. 5개 팀 보고 통합 시 §4 교차 검증 체크리스트 수행
3. B-1·B-2는 팀장 의견 수렴 후 PD님께 안건화
**PD님 상신 후보**: §3-C 2건 (C-1·C-2) 외에는 없음. 나머지는 PM·팀장 재량으로 처리 가능 (C29 준수).
---
감사 종료. 본 보고를 `공유/대화로그/조직운영/2026-04-17.md``#이슈 #결정 #PM` 태그로 append 권고.