From a556d6a01f4e471fa8d3243ae5f7f1801d435d1e Mon Sep 17 00:00:00 2001 From: swrring Date: Wed, 15 Apr 2026 21:18:30 +0900 Subject: [PATCH] =?UTF-8?q?feat(comm):=20Phase=201=20=ED=86=B5=EC=8B=A0=20?= =?UTF-8?q?=ED=97=88=EB=B8=8C=20=EA=B3=B5=EC=9C=A0/=EC=86=8C=ED=86=B5/=20?= =?UTF-8?q?=EC=8B=A0=EC=84=A4=20+=206=EC=B6=95=20=EC=B1=84=EB=84=90=20+=20?= =?UTF-8?q?=EA=B8=B0=EC=A1=B4=20=EC=B1=84=EB=84=90=20=EC=9D=B4=EA=B4=80=20?= =?UTF-8?q?(PD=EB=8B=98=20=EC=A7=81=EC=A0=91=20=EC=A7=80=EC=8B=9C)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 공유/소통/ 허브 디렉토리 신설 - 6축 채널: PM↔개발실, PM↔기획실, 개발실↔기획실 - 기존 공유/기획실→개발실/ (REQ001~003 포함), 공유/개발실→기획실/, 공유/완료/ 를 공유/소통/ 하위로 통합 이관 - 공유/소통/README.md — 파일명·YAML 표준·응답 절차·커밋 prefix 규약 - 개발실 CLAUDE.md, pm-general.md, 개발실장.md 경로 참조 신 허브로 갱신 - Phase 1+2+3 계획의 1단계 (PD님 승인) Co-Authored-By: Claude Opus 4.6 (1M context) --- .claude/agents/pm-general.md | 2 +- 개발실/.claude/agents/개발실장.md | 6 +- 개발실/CLAUDE.md | 8 +- 공유/공통_업무_규칙.md | 2 +- .../{개발실→기획실 => 소통/PM→개발실}/.gitkeep | 0 공유/{완료 => 소통/PM→기획실}/.gitkeep | 0 공유/소통/README.md | 104 ++++++++++++++++++ 공유/소통/개발실→PM/.gitkeep | 0 공유/소통/개발실→기획실/.gitkeep | 0 공유/소통/기획실→PM/.gitkeep | 0 .../2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md | 0 .../2026-04-14_REQ002_장비옵션_음수값_의미확인.md | 0 .../2026-04-14_REQ003_인장_장착수제한_확인.md | 0 공유/소통/완료/.gitkeep | 0 14 files changed, 113 insertions(+), 9 deletions(-) rename 공유/{개발실→기획실 => 소통/PM→개발실}/.gitkeep (100%) rename 공유/{완료 => 소통/PM→기획실}/.gitkeep (100%) create mode 100644 공유/소통/README.md create mode 100644 공유/소통/개발실→PM/.gitkeep create mode 100644 공유/소통/개발실→기획실/.gitkeep create mode 100644 공유/소통/기획실→PM/.gitkeep rename 공유/{ => 소통}/기획실→개발실/2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md (100%) rename 공유/{ => 소통}/기획실→개발실/2026-04-14_REQ002_장비옵션_음수값_의미확인.md (100%) rename 공유/{ => 소통}/기획실→개발실/2026-04-14_REQ003_인장_장착수제한_확인.md (100%) create mode 100644 공유/소통/완료/.gitkeep diff --git a/.claude/agents/pm-general.md b/.claude/agents/pm-general.md index c7e0bf3..bec12ba 100644 --- a/.claude/agents/pm-general.md +++ b/.claude/agents/pm-general.md @@ -56,7 +56,7 @@ PD님이 개발실·기획실에 직접 작업할 때에도 진행 상황을 놓 ### 트래킹 4단계 표준 절차 (정기 또는 모니터링 지시 시) 1. **PD 지시 로그 확인** — `공유/PD_지시_트래킹/{기획실|개발실}_PD_지시_로그.md` 신규·미처리 항목 식별 2. **일일 보고 확인** — `공유/일일보고/` 최신 보고서 검토 -3. **공유 채널 확인** — `공유/기획실→개발실/`, `공유/개발실→기획실/`, `공유/조직공지/` +3. **공유 채널 확인** — `공유/소통/` 허브 6축 (PM↔개발실·PM↔기획실·개발실↔기획실), `공유/조직공지/` (Phase 1, 2026-04-15~) 4. **파일 변경 추적** — `find`/`ls -lt` 등으로 최근 산출물 식별 ### 책임 diff --git a/개발실/.claude/agents/개발실장.md b/개발실/.claude/agents/개발실장.md index 63adf49..e6bea34 100644 --- a/개발실/.claude/agents/개발실장.md +++ b/개발실/.claude/agents/개발실장.md @@ -38,10 +38,10 @@ model: opus 기획실(`${NERDNAVIS_ROOT}/기획실/`)과 공유 채널(`${NERDNAVIS_ROOT}/공유/`)을 통해 협업합니다. 실값은 레포 루트 `paths.local.json` 참조 (PC별 상이). ### 요청 처리 흐름 -1. `공유/기획실→개발실/` 폴더에 요청서가 들어옴 +1. `공유/소통/기획실→개발실/` 또는 `공유/소통/PM→개발실/` 폴더에 요청서가 들어옴 (Phase 1 통신 허브, 2026-04-15~) 2. 요청서의 내용을 분석하여 담당 에이전트를 결정 -3. 처리 결과를 요청서에 `## 응답` 섹션으로 추가, `상태: 완료`로 변경 -4. 완료된 요청서를 `완료/` 폴더로 이동 +3. 처리 결과를 요청서에 `## 응답` 섹션으로 추가, YAML `status: 완료`로 변경 +4. 완료된 요청서를 `공유/소통/완료/` 폴더로 이동 (git mv) ### 기획실 데이터 참조 - **데이터 SOT**: `${TABLE_EXPORT_ROOT}` (= `${UNITY_PROJECT_ROOT}/Assets/ResWork/Table/Export/`, JSON) diff --git a/개발실/CLAUDE.md b/개발실/CLAUDE.md index 493a4b5..5382868 100644 --- a/개발실/CLAUDE.md +++ b/개발실/CLAUDE.md @@ -87,10 +87,10 @@ ### 기획실 요청 처리 절차 -1. `공유/기획실→개발실/` 폴더의 미처리 요청서 확인 -2. 요청서의 `담당에이전트` 필드에 따라 해당 에이전트가 처리 -3. 처리 완료 후 요청서에 `## 응답` 섹션 추가, `상태: 완료`로 변경 -4. 완료된 요청서를 `완료/` 폴더로 이동 +1. `공유/소통/기획실→개발실/` 및 `공유/소통/PM→개발실/` 폴더의 미처리 요청서 확인 (Phase 1 통신 허브, 2026-04-15~) +2. 요청서의 `담당에이전트`·`to` 필드에 따라 해당 에이전트가 처리 +3. 처리 완료 후 요청서에 `## 응답` 섹션 추가, YAML `status: 완료`로 변경 +4. 완료된 요청서를 `공유/소통/완료/` 폴더로 이동 (git mv) ### 기획실 데이터 참조 경로 diff --git a/공유/공통_업무_규칙.md b/공유/공통_업무_규칙.md index 6d451ad..25fcbdf 100644 --- a/공유/공통_업무_규칙.md +++ b/공유/공통_업무_규칙.md @@ -638,7 +638,7 @@ git log --oneline -5 # 머지 결과 검증 총괄PM은 정기적으로 또는 PD님 모니터링 지시 시 다음 4단계를 수행한다: 1. **PD 지시 트래킹 채널 확인** — `공유/PD_지시_트래킹/{부서}_PD_지시_로그.md` 신규·미처리 항목 식별 2. **일일 보고 확인** — `공유/일일보고/` 최근 보고서 검토 -3. **공유 요청 채널 확인** — `공유/기획실→개발실/`, `공유/개발실→기획실/`, `공유/조직공지/` +3. **공유 요청 채널 확인** — `공유/소통/` 허브 6축 (PM↔개발실·PM↔기획실·개발실↔기획실), `공유/조직공지/` 4. **파일 시스템 변경 추적** — 최근 수정된 산출물 식별 부서 간 PD 지시 사항이 충돌·중복되는지 교차 검증하고, 발견 시 즉시 PD님에게 보고한다. diff --git a/공유/개발실→기획실/.gitkeep b/공유/소통/PM→개발실/.gitkeep similarity index 100% rename from 공유/개발실→기획실/.gitkeep rename to 공유/소통/PM→개발실/.gitkeep diff --git a/공유/완료/.gitkeep b/공유/소통/PM→기획실/.gitkeep similarity index 100% rename from 공유/완료/.gitkeep rename to 공유/소통/PM→기획실/.gitkeep diff --git a/공유/소통/README.md b/공유/소통/README.md new file mode 100644 index 0000000..642bcdf --- /dev/null +++ b/공유/소통/README.md @@ -0,0 +1,104 @@ +# 공유/소통/ — 너드나비스 부서간 통신 허브 (Phase 1) + +> **본 디렉토리는 PM·개발실·기획실 간 공식 비동기 통신 채널이다.** +> 모든 부서간 요청·응답·보고는 본 허브의 6축 채널을 경유하며, 처리 완료 후 `완료/` 로 아카이브된다. git commit·push 이벤트가 유일한 트리거이며, 부서 세션 SessionStart hook(Phase 2) 및 NAS post-receive hook(Phase 3)이 본 채널 변경을 감지한다. + +## 6축 채널 구조 + +| 채널 | 송신자 | 수신자 | 주요 용도 | +|------|--------|--------|----------| +| `PM→개발실/` | 총괄PM | 개발실 | PD님 지시 하달, 업무 지시, 검토 요청, 상태 질의 | +| `PM→기획실/` | 총괄PM | 기획실 | 동일 (기획실 대상) | +| `개발실→PM/` | 개발실(실장·팀장) | 총괄PM | 일일보고, 진행 보고, 블로커 보고, 검토 응답 | +| `기획실→PM/` | 기획실(팀장) | 총괄PM | 동일 (기획실 → PM) | +| `기획실→개발실/` | 기획실 | 개발실 | 기획 REQ (데이터 해석 확인·스펙 요청·의존성) | +| `개발실→기획실/` | 개발실 | 기획실 | 기획 REQ 응답, 기술 가이드, 프리뷰 | + +완료 처리된 파일은 `완료/` 로 이동. 감사·추적 목적으로 영구 보존. + +--- + +## 파일 명명 규칙 + +``` +YYYY-MM-DD_[REQ번호]_[제목].md + +예시: +2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md +2026-04-15_STATUS001_Phase3_HOLD_사유.md +2026-04-15_REPORT001_일일보고_개발실.md +``` + +- 날짜는 **작성일** +- REQ번호는 채널별 일련번호 (채널 시작 시점부터 증가, 자율 부여) +- 제목은 20자 이내 권장 + +--- + +## 파일 내부 표준 — YAML 프론트매터 (필수) + +모든 통신 파일 **최상단에 다음 YAML 블록 필수**: + +```yaml +--- +from: <발신자> # 예: 총괄PM, 개발실장, 기획팀장, 클라이언트팀장 등 +to: <수신자> # 예: 개발실, 기획실, 총괄PM (조직 단위 또는 개인) +type: <유형> # 업무지시 | 검토요청 | 상태질의 | REQ | 응답 | 일일보고 | 상태보고 | 블로커 +subject: <제목> # 파일명 제목과 동일 +ref: <참조 경로> # 선행 파일 있을 시 상대경로 (없으면 생략) +priority: normal | high | urgent +status: 대기 | 처리중 | 완료 | 보류 | 취소 +created: YYYY-MM-DD +due: <희망처리시점> # 없으면 생략 (C15: 기한 개념 배제, 우선순위로만 관리) +--- +``` + +본문 구조 자유. 단 장문은 `## 요청 내용`, `## 맥락`, `## 응답 필요 항목` 같은 섹션 구분 권장. + +--- + +## 응답 처리 절차 + +### 수신자 측 +1. 파일 상단 YAML 확인 → priority·type 파악 +2. 본문 읽고 처리 +3. **응답 방식 선택**: + - **같은 파일에 `## 응답` 섹션 추가**: 간단한 확인·답변 + - **반대 방향 채널에 신규 파일 작성**: 독립 안건으로 관리해야 할 응답 +4. 원본 파일의 YAML `status` 를 `완료` 또는 `처리중` 으로 갱신 +5. `완료` 처리 시 원본을 `완료/` 디렉토리로 `git mv` + +### 발신자 측 +- 응답 파일이 자기 수신 채널에 도착하면 SessionStart hook(Phase 2)이 자동 알림 +- 응답 확인 후 원본은 이미 `완료/` 에 있거나, 수신자가 이동하지 않았다면 발신자가 이동 가능 + +--- + +## 커밋 메시지 규칙 + +통신 파일 커밋 시 prefix 표준 (NAS post-receive hook 패턴 매칭·Phase 3): + +| prefix | 의미 | +|--------|------| +| `comm(req):` | 신규 요청 발송 | +| `comm(ans):` | 응답 발송 | +| `comm(rpt):` | 보고·상태 공유 | +| `comm(mv):` | 완료 아카이브 이동 | + +예: `comm(req): PM→개발실 C21 초안 v2 검토 요청` + +--- + +## C21(초안)과의 관계 + +- C21-1(작업 완료 즉시 push): 통신 파일 생성·응답 작성 시점에 **안건 단위로 1회 push** +- C21-2(PM 능동 fetch): PD님이 "개발실·기획실 현황 체크" 지시 시 PM이 즉시 fetch 후 `PM`방향 inbox 스캔 + +## 연관 코어룰 +- **C13** (PD 지시 트래킹): PD님 지시 수령분은 본 허브의 PM→ 채널로 하달 시 그 경로 자체가 트래킹 로그 +- **C17·C18** (세션 도달·공유 완료): 본 허브 변경은 push + 수신 세션 pull·hook 감지까지가 "도달" +- **C21**(초안, 부서 검토중): 즉시 push·능동 fetch +- **C22** (용어 일관): 본 README의 용어(채널명·type·status 값)를 임의 변경 금지 + +## 마이그레이션 주석 +2026-04-15 Phase 1 신설과 함께 기존 `공유/기획실→개발실/`, `공유/개발실→기획실/`, `공유/완료/` 는 본 허브 하위로 통합 이관됨. 미처리 REQ001~003(2026-04-14)은 현재 `공유/소통/기획실→개발실/` 에 위치. diff --git a/공유/소통/개발실→PM/.gitkeep b/공유/소통/개발실→PM/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/공유/소통/개발실→기획실/.gitkeep b/공유/소통/개발실→기획실/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/공유/소통/기획실→PM/.gitkeep b/공유/소통/기획실→PM/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/공유/기획실→개발실/2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md b/공유/소통/기획실→개발실/2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md similarity index 100% rename from 공유/기획실→개발실/2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md rename to 공유/소통/기획실→개발실/2026-04-14_REQ001_각성트리_퍼센트값_해석확인.md diff --git a/공유/기획실→개발실/2026-04-14_REQ002_장비옵션_음수값_의미확인.md b/공유/소통/기획실→개발실/2026-04-14_REQ002_장비옵션_음수값_의미확인.md similarity index 100% rename from 공유/기획실→개발실/2026-04-14_REQ002_장비옵션_음수값_의미확인.md rename to 공유/소통/기획실→개발실/2026-04-14_REQ002_장비옵션_음수값_의미확인.md diff --git a/공유/기획실→개발실/2026-04-14_REQ003_인장_장착수제한_확인.md b/공유/소통/기획실→개발실/2026-04-14_REQ003_인장_장착수제한_확인.md similarity index 100% rename from 공유/기획실→개발실/2026-04-14_REQ003_인장_장착수제한_확인.md rename to 공유/소통/기획실→개발실/2026-04-14_REQ003_인장_장착수제한_확인.md diff --git a/공유/소통/완료/.gitkeep b/공유/소통/완료/.gitkeep new file mode 100644 index 0000000..e69de29