diff --git a/.claude/agents/개발팀장.md b/.claude/agents/개발팀장.md index 420b5c5..8c824f1 100644 --- a/.claude/agents/개발팀장.md +++ b/.claude/agents/개발팀장.md @@ -82,8 +82,10 @@ skills: - 공용 모듈·인터페이스 변경(P13), QA 게이트(P14), 의존성·환경 변경 공유(P15)를 실무적으로 감독한다 - 프로덕션 보호(C8) — 빌드·서버·DB 변경은 롤백 경로 확보 상태에서만 수행 - **설계 문서화 의무(P18)** — 아키텍처·코어·서버·보안 등 설계 결정사항은 반드시 문서로 명문화. 참조된 설계 문서의 실제 존재 여부를 직접 점검. 누락 시 즉시 작성 지시 -- **PD 지시 트래킹·공유 의무(C13·P19, 핵심 규칙)** — PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/개발팀_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·중단(사유+사후 조치) 4단계 전부 가시화. 누락 시 C3·C13 위반(헌법급) -- **일일 보고(P20)** — 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발팀.md` 작성·갱신 +- **PD 지시 트래킹·공유 의무(C13·P19·C27·C29-4, 핵심 규칙)** — PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/개발팀_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·중단(사유+사후 조치) 4단계 전부 가시화. 완료 시 대화로그·소통 채널 완료 이동·Live 더미 동기화 동시 수행. 누락 시 C3·C13 위반(헌법급) +- **대화로그 기록(P24)** — 의미 있는 작업·결정·이슈 발생 시 `공유/대화로그/{프로젝트}/YYYY-MM-DD.md`에 엔트리 추가. **결정·설계 엔트리는 "기각안" 필드 필수** (2026-04-17 PD님 직접 지시, 헌법 제1원칙 목표 2 원칙 B 직결). P20(일일보고)는 2026-04-16 폐기되어 P24가 전담 +- **3축 감사 체계(P26·P27)** — PM 영역은 `pm-auditor`, **개발 영역은 `dev-auditor`**(기존 신설 완료, `.claude/agents/dev-auditor.md`), 기획 영역은 `plan-auditor`. 개발팀장은 중요 기술 결정·커밋 대량 발생 시·API 변경 시 `dev-auditor` 모드 A 교차 검증 권장, 세션 말미 모드 B 주기 감사 1회 수행 +- **git 최신 상태 점검 의무(C30)** — Unity 프로젝트·코어 프레임워크 등 외부 git 레포 작업 착수 직전 `git fetch && git status` 실행하여 최신 상태 확인. 구버전 상태 작업 금지 - 이슈 발생 시 임시 조치가 아닌 근본 원인 해결(C2), 필요 시 총괄PM에게 즉시 보고(C3) **규칙 제안 권한** diff --git a/.claude/agents/기획팀장.md b/.claude/agents/기획팀장.md index 89135af..6e91b7c 100644 --- a/.claude/agents/기획팀장.md +++ b/.claude/agents/기획팀장.md @@ -83,8 +83,9 @@ skills: - **데이터 보호(C6)** — 수치 밸런스 파일(xlsm/csv/json)은 변경 전 버전 태그 백업 필수 - **산출물 추적성(P16)** — 기획 결정의 변경 이력(누가·언제·왜)을 문서화 - **★ 조건 배타 배치 규칙(P17)** — 스테이지 기획 시 배타 조합 7종 전수 체크, 위반 차단 -- **PD 지시 트래킹·공유 의무(C13·P19, 핵심 규칙)** — PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/기획팀_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·중단(사유+사후 조치) 4단계 전부 가시화. 누락 시 C3·C13 위반(헌법급) -- **일일 보고(P20)** — 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_기획팀.md` 작성·갱신 +- **PD 지시 트래킹·공유 의무(C13·P19·C27·C29-4, 핵심 규칙)** — PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/기획팀_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·중단(사유+사후 조치) 4단계 전부 가시화. 완료 시 대화로그·소통 채널 완료 이동·Live 더미 동기화 동시 수행. 누락 시 C3·C13 위반(헌법급) +- **대화로그 기록(P24)** — 의미 있는 작업·결정·이슈 발생 시 `공유/대화로그/{프로젝트}/YYYY-MM-DD.md`에 엔트리 추가. **결정·설계 엔트리는 "기각안" 필드 필수** (2026-04-17 PD님 직접 지시, 헌법 제1원칙 목표 2 원칙 B 직결). P20(일일보고)는 2026-04-16 폐기되어 P24가 전담 +- **3축 감사 체계(P26·P27)** — PM 영역은 `pm-auditor`, 개발 영역은 `dev-auditor`, **기획 영역은 `plan-auditor`**(기존 신설 완료, `.claude/agents/plan-auditor.md`). 기획팀장은 중요 결정·보고 응답 발신 직전 `plan-auditor` 모드 A 교차 검증 권장, 세션 말미 모드 B 주기 감사 1회 수행 - 이슈 발생 시 임시 조치가 아닌 근본 원인 해결(C2), 필요 시 총괄PM에게 즉시 보고(C3) **규칙 제안 권한** diff --git a/.claude/skills/너드나비스-코어룰/SKILL.md b/.claude/skills/너드나비스-코어룰/SKILL.md index 019b0e2..e6374a3 100644 --- a/.claude/skills/너드나비스-코어룰/SKILL.md +++ b/.claude/skills/너드나비스-코어룰/SKILL.md @@ -876,7 +876,19 @@ SessionStart hook의 `change_digest.sh`가 자동 표시. 별도 pull 불필요. | 이유 | 왜 이 결정/작업을 했는가 | ✅ | | 산출물 | 파일 경로 (없으면 "없음") | ✅ | | 상태 | 완료/진행중/보류 | ✅ | -| 기각안 | 검토했으나 채택하지 않은 안과 이유 | 선택 (결정 시 권장) | +| 기각안 | 검토했으나 채택하지 않은 안과 이유 | **결정·설계 엔트리 필수** (기획·개발·조직운영 공통; 없을 시 "없음" 명시) · 단순 진행 엔트리는 선택 | + +### 기각안 필드 필수화 (2026-04-17 PD님 직접 지시) + +**범위**: 결정·설계 엔트리(규칙 신설/변경·방향 결정·시스템 설계·밸런스 수치 결정 등)는 기각안 필드 **필수**. 단순 진행 엔트리(일상적 구현·문서 보완·오탈자 수정 등)는 선택. + +**근거**: 헌법 제1원칙 목표 2 원칙 B — 수상한잡화점 인사이트를 차기 프로젝트 참고 자료로 활용. **"왜 채택했나"보다 "왜 버렸나"가 더 귀중한 노하우**다. 기각안 누락 = 조직 자산 영구 소실. + +**적용 주체**: PM·기획팀장·개발팀장·전문 에이전트(balance/content/level/narrative/system/ux) + 3축 감사관(pm/dev/plan-auditor) 모두 공통 적용. + +**없을 때 기입**: "없음 (다른 안 미검토)" 또는 "없음 (PD님 지적 즉시 수용)" 등 사유 1줄 명시. 공란 금지. + +**발의**: 2026-04-17 기획팀장 `2026-04-17_업무공유체계_점검_기획팀.md` 안건 1. PM 재량 승인 후 PD님 직접 지시로 확정 진행. ### 읽기 의무 (2026-04-17 개정 — C29 위반 재발 방지) @@ -931,13 +943,24 @@ grep -r "기각안" 공유/대화로그/ # 기각 이유 추적 - 세션 말미에 **모드 B 주기 감사** 최소 1회 수행 - 3개 감사관은 상호 교차 검증 가능 (dev-auditor 결과를 pm-auditor가 메타 검증 등) -### P27-2. Agent 호출 이력 기록 의무 (신설) +### P27-2. Agent 호출 이력 기록 의무 (신설 / 2026-04-17 호출 프롬프트 3요소 추가) PM 또는 어떤 에이전트가 Agent 도구로 다른 에이전트를 호출할 때: 1. **호출 프롬프트 요지**를 대화로그 엔트리에 명시 (무엇을 왜 위임했는가) 2. **응답 수령 시 산출물 경로 + 로그 갱신 수행 여부** 기록 3. **호출된 Agent가 로그 갱신을 수행하지 않았다면** 호출자(PM)가 즉시 보완 (C27 의무) +**호출 프롬프트 필수 3요소** (2026-04-17 추가 — 맥락 오류 재발 방지) + +PM이 Agent를 호출할 때 프롬프트에 다음 3요소를 반드시 포함한다: +- **(가) 관련 활성 PD 지시 로그 항목 요약** — 수신 Agent가 현 업무 맥락을 즉시 파악 가능하도록 요지·상태·비고란 최신 지시 1~3줄 요약 +- **(나) 최근 헌법급 변경 요지** — 최근 3일 내 C·P 신설/변경, 에이전트 신설, hook 확장 등. 특히 수신 Agent 역할과 직접 관련된 변경은 커밋 해시·요지 1줄로 명시 +- **(다) 수신 Agent 역할 관련 신규 에이전트·도구 목록** — 3축 감사관(pm/dev/plan-auditor) 존재 여부, 최신 스크립트(`verify_log_paths.sh` 등), 관련 Live 더미 경로 + +**실증 근거**: 2026-04-17 기획팀장 Agent 호출 시 PM이 d33b8be(3축 감사 신설 + plan-auditor) 맥락을 프롬프트에 포함하지 않아, 기획팀장이 SKILL.md P27-1 표를 "미래 계획"으로 오독하고 "plan-auditor 미신설, 안건 #2로 신설 상정 중"으로 잘못 보고한 사건. + +**위반 시**: PM 책임 (수신 Agent 귀책 아님). 동일 패턴 반복 시 PM 역할 재검토 (C23·C29 연계). + ### P27-3. 세션 전환 시나리오별 복원 보장 | 시나리오 | 보장 메커니즘 | diff --git a/.live/SKILL.md b/.live/SKILL.md new file mode 100644 index 0000000..e1de2a8 --- /dev/null +++ b/.live/SKILL.md @@ -0,0 +1,17 @@ +## 2026-04-17 PM — P24·P27-2 개정 (PD 지시 #30·#31) + +### P24 "기각안" 필드 필수화 +- 엔트리 표준 형식 표 "기각안" 필드: "선택 (결정 시 권장)" → **"결정·설계 엔트리 필수"** +- 신규 섹션 "기각안 필드 필수화 (2026-04-17 PD님 직접 지시)" — 범위·근거·적용 주체·기입 방법·발의 출처 명문화 +- 적용 주체: PM·기획팀장·개발팀장·전문 에이전트 6종·3축 감사관 공통 +- 없을 때 기입 예: "없음 (다른 안 미검토)" / "없음 (PD님 지적 즉시 수용)" — 공란 금지 + +### P27-2 "호출 프롬프트 필수 3요소" 추가 +PM이 Agent 호출 시 프롬프트에 반드시 포함: +- (가) 관련 활성 PD 지시 로그 항목 요약 (요지·상태·비고란 최신 1~3줄) +- (나) 최근 헌법급 변경 요지 (최근 3일 내 C·P 신설/변경, 에이전트 신설, hook 확장) +- (다) 수신 Agent 역할 관련 신규 에이전트·도구 목록 (3축 감사관·최신 스크립트·Live 더미) + +실증 근거: 2026-04-17 기획팀장 Agent가 plan-auditor "미신설"로 오인한 사건 (PM이 d33b8be 맥락 누락). + +위반 시 PM 책임, 반복 시 PM 역할 재검토. diff --git a/.live/개발팀장.md b/.live/개발팀장.md new file mode 100644 index 0000000..c01707e --- /dev/null +++ b/.live/개발팀장.md @@ -0,0 +1,13 @@ +## 2026-04-17 PM — 개발팀장 정의 갱신 (PD 지시 #30) + +### 제거 +- 구 **P20(일일 보고)** 지침 — 2026-04-16 폐기됨, P24가 전담 + +### 추가 +- **P24(대화로그 기록)** — 기각안 필수 (결정·설계 엔트리) +- **C13·P19·C27·C29-4 통합 지침** — 완료 시 대화로그·소통 채널·Live 더미 동시 동기화 +- **3축 감사 체계(P26·P27)** — 개발 영역 전담 `dev-auditor` (신설 완료). 중요 기술 결정·커밋 대량 발생·API 변경 시 모드 A, 세션 말미 모드 B +- **C30(git 최신 상태 점검)** — Unity 프로젝트·코어 프레임워크 작업 착수 직전 `git fetch && git status` 필수 + +### 재발 방지 취지 +개발팀장 Agent도 동일 맥락 오류 위험 보유 — 사전 차단. diff --git a/.live/기획팀장.md b/.live/기획팀장.md new file mode 100644 index 0000000..fcfb867 --- /dev/null +++ b/.live/기획팀장.md @@ -0,0 +1,12 @@ +## 2026-04-17 PM — 기획팀장 정의 갱신 (PD 지시 #30) + +### 제거 +- 구 **P20(일일 보고)** 지침 — 2026-04-16 폐기됨, P24가 전담 + +### 추가 +- **P24(대화로그 기록)** — 의미 있는 작업·결정·이슈 발생 시 `공유/대화로그/{프로젝트}/YYYY-MM-DD.md` 엔트리. **결정·설계 엔트리는 "기각안" 필드 필수** (헌법 제1원칙 목표 2 원칙 B 직결) +- **C13·P19·C27·C29-4 통합 지침** — 완료 시 대화로그·소통 채널 완료 이동·Live 더미 동기화 동시 수행 +- **3축 감사 체계(P26·P27)** — 기획 영역 전담 `plan-auditor` (신설 완료, `.claude/agents/plan-auditor.md`). 중요 결정·보고 발신 직전 모드 A 교차 검증, 세션 말미 모드 B 주기 감사 + +### 재발 방지 취지 +기획팀장 Agent가 "plan-auditor 미신설" 잘못 보고한 사건 재발 차단. 에이전트 정의 파일이 최신 규칙(P26·P27) + 신설 감사관을 명시적으로 인지. diff --git a/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md b/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md index dd42d7e..bbaa591 100644 --- a/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md +++ b/공유/PD_지시_트래킹/기획팀_PD_지시_로그.md @@ -46,6 +46,8 @@ C3·C13 위반에 해당. **즉시 자진 보고 후 소급 등록**. | # | 일시 | 지시 요지 | 처리 상태 | 산출물 경로 | 중단 사유 | 사후 조치 | |---|------|----------|----------|-----------|----------|----------| +| 31 | 2026-04-17 | P24 "기각안" 필드 필수화 — 헌법 제1원칙 목표 2 원칙 B(인사이트 기록) 직결. 기획팀장 `2026-04-17_업무공유체계_점검_기획팀.md` 안건 1 채택 | **완료** | SKILL.md P24 본문 개정(결정·설계 엔트리 필수화 + 기각안 필드 필수화 근거 섹션 신설). 적용 주체: PM·팀장급·전문 에이전트 6종·3축 감사관 공통 | - | 기획팀장·개발팀장.md에 P24 기각안 필수 지침 명시. 향후 기각안 기록률 주기 점검 | +| 30 | 2026-04-17 | 기획팀장 맥락 오류(plan-auditor "미신설" 오인) 원인 점검 + 재발 방지 조치 | **완료** | (1) 원인 2중 진단: 기획팀장.md·개발팀장.md가 폐기된 P20(일일보고) 잔존 + P24·P26·P27 미반영 + PM이 Agent 호출 시 최신 헌법급 변경 요지(d33b8be) 프롬프트 누락 (2) 조치: SKILL.md P27-2 "호출 프롬프트 필수 3요소" 추가, 기획팀장·개발팀장.md에 P24·P26·P27·3축 감사관 지침 신설, 구 P20 지침 제거 | - | PM 호출 프롬프트 체크리스트 운영 강제 — 차기 Agent 호출 시 (가)활성 PD 지시 요약 (나)최근 헌법급 변경 요지 (다)관련 신규 에이전트·도구 3요소 필수 포함 | | 27 | 2026-04-16 | 유니티 프로젝트 현재 상태 점검 — 기존 분석 산출물(개발/ 10건, 기획/ 12건) 유효성 교차 검증 | **완료** | `공유/소통/기획팀→PM/2026-04-16_유니티프로젝트_점검_기획팀.md` (8,683 bytes 실측 확인) | - | 후속: xlsm SOT 확정, Spine 도입 현황 개발팀 확인, GameManager.cs 소재 파악 (별도 신규 지시 필요 시 등록) | | 26 | 2026-04-16 | PM 통합 허브 + 부서 독립 세션 하이브리드 구조에 대한 기획팀장 의견 제출 | **완료** | `공유/소통/기획팀→PM/2026-04-16_하이브리드구조_기획팀의견.md`. 총괄PM 교차 검토 후 보완 5건 구현(`c14348b`) | - | - | | 25 | 2026-04-16 | 조직 프로세스 고도화 3대 문제 기획팀장 개선안 제안 | **완료** | `공유/소통/기획팀→PM/2026-04-16_프로세스고도화_개선안_기획팀.md`. 총괄PM 교차 검토 후 통합 6건 구현(`6768969`) | - | - | diff --git a/공유/대화로그/조직운영/2026-04-17.md b/공유/대화로그/조직운영/2026-04-17.md index 86a2eb2..d9eb9c1 100644 --- a/공유/대화로그/조직운영/2026-04-17.md +++ b/공유/대화로그/조직운영/2026-04-17.md @@ -211,3 +211,28 @@ - **기각안**: 단일 `감사→PM/` 공유 채널 — 영역별 감사 이력 분리 기록(차기 프로젝트 참고 자료 축적) 관점에서 기각 - **산출물**: `공유/소통/README.md` 9축 확장 + 필수 7필드 체크리스트 - **상태**: 완료 + + + + +## [PM] 기획팀장 맥락 오류(plan-auditor "미신설" 오인) 원인 점검·조치 (PD 지시 #30) +- **요지**: PM이 "각 팀 업무 현황 보고" 지시에서 Agent(기획팀장) 호출 → 기획팀장이 `plan-auditor` 에이전트를 "미신설, 안건 #2로 신설 상정 중"으로 잘못 보고. 실제로는 커밋 d33b8be에서 신설 완료 상태. 원인 2중 진단: (1) 기획팀장.md·개발팀장.md가 폐기된 **P20(일일보고)** 지침 잔존 + P24·P26·P27·3축 감사 체계 미반영 (2) **PM이 Agent 호출 프롬프트에 최신 헌법급 변경 요지(d33b8be) 명시 누락** — P27-2 미준수 +- **이유**: 단일 세션 + Agent 병렬 호출 구조에서 수신 Agent는 SessionStart hook·PM 맥락을 받지 못하므로 PM이 프롬프트에 맥락을 담지 않으면 Agent가 이전 상태 전제로 응답. 에이전트 정의 파일이 최신 규칙을 반영하지 못한 상태가 이 취약점을 증폭 +- **기각안**: "수신 Agent 측 실측 확인 강화"만으로 해결 — PM 측 프롬프트 누락이 근본 원인이고 수신 Agent가 실측할 의무는 있으나 호출자 책임이 더 큼. 단일 방향 조치만으로는 맥락 불균형 구조 해소 불가 +- **산출물**: + 1. SKILL.md P27-2 "호출 프롬프트 필수 3요소" 추가 — (가)활성 PD 지시 요약 (나)최근 헌법급 변경 요지 (다)관련 신규 에이전트·도구 목록 + 2. `.claude/agents/기획팀장.md` P20 지침 제거 + P24(기각안 필수)·P26·P27·`plan-auditor` 3축 감사 지침 추가 + 3. `.claude/agents/개발팀장.md` P20 지침 제거 + P24(기각안 필수)·P26·P27·`dev-auditor` 3축 감사 지침 + C30 git 최신 상태 점검 추가 + 4. 기획팀 PD 지시 로그 #30 등록 +- **상태**: 완료 + + +## [PM] P24 "기각안" 필드 필수화 — 결정·설계 엔트리 공통 적용 (PD 지시 #31) +- **요지**: 기획팀장 `2026-04-17_업무공유체계_점검_기획팀.md` 안건 1(기획 영역 결정 기각안 필수화)을 PM 재량 검토 후 **조직 전체 결정·설계 엔트리 공통 적용**으로 확대 채택. PD님 직접 지시 "P24 진행 후 완료 보고" 수령으로 즉시 개정 +- **이유**: 헌법 제1원칙 목표 2 원칙 B — 수상한잡화점 인사이트를 차기 프로젝트 참고 자료로 활용. **"왜 채택했나"보다 "왜 버렸나"가 더 귀중한 노하우**. 기획 영역에만 한정하면 개발 아키텍처·조직 운영 결정의 기각안도 소실 위험. 범위 확대로 조직 전체 인사이트 축적 +- **기각안**: + 1. 기획팀장 원안 그대로(기획 영역만 필수) — 개발 아키텍처·조직 운영 결정의 기각안 소실 위험 상존으로 기각, 조직 전체 확대 채택 + 2. 모든 엔트리 일괄 필수화 — 단순 진행 엔트리(일상적 구현·오탈자 수정)까지 기각안 강제 시 토큰 낭비 + 운영 피로, 결정·설계 엔트리로 한정 +- **산출물**: SKILL.md P24 엔트리 표준 형식 표 "기각안" 필드 "선택 (결정 시 권장)" → "**결정·설계 엔트리 필수**" 개정 + "기각안 필드 필수화" 근거 섹션 신설 (범위·근거·적용 주체·기입 방법·발의 출처) +- **적용 주체**: PM·기획팀장·개발팀장·전문 에이전트(balance/content/level/narrative/system/ux) + 3축 감사관(pm/dev/plan-auditor) 공통 +- **상태**: 완료