BurningTimesAi/공유/소통

공유/소통/ — 너드나비스 부서간 통신 허브 (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 블록 필수:

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