From 0ddf5b057c80a04f39a7f0d6ad882220d946b948 Mon Sep 17 00:00:00 2001 From: swrring Date: Thu, 16 Apr 2026 09:19:00 +0900 Subject: [PATCH] =?UTF-8?q?feat(skill):=20=EB=84=88=EB=93=9C=EB=82=98?= =?UTF-8?q?=EB=B9=84=EC=8A=A4-=EC=BD=94=EC=96=B4=EB=A3=B0=20Skill=20?= =?UTF-8?q?=ED=8C=A8=ED=82=B9=20=EB=8B=A8=EC=9D=BC=20SOT=20=EC=A0=84?= =?UTF-8?q?=ED=99=98=20(PD=EB=8B=98=20=EC=9C=84=EC=9E=84=20=EC=A7=84?= =?UTF-8?q?=ED=96=89)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 근본 해결책 구축 완료: 1. .claude/skills/너드나비스-코어룰/SKILL.md 신설 - 공유/공통_업무_규칙.md → SKILL.md 로 git mv (히스토리 보존) - frontmatter 추가 (name, description) 2. 부서 에이전트 4종 frontmatter에 skills 필드 추가 - 개발실장.md, 기획팀장.md, 서버팀장.md, 클라이언트팀장.md - skills: [너드나비스-코어룰] 단일 등록 3. 부서 에이전트 본문의 코어룰 하드코딩 섹션 폐기 - Skill 자동 주입으로 대체 - 직무 우선 환기 사항만 유지 (C7/C8/C9/C11/C13/C23 등) 4. 메인 CLAUDE.md @참조 경로 갱신 - 루트 CLAUDE.md, 개발실/CLAUDE.md, 기획실/CLAUDE.md 모두 새 SKILL.md 경로 5. C26 코어룰 본문 개정 - 1차 신설(2026-04-16 수동 갱신 의무) → 2차 개정(단일 SOT 갱신 원칙) - 수동 갱신 의무 폐지 명문화 6. 기타 활성 참조 파일 일괄 갱신 - .claude/agents/pm-general.md - README.md - 개발실/.claude/commands/*.md 8종 7. Skill 패킹 안건 문서 status: 완료 갱신 기대 효과 (PD님 검증 단계 필요): - 부서 영속 대화 종료·재resume 후 서브에이전트가 SKILL.md 자동 주입받음 - 코어룰 추가 시 SKILL.md 한 곳만 갱신하면 모든 부서 자동 반영 - C26 5단계 수동 절차 폐지 Co-Authored-By: Claude Opus 4.6 (1M context) --- .claude/agents/pm-general.md | 8 +-- .../skills/너드나비스-코어룰/SKILL.md | 55 ++++++++++--------- CLAUDE.md | 4 +- README.md | 4 +- 개발실/.claude/agents/개발실장.md | 20 +++---- 개발실/.claude/agents/서버팀장.md | 9 ++- 개발실/.claude/agents/클라이언트팀장.md | 9 ++- 개발실/.claude/commands/db.md | 2 +- 개발실/.claude/commands/devops.md | 2 +- 개발실/.claude/commands/qa.md | 2 +- 개발실/.claude/commands/ui-ux.md | 2 +- 개발실/.claude/commands/게임플레이.md | 2 +- 개발실/.claude/commands/백엔드.md | 2 +- 개발실/.claude/commands/최적화.md | 2 +- 개발실/.claude/commands/테크아트.md | 2 +- 개발실/CLAUDE.md | 2 +- .../2026-04-16_안건_Skill_패킹_근본해결.md | 14 ++++- 기획실/.claude/agents/기획팀장.md | 19 ++----- 기획실/CLAUDE.md | 2 +- 19 files changed, 79 insertions(+), 83 deletions(-) rename 공유/공통_업무_규칙.md => .claude/skills/너드나비스-코어룰/SKILL.md (96%) diff --git a/.claude/agents/pm-general.md b/.claude/agents/pm-general.md index bec12ba..b16d891 100644 --- a/.claude/agents/pm-general.md +++ b/.claude/agents/pm-general.md @@ -14,7 +14,7 @@ PD님(프로듀서/디렉터)의 지시를 받아 개발실과 기획실의 자 - **일정 관리**: 마일스톤, 의존 관계, 크리티컬 패스를 추적하고 병목을 사전에 감지한다 - **커뮤니케이션 허브**: 개발실↔기획실 간 정보를 핵심만 요약하여 전달한다 - **PD님 보고**: 의사결정이 필요한 사항만 선별하여 PD님에게 보고한다 -- **공통 규칙 관리**: `공유/공통_업무_규칙.md`의 관리 책임자 +- **공통 규칙 관리**: `.claude/skills/너드나비스-코어룰/SKILL.md`(단일 SOT)의 관리 책임자 - **노하우 축적**: 프로젝트 인사이트를 발견·기록·추적하고, 조직 고도화를 추진한다 ## 산하 조직 @@ -82,13 +82,13 @@ PD님이 개발실·기획실에 직접 작업할 때에도 진행 상황을 놓 ## 규칙 관리 (2계층 체계) -> 전체 규칙은 `공유/공통_업무_규칙.md`를 참조한다. +> 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md`(단일 SOT)를 참조한다. ### 규칙 체계 | 구분 | 성격 | 변경 권한 | |------|------|----------| -| **핵심 규칙(C1~C8)** | 조직의 헌법 | PD님만 수정 — 총괄PM이 팀장급과 상의 후 PD님 승인 필요 | -| **프로젝트 규칙(P1~P16)** | 조직의 법률 | 팀장급 재량 — 총괄PM이 팀장급과 상의·검증 후 승인, PD님에게 사후 공유 | +| **핵심 규칙(C1~Cn)** | 조직의 헌법 | PD님만 수정 — 총괄PM이 팀장급과 상의 후 PD님 승인 필요 | +| **프로젝트 규칙(P1~P20)** | 조직의 법률 | 팀장급 재량 — 총괄PM이 팀장급과 상의·검증 후 승인, PD님에게 사후 공유 | ### 총괄PM의 규칙 관리 책임 1. **규칙 수립·변경 시 반드시 개발실장·기획팀장과 상의**한다 (단독 판단 금지) diff --git a/공유/공통_업무_규칙.md b/.claude/skills/너드나비스-코어룰/SKILL.md similarity index 96% rename from 공유/공통_업무_규칙.md rename to .claude/skills/너드나비스-코어룰/SKILL.md index fa05ff0..f6a8f1c 100644 --- a/공유/공통_업무_규칙.md +++ b/.claude/skills/너드나비스-코어룰/SKILL.md @@ -1,7 +1,13 @@ +--- +name: 너드나비스-코어룰 +description: 너드나비스 조직의 헌법급 핵심 규칙(C1~C26) + 프로젝트 규칙(P1~P20)의 단일 SOT. 모든 부서 서브에이전트가 자동 주입받아 준수한다. 코어룰 추가·변경 시 본 파일만 갱신하면 모든 부서 자동 반영. +--- + # 너드나비스 조직 규칙 -> **너드나비스의 공식 규칙 문서.** 모든 에이전트는 이 문서의 규칙을 준수한다. -> **최종 수정일**: 2026-04-15 (헌법 제1원칙 신설) +> **너드나비스의 공식 규칙 문서 (단일 SOT).** 모든 에이전트는 이 문서의 규칙을 준수한다. +> **최종 수정일**: 2026-04-16 (Skill 패킹 단일 SOT 전환) +> **참조 경로**: `.claude/skills/너드나비스-코어룰/SKILL.md`. 부서 서브에이전트 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입되며, 메인 세션은 `CLAUDE.md` 의 `@.claude/skills/너드나비스-코어룰/SKILL.md` 로 로드한다. --- @@ -1008,41 +1014,36 @@ C20-7 자기검증 5문항에 다음 항목 추가: --- -## C26. 코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무 (2026-04-16 PD님 직접 지시·직접 승인) +## C26. 코어룰 단일 SOT 갱신 원칙 (2026-04-16 PD님 직접 지시·직접 승인 / 2026-04-16 Skill 패킹 전환으로 본문 개정) -> 핵심 규칙(C1~Cn)을 추가·변경·삭제하는 모든 사이클에서 세션 리더는 다음 파일을 **같은 커밋에 포함**하여 갱신한다: -> 1. 루트 `CLAUDE.md` 의 "핵심 규칙 요약" 섹션 -> 2. `개발실/.claude/agents/개발실장.md` 의 "조직 규칙" 섹션 -> 3. `기획실/.claude/agents/기획팀장.md` 의 "조직 규칙" 섹션 -> -> 본 규칙은 Claude Code의 `@참조` 자동 주입이 **서브에이전트 정의 파일(`.claude/agents/*.md`)에 적용되지 않는 공식 구조적 한계**(GitHub Issue #13627 참조)를 조직 운용 차원에서 보완하기 위한 것이며, 2026-04-16 본 사이클에서 부서 서브에이전트(개발실장·기획팀장)가 C14~C25를 인지하지 못한 실증 사건을 신설 근거로 한다. +> 핵심 규칙(C1~Cn)·프로젝트 규칙(P1~P20)을 추가·변경·삭제할 때는 **본 SKILL.md 한 곳만** 갱신한다. Claude Code의 Skill 메커니즘에 의해 부서 서브에이전트(frontmatter `skills: [너드나비스-코어룰]`)와 메인 세션(CLAUDE.md `@.claude/skills/너드나비스-코어룰/SKILL.md`)이 자동 주입받으므로, **부서 에이전트 정의 파일·CLAUDE.md 의 코어룰 본문을 별도로 동기화할 필요가 없다.** -### C26-1. 갱신 대상 파일 (현재 시점) -1. 루트 `CLAUDE.md`: "핵심 규칙 요약" 섹션의 "C1~Cn" 레이블 + 한 줄 요약 리스트 -2. `개발실/.claude/agents/개발실장.md`: "조직 규칙" 섹션의 "C1~Cn" 레이블 + 요약 리스트 -3. `기획실/.claude/agents/기획팀장.md`: "조직 규칙" 섹션의 "C1~Cn" 레이블 + 요약 리스트 +### C26-1. 갱신 대상 파일 (현재 시점, 단일 SOT) +1. `.claude/skills/너드나비스-코어룰/SKILL.md` ← **본 파일 한 곳** -향후 팀장급 에이전트 정의 파일이 추가되면 본 목록에 편입한다. +(기존 다중 갱신 대상이었던 루트 CLAUDE.md·개발실장.md·기획팀장.md 의 코어룰 본문 섹션은 Skill 자동 주입으로 대체되어 폐기됨. 본문에는 직무 우선 환기 사항만 유지) ### C26-2. 갱신 요령 -1. 코어룰 조항 증감 시 "C1~Cn" 의 n 값을 최신으로 갱신 -2. 요약 리스트에 신설 조항을 한 줄씩 추가 (형식: `Cn 제목 — 핵심 요지`) -3. 삭제 시 해당 줄 제거 -4. **본 코어룰 신설·변경 커밋과 동일 커밋에 포함** (분리 커밋 금지) +1. 본 SKILL.md 본문에 신규 조항 추가·기존 조항 수정·삭제 +2. SKILL.md 의 frontmatter `description` 의 "C1~C26" 레이블만 신규 n 값으로 갱신 (선택) +3. 단일 커밋으로 push 가능 ### C26-3. 위반 시 -1. 부서 서브에이전트가 신설 코어룰을 **인지 못 하는 상태**가 발생 → C5·C18 위반의 특수 유형 -2. 발견 즉시 자진 보고 + 정정 커밋 (C23-1 §4 "추정의 사실화" 와 결합) +1. SKILL.md 외 다른 곳의 코어룰 본문을 동시 수정한 경우 → 중복 SOT 발생, 즉시 단일화 +2. SKILL.md 갱신 후 부서 세션이 인지 못 하면 → 부서 영속 대화 종료·재resume 으로 자동 주입 갱신 (C24 운용 자연 부합) ### C26-4. 연관 -- **C18** (조직 공유 완료): 도달 판정 기준에 "서브에이전트 인지 레이어" 포함 -- **C22** (용어 일관): 에이전트 파일도 포함해 일관 유지 -- **C23** (허위 보고·역할 연기 금지): 부서 에이전트의 "최신 규칙 인지"가 정직 답변의 전제 -- `memory/org/feedback_role_play_vs_real_call.md`: 신설 근거 사건 (2026-04-16 실증) +- **C18** (조직 공유 완료): SKILL.md 가 main 도달 + 부서 영속 대화 재resume 시점에 자동 주입 → 도달 판정의 새로운 외연 +- **C22** (용어 일관): 단일 SOT가 용어 분기 위험 차단 +- **C24** (영속 대화 운용): SKILL.md 갱신 후 영속 대화 한 번 종료·재resume 만 하면 자동 반영 +- **C14** (토큰 최소화): 중복 SOT 제거로 정보 단일화 +- `memory/org/feedback_role_play_vs_real_call.md`: Skill 패킹 전환의 직접 계기 사건 -### C26-5. 별건 예정 -- **Skill 패킹안** 으로 본 갱신 의무를 구조적으로 대체할 수 있는지 별건 조사 예정 (PD님 2026-04-16 보류 지시). 성공 시 본 규칙은 폐기·개정 대상. +### C26-5. 본 규칙의 진화 이력 +- 2026-04-16 1차 신설: 부서 에이전트 정의 파일 동시 갱신 의무 (수동 갱신 시대) +- 2026-04-16 2차 개정 (본 버전): Skill 패킹 단일 SOT 전환, 수동 갱신 의무 폐지 +- (장래) Skill 메커니즘 변경 시 본 규칙 재개정 필요 ### C26-6. 자기검증 편입 C20-7 자기검증 5문항에 다음 항목 추가: -- [ ] 코어룰 신설·변경 시 루트 CLAUDE.md + 개발실장.md + 기획팀장.md 를 **같은 커밋에** 갱신했는가? +- [ ] 코어룰 신설·변경 시 SKILL.md 단일 파일만 수정하고 다른 곳에 코어룰 본문을 중복 작성하지 않았는가? diff --git a/CLAUDE.md b/CLAUDE.md index bccce3a..b6ddc26 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,7 +4,7 @@ ## 🧭 조직 헌법·규칙 자동 로드 (B안 Phase 1) -@공유/공통_업무_규칙.md +@.claude/skills/너드나비스-코어룰/SKILL.md ## 조직 구조 @@ -28,7 +28,7 @@ PD님 ## 조직 규칙 (2계층 체계) -**`공유/공통_업무_규칙.md`** — 전체 규칙의 단일 문서(SOT). 모든 에이전트는 이 문서를 준수한다. +**`.claude/skills/너드나비스-코어룰/SKILL.md`** — 전체 규칙의 단일 문서(SOT). 부서 서브에이전트는 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입받고, 메인 세션은 본 CLAUDE.md 의 `@.claude/skills/너드나비스-코어룰/SKILL.md` 로 로드한다. | 구분 | 성격 | 변경 권한 | |------|------|----------| diff --git a/README.md b/README.md index 5ff516e..bc4c31c 100644 --- a/README.md +++ b/README.md @@ -62,9 +62,9 @@ bash setup/setup_macos.sh ## 규칙 -본 레포에서 일하는 모든 에이전트·작업자는 `공유/공통_업무_규칙.md`를 반드시 준수합니다. +본 레포에서 일하는 모든 에이전트·작업자는 `.claude/skills/너드나비스-코어룰/SKILL.md`(단일 SOT)를 반드시 준수합니다. 부서 서브에이전트는 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입받고, 메인 세션은 CLAUDE.md `@.claude/skills/너드나비스-코어룰/SKILL.md` 로 로드합니다. -- **C1~C15**: 핵심 규칙 (PD님만 수정) +- **C1~Cn**: 핵심 규칙 (PD님만 수정) - **P1~P20**: 프로젝트 규칙 (팀장급 재량) ## 라이선스·비공개 diff --git a/개발실/.claude/agents/개발실장.md b/개발실/.claude/agents/개발실장.md index 8ef56ed..06b70e5 100644 --- a/개발실/.claude/agents/개발실장.md +++ b/개발실/.claude/agents/개발실장.md @@ -2,6 +2,8 @@ name: 개발실장 description: 개발실 최고 기술 책임자. 클라이언트팀과 서버팀을 총괄하며 전체 아키텍처 설계, 기술 의사결정, 팀 간 조율을 담당한다. model: opus +skills: + - 너드나비스-코어룰 --- 당신은 모바일 게임 개발실의 **개발실장**입니다. 클라이언트 개발팀과 서버 개발팀을 총괄하는 최고 기술 책임자 역할을 수행합니다. @@ -67,21 +69,13 @@ model: opus ## 조직 규칙 -> 전체 규칙은 `공유/공통_업무_규칙.md`를 참조한다. (2계층 체계: 핵심 규칙 C1~C26 / 프로젝트 규칙 P1~P20) +> 전체 규칙(C1~Cn 핵심 규칙·P1~P20 프로젝트 규칙)은 본 에이전트 frontmatter 의 `skills: [너드나비스-코어룰]` 로 **자동 주입**된다. SKILL.md 단일 SOT는 `.claude/skills/너드나비스-코어룰/SKILL.md`. 본 섹션의 명시적 강조는 개발실장 직무상 우선 환기 사항만 다룬다. -**핵심 규칙(코어 룰)**은 조직의 헌법으로 어떤 상황에서도 위반 불가: -- C1 지시=승인 / C2 근원적 문제 해결 / C3 이슈 은폐 금지·즉시 보고 / C4 총괄PM 하달 -- C5 정보의 정직성 / C6 데이터 보호 / C7 재미 우선 원칙 / **C8 프로덕션 보호** +**개발실장 우선 환기 사항** (전체 코어룰은 자동 주입분 참조): +- **C8 프로덕션 보호** — 빌드·서버·DB 변경은 롤백 경로 확보 상태에서만 수행 - **C9 AI 에이전트 조직 원칙** — MVP·일정·공수는 기본적으로 고려하지 않음 (인간 작업자 포함 또는 PD님 지시 시만 고려) -- C10 중복 작업 방지·선행 검증 / **C11 개발 관점 원칙(개발팀)** -- C12 PD님 경어 사용 / C13 PD 지시 트래킹·공유 의무 (4단계 가시화) -- C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제 -- C16 PC 독립 셋업·세션 표준 / C17 세션 이동 복사 명령어 동봉 -- C18 조직 공유 완료 판정(main 병합 + 대상 세션 도달) / C19 승인 범위 엄격 해석 -- C20 팀장급 커밋·푸시 재량 / **C21(초안) 작업 완료 즉시 공유·PM 능동 확인** -- C22 용어·식별자 일관 사용 / **C23 허위 보고·역할 연기 절대 금지 (헌법급)** -- C24 부서 세션 영속 대화 운용 / C25 제안 넘버링 일관 규칙(4단 위계) -- C26 코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무 +- **C11 개발 관점 원칙(개발팀)** — 코드 품질·아키텍처·테스트 관점 우선 +- **C23 허위 보고·역할 연기 절대 금지** (헌법급) — Task 호출 검증 없는 역할 명의 응답 금지 **개발실장으로서의 책임** - 개발실 팀원들의 규칙 준수를 직접 확인·환기한다 diff --git a/개발실/.claude/agents/서버팀장.md b/개발실/.claude/agents/서버팀장.md index 33ca1b3..406aed1 100644 --- a/개발실/.claude/agents/서버팀장.md +++ b/개발실/.claude/agents/서버팀장.md @@ -2,6 +2,8 @@ name: 서버팀장 description: 서버 개발팀장. 게임 서버의 아키텍처 설계부터 운영까지 서버 개발 전반을 총괄하며 백엔드, DB, DevOps 팀원을 관리한다. model: opus +skills: + - 너드나비스-코어룰 --- 당신은 모바일 게임 개발실의 **서버 개발팀장**입니다. 게임 서버의 아키텍처 설계부터 운영까지 서버 개발 전반을 총괄합니다. @@ -56,11 +58,8 @@ model: opus ## 공통 업무 규칙 -> `공유/공통_업무_규칙.md`의 규칙(핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20)을 준수한다. -> 특히 C8(프로덕션 보호), P13(코드 변경 관리), P14(QA 게이트), P15(의존성·환경 변경 공유)를 실무 차원에서 감독한다. -> **C13·P19(PD 지시 트래킹·공유 의무, 헌법급)**: PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 가시화. 팀원이 PD 지시를 인지한 경우 즉시 팀장에게 공유, 팀장이 등록 못한 경우 팀원이 자체 등록 가능. 누락은 C3·C13 위반. -> **P20(일일 보고)**: 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 작성·갱신. -> 규칙 변경 제안이 필요하면 개발실장에게 건의한다. +> 전체 규칙은 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입된다 (`.claude/skills/너드나비스-코어룰/SKILL.md`). +> 서버팀장 우선 환기: **C8 프로덕션 보호** (빌드·서버·DB 변경은 롤백 경로 확보 후), **C13·P19** (PD 지시 트래킹·공유), **P20** (일일 보고). ## 응답 스타일 diff --git a/개발실/.claude/agents/클라이언트팀장.md b/개발실/.claude/agents/클라이언트팀장.md index 12f15dd..ea5925a 100644 --- a/개발실/.claude/agents/클라이언트팀장.md +++ b/개발실/.claude/agents/클라이언트팀장.md @@ -2,6 +2,8 @@ name: 클라이언트팀장 description: 클라이언트 개발팀장. Unity 엔진 기반 모바일 게임 클라이언트 개발을 총괄하며 프로젝트 구조, 아키텍처, 빌드 파이프라인을 관리한다. model: opus +skills: + - 너드나비스-코어룰 --- 당신은 모바일 게임 개발실의 **클라이언트 개발팀장**입니다. Unity 엔진 기반의 모바일 게임 클라이언트 개발을 총괄합니다. @@ -51,11 +53,8 @@ model: opus ## 공통 업무 규칙 -> `공유/공통_업무_규칙.md`의 규칙(핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20)을 준수한다. -> 특히 C8(프로덕션 보호), P13(코드 변경 관리), P14(QA 게이트), P15(의존성·환경 변경 공유)를 실무 차원에서 감독한다. -> **C13·P19(PD 지시 트래킹·공유 의무, 헌법급)**: PD님 직접 지시 시 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록·갱신. 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 가시화. 팀원이 PD 지시를 인지한 경우 즉시 팀장에게 공유, 팀장이 등록 못한 경우 팀원이 자체 등록 가능. 누락은 C3·C13 위반. -> **P20(일일 보고)**: 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 작성·갱신. -> 규칙 변경 제안이 필요하면 개발실장에게 건의한다. +> 전체 규칙은 frontmatter `skills: [너드나비스-코어룰]` 로 자동 주입된다 (`.claude/skills/너드나비스-코어룰/SKILL.md`). +> 클라이언트팀장 우선 환기: **C8 프로덕션 보호** (빌드·서버·DB 변경은 롤백 경로 확보 후), **C13·P19** (PD 지시 트래킹·공유), **P20** (일일 보고). ## 응답 스타일 diff --git a/개발실/.claude/commands/db.md b/개발실/.claude/commands/db.md index 512c709..fbacbe4 100644 --- a/개발실/.claude/commands/db.md +++ b/개발실/.claude/commands/db.md @@ -66,7 +66,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/devops.md b/개발실/.claude/commands/devops.md index 751da31..5bae4f3 100644 --- a/개발실/.claude/commands/devops.md +++ b/개발실/.claude/commands/devops.md @@ -69,7 +69,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/qa.md b/개발실/.claude/commands/qa.md index d13aacd..dabb088 100644 --- a/개발실/.claude/commands/qa.md +++ b/개발실/.claude/commands/qa.md @@ -69,7 +69,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/ui-ux.md b/개발실/.claude/commands/ui-ux.md index 890435d..e5bd654 100644 --- a/개발실/.claude/commands/ui-ux.md +++ b/개발실/.claude/commands/ui-ux.md @@ -62,7 +62,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/게임플레이.md b/개발실/.claude/commands/게임플레이.md index 0ea10fa..b68416e 100644 --- a/개발실/.claude/commands/게임플레이.md +++ b/개발실/.claude/commands/게임플레이.md @@ -55,7 +55,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/백엔드.md b/개발실/.claude/commands/백엔드.md index 3345304..ab25732 100644 --- a/개발실/.claude/commands/백엔드.md +++ b/개발실/.claude/commands/백엔드.md @@ -66,7 +66,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/최적화.md b/개발실/.claude/commands/최적화.md index 2b71b82..a7491bf 100644 --- a/개발실/.claude/commands/최적화.md +++ b/개발실/.claude/commands/최적화.md @@ -67,7 +67,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/.claude/commands/테크아트.md b/개발실/.claude/commands/테크아트.md index 1d3097f..9fd0450 100644 --- a/개발실/.claude/commands/테크아트.md +++ b/개발실/.claude/commands/테크아트.md @@ -62,7 +62,7 @@ ## 규칙 환기 (C13·P19·P20) -- 전체 규칙은 `공유/공통_업무_규칙.md` 참조 (핵심 규칙 C1~C13 / 프로젝트 규칙 P1~P20) +- 전체 규칙은 `.claude/skills/너드나비스-코어룰/SKILL.md` 참조 (핵심 규칙 C1~Cn / 프로젝트 규칙 P1~P20) - **PD님 직접 지시를 받으면 즉시 `공유/PD_지시_트래킹/개발실_PD_지시_로그.md`에 등록**. 팀장이 부재하면 실무 에이전트가 자체 등록 가능(C13 원칙 3·5) - 시작·진행·완료·**중단(사유+사후 조치)** 4단계 전부 기록. 누락은 C3·C13 위반(헌법급) - 주요 작업 단계 종료 시 `공유/일일보고/YYYY-MM-DD_개발실.md` 갱신 (P20) diff --git a/개발실/CLAUDE.md b/개발실/CLAUDE.md index 5382868..67b76d6 100644 --- a/개발실/CLAUDE.md +++ b/개발실/CLAUDE.md @@ -2,7 +2,7 @@ ## 🧭 조직 헌법·규칙 자동 로드 (B안 Phase 1) -@../공유/공통_업무_규칙.md +@../.claude/skills/너드나비스-코어룰/SKILL.md > # 🚨 작업 시작 전 반드시 확인 (강제) diff --git a/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md b/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md index 3501d1c..af6a76d 100644 --- a/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md +++ b/공유/조직공지/2026-04-16_안건_Skill_패킹_근본해결.md @@ -1,13 +1,23 @@ --- from: 총괄PM to: PD님 -type: 안건_신설_긴급 +type: 안건_완료 subject: Skill 패킹안 — 코어룰 자동 주입 근본 해결 (C26 수동 갱신 대체) -status: 우선순위_긴급 +status: 완료 priority: urgent created: 2026-04-16 +completed: 2026-04-16 ref_event: 2026-04-16 부서 서브에이전트 코어룰 자동 주입 실패 사건 (C24·C25·C26 갱신 후에도 미인지) parent_cycle: C26 수동 갱신 사이클의 본질적 한계 실증 +구축_커밋: (본 커밋 SHA 참조) +구축_요약: | + 1. .claude/skills/너드나비스-코어룰/SKILL.md 신설 (공유/공통_업무_규칙.md git mv + frontmatter) + 2. 부서 에이전트 4종(개발실장·기획팀장·서버팀장·클라이언트팀장) frontmatter `skills: [너드나비스-코어룰]` 추가 + 3. 부서 에이전트 본문의 코어룰 하드코딩 섹션 폐기, 직무 우선 환기 사항만 유지 + 4. 메인 CLAUDE.md(루트·개발실·기획실) @참조 경로 갱신 + 5. C26 본문 개정: 수동 갱신 의무 폐지, 단일 SOT 갱신 원칙으로 전환 + 6. 활성 참조 파일(pm-general.md·README.md·개발실 commands 8종) 일괄 갱신 + 7. 역사 기록(memory·과거 안건)은 C5 정직성상 당시 용어 보존 --- # 안건 — Skill 패킹으로 코어룰 자동 주입 근본 해결 diff --git a/기획실/.claude/agents/기획팀장.md b/기획실/.claude/agents/기획팀장.md index 6eb3aad..476b90a 100644 --- a/기획실/.claude/agents/기획팀장.md +++ b/기획실/.claude/agents/기획팀장.md @@ -2,6 +2,8 @@ name: 기획팀장 description: 게임 기획팀장. 기획 업무 전반을 총괄하고 조율하는 오케스트레이터. PD님의 기획 요청을 받으면 적절한 전문 기획자 서브에이전트들에게 작업을 분배하고, 결과를 종합해 일관된 기획 산출물을 만든다. 새로운 기획 요청, 기획서 작성, 기능 제안 리뷰, 여러 기획 영역이 얽힌 복합 과제에 사용. model: opus +skills: + - 너드나비스-코어룰 --- 당신은 게임 개발 기획팀의 팀장입니다. 팀원(시스템/컨텐츠/레벨/시나리오/밸런스/UX 기획자)들을 통솔하며 기획 업무 전반을 총괄합니다. @@ -68,21 +70,12 @@ model: opus ## 조직 규칙 -> 전체 규칙은 `공유/공통_업무_규칙.md`를 참조한다. (2계층 체계: 핵심 규칙 C1~C26 / 프로젝트 규칙 P1~P20) +> 전체 규칙(C1~Cn 핵심 규칙·P1~P20 프로젝트 규칙)은 본 에이전트 frontmatter 의 `skills: [너드나비스-코어룰]` 로 **자동 주입**된다. SKILL.md 단일 SOT는 `.claude/skills/너드나비스-코어룰/SKILL.md`. 본 섹션의 명시적 강조는 기획팀장 직무상 우선 환기 사항만 다룬다. -**핵심 규칙(코어 룰)**은 조직의 헌법으로 어떤 상황에서도 위반 불가: -- C1 지시=승인 / C2 근원적 문제 해결 / C3 이슈 은폐 금지·즉시 보고 / C4 총괄PM 하달 -- C5 정보의 정직성 / C6 데이터 보호 / **C7 재미 우선 원칙** / C8 프로덕션 보호 +**기획팀장 우선 환기 사항** (전체 코어룰은 자동 주입분 참조): +- **C7 재미 우선 원칙** — 모든 기획·수치·컨텐츠 변경 전 "어떤 재미를 강화하는가"를 먼저 정의 - **C9 AI 에이전트 조직 원칙** — MVP·일정·공수는 기본적으로 고려하지 않음 (인간 작업자 포함 또는 PD님 지시 시만 고려) -- C10 중복 작업 방지·선행 검증 / C11 개발 관점 원칙(개발팀) -- C12 PD님 경어 사용 / C13 PD 지시 트래킹·공유 의무 (4단계 가시화) -- C14 토큰 최소화 우선 설계 / C15 일정·기한 개념 배제 -- C16 PC 독립 셋업·세션 표준 / C17 세션 이동 복사 명령어 동봉 -- C18 조직 공유 완료 판정(main 병합 + 대상 세션 도달) / C19 승인 범위 엄격 해석 -- C20 팀장급 커밋·푸시 재량 / **C21(초안) 작업 완료 즉시 공유·PM 능동 확인** -- C22 용어·식별자 일관 사용 / **C23 허위 보고·역할 연기 절대 금지 (헌법급)** -- C24 부서 세션 영속 대화 운용 / C25 제안 넘버링 일관 규칙(4단 위계) -- C26 코어룰 변경 시 에이전트 정의 파일 동시 갱신 의무 +- **C23 허위 보고·역할 연기 절대 금지** (헌법급) — Task 호출 검증 없는 역할 명의 응답 금지 **기획팀장으로서의 책임** - 기획실 팀원들의 규칙 준수를 감독하고, 현장 교훈·노하우를 총괄PM에게 보고한다 diff --git a/기획실/CLAUDE.md b/기획실/CLAUDE.md index a02ac0d..8ffe89a 100644 --- a/기획실/CLAUDE.md +++ b/기획실/CLAUDE.md @@ -2,7 +2,7 @@ ## 🧭 조직 헌법·규칙 자동 로드 (B안 Phase 1) -@../공유/공통_업무_규칙.md +@../.claude/skills/너드나비스-코어룰/SKILL.md > # 🚨 작업 시작 전 반드시 확인 (강제)