채널 가이드 표준 v1.3¶

박제: 2026-05-21
정본: workspace/wiki/concepts/channel-guide-standard-v1.md

1. 원칙¶

AI 1차 독자, 사람 2차¶

런타임에서 channel_id·name·category·agent·model 모두 알 수 있음 (session_status 명령). 메타데이터 박제 ❌ → 본문만.

AGENTS·SOUL·wiki 중복 ❌¶

AGENTS = 행동 룰 (응답·Safety·escalation)
SOUL = 톤·말투
wiki/entities = 회사 자산·서비스·단가
채널 가이드 = 위 셋이 못 다룬 잔여만

가이드 진화 = 사람 주도¶

AI 자체 카운트·confidence·중요도 트리거 ❌
사람 명시 요청 / HQ 정기 회고 / AI 단발 제안 (사람 판단으로만 갱신)

2. 정본 위치 (v1.3 핵심)¶

채널 가이드 정본 = 그 채널 owner agent의 workspace.

AGENTS.md 모델과 동일 분산 패턴: - 공통 헌법 (shared/AGENTS.partial.*.md) = main 정본 → 모두 읽기 - 부서 local (workspace*/AGENTS.local.md) = 부서 정본 → 부서만 - 채널 가이드 = owner agent 정본 → owner만

가이드 종류	정본 위치	작성자
가이드 표준 (이 문서)	`workspace/wiki/concepts/`	main
main 카테고리 채널 가이드	`workspace/memory/channels/`	main
부서 채널 가이드	`workspace-*/memory/channels/`	해당 부서

main이 부서 채널 가이드 정본 보유 ❌ (부서 자율 침해, main 병목).

3. 명명 패턴¶

channel-{discord_id}-{name}.md
예: channel-1487821811365445643-디자인-시스템.md
discord_id = 기계 식별자 (AI lookup), name = 사람 식별

4. 일반 채널 (5섹션)¶

# #채널명

## 1. 채널 계약
TL;DR 3-5줄. 채널 목적.

## 2. 목적·범위
- **In**: 다룰 주제
- **Out**: 안 다룰 주제 (다른 채널 안내)

## 3. 고유 워크플로우
채널만의 특수 SOP. 없으면 "TBD".

## 4. 정본 출처·산출물
wiki·DB·템플릿 링크 (인라인 복사 ❌).

## 5. KPI
"TBD" 또는 측정 가능 1-3개.

5. HQ 채널 (5섹션·차별화)¶

# #카테고리-hq

## 1. 채널 계약
카테고리 HQ 역할.

## 2. 목적·범위
- **In**: 카테고리 메타 책임
- **Out**: 실무 (카테고리 일반 채널)

## 3. 카테고리 라우팅 정책
카테고리 내 채널별 매핑.
"어디 가야 하나" 질의 응답 기준.

## 4. 스킬 의뢰 접수·관리 SOP
- 의뢰 접수: 본 채널
- 작성 위치: 일반 채널 Opus 서브 세션
- 검수·등록: HQ
- 흐름: 의뢰 → 작성 위치 안내 → 작성 → artifact → HQ 검수 → 등록

## 5. 정본 출처·산출물 + KPI

6. 길이 가이드¶

일반 채널: 0.3-2.0 KB
HQ 채널: 0.5-2.5 KB
Hard ceiling: 4 KB (초과 시 wiki로 분리 검토)

7. 갱신 워크플로우 (사람 주도)¶

트리거	처리
장캐리/직원 명시 요청	owner agent 편집 → git commit
HQ 정기 회고 (분기·월)	카테고리 가이드 일괄 검토
AI 단발 제안	사람에게 1줄 제안 → OK/❌ 판단 → 갱신

자동 카운트·confidence·중요도 트리거 ❌.

8. 안티패턴¶

Don't	이유
Frontmatter metadata	런타임이 다 안다
응답/침묵 규칙	AGENTS 응답 라우팅 중복
일반 escalation	AGENTS Action table 중복
일반 Safety 룰	AGENTS Safety 불변 룰 중복
톤·말투 가이드	SOUL 중복
서비스 단가·고객 정보	wiki/entities 중복
카테고리 라우팅 (일반 채널)	HQ 채널이 다룸
AI 자체 측정·판단 룰	AGENTS principles 금지
1회성 사고로 만든 룰	AGENTS Recording 1회성 ❌
측정·실행·감지 불가능한 룰	공허한 룰
main이 부서 채널 가이드 정본 보유	부서 자율성 침해, main 병목
심볼릭 링크로 가이드 공유	가이드는 작성자가 자유 편집해야 함

9. v1.0 → v1.3 변경 이력¶

버전	일자	변경
v1.0	2026-05-17	8섹션, 14 frontmatter, GPT-5.5 검수 8.1/10
v1.1	2026-05-20	6섹션 다이어트, frontmatter 14→5
v1.2	2026-05-21 (오전)	Frontmatter 폐기, 5섹션, 안티패턴 10개
v1.3	2026-05-21 (오후)	분산 정본 (main 통합 폐기), 일반/HQ 차별화