fix(agents): 기획팀장 맥락 오류 재발 방지 + P24 기각안 필수화 (PD 지시 #30·#31)

## PD 지시 #30 — 기획팀장 맥락 오류 재발 방지
기획팀장 Agent가 "plan-auditor 미신설" 잘못 보고한 사건 원인 2중 진단:
- 기획팀장·개발팀장.md가 폐기된 P20(일일보고) 잔존 + P24·P26·P27·3축 감사 체계 미반영
- PM이 Agent 호출 프롬프트에 최신 헌법급 변경 요지(d33b8be) 명시 누락 — P27-2 미준수

### 조치
- SKILL.md P27-2 "호출 프롬프트 필수 3요소" 추가
  (가) 활성 PD 지시 요약 (나) 최근 헌법급 변경 요지 (다) 관련 신규 에이전트·도구 목록
- 기획팀장.md P20 제거 + P24(기각안 필수)·P26·P27·plan-auditor 3축 감사 지침 추가
- 개발팀장.md P20 제거 + P24·P26·P27·dev-auditor + C30 git 최신 상태 점검 추가

## PD 지시 #31 — P24 "기각안" 필드 필수화
기획팀장 안건 1 채택 + PM 재량 확대 (기획→조직 전체 결정·설계 엔트리 공통)
- 엔트리 표준 형식 표: "선택 (결정 시 권장)" → "결정·설계 엔트리 필수"
- 신규 섹션 "기각안 필드 필수화" — 범위·근거·적용 주체·기입 방법·발의 출처
- 근거: 헌법 제1원칙 목표 2 원칙 B — "왜 버렸나"가 더 귀중한 노하우
- 적용 주체: PM·팀장급·전문 에이전트 6종·3축 감사관 공통

## 기록
- 기획팀 PD 지시 로그 #30·#31 등록
- 조직운영 대화로그 2 엔트리 append (기각안 포함)
- .live/ 더미 3종 (SKILL.md·기획팀장.md·개발팀장.md) 기록

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
깃 관리자 2026-04-17 15:26:55 +09:00
parent d33b8beaf2
commit 06a7bb8f93
8 changed files with 101 additions and 6 deletions

View File

@ -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)
**규칙 제안 권한**

View File

@ -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)
**규칙 제안 권한**

View File

@ -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. 세션 전환 시나리오별 복원 보장
| 시나리오 | 보장 메커니즘 |

17
.live/SKILL.md Normal file
View File

@ -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 역할 재검토.

13
.live/개발팀장.md Normal file
View File

@ -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도 동일 맥락 오류 위험 보유 — 사전 차단.

12
.live/기획팀장.md Normal file
View File

@ -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) + 신설 감사관을 명시적으로 인지.

View File

@ -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`) | - | - |

View File

@ -211,3 +211,28 @@
- **기각안**: 단일 `감사→PM/` 공유 채널 — 영역별 감사 이력 분리 기록(차기 프로젝트 참고 자료 축적) 관점에서 기각
- **산출물**: `공유/소통/README.md` 9축 확장 + 필수 7필드 체크리스트
- **상태**: 완료
<!-- checkpoint: 2026-04-17 #기획팀장_맥락오류_점검 -->
<!-- #PD지시 #PM #완료 #맥락오류점검 -->
## [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 등록
- **상태**: 완료
<!-- #PD지시 #PM #완료 #P24기각안필수화 -->
## [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) 공통
- **상태**: 완료