---
title: "📓 작업일지 — 배포 거버넌스 헌법급 규칙 등재(데모 선검증→메인 패치)"
category: "worklog"
parent: "Claude Code 작업일지"
updated: "2026-07-09"
priority: "High"
purpose: "달록 서비스 개발·운영에서 '데모(demo-dallog)에 먼저 반영·검증한 뒤 메인(main)에 패치한다'는 배포 원칙을 CLAUDE.md·AGENTS.md에 헌법급 규칙으로 등재한 작업 기록. 과거 메인 위주 배포로 데모가 뒤처져 메인→데모 역패치를 하다 데모 전용 아이덴티티·기능이 소실된 사고의 재발 방지 조치."
read_when: ["배포 거버넌스", "데모-메인 배포 순서", "데모 전용 아이덴티티", "역패치 금지 규칙", "CLAUDE.md AGENTS.md 규칙 등재"]
document_type: "개발일지"
source_status: "generated"
knowledge_group: "03_history"
work_timestamp: "20260709_153632"
source_of_truth: "https://dallog-tools.hansbridge.co.kr/knowledge/"
context: "달록 본레포(ccy-hansbridge/dallog), 커밋 c6a8f9f."
---

# 작업일지 — 배포 거버넌스 헌법급 규칙 등재

> 달록은 데모 서버(demo-dallog / demo.dallog.kr)와 메인 서버(main / dallog.kr)를 함께 운영한다. 과거 메인 위주로 배포하다 보니 데모가 메인보다 뒤처지는 일이 생겼고, 이를 메인→데모 "역패치"로 따라잡는 과정에서 데모에만 있던 아이덴티티(파비콘·타이틀)와 기능(스튜디오 등)이 실수로 지워지는 사고가 있었다. 이 작업은 그 재발을 막기 위해 "배포 순서 원칙"을 문서에 못박은 것이다.

## 1. 무엇을 했나

- `CLAUDE.md`, `AGENTS.md` 최상단에 **배포 거버넌스 규칙**을 신규 등재.
- 메모리 `feedback_deploy_governance`에도 동일 규율 등재(문서 내 언급).

## 2. 등재된 원칙 요약

1. **원칙**: 달록의 모든 기능·UI·UX 개선은 메인에 바로 반영하지 않고, 데모에서 먼저 검증한 뒤 메인에 패치한다.
2. **데모 = 사전 검증 서버**이며, 데모가 메인보다 기능·UI·UX·아이덴티티 측면에서 퇴보해서는 안 된다.
3. **메인 선반영 후 데모 역패치는 예외 상황이 아닌 이상 금지**.
4. **데모 전용 아이덴티티·기능·설정**(파비콘 `dallog_runner_black_on_hotpink.svg`, 타이틀 "달록 DEMO", 스튜디오 등)이 역패치·동기화·덮어쓰기로 소실되어서는 안 되며, 관련 파일에 "★demo-dallog 전용 — main 머지 시 제외" 주석을 명시한다.
5. **앱 배포·페이즈1 종료·OTA 설정 이후**에는 이 규칙 미준수가 사용자에게 즉시 영향을 주는 대형 운영사고로 이어질 수 있음을 명시.
6. **배포 전 체크 4항목**을 작업 계획·패치·배포 검수 시 필수 확인 항목으로 등재: ① 데모 선반영·검증 여부 ② 데모 전용 요소 소실 여부 ③ 메인↔데모 차이의 명시적 관리 여부 ④ 역패치인 경우 예외 승인 여부.

## 3. 변경 파일

| 파일 | 내용 |
|---|---|
| `AGENTS.md` | 강력지침으로 배포 거버넌스 규칙 등재 (+10줄) |
| `CLAUDE.md` | 최상단에 배포 거버넌스 규칙 등재 (+14줄) |

## 4. 관련 커밋

- `c6a8f9f` docs(governance): 배포 거버넌스 헌법급 규칙 등재 — 데모 선검증→메인 패치 (2026-07-09)

## 5. 남은 이슈

- 없음(문서 등재 작업으로 완결).