BurningTimesAi/공유/조직공지/2026-04-23_세션시작_교훈환기_6계층_확장.md

# [조직공지] 세션 시작 교훈 환기 체계 6계층 확장 (BT4)

> **발행일**: 2026-04-23
> **근거**: PD님 2026-04-23 직접 지시 + pm-auditor·dev-auditor·plan-auditor·개발팀장·기획팀장 5종 교차검증
> **지시 요지**: "지난 7일 문서 매번 체크는 과도. 1일 내 우선 + 필요 시 확장. 토큰 효율·응답 속도 개선·조직 연속성 저해 우려 있으면 조정"
> **승인**: PD님 1·2·3A·4E·5안 일괄 승인
> **적용 시점**: 2026-04-23 즉시 (세션 공유 완료분)
> **단일 SOT**: 본 공지가 BT4 6계층 교훈 환기 체계 조직 표준

---

## 1. 변경 요지

구 "최근 7일 feedback 요지 매 세션 주입" 단일 윈도우 → **6계층 + 감사관 E안 자동 윈도우**로 전환. PD 원칙 "고정 범위 아닌 최근 활동 지점부터 역순"을 스냅샷·감사관 윈도우에 일관 적용.

### 6계층 구조

| 계층 | 대상 | 발동 조건 | 윈도우 |
|------|------|---------|--------|
| **0** | 헌법급 feedback 9종 (`tier: constitutional`)·활성 PD 지시·완료 아카이브 최근 5건·최근 7일 기각안·`project_context_조직운영.md` 최신 20개 | **공백 무관 항상 주입** | 건수 기반 |
| 1 | feedback·대화로그 | 공백 ≤1일 | 1일 |
| 2 | 동 | 공백 2~7일 | 공백일수 자동 확장 |
| 3 | 동 | 공백 >7일 | 전수 탐색 모드 (개수 기반) |
| 4 | 동 | `SESSION_RESTORE_EXTEND=N` | 수동 N일 |
| 5 | 내용축 트리거 (인프라 commit·외부 레포·PD 지시 상태 변경·기획 경로) | 자동 감지 | 시간축과 **max 채택** |

### 감사관 E안 자동 윈도우
- **메커니즘**: `scripts/audit_pattern_analyzer.sh auditor_window <name>` — 마지막 해당 감사관 호출 시점 → 현재 자동 산정
- **최소 1일 · 최대 30일 상한**
- **`--extend=N` 수동 확장**

---

## 2. 구현 파일

### 신설
- `memory/org/project_context_조직운영.md` — 이벤트 기반 최신 20개 엔트리 SOT (계층 0 고정 주입)
- `memory/org/project_context_조직운영_archive.md` — 밀려난 엔트리 영구 보존
- `memory/org/feedback_session_restore_monitoring.md` — 🏆 pm-auditor 지속 모니터링 SOT

### 갱신
- `scripts/recent_feedback_brief.sh` — 6계층 로직 (구 7일 고정 폐기)
- `scripts/audit_pattern_analyzer.sh` — 감사관 E안 자동 윈도우 + `session_restore_report` 수동 발동
- SKILL.md — C31-G 자기검증 6계층 반영 + 조직 현황·P29-3·P30-3 게임 명칭 영문 병기
- `memory/org/feedback_*.md` 9종 — frontmatter `tier: constitutional` 태깅
- `.claude/agents/pm-auditor.md` — 감사 영역 6 "BT4 6계층 운영 모니터링" 신설
- `.claude/agents/개발팀장.md` · `기획팀장.md` — Agent 호출 프롬프트 표준 첨부 3종

---

## 3. 헌법급 feedback 9종 (`tier: constitutional` 태깅 완료)

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 주관 개입 차단).

---

## 4. 게임 명칭 영문 풀네임 확정 (PD 5안)

- **한글**: 기묘한 고을 : 조선퇴마뎐
- **영문**: **EerieVillage: Joseon Exorcist**

전파 완료 파일: SKILL.md 조직 현황 섹션·P29-3·P30-3·본 공지·`프로젝트/EerieVillage/README.md`·`공유/조직공지/2026-04-21_BT_조직_출범_인계서.md`·`memory/org/project_context_조직운영.md`

---

## 5. pm-auditor 지속 모니터링 의무 (PD 직접 지시)

PD님 2026-04-23 직접 지시: **"이 시스템을 운영해보고 이슈·비효율적인 부분이 있을 경우, 수정할 수 있도록 pm-auditor가 지속적으로 모니터링하며 개선점을 찾아봐. 프로젝트 archive.md 이동 시점을 기준으로, 데이터를 축적한 후 개선점을 보고하도록 기록해둬."**

- **트리거**: `memory/org/project_context_조직운영_archive.md` 첫 엔트리 이동 시점
- **자동 보고서 생성**: `scripts/audit_pattern_analyzer.sh` archive 첫 엔트리 감지 시 자동 `generate_session_restore_report()` 발동
- **수동 발동**: `bash scripts/audit_pattern_analyzer.sh session_restore_report`
- **SOT**: `memory/org/feedback_session_restore_monitoring.md`

모니터링 영역 6종: 계층별 발동 횟수·주입량 토큰 비용·감사관 E안 윈도우 실사용·트리거 감지 정확도·누락 중복 사례·`tier: constitutional` 자동 선별 정확성.

---

## 6. 논의·결정 경위 (교차검증 Critical·Major 반영)

### Critical 해소 (2건)
- **C36-2 승인 절차** — PD님 명시 승인 완료
- **외부 레포 연계 감지 누락** — 계층 5에 `paths.local.json` 경로 기반 Unity·BT.Framework `git log` 실측 반영

### Major 반영 (6건)
- 계층 0 목록 5→9종 확장
- `tier: constitutional` 자동 선별 도입
- C31-G 본문 수정
- 인프라 commit 감지 범위 확장 (`scripts/*`·`setup/*`·`CLAUDE.md`·`.claude/settings*`·`paths.local.json*`)
- 계층 0 기획 기각안 + 장기 기획 SOT 경로 리스트
- 순수 코드 연쇄 트리거 + 서브에이전트 프롬프트 즉시 갱신

### 상반 의견 조율
- **기획 특화 키워드 7종 즉시 반영 여부** — plan-auditor 필수 vs 기획팀장 불필요. **PM 중재안** = 파일 경로 매칭(`프로젝트/*/기획/**`)만 즉시 반영·키워드 세트는 운영 1~2주 후 누락 사례 누적 시 재발의
- **감사관 윈도우 고정 기간** — 4안 (pm·dev·plan-auditor 본인들 의견 상반) 모두 PD 재검토 지시로 **E안** (자동 윈도우) 신설·채택

### 기각안
1. **B안 시간축 단일** — PM 초안. PD 지적 "내 피드백·중요 맥락 놓칠 수 있는 거 아니냐"로 기각, 계층 0 신설 + 내용축 복원
2. **30일 고정 스냅샷** — 근거 불명확. 이벤트 기반 최신 20개 엔트리로 대체
3. **감사관 윈도우 고정 차등** (A·B·C·D안) — 기간 고정 근거 불명확. E안 자동 윈도우로 대체

---

## 7. 연관 규칙
- **헌법 제1원칙 ②** 경험 축적·계승·발전 (모니터링으로 운영 데이터 축적)
- **헌법 제1원칙 ⑤** 세션·PC 연속성 보장 (6계층의 상위 근거)
- **C14** 토큰 최소화 우선 설계 (고정비 최소화·이벤트 기반)
- **C31-G** 응답 발신 직전 자기검증 (6계층 구조 참조)
- **C35-9** pm-auditor 매니페스트 워크플로우 (집행 전 승인 절차)
- **C35-10** 장기 행동 패턴 분석 (본 모니터링의 상위 규칙)
- **C36-2** PM 자율 판단 범위 상한 (방향·원칙 수준 PD 승인 선행 준수)

---

## 8. 조직 적용
- **적용 범위**: BurningTimes 전 세션·전 PC·전 에이전트
- **적용 시점**: 2026-04-23 즉시 (본 공지 main push 시점)
- **개정 권한**: 총괄PM + pm-auditor 합의 + PD님 승인 (본 공지는 조직 표준)
- **운영 데이터 기반 개선**: pm-auditor가 archive 첫 엔트리 이동 시점에 자동 보고서 생성 → PD님 개선 안건 보고 → 결정 후 집행