--- type: 점검보고 from: 개발팀장 to: PM date: 2026-04-17 status: 완료 tags: [업무공유, 기록체계, 교차검증, C29, C13, C27] --- # 업무 공유·기록 체계 점검 — 개발팀 관점 > **범위**: 개발팀 내부(개발팀장·클라이언트팀장·서버팀장·QA)의 기록 의무 명확성, 세션 전환 맥락 유지, 누락 감지, 교차 검증, 책임 분배 5축. 실측 근거 우선. --- ## A. 현황 실측 ### A1. 기록 의무 명확성 — 구멍 있음 **실측 경로·규칙 매핑**: - PD 지시: `공유/PD_지시_트래킹/개발팀_PD_지시_로그.md` (P19, 활성·아카이브 2분할 적용됨) - 대화로그: `공유/대화로그/{수상한잡화점|코어프레임워크|조직운영}/YYYY-MM-DD.md` (P24) - 소통 채널: `공유/소통/개발팀→PM/`, `개발팀→기획팀/`, 완료분은 `완료/`로 이동 (C29-4) - Live 더미: `.live/` (P25) **잘 되는 것**: - PD 지시 로그는 #1·#2·#5·#28 각 행이 장문 사후조치 컬럼을 갖춰 진행 상태 추적 가능 - 2026-04-17 대화로그에 Unity MCP 기술검토(12:21) 및 기각안까지 기록됨 (P24 표준 형식 준수) - 완료 아카이브 분리(#27 `코어코드 통합` 완료 이동)는 세션 갱신 시 활성 테이블만 스캔하는 구조를 실제로 지원 **구멍 4종**: 1. **코드·커밋 레벨 기록 공백** — 규칙상 "의미 있는 작업"의 범위가 문서·결정 중심이고, **코드 변경·리팩토링·서브모듈 수정·빌드 설정 변경** 같은 개발 고유 활동이 P24 대화로그에 들어가야 하는지 명시 부재. 2026-04-16 `코어코드/BT.Framework/` git 통합 커밋 `7187ac6`은 대화로그 `코어프레임워크/2026-04-16.md`에 엔트리가 있으나, 커밋 SHA·변경 파일 수치 누락. 다른 커밋(2026-04-16 Template 17개 파일 생성 등)은 대화로그 엔트리가 확인되지 않음. 2. **산하 팀장(클라이언트·서버·QA) 독립 로그 부재** — PD 지시 로그는 "개발팀" 단일 파일이며, 산하 팀장별 의사결정 이력이 개발팀장 로그에 통합되어 **클라이언트↔서버 경계 결정의 추적성이 낮음**. 예: Unity 프로젝트 점검(2026-04-16 커밋)은 기획팀장이 수행했는데 클라이언트팀장 판단 경로가 불명확. 3. **기술 결정·아키텍처 결정의 P22 결정로그 활용도 저조** — `공유/소통/개발팀→PM/` 6개 파일 중 "결정로그" 프론트매터를 단일 SOT 규격으로 갖춘 파일이 확인되지 않음 (실측: 파일명 패턴 `RPT`·`기술검토`·`업무현황` 중심). P22는 3줄 이내 결정로그를 요구하나 개발팀은 장문 보고서로만 송신. 4. **구 명칭 잔재** — 2026-04-16 커밋 `fix(naming): 구 명칭(개발실·기획실·개발실장) 잔존 참조 일괄 정리`로 해소 시도했으나, `공유/소통/개발팀→PM/2026-04-16_업무현황_개발실.md`·`완료/2026-04-16_프로세스고도화_개선안_개발실.md` 등 파일명에 여전히 "개발실" 잔존. 검색 시 혼선 유발. ### A2. 세션 전환 시 맥락 유지 — 구멍 큼 **잘 되는 것**: P21-5B가 2026-04-17 신설되어 PM이 세션 시작 시 최근 2일 대화로그 + `git log --since="2 days ago"` 자동 복원. **구멍 3종**: 1. **개발팀장 Agent 호출 세션은 완전 일회성** — Agent 도구로 호출된 개발팀장 세션은 PM 세션의 일시 확장이며, **독립적인 세션 맥락 저장소가 없다**. P21-5B는 PM 전용. 개발팀장이 이전 Agent 호출에서 내린 결정(예: 2026-04-17 12:21 Unity MCP 기술검토 판단 근거)을 재호출 시 복원하려면 **대화로그를 PM이 프롬프트에 수동 주입**해야 함. 2. **산하 팀장 교차 참조 경로 없음** — 클라이언트팀장이 서버팀장의 직전 결정을 읽는 공식 경로가 `공유/소통/PM→개발팀/` 또는 대화로그 전체 스캔뿐. PM이 개발팀장을 Agent로 호출할 때마다 해당 맥락을 프롬프트에 포함시켜야 하며, **누락 시 산하 팀장은 "이전에 결정된 줄 모르고" 재결정 제안** 가능성. 3. **Live 더미 Read 의무는 있으나 PD 지시 로그 `## 활성 지시` 읽기 의무는 없음** — 서브에이전트가 작업 착수 전 `.live/` Read 의무(P25)는 있으나, 현 상태의 PD 지시 로그 활성 섹션을 개발팀 Agent가 자동 Read하는 메커니즘 부재. 결과: #1·#2·#5·#28의 "대기 중·사후조치" 컬럼을 모르고 중복 제안할 위험. ### A3. 누락 감지 자동화 — pm-auditor 외 개발팀 전용 없음 **실측**: `scripts/` 디렉토리 14개 스크립트 중 개발팀 영역 전용 감지 스크립트 0건. `.claude/agents/pm-auditor.md`는 존재하나 PM 영역 감사 전용. **구멍 3종**: 1. **커밋 직후 대화로그 갱신 감지 hook 부재** — git commit 발생 시 해당 프로젝트의 당일 대화로그 파일 수정 여부를 확인하는 hook이 없음. 결과: 커밋만 쌓이고 맥락은 대화로그에 없는 패턴 재발 가능. 2. **Unity·코어프레임워크 레포 git 상태 점검은 C30이 의무화했으나 자동 감지 없음** — 작업 착수 전 수동 `git fetch` 호출 의존. 누락 시 침묵 실패. 3. **dev-auditor 부재** — PM 영역은 pm-auditor가 로그 추적·규칙 준수·재량 처리·프로세스 개선을 전담. 개발팀 영역(코드 변경 기록, C11 자원 효율성 점검, P13 공용 모듈 영향 분석 등)은 감사 전담이 없음. ### A4. 교차 검증 구조 — 비대칭 **잘 되는 것**: pm-auditor가 개발팀 로그도 감사 대상에 포함 (2026-04-17 커밋 `fix(records): pm-auditor 감사 Critical 2 + Major 3 일괄 해소`가 개발팀 PD 지시 로그 #1·#27 경로 정정 포함). **구멍 2종**: 1. **개발팀 내부 산하 팀 상호 검증 경로 없음** — 클라이언트팀장이 서버팀장 결정을 검증하거나, QA가 양쪽 기록을 검증하는 정기 트리거 없음. 현재는 PM이 개발팀장을 호출해야만 개발팀 내부 교차 검증 가능. 2. **기획팀↔개발팀 상호 검증은 소통 채널(`개발팀→기획팀`·`기획팀→개발팀`)로만 수행** — 주기적 감사가 아닌 이벤트 기반. 예: 08~10 SOT 문서(전투·카드·데이터로딩)에 기획 변경 영향이 반영되었는지 정기 체크 없음. ### A5. 책임 분배 — 매트릭스 미정의 **현 실태**: - PD 지시 로그 전체 책임: 개발팀장 - 대화로그: "작업 수행 에이전트" (모호 — Agent 호출된 자가 쓰는가, PM이 정리하는가?) - 소통 채널: "수행 팀" (모호) - Live 더미: PM만 Write, 서브에이전트 Read 전용 **경계 모호 영역**: 1. 공용 모듈 변경 (Framework Core 추가) — 클라이언트팀장인지 개발팀장인지? 2. 클라-서버 API 스펙 변경 — 양쪽 모두인지 한쪽만인지? 3. QA 전용 테스트 추가 — QA인지 해당 영역 개발자인지? 4. Unity MCP 시뮬레이션 환경 (2026-04-17 #28) — 개발팀 내부에서 클라·서버 어디 책임? --- ## B. 구체 개선안 ### 개선안 1 — dev-auditor 에이전트 신설 - **대상**: `.claude/agents/dev-auditor.md` 신규 작성 - **구멍 근거**: A3-3, A4-1 - **구현 방안**: pm-auditor 구조 차용. 감사 영역 4종 = ①코드 변경과 대화로그 정합성 ②P13 공용 모듈 영향 전파 ③클라-서버 경계 결정 추적 ④Unity·코어 레포 git 상태. 모드 A/B/C는 동일. 산출물: `공유/소통/dev-auditor→개발팀장/YYYY-MM-DD_감사보고_<주제>.md`. - **비용·리스크**: pm-auditor 대비 추가 opus 호출 1건(감사 시). 감사 빈도는 개발팀장 재량. - **분류**: **PM 조율 필요** (pm-auditor 신설 선례에 따라 PM이 템플릿·허용 범위 판단 후 개발팀장 재량 착수). ### 개선안 2 — PD 지시 로그 활성 섹션 자동 Read 의무 (서브에이전트) - **대상**: `.claude/skills/BurningTimes-코어룰/SKILL.md` P25 또는 별도 조항 - **구멍 근거**: A2-3 - **구현 방안**: P25 "서브에이전트 의무" 조항에 `.live/` Read 외에 `공유/PD_지시_트래킹/{자기_부서}_PD_지시_로그.md`의 `## 활성 지시` 섹션 Read를 추가. 토큰 영향: 활성 지시는 보통 5건 이하, 2KB 내외. - **비용·리스크**: 서브에이전트 토큰 약 +2KB/호출. 장기 누적 비용은 중복 제안 회피 이익과 트레이드오프. - **분류**: **개발팀장 재량 — 제안, PM 조율**. 룰 개정은 C29-3 팀 논의 권장. ### 개선안 3 — P22 결정로그 개발팀 강제 적용 - **대상**: `.claude/skills/BurningTimes-코어룰/SKILL.md` P22 - **구멍 근거**: A1-3 - **구현 방안**: 개발팀 기술 결정(아키텍처·API 스펙·공용 모듈·빌드·테스트 정책) 확정 시 `공유/소통/개발팀→PM/YYYY-MM-DD_결정_<주제>.md` 3줄 결정로그 의무화. 기존 장문 보고서(`기술검토`·`업무현황`)와 별도로 발행. 프론트매터 `type: 결정로그` 강제. - **비용·리스크**: 개발팀 발신 파일 수 증가. 대신 PM이 결정을 스캔할 때 O(파일수)가 아닌 O(결정로그수)로 축소. - **분류**: **개발팀장 재량 즉시 착수**. 차기 기술 결정부터 적용. ### 개선안 4 — 산하 팀장별 독립 대화로그 분리 - **대상**: `공유/대화로그/` 하위 경로 확장 - **구멍 근거**: A1-2, A5-모호 영역 1·2·3 - **구현 방안**: `공유/대화로그/수상한잡화점/` 같은 프로젝트 축 외에 **팀 축**(`클라이언트/`·`서버/`·`QA/`·`개발공통/`) 추가. 팀 결정은 팀 축에, 프로젝트 작업은 프로젝트 축에 기록. 겹치는 작업은 양쪽 참조 링크. - **비용·리스크**: 파일 수 증가·검색 분기. 반대로 팀장별 맥락 복원 정확도 상승. - **분류**: **PM 조율 필요** (다른 부서 기획팀과도 구조 일관성 필요). ### 개선안 5 — 책임 경계 매트릭스 SOT 신설 - **대상**: `.claude/skills/BurningTimes-코어룰/` 하위 보조 문서 또는 P13 확장 - **구멍 근거**: A5 전반 - **구현 방안**: 기록 주체 × 작업 유형 × 저장 채널 3차원 매트릭스 표. 예: "공용 모듈 변경 → 개발팀장 기록 (클라이언트·서버팀장 참조)", "API 스펙 변경 → 클라이언트팀장+서버팀장 양측 기록". 문서 위치: `공유/소통/README.md` 확장 또는 SKILL.md 부록. - **비용·리스크**: 초안 작성 공수. 이후 유지비 낮음. - **분류**: **PM 조율 필요**. 본 보고서 B.C 매트릭스 초안이 착수점 역할. ### 개선안 6 — 구 명칭 파일명 일괄 정리 (완결) - **대상**: `공유/소통/` 이하 파일명 중 "개발실·기획실" 잔존 6건 추정 - **구멍 근거**: A1-4 - **구현 방안**: `git mv`로 파일명 변경. 기존 상대 참조가 있으면 함께 수정. - **비용·리스크**: 낮음. 참조 깨짐 리스크는 grep로 선행 확인. - **분류**: **개발팀장 재량 즉시 착수**. 단, 파일명이 PM 소통 채널인 경우 PM 통지 후 진행. ### 개선안 7 — 커밋 후 대화로그 갱신 감지 hook - **대상**: `.claude/hooks/` (현재 디렉토리 부재 확인됨, 신설 필요) 또는 `scripts/post_commit_log_check.sh` - **구멍 근거**: A3-1 - **구현 방안**: git post-commit hook 또는 PreToolUse hook에서 당일 커밋 SHA와 `공유/대화로그/*/YYYY-MM-DD.md` 마지막 수정 시각 비교. 커밋 있는데 대화로그 업데이트 없으면 경고. - **비용·리스크**: hook 설치 관리 복잡. 기존 `auto_approve.py`와의 충돌 점검 필요. - **분류**: **PM 조율 필요** (hook 체계 전반을 PM이 관리 중). --- ## C. 책임 경계 매트릭스 (제안 초안) | 작업 유형 | 주 책임 기록 주체 | 채널 | 참조(읽기) 주체 | |----------|------------------|------|----------------| | PD 직접 지시 (개발 범위) | 개발팀장 | PD 지시 로그 | PM·산하 팀장 전원 | | 공용 모듈(Framework Core) 변경 | 개발팀장 + 결정로그 | 개발팀→PM 결정로그 + 대화로그 `코어프레임워크/` | 클라이언트팀장·서버팀장·QA | | 클라이언트 전용 아키텍처 | 클라이언트팀장 | 대화로그 `클라이언트/`(신설 제안) + PM 보고 시 결정로그 | 개발팀장·QA | | 서버 API 스펙 변경 | 서버팀장 (발의) + 클라이언트팀장 (영향 승인) | 양측 결정로그 + `개발팀→기획팀` (기획 영향 시) | PM·QA | | QA 테스트 정책 | QA | 대화로그 `QA/`(신설 제안) | 개발팀장·산하 팀장 | | Unity 프로젝트 수정 | 수행 에이전트 (클라 또는 기획) | 대화로그 해당 프로젝트 축 + C30 git 점검 기록 | 개발팀장 | | 서브모듈·빌드 스크립트 | 수행 에이전트 | 대화로그 `조직운영/` + 커밋 메시지 상세화 | 전원 | **현재 누락 영역**: - QA 전용 로그 채널 (신설 제안 — 개선안 4와 연동) - 클라-서버 경계 결정의 양측 기록 강제 (현재는 한쪽만 기록되기 쉬움) - Unity 프로젝트 C30 실행 이력 (git fetch 결과를 어디에 기록하는지 미정의) --- ## 결론 요지 - **즉시 착수 가능(개발팀장 재량)**: 개선안 3(P22 결정로그 적용), 개선안 6(구 명칭 정리). - **PM 조율 필요**: 개선안 1(dev-auditor), 개선안 2(활성 지시 Read 의무), 개선안 4(산하 팀장 대화로그), 개선안 5(책임 매트릭스 SOT), 개선안 7(커밋 hook). - **PD님 실질 결정 필요**: 없음. 본 점검 범위 내 모든 개선안은 팀 논의 또는 PM 조율로 결정 가능 (C29). **최우선 1건 추천**: 개선안 1(dev-auditor)이 A3·A4 구멍 대부분을 구조적으로 해소. pm-auditor 선례로 구현 리스크 낮음.