13 KiB

Raw Blame History

from	to	type	subject	priority	status	created	ref	관련_선행감사
pm-auditor	총괄PM	감사보고	업무 공유·기록 체계 전수 점검 (PM 조직 메타 관점)	high	작성완료	2026-04-17	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 누락 사건 재분석 (어느 단계가 실패했는가):

PD 지시 로그 #28 비고란에 "Unity MCP 활용 방향으로 전환" 1줄 기록됨 — 로그 기록은 정상
pm_context_restore.sh는 대화로그·커밋만 노출 — PD 지시 로그 활성 항목을 hook이 스캔하지 않음
PM이 수동으로 PD 지시 로그를 Read하지 않으면 비고란 변경 감지 불가 — 수동 의존 구조
C31-1-D(세션 시작 맥락 복원) 체크리스트가 "PD 지시 로그 활성 테이블 Read"를 명시하지 않음 — 체크리스트 공백

결론: pm_context_restore.sh는 대화로그·커밋 축만 커버하며, PD 지시 로그 비고란 변경은 사각지대. 활성 테이블 스캔 스크립트 신설 필요.

2-2. pm-auditor 자체의 한계

실측 한계:

settings.json agent 미등록 — general-purpose로 폴백되어 에이전트 정의의 model(opus) 지정이 무력화. 감사 깊이 저하 우려
모드 A(응답 발신 직전 교차 검증) 실행 불가 — PM이 응답을 작성 중 발신 전에 pm-auditor를 호출하려면 동기식 tool call이 필요하나, 현재 Task 도구는 비동기 일회성 호출. "발신 직전"이 구조적으로 불가
메타 인식 한계 — 본 감사자는 "PM이 놓친 것"을 보지만, "PM과 pm-auditor가 함께 놓친 것"은 포착 불가 (재귀 감사자 부재)
스스로의 신설 당일 등록 지연 — 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

자율 준수 의존 영역 (강제 전환 가능):

C31 체크리스트 수동 수행 → PM 응답 발신 전 체크리스트 파일 Write 강제 hook 가능
P24 대화로그 기록 → 세션 종료 시점 파일 부재 검출 hook은 있으나 Write까지 강제는 아님
PD 지시 로그 갱신 → Agent 응답 수령 시 자동 상태 동기화 스크립트 부재

3. 구체 개선안 (A·B·C·D — C25 위계)

A. 즉시 착수 (PM 재량, 규칙·스크립트 신설)

A-1. scripts/pd_log_active_scan.sh 신설 — 세션 시작 시 PD 지시 로그 활성 테이블을 파싱하여 비고란·산출물 경로 최신 변경 요약 출력. SessionStart hook 체인에 추가. (구현 난이도: 낮음. 효과: #28 사건 재발 차단. 해결 시나리오: D·C-부분)
A-2. C31-1-D 체크리스트 보강 — "PD 지시 로그 활성 테이블 전수 Read"를 명시 항목으로 추가. (난이도: 낮음. 효과: 수동 의존 시에도 경로 명시. 해결: A)
A-3. scripts/agent_call_log.sh 신설 — Task 도구 호출 시 프롬프트·응답 요지를 공유/대화로그/조직운영/에 자동 append. (난이도: 중. 효과: 2-3번 공백 해소. 해결: D)
A-4. pm-auditor settings.json 정식 등록 — agent 목록 추가로 opus 모델 적용·Task 호출 정상화. (난이도: 낮음. 효과: 본 감사자 정상화. 해결: 즉시)
A-5. 감사 결과 memory/feedback_pm_context_hook_gap.md 신설 — 본 보고 핵심 교훈 영구 보존. (난이도: 낮음. 효과: 노하우 축적. 해결: 재발 방지)

B. PM 조율 (팀장 Agent 확인 필요)

B-1. 기록 채널 역할 경계 재정의 — C13/C29-4/P19/P24 중복을 "1차 기록지 + 2차 교차 참조" 구조로 단일화. 각 팀장 의견 수렴 후 SKILL.md 개정. (난이도: 중. 효과: 부분 갱신 방치 패턴 차단. 해결: 2-5)
B-2. "세션 상태 스냅샷" 단일 SOT 신설 — 공유/세션_현황.md 한 파일에 "현재 PD님과 논의 중인 안건·미해결 결정·차단 요인"을 3항목으로 압축 유지. PM이 응답 발신 전후 자동 갱신. (난이도: 중-상. 효과: 시나리오 D 해결. 해결: D)

C. PD님 실질 결정 사항 (C29 엄격 — 진짜 PD님만 결정 가능한 것)

C-1. 본 감사 보고 수용·반려 — 개선안 A·B 착수 여부 최종 의사
C-2. 시나리오 C(1주일+ 공백) 대응 우선순위 — 현재 조직 운영 빈도상 시나리오 C가 발생하는가, 방어 투자 필요한가에 대한 방향

D. pm-auditor 자체 개선 (본 에이전트 정의 갱신 안건)

D-1. 감사 영역 5종으로 확장 — 기존 4종(로그 추적·규칙 준수·PM 재량 추적·프로세스 개선)에 "규칙 체계 정합성 메타 감사" 추가. 본 보고 2-4축이 근거
D-2. 자기 한계 명시 절 신설 — pm-auditor.md에 "본 감사자가 구조적으로 포착 불가한 영역" 섹션 추가
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에게:

A-1~A-5 착수 여부 본 세션 내 결정
5개 팀 보고 통합 시 §4 교차 검증 체크리스트 수행
B-1·B-2는 팀장 의견 수렴 후 PD님께 안건화

PD님 상신 후보: §3-C 2건 (C-1·C-2) 외에는 없음. 나머지는 PM·팀장 재량으로 처리 가능 (C29 준수).

감사 종료. 본 보고를 공유/대화로그/조직운영/2026-04-17.md에 #이슈 #결정 #PM 태그로 append 권고.

13 KiB Raw Blame History