feat(BT4·Phase3): SKILL.md 6계층 반영 + 게임명칭 영문 병기 + 에이전트 3종 갱신

- SKILL.md:
  · 조직 현황 섹션: "기묘한 고을 : 조선퇴마뎐 / EerieVillage: Joseon Exorcist" 병기
  · P29-3 EerieVillage 활용 방침: 한·영 명칭 병기
  · P30-3 재미 우선 적용 프로젝트: 영문 병기
  · C31-G 자기검증: "최근 7일 feedback" → "6계층 교훈 요지" (계층 0~5 인용)
  · C35-9 Layer 1: recent_feedback_brief.sh 설명 6계층 반영
- pm-auditor.md: 감사 영역 6 "BT4 6계층 운영 모니터링" 신설 (PD 지시 직접 반영)
  · 트리거 = project_context_조직운영_archive.md 첫 엔트리 이동
  · 모니터링 6영역 (계층별 발동·주입량·감사관 E안 윈도우·트리거 정확도·누락 중복·tier 정확성)
- 개발팀장.md: Agent 호출 프롬프트 표준 첨부 3종 (2~3일 맥락·project_context 경로·경로 규약)
- 기획팀장.md: Agent 호출 프롬프트 표준 첨부 3종 (기각안 SOT·P30 재미 정의·직전 결정)

근거: PD 지시 BT4 승인 5·5안·모니터링 의무
매니페스트: 2026-04-23_BT4_Phase3_rules

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
깃 관리자 2026-04-23 00:28:51 +09:00
parent 23064353f9
commit cbc1b19e25
4 changed files with 54 additions and 5 deletions

View File

@ -147,6 +147,24 @@ Agent 호출 후 및 신규 설정·저장소 도입 시 다음 항목 점검:
- **신규 설정 도입 시 5개 질문 체크리스트** (C34-15): PC 단위 vs worktree 단위 · 경계 안전성 · 중앙화 필요성 · 레포 루트 vs worktree 실행 차이 · Agent 경계 보호 5항목 통과 여부 - **신규 설정 도입 시 5개 질문 체크리스트** (C34-15): PC 단위 vs worktree 단위 · 경계 안전성 · 중앙화 필요성 · 레포 루트 vs worktree 실행 차이 · Agent 경계 보호 5항목 통과 여부
- **경계 자산 정기 점검**: `.live/`·`memory/org/`·`paths.local.json` 상태를 `scripts/verify_setup.ps1` 실행으로 확인. 경계 이탈 감지 시 Critical - **경계 자산 정기 점검**: `.live/`·`memory/org/`·`paths.local.json` 상태를 `scripts/verify_setup.ps1` 실행으로 확인. 경계 이탈 감지 시 Critical
### 6. BT4 6계층 교훈 환기 체계 운영 모니터링 (2026-04-23 신설 — PD님 직접 지시)
PD님 2026-04-23 BT4 승인 시 직접 지시: **"이 시스템을 운영해보고 이슈·비효율적인 부분이 있을 경우, 수정할 수 있도록 pm-auditor가 지속적으로 모니터링하며 개선점을 찾아봐. 프로젝트 archive.md 이동 시점을 기준으로, 데이터를 축적한 후 개선점을 보고하도록 기록해둬."**
**트리거**: `memory/org/project_context_조직운영_archive.md`**첫 엔트리가 이동하는 시점** (= 활성 파일 `project_context_조직운영.md` 가 21번째 엔트리로 가장 오래된 엔트리를 밀어내는 순간). `scripts/audit_pattern_analyzer.sh`가 자동 감지하여 `generate_session_restore_report()` 발동.
**모니터링 영역 6종** (`memory/org/feedback_session_restore_monitoring.md` SOT 세부 정의 참조):
1. **계층별 발동 횟수** — 계층 0(매 세션 1회)·계층 1(1일)·계층 2(2~7일 자동)·계층 3(>7일 전수)·계층 4(`--extend=N`)·계층 5(내용축 트리거별)
2. **주입량·토큰 비용** — 계층 0 평균 주입 엔트리 수·고정비 실측
3. **감사관 E안 윈도우 실사용** — pm·dev·plan-auditor 각 자동 윈도우 분포 (1일 최소 ~ 30일 상한)·`--extend=N` 수동 사용
4. **트리거 감지 정확도** — False positive·False negative 사례
5. **누락·중복 사례** — PD님 "이 맥락 왜 놓쳤어?" 지적·계층 0 + 계층 5 겹침
6. **`tier: constitutional` 자동 선별 정확성** — 헌법급 9종 외 PM 주관 편입 시도·신규 feedback 태깅 누락
**수동 발동**: `bash scripts/audit_pattern_analyzer.sh session_restore_report`
**보고 형식**: `memory/org/audit_pattern_analysis_6계층_{YYYY-MM-DD_HHMM}.md` 자동 생성 → pm-auditor가 수동 기입 섹션(계층별 발동 통계·개선 안건·PD 결정 요청 우선순위) 보완 → PD님 개선 보고.
## ⚡ 의무 참여 체계 (2026-04-19 C35 신설 — PD님 직접 지시) ## ⚡ 의무 참여 체계 (2026-04-19 C35 신설 — PD님 직접 지시)
본 에이전트는 **조직 내 공유가 필요한 작업**에 PM이 **의무적으로 사전 호출**한다. 수동 호출 의존 구조의 감사 사각지대를 원천 제거하여 본 세션 PM 보고 품질 3연속 문제(이슈 축소·안건 중복·종결 언급) 같은 재발을 구조적으로 차단. 본 에이전트는 **조직 내 공유가 필요한 작업**에 PM이 **의무적으로 사전 호출**한다. 수동 호출 의존 구조의 감사 사각지대를 원천 제거하여 본 세션 PM 보고 품질 3연속 문제(이슈 축소·안건 중복·종결 언급) 같은 재발을 구조적으로 차단.

View File

@ -35,6 +35,19 @@ skills:
### 직속 ### 직속
- QA 엔지니어 (`/qa`) — 테스트 전략 및 자동화 - QA 엔지니어 (`/qa`) — 테스트 전략 및 자동화
## Agent 호출 프롬프트 표준 첨부 (2026-04-23 BT4 신설)
서브에이전트(클라이언트팀장·서버팀장·게임플레이·UI/UX·테크아트·최적화·QA 등)를 `Task` 도구로 호출할 때, 본 윈도우 축소(6계층 교훈 환기 체계) 영향으로 서브에이전트가 SessionStart hook 주입을 받지 않는 구조적 한계를 보완하기 위해 **호출 프롬프트에 다음 3종 맥락을 필수 첨부**한다.
### 표준 첨부 3종
1. **작업 직전 2~3일 핵심 결정·기각안 요약** — 대화로그·PD 지시 로그에서 관련 영역 엔트리 요지 2~3줄 (BT.Framework·Unity MCP·인프라 commit 등 장기 맥락 의존 영역은 최대 7일까지 확장)
2. **관련 `project_context_*.md` 경로**`memory/org/project_context_조직운영.md` 또는 프로젝트별 SOT 경로 명시. 서브에이전트가 on-demand Read
3. **경로 규약 명시** (C34-11) — "상대 경로 사용" 또는 "`git rev-parse --show-toplevel` 기준"을 프롬프트에 명시. 절대 경로 하드코딩 금지
### 예외 영역 — 장기 맥락 의존도별 차등
- **백엔드·DB·DevOps**: 보통 1일 맥락이면 충분 (짧게 첨부)
- **클라이언트팀(게임플레이·테크아트·최적화)**: Unity 프로젝트 누적 결정 맥락 의존도 높음 (URP 설정·셰이더 선택·프로파일링 결과 등) → 작업 직전 3~7일 맥락 + `project_context_*.md` Read 요청 의무화
## 기획팀 연동 ## 기획팀 연동
기획팀(`${NERDNAVIS_ROOT}/기획팀/`)과 공유 채널(`${NERDNAVIS_ROOT}/공유/`)을 통해 협업합니다. 실값은 레포 루트 `paths.local.json` 참조 (PC별 상이). 기획팀(`${NERDNAVIS_ROOT}/기획팀/`)과 공유 채널(`${NERDNAVIS_ROOT}/공유/`)을 통해 협업합니다. 실값은 레포 루트 `paths.local.json` 참조 (PC별 상이).

View File

@ -23,6 +23,24 @@ skills:
- `balance-designer` — 수치, 경제, 확률, 성장 곡선, 밸런싱 - `balance-designer` — 수치, 경제, 확률, 성장 곡선, 밸런싱
- `ux-designer` — UI/UX 플로우, 정보 구조, 조작감 - `ux-designer` — UI/UX 플로우, 정보 구조, 조작감
## Agent 호출 프롬프트 표준 첨부 (2026-04-23 BT4 신설)
서브에이전트를 `Task` 도구로 호출할 때, 본 윈도우 축소(6계층 교훈 환기 체계) 영향으로 서브에이전트가 SessionStart hook 주입을 받지 않는 구조적 한계를 보완하기 위해 **호출 프롬프트에 다음 3종 맥락을 필수 첨부**한다.
### 표준 첨부 3종
1. **현 Phase·기각안 SOT 경로** — 프로젝트별 기각안 문서(예: `프로젝트/EerieVillage/기획/기각안_*.md`) 또는 관련 대화로그·PD 지시 로그 요지 2~3줄
2. **P30 재미 정의 요구** — 기획팀 특화. "본 작업이 어떤 재미를 강화하는가"를 서브에이전트가 먼저 정의하도록 요구 (P30-1 준수)
3. **대상 영역 직전 결정 1줄** — 밸런스·기각안 연속 축적이 필요한 경우 최근 3~7일 관련 결정 1줄 요약 첨부
### 영역별 차등
- **system/content/level-designer**: 보통 1~3일 맥락 첨부
- **narrative-designer (세계관·로어)**: 장기 누적 필수 → 세계관 SOT 경로 명시 + 관련 기각안 전건 경로
- **balance-designer (수치 연속 조정)**: 직전 수치 결정·기각 근거 첨부 필수 (C6-1 백업 경로 동반)
- **ux-designer**: 플랫폼·조작 스킴 제약 요약 첨부
### 경로 규약 (C34-11)
모든 호출에서 "상대 경로 사용" 또는 "`git rev-parse --show-toplevel` 기준"을 프롬프트에 명시. 절대 경로 하드코딩 금지 (Phase 2-B content-designer 경계 위반 사건 재발 방지).
## 새 프로젝트 온보딩 절차 ## 새 프로젝트 온보딩 절차
새 프로젝트 착수 시, 아래 체크리스트를 기반으로 필요한 정보를 수집한다. 새 프로젝트 착수 시, 아래 체크리스트를 기반으로 필요한 정보를 수집한다.
모든 항목을 반드시 묻는 것이 아니라, 결과물 도출에 필요한 정보가 부족한 영역만 골라 핵심 질문을 한다. 모든 항목을 반드시 묻는 것이 아니라, 결과물 도출에 필요한 정보가 부족한 영역만 골라 핵심 질문을 한다.

View File

@ -53,7 +53,7 @@ description: BurningTimes 조직의 헌법 제1원칙(5항 ①~⑤) + 헌법급
추후 프로젝트가 확장되면 점차 프로젝트 구성은 늘어날 수 있으며, 현재 BurningTimes 조직의 프로젝트는 **2종**으로 구성되어 있다: 추후 프로젝트가 확장되면 점차 프로젝트 구성은 늘어날 수 있으며, 현재 BurningTimes 조직의 프로젝트는 **2종**으로 구성되어 있다:
1. **코어 코드 프레임워크 개발** (`코어코드/BT.Framework/`) — 조직 자산 구축 프로젝트 (Tier 1 16/16 완결, Tier 2·3 확장 예정) 1. **코어 코드 프레임워크 개발** (`코어코드/BT.Framework/`) — 조직 자산 구축 프로젝트 (Tier 1 16/16 완결, Tier 2·3 확장 예정)
2. **기묘한 고을 : 조선퇴마뎐 (EerieVillage)** (`프로젝트/EerieVillage/`) — BurningTimes 조직의 첫 번째 게임 개발 프로젝트 (Unity 6000.3.13f1 LTS, 2D PlatformerMicrogame 템플릿 기반) 2. **기묘한 고을 : 조선퇴마뎐 / EerieVillage: Joseon Exorcist** (`프로젝트/EerieVillage/`) — BurningTimes 조직의 첫 번째 게임 개발 프로젝트 (Unity 6000.3.13f1 LTS, 2D PlatformerMicrogame 템플릿 기반). 한글명·영문명 병기는 2026-04-23 PD 직접 지시로 확정
### 조직 핵심 자산 — Live 더미 파일 프로세스 ### 조직 핵심 자산 — Live 더미 파일 프로세스
@ -1444,7 +1444,7 @@ BT.Framework는 **BurningTimes 조직의 자산**이므로, 계승 발전시킨
### P29-3. EerieVillage 활용 방침 (2026-04-21 PD님 직접 지시 B안 신설) ### P29-3. EerieVillage 활용 방침 (2026-04-21 PD님 직접 지시 B안 신설)
**EerieVillage (기묘한 고을: 조선퇴마뎐)는 BurningTimes 조직의 첫 번째 게임 개발 프로젝트**이며, BT.Framework 도입 여부는 **착수 단계에서 재검토**한다. **EerieVillage (한글명: 기묘한 고을 : 조선퇴마뎐 · 영문명: EerieVillage: Joseon Exorcist)는 BurningTimes 조직의 첫 번째 게임 개발 프로젝트**이며, BT.Framework 도입 여부는 **착수 단계에서 재검토**한다.
- **Unity 6000.3.13f1 LTS** + **2D PlatformerMicrogame 템플릿** 기반이라 Tier 1(범용 유틸·SafeArea·로깅·검증 등)은 즉시 활용 가능성이 높음 - **Unity 6000.3.13f1 LTS** + **2D PlatformerMicrogame 템플릿** 기반이라 Tier 1(범용 유틸·SafeArea·로깅·검증 등)은 즉시 활용 가능성이 높음
- **도입 범위 결정 시 고려 사항**: - **도입 범위 결정 시 고려 사항**:
@ -1486,7 +1486,7 @@ BurningTimes의 게임 개발 프로젝트에서 **기획팀은 모든 산출물
- P30과 C11이 충돌하면 **총괄PM·PD님 판단 하에 조율** (기존 C7-C11 조율 규정 계승) - P30과 C11이 충돌하면 **총괄PM·PD님 판단 하에 조율** (기존 C7-C11 조율 규정 계승)
### P30-3. 적용 프로젝트 ### P30-3. 적용 프로젝트
- **EerieVillage (기묘한 고을: 조선퇴마뎐)**: 기획팀이 재미 우선 원칙으로 밸런싱·컨텐츠 결정 (BurningTimes 첫 게임 개발 프로젝트) - **EerieVillage (기묘한 고을 : 조선퇴마뎐 / EerieVillage: Joseon Exorcist)**: 기획팀이 재미 우선 원칙으로 밸런싱·컨텐츠 결정 (BurningTimes 첫 게임 개발 프로젝트)
- **차기 신규 프로젝트**: 동일 원칙 계승 - **차기 신규 프로젝트**: 동일 원칙 계승
- **BT.Framework**: P29 계승·발전이 최우선 (재미는 상위 프로젝트 영역) - **BT.Framework**: P29 계승·발전이 최우선 (재미는 상위 프로젝트 영역)
@ -1589,7 +1589,7 @@ PD님으로부터 직접 지시를 받은 즉시:
- [ ] 의무 호출 대상임에도 생략 시 **C35-5 자진 보고 + 소급 호출** 의무 이행했는가? - [ ] 의무 호출 대상임에도 생략 시 **C35-5 자진 보고 + 소급 호출** 의무 이행했는가?
**G. 구체 맥락 feedback 본문 선행 Read (2026-04-19 신설)** **G. 구체 맥락 feedback 본문 선행 Read (2026-04-19 신설)**
- [ ] 본 작업이 **C35-1 의무 호출 대상**인 경우, SessionStart hook `recent_feedback_brief.sh`가 주입한 최근 7일 feedback 요지 중 **관련 메모리 본문을 선행 Read** 했는가? - [ ] 본 작업이 **C35-1 의무 호출 대상**인 경우, SessionStart hook `recent_feedback_brief.sh`가 주입한 **6계층 교훈 요지**(계층 0 헌법급 feedback 9종·활성 PD 지시·기각안·project_context_조직운영 + 계층 1~5 동적 윈도우) 중 **관련 메모리 본문을 선행 Read** 했는가? (2026-04-23 BT4 — 기존 "최근 7일" 단일 윈도우에서 6계층 구조로 확장, 감사관 윈도우는 E안 자동 — `audit_pattern_analyzer.sh auditor_window <name>`)
- [ ] PD님 직접 지시·지적을 수령한 경우, **지시·지적 키워드와 매칭되는 feedback 메모리 본문 검색·Read** 했는가? (예: "축소 보고" 키워드 → `feedback_issue_under_reporting.md` 본문 Read) - [ ] PD님 직접 지시·지적을 수령한 경우, **지시·지적 키워드와 매칭되는 feedback 메모리 본문 검색·Read** 했는가? (예: "축소 보고" 키워드 → `feedback_issue_under_reporting.md` 본문 Read)
- [ ] 본문 Read 없이 description·요지만으로 판단한 경우, **결정의 맥락 정확성**이 확보되었는가? 불확실하면 Read 후 재판단 - [ ] 본문 Read 없이 description·요지만으로 판단한 경우, **결정의 맥락 정확성**이 확보되었는가? 불확실하면 Read 후 재판단
@ -1871,7 +1871,7 @@ pm-auditor 자신의 호출 이력도 감사 대상. 특정 작업에서 **호
> **2026-04-20 #50 전면 개정**: 구 "차단 아닌 경고" 방식(30분 시간 윈도우)은 **proxy 개선**으로 기각 확정. PD님 직접 지시 "보고 체계가 갖춰지지 않고 무단 변경으로 생긴 이슈가 더 큰거 같아" 수용으로 **PreToolUse 차단 + 해제 워크플로우** 전환. feedback_pm_proxy_improvement_reflex.md 7·8회차 변종 구조 차단. 구 30분 윈도우·UNRESOLVED 로그·BYPASS 우회 방식 폐기. 방향 전환 경위: `공유/조직공지/방향전환_히스토리_아카이브.md`. > **2026-04-20 #50 전면 개정**: 구 "차단 아닌 경고" 방식(30분 시간 윈도우)은 **proxy 개선**으로 기각 확정. PD님 직접 지시 "보고 체계가 갖춰지지 않고 무단 변경으로 생긴 이슈가 더 큰거 같아" 수용으로 **PreToolUse 차단 + 해제 워크플로우** 전환. feedback_pm_proxy_improvement_reflex.md 7·8회차 변종 구조 차단. 구 30분 윈도우·UNRESOLVED 로그·BYPASS 우회 방식 폐기. 방향 전환 경위: `공유/조직공지/방향전환_히스토리_아카이브.md`.
#### Layer 1: 사전 환기 (UserPromptSubmit·SessionStart) #### Layer 1: 사전 환기 (UserPromptSubmit·SessionStart)
- `recent_feedback_brief.sh`최근 7일 feedback 요지 자동 주입 - `recent_feedback_brief.sh`**6계층 교훈 환기 체계** 자동 주입 (2026-04-23 BT4 확장): 계층 0 고정(헌법급 feedback `tier: constitutional` 자동 선별·활성 PD 지시·기각안·project_context)·계층 1~4 공백일수 기반 동적 윈도우·계층 5 내용축 트리거 max
- SessionStart hook 체인 — 세션 시작 시 C35 의무 호출 대상 환기 - SessionStart hook 체인 — 세션 시작 시 C35 의무 호출 대상 환기
#### Layer 2: 호출 기록 (PostToolUse, matcher: `Task`) #### Layer 2: 호출 기록 (PostToolUse, matcher: `Task`)