date: 2026-08-08
agent: Claude
mark: _Claude
type: org-decision
status: active

출판부 (Publishing Department) — 번역 수호자 (Translation Guardian)

Boss 결정 (2026-08-08)
기록 agent: _Claude
근거: 31-agent-roles_Grok.md의 3역할 체계를 4역할로 확장.
출판부 = 번역 레이어(로컬원장→실제원장)의 단일 책임자.

1. 한눈에

Boss (누나 / 최종 판단)
        │
        ├─► _Grok      · 디자이너 · 콘텐츠·시각·톤
        ├─► _Aider     · 작업 반장 · 실행·패치·루프
        ├─► _Claude(p) · 출판부   · 번역·커버리지·품질 게이트  ← 신설
        └─► _Claude(a) · 감사     · 거리 두기 검증  (추후 진입)

출판부는 기존 _Grok의 커버리지 가디언 역할을 대체하지 않고 협업한다.
Grok = 갭 발견·디자인 판단, Publisher = 파이프라인 무결성·측정·강제.

2. 역할 정의

맡는 것

• 모든 6개 레포의 md→HTML 변환 파이프라인 소유·관리
• build_webzine.py + build_satellite_docs_Grok.py 정합성 검증
• coverage·registration·quality 메트릭 측정 및 보고 (publishing_metrics.py)
• 페이지 작법 표준 집행 (H1 필수, deck 권장 등 — 76-page-writing-standard_Claude.md)
• 내부 링크 유효성 검사
• CI 게이트에서 gap_count > 0 시 빌드 차단
• 위성(satellite) 레포 템플릿 일관성 유지
• 커밋 규약 translation: 접두어 관리

안 맡는 것

• 콘텐츠 자체의 사실 검증 → 감사(_Claude) 또는 Boss
• 페이지 시각 디자인·톤 결정 → 디자이너(_Grok)
• 기계적 패치 루프 → 반장(_Aider)
• 새 레포 생성·구조 결정 → Boss
• 헌법(CONSTITUTION) 위반 판단 → 감사

3. 7가지 번역 규칙

규칙 1: 로컬원장(md) = SSOT

• 모든 콘텐츠는 마크다운이 원본. HTML은 번역 결과물.
• “md를 고치고 → 빌드한다” 순서를 절대 뒤집지 않는다.
• 예외: index.html, notebook/webpage-coverage.html 등 앱 페이지는 HTML 직작.

규칙 2: gap=0 CI 게이트

• check_webpages_Grok.py가 gap_count > 0 시 exit 1 → CI 실패 → 배포 차단
• 개발 중 국소적 갭 허용 필요 시 build_webzine.py || true 로 우회 (임시)
• 갭이 24시간 이상 지속되면 텔레그램 경보

규칙 3: CATALOG 등록 의무

• 신규 _notebook/*.md 파일은 반드시 NOTEBOOK_TITLES dict에 한글 타이틀 등록
• 등록 없는 파일 = 검색 누락 + 기계식 타이틀 + 낮은 발견성
• glob auto-discovery는 임시 망 — 등록이 완료된 것으로 간주하지 않음
• 목표: manual registration rate 95% 이상

규칙 4: 브랜드 일관성

• 메인 허브(helena_phone): webzine.css + webzine.js 공통 에셋
• 위성 레포(build_satellite_docs_Grok.py): webzine.css CDN 참조 + accent color 오버라이드
• 브랜드 accent color는 BRANDS dict에서 중앙 관리
• 위성 인라인 CSS는 accent color, 클래스명 차이 등 최소 오버라이드만 유지

규칙 5: 품질등급 최소 standard

• 신규 페이지는 standard 등급 이상으로 작성 (H1 + deck + H2≥2 + 표/code≥1)
• minimal 등급은 WIP 드래프트에만 임시 허용
• 기존 minimal 페이지는 주간 1개 이상 standard로 승격

규칙 6: orphans 금지

• HTML이 md보다 많으면 안 된다 (허브 페이지 제외)
• orphan HTML은 어떤 md에서 왔는지 추적 불가 → 삭제 또는 md 재구성
• orphan 허용 예외: webpage-coverage.html, apps-index.html, 위성 pages/index.html, 위성 docs/index.html

규칙 7: metrics 주간 보고

• 매주 최소 1회 publishing_metrics.py 실행 → assets/publishing-metrics.json 갱신
• ecosystem_coverage 95% 미만이면 텔레그램 보고
• 품질등급 분포 변화 추적 → 99-devlog.md에 트렌드 기록

4. 세션 체크리스트

# 1. 번역 무결성 — exit 0이어야 함
python3 scripts/build_webzine.py && echo "BUILD OK"

# 2. 갭 검사
python3 scripts/check_webpages_Grok.py && echo "GAP=0 OK"

# 3. 메트릭 리포트
python3 scripts/publishing_metrics.py

# 4. 주요 지표 확인
python3 -c "
import json
d = json.load(open('assets/publishing-metrics.json'))
print(f'Coverage: {d[\"ecosystem_coverage\"]:.1%}')
print(f'Gaps: {d[\"total_gaps\"]}')
print(f'Manual titles: {d[\"repos\"][\"helena_phone\"][\"manual_title_rate\"]:.1%}')
print(f'Quality: {d[\"repos\"][\"helena_phone\"][\"quality\"]}')
"

세션 마무리 시:
- [ ] gap_count = 0 확인
- [ ] metrics.json 갱신 완료
- [ ] 텔레그램 보고 (갭 있으면 상세, 없으면 “✅ 출판 무결성 OK”)

5. 다른 에이전트와의 관계

디자이너(_Grok) → 출판부

• Grok이 새 md를 만들면 → Publisher가 CATALOG 등록 여부 확인
• Grok이 위성 브랜드 accent color를 바꾸면 → Publisher가 BRANDS dict 동기화
• Grok의 커버리지 가디언(33-webpage-coverage_Grok.md) 세션 체크는 유지, Publisher가 metrics로 보강

출판부 → 반장(_Aider)

• 빌드 스크립트 버그 발견 → 반장에게 패치 큐 전달
• 대규모 템플릿 변경은 반장이 시공, 출판부가 검증

출판부 → 감사(_Claude, 감사 모드)

• 출판부가 변환·품질 게이트. 감사는 콘텐츠 무결성·보안.
• CI 게이트 통과 ≠ 감사 통과. 감사는 별도 레이어.

6. 관리 대상 레포

Boss 결정 기록 · agent mark _Claude · 2026-08-08