14 KiB

Raw Blame History

type

from

date

status

업무 공유·기록 체계 점검 — 개발팀 관점

범위: 개발팀 내부(개발팀장·클라이언트팀장·서버팀장·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종:

코드·커밋 레벨 기록 공백 — 규칙상 "의미 있는 작업"의 범위가 문서·결정 중심이고, 코드 변경·리팩토링·서브모듈 수정·빌드 설정 변경 같은 개발 고유 활동이 P24 대화로그에 들어가야 하는지 명시 부재. 2026-04-16 코어코드/NerdNavis.Framework/ git 통합 커밋 7187ac6은 대화로그 코어프레임워크/2026-04-16.md에 엔트리가 있으나, 커밋 SHA·변경 파일 수치 누락. 다른 커밋(2026-04-16 Template 17개 파일 생성 등)은 대화로그 엔트리가 확인되지 않음.
산하 팀장(클라이언트·서버·QA) 독립 로그 부재 — PD 지시 로그는 "개발팀" 단일 파일이며, 산하 팀장별 의사결정 이력이 개발팀장 로그에 통합되어 클라이언트↔서버 경계 결정의 추적성이 낮음. 예: Unity 프로젝트 점검(2026-04-16 커밋)은 기획팀장이 수행했는데 클라이언트팀장 판단 경로가 불명확.
기술 결정·아키텍처 결정의 P22 결정로그 활용도 저조 — 공유/소통/개발팀→PM/ 6개 파일 중 "결정로그" 프론트매터를 단일 SOT 규격으로 갖춘 파일이 확인되지 않음 (실측: 파일명 패턴 RPT·기술검토·업무현황 중심). P22는 3줄 이내 결정로그를 요구하나 개발팀은 장문 보고서로만 송신.
구 명칭 잔재 — 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종:

개발팀장 Agent 호출 세션은 완전 일회성 — Agent 도구로 호출된 개발팀장 세션은 PM 세션의 일시 확장이며, 독립적인 세션 맥락 저장소가 없다. P21-5B는 PM 전용. 개발팀장이 이전 Agent 호출에서 내린 결정(예: 2026-04-17 12:21 Unity MCP 기술검토 판단 근거)을 재호출 시 복원하려면 대화로그를 PM이 프롬프트에 수동 주입해야 함.
산하 팀장 교차 참조 경로 없음 — 클라이언트팀장이 서버팀장의 직전 결정을 읽는 공식 경로가 공유/소통/PM→개발팀/ 또는 대화로그 전체 스캔뿐. PM이 개발팀장을 Agent로 호출할 때마다 해당 맥락을 프롬프트에 포함시켜야 하며, 누락 시 산하 팀장은 "이전에 결정된 줄 모르고" 재결정 제안 가능성.
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종:

커밋 직후 대화로그 갱신 감지 hook 부재 — git commit 발생 시 해당 프로젝트의 당일 대화로그 파일 수정 여부를 확인하는 hook이 없음. 결과: 커밋만 쌓이고 맥락은 대화로그에 없는 패턴 재발 가능.
Unity·코어프레임워크 레포 git 상태 점검은 C30이 의무화했으나 자동 감지 없음 — 작업 착수 전 수동 git fetch 호출 의존. 누락 시 침묵 실패.
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종:

개발팀 내부 산하 팀 상호 검증 경로 없음 — 클라이언트팀장이 서버팀장 결정을 검증하거나, QA가 양쪽 기록을 검증하는 정기 트리거 없음. 현재는 PM이 개발팀장을 호출해야만 개발팀 내부 교차 검증 가능.
기획팀↔개발팀 상호 검증은 소통 채널(개발팀→기획팀·기획팀→개발팀)로만 수행 — 주기적 감사가 아닌 이벤트 기반. 예: 08~10 SOT 문서(전투·카드·데이터로딩)에 기획 변경 영향이 반영되었는지 정기 체크 없음.

A5. 책임 분배 — 매트릭스 미정의

현 실태:

PD 지시 로그 전체 책임: 개발팀장
대화로그: "작업 수행 에이전트" (모호 — Agent 호출된 자가 쓰는가, PM이 정리하는가?)
소통 채널: "수행 팀" (모호)
Live 더미: PM만 Write, 서브에이전트 Read 전용

경계 모호 영역:

공용 모듈 변경 (Framework Core 추가) — 클라이언트팀장인지 개발팀장인지?
클라-서버 API 스펙 변경 — 양쪽 모두인지 한쪽만인지?
QA 전용 테스트 추가 — QA인지 해당 영역 개발자인지?
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/너드나비스-코어룰/SKILL.md P25 또는 별도 조항
구멍 근거: A2-3
구현 방안: P25 "서브에이전트 의무" 조항에 .live/ Read 외에 공유/PD_지시_트래킹/{자기_부서}_PD_지시_로그.md의 ## 활성 지시 섹션 Read를 추가. 토큰 영향: 활성 지시는 보통 5건 이하, 2KB 내외.
비용·리스크: 서브에이전트 토큰 약 +2KB/호출. 장기 누적 비용은 중복 제안 회피 이익과 트레이드오프.
분류: 개발팀장 재량 — 제안, PM 조율. 룰 개정은 C29-3 팀 논의 권장.

개선안 3 — P22 결정로그 개발팀 강제 적용

대상: .claude/skills/너드나비스-코어룰/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/너드나비스-코어룰/ 하위 보조 문서 또는 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 선례로 구현 리스크 낮음.

14 KiB Raw Blame History Unescape Escape