BurningTimesAi/공유/소통

공유/소통/ — BurningTimes 부서간 통신 허브

본 디렉토리는 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 파싱 기반:

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