From cbc1b19e2589a7e17585bafd46e67b387808cd0e Mon Sep 17 00:00:00 2001 From: swrring Date: Thu, 23 Apr 2026 00:28:51 +0900 Subject: [PATCH] =?UTF-8?q?feat(BT4=C2=B7Phase3):=20SKILL.md=206=EA=B3=84?= =?UTF-8?q?=EC=B8=B5=20=EB=B0=98=EC=98=81=20+=20=EA=B2=8C=EC=9E=84?= =?UTF-8?q?=EB=AA=85=EC=B9=AD=20=EC=98=81=EB=AC=B8=20=EB=B3=91=EA=B8=B0=20?= =?UTF-8?q?+=20=EC=97=90=EC=9D=B4=EC=A0=84=ED=8A=B8=203=EC=A2=85=20?= =?UTF-8?q?=EA=B0=B1=EC=8B=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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) --- .claude/agents/pm-auditor.md | 18 ++++++++++++++++++ .claude/agents/개발팀장.md | 13 +++++++++++++ .claude/agents/기획팀장.md | 18 ++++++++++++++++++ .claude/skills/BurningTimes-코어룰/SKILL.md | 10 +++++----- 4 files changed, 54 insertions(+), 5 deletions(-) diff --git a/.claude/agents/pm-auditor.md b/.claude/agents/pm-auditor.md index 6dacf4d..3b9a886 100644 --- a/.claude/agents/pm-auditor.md +++ b/.claude/agents/pm-auditor.md @@ -147,6 +147,24 @@ Agent 호출 후 및 신규 설정·저장소 도입 시 다음 항목 점검: - **신규 설정 도입 시 5개 질문 체크리스트** (C34-15): PC 단위 vs worktree 단위 · 경계 안전성 · 중앙화 필요성 · 레포 루트 vs worktree 실행 차이 · Agent 경계 보호 5항목 통과 여부 - **경계 자산 정기 점검**: `.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님 직접 지시) 본 에이전트는 **조직 내 공유가 필요한 작업**에 PM이 **의무적으로 사전 호출**한다. 수동 호출 의존 구조의 감사 사각지대를 원천 제거하여 본 세션 PM 보고 품질 3연속 문제(이슈 축소·안건 중복·종결 언급) 같은 재발을 구조적으로 차단. diff --git a/.claude/agents/개발팀장.md b/.claude/agents/개발팀장.md index 0a36448..0a308e7 100644 --- a/.claude/agents/개발팀장.md +++ b/.claude/agents/개발팀장.md @@ -35,6 +35,19 @@ skills: ### 직속 - 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별 상이). diff --git a/.claude/agents/기획팀장.md b/.claude/agents/기획팀장.md index 7c0530c..d0d31e8 100644 --- a/.claude/agents/기획팀장.md +++ b/.claude/agents/기획팀장.md @@ -23,6 +23,24 @@ skills: - `balance-designer` — 수치, 경제, 확률, 성장 곡선, 밸런싱 - `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 경계 위반 사건 재발 방지). + ## 새 프로젝트 온보딩 절차 새 프로젝트 착수 시, 아래 체크리스트를 기반으로 필요한 정보를 수집한다. 모든 항목을 반드시 묻는 것이 아니라, 결과물 도출에 필요한 정보가 부족한 영역만 골라 핵심 질문을 한다. diff --git a/.claude/skills/BurningTimes-코어룰/SKILL.md b/.claude/skills/BurningTimes-코어룰/SKILL.md index ae017f3..bef49e1 100644 --- a/.claude/skills/BurningTimes-코어룰/SKILL.md +++ b/.claude/skills/BurningTimes-코어룰/SKILL.md @@ -53,7 +53,7 @@ description: BurningTimes 조직의 헌법 제1원칙(5항 ①~⑤) + 헌법급 추후 프로젝트가 확장되면 점차 프로젝트 구성은 늘어날 수 있으며, 현재 BurningTimes 조직의 프로젝트는 **2종**으로 구성되어 있다: 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 더미 파일 프로세스 @@ -1444,7 +1444,7 @@ BT.Framework는 **BurningTimes 조직의 자산**이므로, 계승 발전시킨 ### 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·로깅·검증 등)은 즉시 활용 가능성이 높음 - **도입 범위 결정 시 고려 사항**: @@ -1486,7 +1486,7 @@ BurningTimes의 게임 개발 프로젝트에서 **기획팀은 모든 산출물 - P30과 C11이 충돌하면 **총괄PM·PD님 판단 하에 조율** (기존 C7-C11 조율 규정 계승) ### P30-3. 적용 프로젝트 -- **EerieVillage (기묘한 고을: 조선퇴마뎐)**: 기획팀이 재미 우선 원칙으로 밸런싱·컨텐츠 결정 (BurningTimes 첫 게임 개발 프로젝트) +- **EerieVillage (기묘한 고을 : 조선퇴마뎐 / EerieVillage: Joseon Exorcist)**: 기획팀이 재미 우선 원칙으로 밸런싱·컨텐츠 결정 (BurningTimes 첫 게임 개발 프로젝트) - **차기 신규 프로젝트**: 동일 원칙 계승 - **BT.Framework**: P29 계승·발전이 최우선 (재미는 상위 프로젝트 영역) @@ -1589,7 +1589,7 @@ PD님으로부터 직접 지시를 받은 즉시: - [ ] 의무 호출 대상임에도 생략 시 **C35-5 자진 보고 + 소급 호출** 의무 이행했는가? **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 `) - [ ] PD님 직접 지시·지적을 수령한 경우, **지시·지적 키워드와 매칭되는 feedback 메모리 본문 검색·Read** 했는가? (예: "축소 보고" 키워드 → `feedback_issue_under_reporting.md` 본문 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`. #### 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 의무 호출 대상 환기 #### Layer 2: 호출 기록 (PostToolUse, matcher: `Task`)