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

7.3 KiB

[조직공지] 세션 시작 교훈 환기 체계 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님 개선 안건 보고 → 결정 후 집행