BurningTimesAi/공유/소통/README.md

# 공유/소통/ — 너드나비스 부서간 통신 허브

> **본 디렉토리는 PM·개발팀·기획팀·감사관(3종) 간 공식 비동기 통신 채널이다.**
> 모든 부서간 요청·응답·보고·감사는 본 허브의 9축 채널을 경유하며, 처리 완료 후 `완료/` 로 아카이브된다. git commit 이벤트가 유일한 트리거이며, SessionStart hook이 본 채널 변경을 감지·알림.

## ⚠️ 2026-04-17 개정 — 9축 채널 확장 (감사관 3종 추가)

## 9축 채널 구조

| 채널 | 송신자 | 수신자 | 주요 용도 |
|------|--------|--------|----------|
| `PM→개발팀/` | 총괄PM | 개발팀 | PD님 지시 하달, 업무 지시, 검토 요청 |
| `PM→기획팀/` | 총괄PM | 기획팀 | 동일 (기획팀 대상) |
| `개발팀→PM/` | 개발팀(팀장) | 총괄PM | 현황 보고, 진행 보고, 블로커 보고, 검토 응답 |
| `기획팀→PM/` | 기획팀(팀장) | 총괄PM | 동일 (기획팀 → PM) |
| `기획팀→개발팀/` | 기획팀 | 개발팀 | 기획 REQ (데이터 해석·스펙·의존성) |
| `개발팀→기획팀/` | 개발팀 | 기획팀 | 기획 REQ 응답, 기술 가이드, 프리뷰 |
| **`pm-auditor→PM/`** | **pm-auditor** | **총괄PM** | **PM·조직 규칙·세션 맥락 메타 감사** (신설 2026-04-17) |
| **`dev-auditor→PM/`** | **dev-auditor** | **총괄PM** | **개발팀 감사 보고** (신설 2026-04-17) |
| **`plan-auditor→PM/`** | **plan-auditor** | **총괄PM** | **기획팀 감사 보고** (신설 2026-04-17) |

완료 처리된 파일은 `완료/` 로 이동. 감사·추적 목적으로 영구 보존.

---

## 파일 명명 규칙

```
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 프론트매터 필수 (2026-04-17 강화)

> **2026-04-17 pm-auditor 감사 Major M1**: 7건의 소통 파일이 `subject:` 필드 누락으로 inbox_scan에 "제목 없음" 표시. 반복 패턴 차단을 위해 본 섹션 강화.

모든 통신 파일 **최상단에 다음 YAML 블록 필수**. 감사관 3종·inbox_scan.sh 파싱 기반:

```yaml
---
from: <발신자>              # ⚠️ 필수. 예: 총괄PM, 개발팀장, 기획팀장, 클라이언트팀장, pm-auditor, dev-auditor, plan-auditor
to: <수신자>                # ⚠️ 필수. 예: 개발팀, 기획팀, 총괄PM
type: <유형>                # ⚠️ 필수. 업무지시 | 검토요청 | 상태질의 | REQ | 응답 | 현황보고 | 상태보고 | 블로커 | 기술검토 | 감사보고 | 결정로그
subject: <제목>             # 🚨 필수 (inbox_scan 파싱 대상, 누락 시 Major 감사 분류)
priority: normal | high | urgent   # ⚠️ 필수
status: 대기 | 진행중 | 검토완료 | 작성완료 | 완료 | 보류 | 취소  # ⚠️ 필수
created: YYYY-MM-DD          # ⚠️ 필수
ref: <참조 경로>            # 선택. 선행 파일·PD 지시 로그 #번호·커밋 SHA
req_ref: <관련 REQ 경로>    # 선택. REQ ↔ RPT 연결
updated: YYYY-MM-DD          # 선택. 수정 시 추가
---
```

### 필수 7필드 체크리스트 (발신 전 자체 검증)
- [ ] `from:` — 발신자 명시 (에이전트명 풀네임)
- [ ] `to:` — 수신자 명시
- [ ] `type:` — 허용 값 중 정확히 1개 선택
- [ ] `subject:` — 40자 이내 제목 (파일명과 일치 권장)
- [ ] `priority:` — normal/high/urgent 중 1개
- [ ] `status:` — 초기 상태 명시
- [ ] `created:` — YYYY-MM-DD 포맷

**하나라도 누락 시 pm-auditor·dev-auditor·plan-auditor 감사에서 Major 분류.**

본문 구조 자유. 단 장문은 `## 요청 내용`, `## 맥락`, `## 응답 필요 항목` 같은 섹션 구분 권장.

---

## 응답 처리 절차

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