# 공유/소통/ — 너드나비스 부서간 통신 허브 (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(dec):` | 결정로그 발행 |

예: `comm(req): PM→개발실 C21 초안 v2 검토 요청`

---

## 결정로그 (Decision Log) — 세션 간 소통 핵심 채널

> **2026-04-16 PD님 직접 지시로 신설.** 세션 간 소통 부재 근본 해결.

### 목적
각 세션에서 내린 **핵심 결정사항·노하우**를 대화 안에 묻히지 않게 파일로 남겨, 타 세션이 인지할 수 있도록 한다.

### type: 결정로그
YAML 프론트매터의 `type: 결정로그`로 분류.

### 발행 의무
- 세션에서 **의미 있는 결정**이 발생하면, 세션 종료 전에 자기 송신 채널에 결정로그 1건 발행
- 형식: 3줄 이내 핵심만 (배경 1줄 + 결정 1줄 + 영향 1줄)
- 발행 후 커밋·push (C20 팀장 재량)

### 파일 명명
```
YYYY-MM-DD_DEC번호_제목.md
예: 2026-04-16_DEC001_P21_세션갱신_프로토콜_신설.md
```

### 수신 자동화
SessionStart hook의 `change_digest.sh`가 커밋 로그에서 `comm(dec):` 접두사를 포함한 변경을 자동 표시하므로, 수신 세션은 resume만으로 결정로그 존재를 인지.

---

## 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)은 현재 `공유/소통/기획실→개발실/` 에 위치.