118 lines
7.1 KiB
Markdown
118 lines
7.1 KiB
Markdown
|
# 2026-04-23 조직운영 대화로그 — 세션 시작 교훈 환기 체계 6계층 확장 설계
|
||
|
|
|
||
|
|
## 세션 개요
|
||
|
|
- **세션 주체**: PM 단일 세션 (worktree `nice-spence-b3451d`)
|
||
|
|
- **작업 성격**: PD님 직접 지시 — 탐색 윈도우 효율화 + 조직 연속성 보장
|
||
|
|
- **근거 원칙**: 헌법 제1원칙 ⑤ (세션·PC 연속성 보장) + C14 토큰 최소화 우선 설계
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## [설계 결정] 세션 시작 교훈 환기 체계 6계층 확장 (BT4)
|
||
|
|
|
||
|
|
**태그**: #BT4 #PD지시 #코어룰변경 #C36-2승인완료 #v3안최종
|
||
|
|
|
||
|
|
### 배경
|
||
|
|
- PD님 2026-04-23 직접 지시: "지난 7일 문서 매번 체크는 과도. 1일 내 우선 + 필요 시 확장"
|
||
|
|
- 목적: 업무 효율성·토큰 낭비 감소·응답 속도 향상
|
||
|
|
- 단 "조직 연속성 저해 우려 있으면 조정"을 전제로 함
|
||
|
|
|
||
|
|
### 논의 경위 (턴별 진화)
|
||
|
|
1. **1차 PM 초안**: 7층 구조 (1일 기본 + 트리거 6종 + 감사관 분리 + project_context + Agent 보완)
|
||
|
|
2. **PD 제안 수용 (F·G)**: 트리거 F를 "1일 초과 공백 시 1일씩 점진 확장 최대 7일" + G "7일 초과 전수 탐색"
|
||
|
|
3. **PD 4계층 구조 제시**: "고정 범위 아닌 최근 활동 지점부터 역순" 원칙 도입
|
||
|
|
4. **PM 5계층 초안** (B안 시간축 단일): 내용축 트리거 폐기
|
||
|
|
5. **PD 지적**: "내 피드백·중요 맥락 놓칠 수 있는 거 아니냐"
|
||
|
|
6. **PM 자진 정정 6계층 v2**: 계층 0 고정 주입 레이어 신설 + 계층 5 내용축 복원
|
||
|
|
7. **PD 교차검증 지시** → 5종 에이전트 병렬 호출
|
||
|
|
8. **교차검증 결과 반영 v3**: Critical 2건·Major 6건 보완
|
||
|
|
9. **PD 결정 5건 요청 → PD 재검토 지시 2건** (3안 30일·4안 기간 고정 근거 불명확)
|
||
|
|
10. **PM 재검토 A안·E안 제시** → **PD 모두 승인 + pm-auditor 지속 모니터링 의무 추가**
|
||
|
|
|
||
|
|
### 최종 확정 — 6계층 v3 + 운영 모니터링
|
||
|
|
|
||
|
|
#### 계층 구조
|
||
|
|
| 계층 | 대상 | 발동 조건 |
|
||
|
|
|------|------|---------|
|
||
|
|
| **0** | 헌법급 feedback 9종 (`tier: constitutional` 자동 선별) · 활성 PD 지시 로그 전건 · 완료 아카이브 최근 5건 · 최근 7일 기각안 요지 · 장기 기획 SOT 경로 리스트 · `project_context_조직운영.md` (이벤트 기반 최신 20개) | 공백 무관 **항상 주입** |
|
||
|
|
| **1** | feedback·대화로그 | 공백 ≤1일 → 1일 윈도우 |
|
||
|
|
| **2** | 동 | 공백 2~7일 → 공백일수 자동 확장 |
|
||
|
|
| **3** | 동 | 공백 >7일 → 전수 탐색 모드 (개수 기반) |
|
||
|
|
| **4** | 동 | PM 명시 `--extend=N` |
|
||
|
|
| **5** | 내용축 감지 | 인프라 commit(`SKILL·feedback·hook·매니페스트·scripts/*·setup/*·.claude/settings*·CLAUDE.md·paths.local.json*`) / 외부 레포 commit(Unity·BT.Framework) / PD 키워드 / 활성 PD 지시 상태 변경 / 기획 파일 경로 매칭(`프로젝트/*/기획/**`) / 순수 코드 연쇄(`BT.Framework/`·`프로젝트/` 3일+ 연속) → 시간축과 **max 채택** |
|
||
|
|
|
||
|
|
#### 감사관 윈도우 — E안
|
||
|
|
- **메커니즘**: `$HOME/.claude/nerdnavis-audit/auditor_calls/` 이력 기반 마지막 해당 감사관 호출 시점 조회
|
||
|
|
- **자동 윈도우** = 마지막 감사 시점 → 현재 시각
|
||
|
|
- **최소 보장 1일** (즉각 연속 호출 공허 방지)
|
||
|
|
- **최대 안전장치 30일** (초과 시 전수 탐색 모드)
|
||
|
|
- **`--extend=N` 수동 확장**
|
||
|
|
|
||
|
|
#### 헌법급 feedback 9종 (계층 0)
|
||
|
|
1. `feedback_pm_proxy_improvement_reflex.md`
|
||
|
|
2. `feedback_pm_over_conservative_interpretation.md`
|
||
|
|
3. `feedback_issue_under_reporting.md`
|
||
|
|
4. `feedback_role_play_vs_real_call.md`
|
||
|
|
5. `feedback_approval_scope_expansion.md`
|
||
|
|
6. `feedback_agenda_framing_duplication.md`
|
||
|
|
7. `feedback_resolved_agenda_unnecessary_reference.md`
|
||
|
|
8. `feedback_pm_context_restoration_failure.md`
|
||
|
|
9. `feedback_c35_initial_enforcement.md`
|
||
|
|
|
||
|
|
frontmatter에 `tier: constitutional` 추가하여 스크립트가 자동 선별. PM 주관 개입 차단 (pm-auditor Major 1·2 대응).
|
||
|
|
|
||
|
|
#### 게임 명칭 영문 풀네임 확정
|
||
|
|
- **한글**: 기묘한 고을 : 조선퇴마뎐
|
||
|
|
- **영문**: **EerieVillage: Joseon Exorcist**
|
||
|
|
|
||
|
|
SKILL.md 조직 현황 섹션·P29-3·README·인계서·project_context 첫 엔트리에 병기.
|
||
|
|
|
||
|
|
#### pm-auditor 지속 모니터링 의무 (PD 직접 지시)
|
||
|
|
- **트리거 시점**: `project_context_조직운영_archive.md` 첫 엔트리 이동 시점 (= 최신 20개 가득 차서 오래된 엔트리가 아카이브로 밀리는 시점)
|
||
|
|
- **축적 데이터 항목**:
|
||
|
|
- 6계층 발동 횟수 (각 계층별)
|
||
|
|
- 계층 0 자동 주입량 평균 (토큰 비용 실측)
|
||
|
|
- 계층 2 공백일수 자동 확장 실측 분포
|
||
|
|
- 계층 3 전수 탐색 모드 발동 횟수
|
||
|
|
- 계층 5 트리거 감지 정확도 (false positive·false negative)
|
||
|
|
- 감사관 E안 윈도우 실사용 (최소 1일·최대 30일 분포·`--extend=N` 사용)
|
||
|
|
- 누락·중복·오탐 사례
|
||
|
|
- **산출물**: PD님 개선점 보고 + 본 feedback 메모리에 SOT 축적
|
||
|
|
|
||
|
|
### 교차검증 반영 Critical·Major
|
||
|
|
|
||
|
|
#### Critical (해소 완료)
|
||
|
|
- **①** C36-2 승인 절차 → PD님 명시 승인 완료
|
||
|
|
- **②** 외부 레포 연계 감지 누락 → 계층 5에 `paths.local.json` 경로 기반 Unity·BT.Framework `git log` 실측 로직 추가
|
||
|
|
|
||
|
|
#### Major (반영 완료)
|
||
|
|
- 계층 0 목록 5→9종 확장 (pm-auditor)
|
||
|
|
- `tier: constitutional` 자동 선별 도입 (pm-auditor)
|
||
|
|
- C31-G 본문 수정 (pm-auditor)
|
||
|
|
- 인프라 commit 감지 범위 확장 (dev-auditor)
|
||
|
|
- 계층 0 기획 기각안 + 장기 기획 SOT 경로 리스트 (plan-auditor)
|
||
|
|
- 순수 코드 연쇄 트리거 + 서브에이전트 프롬프트 즉시 갱신 (개발팀장)
|
||
|
|
|
||
|
|
### 기각안 (PM 논의 과정 기록)
|
||
|
|
|
||
|
|
1. **B안 (시간축 단일)** — 기각. PD 피드백·누적 맥락 매일 리셋 위험. PM 자진 정정 후 A안(병행 max)로 복귀
|
||
|
|
2. **감사관 윈도우 고정 차등 (A·B·C·D안)** — 기각. PD님 직접 지적 "기간 고정 근거 불명확, 유연". E안 신설 수용
|
||
|
|
3. **스냅샷 30일 기간 고정** — 기각. 임의 경계·활동 밀도 미반영. 이벤트 기반 최신 20개로 대체
|
||
|
|
4. **기획 특화 키워드 7종 즉시 반영** — 부분 기각. 경로 매칭만 즉시 적용, 키워드 세트는 운영 1~2주 후 재발의 (plan-auditor vs 기획팀장 상반 의견 PM 중재)
|
||
|
|
|
||
|
|
### 집행 순서 (본 엔트리 후속)
|
||
|
|
1. 매니페스트 등록 (`scripts/manifest_register.sh`)
|
||
|
|
2. pm-auditor 사전 재호출 (v3 최종안 통과 확인)
|
||
|
|
3. 구조물 신설 commit (project_context·_archive·feedback_session_restore_monitoring·frontmatter tier 9종)
|
||
|
|
4. 로직 구현 commit (`recent_feedback_brief.sh` 6계층·`audit_pattern_analyzer.sh` E안 윈도우)
|
||
|
|
5. 규칙·에이전트 갱신 commit (SKILL.md C31-G·조직 현황·P29-3·pm-auditor·개발팀장·기획팀장)
|
||
|
|
6. 조직공지 발행 + 인계서 영문 병기
|
||
|
|
7. main push
|
||
|
|
|
||
|
|
### 연관 규칙
|
||
|
|
- **C14** 토큰 최소화 우선 설계
|
||
|
|
- **C31-G** 응답 발신 직전 자기검증 (본문 수정 연쇄)
|
||
|
|
- **C35-9** pm-auditor 매니페스트 워크플로우
|
||
|
|
- **C36-2** PM 자율 판단 범위 상한 (헌법·C·P 본문 수정 PD 명시 승인 선행)
|
||
|
|
- **C34** PC 로컬 실시간 공유 (audit 이력 기반 E안 윈도우)
|
||
|
|
- **헌법 제1원칙 ⑤** 세션·PC 연속성 (본 체계 상위 근거)
|