From 46baeaff919dd53f85d7bed8c41c45f10e9ef2f9 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 13:28:46 +0900
Subject: [PATCH 01/17] =?UTF-8?q?docs:=20=EA=B0=9C=EB=B0=9C=20=EC=B0=B8?=
 =?UTF-8?q?=EC=A1=B0=20=EB=AC=B8=EC=84=9C=20=EC=B6=94=EA=B0=80=20(referenc?=
 =?UTF-8?q?e/)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- API 엔드포인트 정리 (api_endpoints.md)
- 인프라 정보 정리 (infrastructure.md)
- 환경변수 정리 (environment_variables.md)
- 배포 파이프라인 정리 (deployment_pipelines.md)
- 상수/설정값 정리 (constants.md)
- 네이밍 컨벤션 정리 (naming_conventions.md)
- 로깅 규칙 정리 (logging_rules.md)

목적: 개발 시 중복/오류 방지, 빠른 참조
모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용
---
 book/300_architecture/300_README.md           |  10 ++
 .../reference/api_endpoints.md                | 116 ++++++++++++++++++
 book/300_architecture/reference/constants.md  | 100 +++++++++++++++
 .../reference/deployment_pipelines.md         |  99 +++++++++++++++
 .../reference/environment_variables.md        |  92 ++++++++++++++
 .../reference/infrastructure.md               |  96 +++++++++++++++
 .../reference/logging_rules.md                | 105 ++++++++++++++++
 .../reference/naming_conventions.md           |  94 ++++++++++++++
 8 files changed, 712 insertions(+)
 create mode 100644 book/300_architecture/reference/api_endpoints.md
 create mode 100644 book/300_architecture/reference/constants.md
 create mode 100644 book/300_architecture/reference/deployment_pipelines.md
 create mode 100644 book/300_architecture/reference/environment_variables.md
 create mode 100644 book/300_architecture/reference/infrastructure.md
 create mode 100644 book/300_architecture/reference/logging_rules.md
 create mode 100644 book/300_architecture/reference/naming_conventions.md

diff --git a/book/300_architecture/300_README.md b/book/300_architecture/300_README.md
index d92c78a..f802662 100644
--- a/book/300_architecture/300_README.md
+++ b/book/300_architecture/300_README.md
@@ -20,6 +20,16 @@ Part 2에서 우리는 게임 메커니즘을 활용한 설계를 소개했습
 - 360_로빙_컨테이너_경량화_전략.md
 - 370_임베딩_서비스_분리_아키텍처.md
 
+## 참조 문서 (reference/)
+개발 시 빠른 참조를 위한 정리 문서:
+- [API 엔드포인트](./reference/api_endpoints.md)
+- [인프라](./reference/infrastructure.md)
+- [환경변수](./reference/environment_variables.md)
+- [배포 파이프라인](./reference/deployment_pipelines.md)
+- [상수/설정값](./reference/constants.md)
+- [네이밍 컨벤션](./reference/naming_conventions.md)
+- [로깅 규칙](./reference/logging_rules.md)
+
 ## 핵심 메시지
 컨테이너는 몸, 기억은 영혼. 100개의 로빙이 1개의 스킬 서비스를 공유하는 효율적 아키텍처.
 
diff --git a/book/300_architecture/reference/api_endpoints.md b/book/300_architecture/reference/api_endpoints.md
new file mode 100644
index 0000000..2480dcc
--- /dev/null
+++ b/book/300_architecture/reference/api_endpoints.md
@@ -0,0 +1,116 @@
+# API 엔드포인트 참조
+
+**작성일**: 2025-12-06
+**목적**: 개발 시 API 엔드포인트 중복/오류 방지, 빠른 참조
+
+---
+
+## rb8001 (메인 서비스, 8001)
+
+### 메시지 처리
+| 엔드포인트 | 메서드 | 설명 | 인증 |
+|-----------|--------|------|------|
+| `/api/message` | POST | Gateway/Frontend 메시지 처리 | JWT 필수 |
+| `/api/feedback/chat` | POST | 채팅 피드백 (좋아요/싫어요) | JWT 필수 |
+
+**참고**: `rb8001/app/router/message_endpoint.py:26`, `rb8001/main.py:85`
+
+### LLM
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/llm/generate` | POST | 텍스트 생성 |
+| `/api/llm/summarize` | POST | 요약 |
+| `/api/llm/complete` | POST | 완성 |
+| `/api/llm/health` | GET | 헬스체크 |
+
+**참고**: `rb8001/app/router/llm_endpoint.py:28,55,93,124`
+
+### 감정 분석
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/emotion/infer` | POST | 감정 추론 |
+| `/api/emotion/timeseries` | GET | 시계열 데이터 |
+| `/api/emotion/team-insight` | GET | 팀 인사이트 |
+| `/api/emotion/process-message` | POST | 메시지 처리 |
+| `/api/emotion/health` | GET | 헬스체크 |
+
+**참고**: `rb8001/app/router/emotion_endpoint.py:75,150,188,263,303`
+
+### 기억 온톨로지
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/v1/memory/event` | POST | 사건 저장 |
+| `/api/v1/memory/recall` | POST | 회상 |
+| `/api/v1/memory/stats` | GET | 통계 |
+
+**참고**: `rb8001/app/router/memory_ontology.py:69,118,181`
+
+### Intent 리뷰
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/intent-review/queue` | GET | 큐 조회 |
+| `/api/intent-review/{item_id}/label` | PUT | 라벨 업데이트 |
+| `/api/intent-review/stats` | GET | 통계 |
+
+**참고**: `rb8001/app/router/intent_review_endpoint.py:33,58,81`
+
+### IR Deck 평가
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/ir-deck/upload` | POST | PDF 업로드 |
+| `/api/ir-deck/evaluate` | POST | 평가 시작 |
+| `/api/ir-deck/evaluation/{evaluation_id}` | GET | 평가 결과 |
+| `/api/ir-deck/chat` | POST | 채팅 |
+| `/api/ir-deck/feedback` | POST | 피드백 |
+
+**참고**: `rb8001/app/router/ir_deck.py:109,169,263,297,344`
+
+### Slack
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/slack/events` | POST | Slack 이벤트 |
+| `/slack/slash` | POST | 슬래시 명령어 |
+| `/slack/health` | GET | 헬스체크 |
+
+**참고**: `rb8001/app/router/slack_endpoint.py:33,70,117`
+
+---
+
+## skill-* 서비스
+
+| 서비스 | 포트 | 주요 엔드포인트 | 참고 |
+|--------|------|----------------|------|
+| skill-email | 8501 | `/health` | - |
+| skill-news | 8505 | `/health` | `skill_news/README.md:30` |
+| skill-slack | 8502 | `/health` | `skill-slack/README.md:23` |
+| skill-rag-file | 8508 | `/healthz`, `/api/upload`, `/api/search` | `skill-rag-file/app/main.py:60` |
+| skill-calendar | 8512 | `/health`, `/api/events` | `skill-calendar/README.md:23` |
+
+---
+
+## robeing-monitor (9024)
+
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/health` | GET | 헬스체크 |
+| `/api/stats/{robeing_id}` | GET/PUT | 스탯 조회/업데이트 |
+| `/api/monitor/robeings` | GET | 로빙 상태 |
+| `/api/monitor/skills` | GET | 스킬 서비스 상태 |
+
+**참고**: `robeing-monitor/README.md:68`, `robeing-monitor/app/api/monitor.py`
+
+---
+
+## Gateway (8100)
+
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/gateway/slack/events` | POST | Slack 이벤트 프록시 |
+| `/gateway/*` | * | 각 서비스 프록시 |
+
+**참고**: `AGENTS.md:88-92`
+
+---
+
+**업데이트**: 서비스 추가/변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/constants.md b/book/300_architecture/reference/constants.md
new file mode 100644
index 0000000..99cf102
--- /dev/null
+++ b/book/300_architecture/reference/constants.md
@@ -0,0 +1,100 @@
+# 상수/설정값 참조
+
+**작성일**: 2025-12-06
+**목적**: 코드 중복 방지, 일관성 유지
+
+---
+
+## 스킬 레벨
+
+| 레벨 | 스킬 | 설명 |
+|------|------|------|
+| 1 | 기본 대화 | 기본 채팅 |
+| 2 | 이메일 읽기 | Gmail 읽기 |
+| 3 | Slack 대화 | Slack 연동 |
+| 4 | 이메일 전송 | Gmail 전송 |
+| 5 | 데일리 브리핑 | 뉴스 요약 |
+| 7 | 일정 관리 | 캘린더 |
+| 11 | 문서 작성/편집 | 문서 작업 |
+| 13 | 데이터 분석/차트 | 분석 |
+| 17 | 프로젝트 관리 | 프로젝트 |
+| 19 | AI 인사이트/예측 | 인사이트 |
+| 23 | 자동화 워크플로우 | 자동화 |
+
+**참고**: `DOCS/journey/troubleshooting/250830_skill_level_system_restructure.md:45-57`
+
+---
+
+## 스킬 타입
+
+| 타입 | 설명 | 사용 위치 |
+|------|------|-----------|
+| `EMAIL` | 이메일 스킬 | `rb8001/app/services/brain/decision_engine.py:76` |
+| `NEWS` | 뉴스 스킬 | 동일 |
+| `SLACK` | Slack 스킬 | 동일 |
+| `LLM` | LLM 처리 | 동일 |
+| `CALENDAR` | 캘린더 스킬 | 동일 |
+| `TOOL` | 도구 스킬 | 동일 |
+
+**참고**: `rb8001/app/services/brain/decision_engine.py:76-108`
+
+---
+
+## 감정 분류
+
+| 감정 | 설명 |
+|------|------|
+| `fear` | 두려움 |
+| `surprise` | 놀람 |
+| `anger` | 분노 |
+| `sadness` | 슬픔 |
+| `neutral` | 중립 |
+| `happiness` | 행복 |
+| `disgust` | 혐오 |
+
+**참고**: `rb8001/app/services/emotion_classifier.py`
+
+---
+
+## 스탯 요구사항
+
+| 스킬 | Memory | React | Compute | Empathy |
+|------|--------|-------|---------|---------|
+| EMAIL | 10 | 5 | 5 | 5 |
+| NEWS | - | 10 | 5 | - |
+| SLACK | 15 | - | - | 10 |
+| ANALYSIS | 15 | - | 20 | - |
+| LLM | - | - | 15 | 10 |
+
+**참고**: `rb8001/app/services/brain/decision_engine.py:560-565`
+
+---
+
+## HTTP 상태 코드
+
+| 코드 | 의미 | 사용 예시 |
+|------|------|-----------|
+| 200 | 성공 | 정상 응답 |
+| 401 | 인증 실패 | JWT 만료 |
+| 403 | 권한 없음 | 레벨 부족 |
+| 404 | 없음 | 리소스 없음 |
+| 500 | 서버 오류 | 내부 에러 |
+
+---
+
+## 로그 레벨
+
+| 레벨 | 설명 | 사용 시점 |
+|------|------|-----------|
+| `DEBUG` | 디버그 정보 | 개발 중 |
+| `INFO` | 일반 정보 | 정상 동작 |
+| `WARNING` | 경고 | 예상 가능한 문제 |
+| `ERROR` | 오류 | 처리 실패 |
+| `CRITICAL` | 치명적 오류 | 시스템 중단 |
+
+**참고**: `rb8001/app/core/logger.py`
+
+---
+
+**업데이트**: 상수 추가/변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/deployment_pipelines.md b/book/300_architecture/reference/deployment_pipelines.md
new file mode 100644
index 0000000..1330bf1
--- /dev/null
+++ b/book/300_architecture/reference/deployment_pipelines.md
@@ -0,0 +1,99 @@
+# 배포 파이프라인 참조
+
+**작성일**: 2025-12-06
+**목적**: 배포 프로세스 빠른 참조
+
+---
+
+## 자동 배포 (Gitea Actions)
+
+### 배포 대상 서비스
+- rb8001
+- robeing-monitor
+- skill_email
+- skill_news
+- skill-rag-file
+- skill-publish
+- skill-slack
+- fluent-bit
+- frontend-customer
+- frontend-ir-valuation
+
+**참고**: `AGENTS.md:28-29`
+
+### 배포 플로우
+1. 로컬에서 코드 수정
+2. `git push origin main`
+3. Gitea Actions 자동 실행 (51123 서버)
+4. SSH로 51124 서버 접속
+5. `git pull origin main`
+6. `docker compose down && docker compose up -d --build`
+7. 헬스체크 확인
+
+**참고**: `AGENTS.md:83-85`
+
+### 워크플로우 파일 위치
+- 경로: `.gitea/workflows/*.yml`
+- 예시: `rb8001/.gitea/workflows/cicd.yml`
+
+---
+
+## 수동 배포
+
+### 배포 대상 서비스
+- skill-embedding
+- skill-calendar
+
+**참고**: `AGENTS.md:29`
+
+### 배포 절차
+```bash
+cd /home/admin/ivada_project/[서비스명]
+git pull origin main
+docker compose down && docker compose up -d --build
+docker ps  # 재시작 확인
+```
+
+---
+
+## 배포 검증
+
+### 필수 확인 사항
+- [ ] `docker ps`로 컨테이너 실행 확인
+- [ ] 헬스체크 엔드포인트 응답 확인
+- [ ] 로그 확인 (`docker logs [컨테이너명] --tail 50`)
+
+**주의**: Actions 성공 메시지만 믿지 말고 실제 컨테이너 상태 확인
+
+**참고**: `AGENTS.md:30-31`
+
+---
+
+## SSH Secrets
+
+| Secret 이름 | 설명 | 사용 위치 |
+|------------|------|-----------|
+| `SSH_PRIVATE_KEY_51124` | 51124 서버 SSH 키 | Gitea Actions |
+| `SSH_HOST_51124` | 192.168.219.52 | Gitea Actions |
+| `SSH_USER_51124` | admin | Gitea Actions |
+
+**참고**: `DOCS/journey/plans/251206_skill_calendar_자동배포_구성.md`
+
+---
+
+## 트러블슈팅
+
+### Actions 캐시 문제
+- 증상: 워크플로우 수정이 반영되지 않음
+- 해결: `/root/.cache/act/` 삭제
+- 참고: `DOCS/journey/troubleshooting/250929_actions_cache_problem.md`
+
+### SSH 인증 실패
+- 증상: "Permission denied (publickey)"
+- 해결: Gitea Secrets의 SSH 키 확인
+- 참고: `DOCS/journey/troubleshooting/250728_happybell80_nginx프록시및CI배포문제해결.md`
+
+---
+
+**업데이트**: 배포 프로세스 변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/environment_variables.md b/book/300_architecture/reference/environment_variables.md
new file mode 100644
index 0000000..39692c7
--- /dev/null
+++ b/book/300_architecture/reference/environment_variables.md
@@ -0,0 +1,92 @@
+# 환경변수 참조
+
+**작성일**: 2025-12-06
+**목적**: 환경변수 중복/오류 방지, 빠른 참조
+
+---
+
+## 공통 환경변수
+
+| 변수명 | 필수 | 설명 | 예시 |
+|--------|------|------|------|
+| `SERVICE_NAME` | 예 | 서비스 이름 | `skill-slack` |
+| `PORT` | 예 | 서비스 포트 | `8502` |
+| `LOG_LEVEL` | 선택 | 로그 레벨 | `INFO` |
+| `DATABASE_URL` | 예* | PostgreSQL 연결 문자열 | `postgresql://...` |
+| `JWT_SECRET_KEY` | 예* | JWT 시크릿 키 | - |
+
+*일부 서비스만 필수
+
+---
+
+## rb8001
+
+| 변수명 | 필수 | 설명 | 참고 |
+|--------|------|------|------|
+| `DATABASE_URL` | 예 | PostgreSQL 연결 | `rb8001/docker-compose.yml` |
+| `JWT_SECRET_KEY` | 예 | JWT 인증 | `rb8001/app/auth.py` |
+| `NEO4J_PASSWORD` | 선택 | Neo4j 비밀번호 | `rb8001/docker-compose.yml` |
+| `TAVILY_API_KEY` | 선택 | Tavily API 키 | `rb8001/docker-compose.yml` |
+| `USE_EMOTION_ANALYSIS` | 선택 | 감정 분석 활성화 | `true/false` |
+| `GEMINI_API_KEY` | 선택 | Gemini API 키 | - |
+
+---
+
+## skill-* 서비스
+
+### skill-slack
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `SERVICE_API_KEY` | 예 | 서비스 인증 키 |
+| `SLACK_BOT_TOKEN` | 예 | Slack 봇 토큰 |
+| `JWT_SECRET_KEY` | 예 | JWT 검증 |
+
+**참고**: `skill-slack/app/core/config.py`, `skill-slack/docker-compose.yml`
+
+### skill-rag-file
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `DATABASE_URL` | 예 | PostgreSQL 연결 |
+| `CHROMA_PORT` | 선택 | ChromaDB 포트 (기본: 8000) |
+
+**참고**: `skill-rag-file/docker-compose.yml:11`
+
+### skill-calendar
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `DATABASE_URL` | 예 | PostgreSQL 연결 (51123) |
+
+**참고**: `skill-calendar/docker-compose.yml:14`
+
+### skill-news
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `GEMINI_API_KEY` | 예 | Gemini API 키 |
+| `DATABASE_URL` | 예 | PostgreSQL 연결 |
+
+**참고**: `skill_news/README.md:36-39`
+
+---
+
+## robeing-monitor
+
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `DATABASE_URL` | 예 | PostgreSQL 연결 |
+| `ROBEING_URLS` | 예 | 로빙 서비스 URL 목록 |
+| `SKILL_URLS` | 예 | 스킬 서비스 URL 목록 |
+
+**참고**: `robeing-monitor/README.md:37-42`
+
+---
+
+## 주의사항
+
+- **민감 정보 하드코딩 금지**: API 키, 토큰, 비밀번호는 `.env` 파일에만 저장
+- **기본값 사용 금지**: 환경변수 미설정 시 명시적 에러 처리
+- **참고**: `DOCS/book/300_architecture/311_FastAPI_구조_원칙.md` 섹션 12
+
+---
+
+**업데이트**: 환경변수 추가/변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/infrastructure.md b/book/300_architecture/reference/infrastructure.md
new file mode 100644
index 0000000..772a446
--- /dev/null
+++ b/book/300_architecture/reference/infrastructure.md
@@ -0,0 +1,96 @@
+# 인프라 참조
+
+**작성일**: 2025-12-06
+**목적**: 서버/포트/네트워크 정보 빠른 참조
+
+---
+
+## 서버 구성
+
+| 서버 | IP | 역할 | 주요 서비스 |
+|------|-----|------|------------|
+| 51123 | 192.168.219.45 | 메인 서버 | nginx, Gitea, auth-server, robeing-gateway, frontend-base, PostgreSQL |
+| 51124 | 192.168.219.52 | 로빙/스킬 서버 | rb8001, robeing-monitor, skill-*, ChromaDB |
+
+**참고**: `AGENTS.md:78-81`, `DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md:27-30`
+
+---
+
+## 포트 매핑
+
+### 51123 서버
+| 서비스 | 포트 | 프로토콜 | 설명 |
+|--------|------|----------|------|
+| nginx | 80, 443 | HTTP/HTTPS | 웹 서버 |
+| Gitea | 3000 | HTTP | Git 저장소 |
+| robeing-gateway | 8100 | HTTP | API 게이트웨이 |
+| frontend-base | 8000 | HTTP | 관리자 대시보드 |
+| auth-server | 9000 | HTTP | 인증 서버 |
+| PostgreSQL | 5432 | TCP | 데이터베이스 |
+| Neo4j | 7687 | TCP | 그래프 DB |
+
+### 51124 서버
+| 서비스 | 포트 | 프로토콜 | 설명 |
+|--------|------|----------|------|
+| rb8001 | 8001 | HTTP | 메인 로빙 서비스 |
+| robeing-monitor | 9024 | HTTP | 모니터링 서비스 |
+| skill-email | 8501 | HTTP | 이메일 스킬 |
+| skill-news | 8505 | HTTP | 뉴스 스킬 |
+| skill-slack | 8502 | HTTP | Slack 스킬 |
+| skill-rag-file | 8508 | HTTP | RAG 파일 스킬 |
+| skill-calendar | 8512 | HTTP | 캘린더 스킬 |
+| skill-embedding | 8511 | HTTP | 임베딩 스킬 |
+| skill-publish | - | HTTP | 퍼블리싱 스킬 |
+| ChromaDB | 8000 | HTTP | 벡터 DB |
+
+**참고**: `AGENTS.md:78-81`, 각 서비스 `docker-compose.yml`
+
+---
+
+## 네트워크 플로우
+
+### 배포 플로우
+```
+로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작
+```
+
+**참고**: `AGENTS.md:83-85`
+
+### Admin Dashboard 라우팅
+```
+사용자 → nginx (51123) → robeing-gateway (8100) → frontend-base (8000)
+```
+
+**참고**: `AGENTS.md:88-92`
+
+### API 프록시
+```
+Frontend → nginx (/gateway/) → Gateway (8100) → 각 서비스
+```
+
+---
+
+## SSH 접속
+
+| 서버 | SSH 포트 | 사용자 | 용도 |
+|------|----------|--------|------|
+| 51124 | 51124 | admin | 배포 (Gitea Actions) |
+
+**참고**: `AGENTS.md:28-29`, Gitea Actions 워크플로우
+
+---
+
+## 데이터베이스
+
+| DB | 서버 | 포트 | 데이터베이스명 | 사용자 |
+|----|------|------|---------------|--------|
+| PostgreSQL | 51123 | 5432 | main_db | robeings |
+| Neo4j | 51123 | 7687 | - | neo4j |
+| ChromaDB | 51124 | 8000 | - | - |
+
+**참고**: `DOCS/book/300_architecture/database/tables.md`
+
+---
+
+**업데이트**: 서버/포트 변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/logging_rules.md b/book/300_architecture/reference/logging_rules.md
new file mode 100644
index 0000000..bddcdd7
--- /dev/null
+++ b/book/300_architecture/reference/logging_rules.md
@@ -0,0 +1,105 @@
+# 로깅 규칙 참조
+
+**작성일**: 2025-12-06
+**목적**: 로그 일관성 유지, 디버깅 효율성 향상
+
+---
+
+## 로그 레벨 사용 규칙
+
+| 레벨 | 사용 시점 | 예시 |
+|------|-----------|------|
+| `DEBUG` | 상세 디버깅 정보 | 변수 값, 함수 진입/종료 |
+| `INFO` | 정상 동작 정보 | 요청 처리, 상태 변경 |
+| `WARNING` | 예상 가능한 문제 | 재시도, 폴백 처리 |
+| `ERROR` | 처리 실패 | 예외 발생, API 오류 |
+| `CRITICAL` | 시스템 중단 | DB 연결 실패, 서비스 다운 |
+
+**참고**: `rb8001/app/core/logger.py`
+
+---
+
+## 로그 포맷
+
+### 구조화된 로그
+```python
+logger.info(f"User {user_id} authenticated", extra={
+    "user_id": user_id,
+    "action": "authenticate"
+})
+```
+
+### JSON 로깅
+- 형식: JSON (python-json-logger 사용)
+- 필드: `time`, `level`, `module`, `msg`
+
+**참고**: `rb8001/app/core/logger.py`
+
+---
+
+## 로그 위치
+
+### 컨테이너 내부
+- 경로: `/code/logs/[서비스명].log`
+- 예시: `/code/logs/rb8001.log`
+
+### 호스트 (백업)
+- 경로: `/mnt/51123logs/[서비스명]/`
+- 백업 시간: 매일 03:00
+
+**참고**: `AGENTS.md:133-137`
+
+---
+
+## 로그 확인 방법
+
+### 실시간 로그
+```bash
+docker logs [컨테이너명] --tail 100
+```
+
+### 파일 로그
+```bash
+tail -f /code/logs/[서비스명].log
+```
+
+### 에러 필터링
+```bash
+docker logs [컨테이너명] | grep -iE "error|warn|fail"
+```
+
+**참고**: `AGENTS.md:133-137`
+
+---
+
+## 로그 보관
+
+### Docker JSON 로그
+- 위치: `/var/lib/docker/containers/*/json.log`
+- 권한: sudo 필요
+
+### OpenSearch
+- 주소: http://192.168.219.45:9200
+- 인덱스: `dataprepper-static` (서비스 로그)
+- 일별 인덱스: `dataprepper-YYYY.MM.DD` (fluent-bit 로그)
+
+**참고**: `AGENTS.md:137-142`
+
+---
+
+## 로깅 모범 사례
+
+### DO
+- 요청/응답 로깅 (INFO)
+- 에러 상세 정보 포함 (ERROR)
+- 사용자 ID 포함 (개인정보 제외)
+
+### DON'T
+- 민감 정보 로깅 (비밀번호, 토큰)
+- 과도한 DEBUG 로그 (프로덕션)
+- 중복 로그 (같은 정보 반복)
+
+---
+
+**업데이트**: 로깅 규칙 변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/naming_conventions.md b/book/300_architecture/reference/naming_conventions.md
new file mode 100644
index 0000000..c084fc5
--- /dev/null
+++ b/book/300_architecture/reference/naming_conventions.md
@@ -0,0 +1,94 @@
+# 네이밍 컨벤션 참조
+
+**작성일**: 2025-12-06
+**목적**: 코드 일관성 유지, 가독성 향상
+
+---
+
+## 파일명
+
+### Python
+- **router**: `{기능}_endpoint.py` (예: `message_endpoint.py`)
+- **service**: `{도메인}_{기능}.py` (예: `coldmail_filter.py`)
+- **state**: `{도메인}_repository.py` (예: `conversation_repository.py`)
+
+**참고**: `DOCS/book/300_architecture/311_FastAPI_구조_원칙.md:53-63`
+
+### 디렉토리
+- `router/`: HTTP 엔드포인트
+- `services/`: 비즈니스 로직
+- `state/`: DB 접근 (Repository 패턴)
+- `models/`: ORM 모델
+- `schemas/`: Pydantic 모델
+
+**참고**: `DOCS/book/300_architecture/311_FastAPI_구조_원칙.md:27-51`
+
+---
+
+## 변수명
+
+### Python
+- **snake_case**: 변수, 함수, 모듈
+- **PascalCase**: 클래스
+- **UPPER_CASE**: 상수
+
+**예시**:
+```python
+user_id = "uuid"  # 변수
+def get_user_info():  # 함수
+    pass
+class UserService:  # 클래스
+    pass
+MAX_RETRIES = 3  # 상수
+```
+
+---
+
+## API 엔드포인트
+
+### 경로 규칙
+- **kebab-case**: URL 경로 (예: `/api/intent-review/queue`)
+- **RESTful**: 리소스 중심 (예: `/api/events/{event_id}`)
+
+**참고**: `rb8001/app/router/intent_review_endpoint.py:33`
+
+---
+
+## 데이터베이스
+
+### 테이블명
+- **snake_case**: 소문자, 언더스코어 (예: `conversation_log`)
+- **복수형**: 컬렉션 의미 (예: `users`, `conversations`)
+
+### 컬럼명
+- **snake_case**: 소문자, 언더스코어 (예: `user_id`, `created_at`)
+- **UUID**: `id` 또는 `{entity}_id` (예: `user_id`)
+
+**참고**: `DOCS/book/300_architecture/database/tables.md`
+
+---
+
+## 환경변수
+
+### 명명 규칙
+- **UPPER_SNAKE_CASE**: 대문자, 언더스코어
+- **명확한 의미**: `DATABASE_URL`, `JWT_SECRET_KEY`
+
+**참고**: `DOCS/book/300_architecture/reference/environment_variables.md`
+
+---
+
+## 서비스명
+
+### 컨테이너명
+- **kebab-case**: 소문자, 하이픈 (예: `skill-slack`, `robeing-monitor`)
+
+### 서비스 ID
+- **소문자**: `rb8001`, `skill-email`
+
+**참고**: `AGENTS.md:78-81`
+
+---
+
+**업데이트**: 컨벤션 변경 시 즉시 반영
+

From 0a4edd4542a4b49f9f4f8ddc1d01a62075fb2699 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 13:35:34 +0900
Subject: [PATCH 02/17] =?UTF-8?q?docs:=20reference=20=EB=AC=B8=EC=84=9C=20?=
 =?UTF-8?q?=EB=88=84=EB=9D=BD=20=ED=95=AD=EB=AA=A9=20=EB=B3=B4=EC=99=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- API 엔드포인트: test, dm 엔드포인트 추가
- API 엔드포인트: skill-embedding, skill-publish 추가
- 인프라: skill-embedding 포트 8515, skill-publish 포트 8511 수정
- 환경변수: rb8001 추가 변수, skill-embedding, skill-publish 추가
---
 .../reference/api_endpoints.md                | 24 +++++++++++++++++++
 .../reference/environment_variables.md        | 18 ++++++++++++++
 .../reference/infrastructure.md               |  4 ++--
 3 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/book/300_architecture/reference/api_endpoints.md b/book/300_architecture/reference/api_endpoints.md
index 2480dcc..463efb4 100644
--- a/book/300_architecture/reference/api_endpoints.md
+++ b/book/300_architecture/reference/api_endpoints.md
@@ -74,6 +74,28 @@
 
 **참고**: `rb8001/app/router/slack_endpoint.py:33,70,117`
 
+### DM (Direct Message)
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/dm/send` | POST | 모든 사용자 DM 전송 |
+| `/dm/send-to-user` | POST | 특정 사용자 DM 전송 |
+| `/dm/health` | GET | 헬스체크 |
+
+**참고**: `rb8001/app/router/dm_endpoint.py:10,35,58`
+
+### Test
+| 엔드포인트 | 메서드 | 설명 |
+|-----------|--------|------|
+| `/api/test/router-message` | POST | Router 플로우 테스트 |
+| `/api/test/message` | POST | 메시지 처리 테스트 |
+| `/api/test/memory/store` | POST | 메모리 저장 테스트 |
+| `/api/test/memory/search` | POST | 메모리 검색 테스트 |
+| `/api/test/memory/stats` | GET | 메모리 통계 |
+| `/api/test/emotion` | POST | 감정 분석 테스트 |
+| `/api/test/health` | GET | 헬스체크 |
+
+**참고**: `rb8001/app/router/test_endpoint.py:29,74,110,137,165,175,200`
+
 ---
 
 ## skill-* 서비스
@@ -85,6 +107,8 @@
 | skill-slack | 8502 | `/health` | `skill-slack/README.md:23` |
 | skill-rag-file | 8508 | `/healthz`, `/api/upload`, `/api/search` | `skill-rag-file/app/main.py:60` |
 | skill-calendar | 8512 | `/health`, `/api/events` | `skill-calendar/README.md:23` |
+| skill-embedding | 8515 | `/health`, `/api/embed` | `skill-embedding/docker-compose.yml:14` |
+| skill-publish | 8511 | `/health` | `skill-publish/docker-compose.yml:9` |
 
 ---
 
diff --git a/book/300_architecture/reference/environment_variables.md b/book/300_architecture/reference/environment_variables.md
index 39692c7..be00673 100644
--- a/book/300_architecture/reference/environment_variables.md
+++ b/book/300_architecture/reference/environment_variables.md
@@ -29,6 +29,9 @@
 | `TAVILY_API_KEY` | 선택 | Tavily API 키 | `rb8001/docker-compose.yml` |
 | `USE_EMOTION_ANALYSIS` | 선택 | 감정 분석 활성화 | `true/false` |
 | `GEMINI_API_KEY` | 선택 | Gemini API 키 | - |
+| `SLACK_BOT_TOKEN` | 선택 | Slack 봇 토큰 | - |
+| `OPENAI_API_KEY` | 선택 | OpenAI API 키 | - |
+| `ANTHROPIC_API_KEY` | 선택 | Anthropic API 키 | - |
 
 ---
 
@@ -66,6 +69,21 @@
 
 **참고**: `skill_news/README.md:36-39`
 
+### skill-embedding
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `PORT` | 예 | 서비스 포트 (8515) |
+| `SERVICE_NAME` | 예 | 서비스 이름 |
+
+**참고**: `skill-embedding/docker-compose.yml:14-15`
+
+### skill-publish
+| 변수명 | 필수 | 설명 |
+|--------|------|------|
+| `PORT` | 예 | 서비스 포트 (8511) |
+
+**참고**: `skill-publish/docker-compose.yml:9`
+
 ---
 
 ## robeing-monitor
diff --git a/book/300_architecture/reference/infrastructure.md b/book/300_architecture/reference/infrastructure.md
index 772a446..d493e57 100644
--- a/book/300_architecture/reference/infrastructure.md
+++ b/book/300_architecture/reference/infrastructure.md
@@ -39,8 +39,8 @@
 | skill-slack | 8502 | HTTP | Slack 스킬 |
 | skill-rag-file | 8508 | HTTP | RAG 파일 스킬 |
 | skill-calendar | 8512 | HTTP | 캘린더 스킬 |
-| skill-embedding | 8511 | HTTP | 임베딩 스킬 |
-| skill-publish | - | HTTP | 퍼블리싱 스킬 |
+| skill-embedding | 8515 | HTTP | 임베딩 스킬 |
+| skill-publish | 8511 | HTTP | 퍼블리싱 스킬 |
 | ChromaDB | 8000 | HTTP | 벡터 DB |
 
 **참고**: `AGENTS.md:78-81`, 각 서비스 `docker-compose.yml`

From e6cdda0a230d0fba367ea5613ee7c846dc65082b Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 13:35:43 +0900
Subject: [PATCH 03/17] =?UTF-8?q?docs:=20api=5Fendpoints.md=20100=EC=A4=84?=
 =?UTF-8?q?=20=EC=9D=B4=ED=95=98=EB=A1=9C=20=EA=B0=84=EC=86=8C=ED=99=94=20?=
 =?UTF-8?q?(test=20=EC=97=94=EB=93=9C=ED=8F=AC=EC=9D=B8=ED=8A=B8=20?=
 =?UTF-8?q?=EC=9A=94=EC=95=BD)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 book/300_architecture/reference/api_endpoints.md | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/book/300_architecture/reference/api_endpoints.md b/book/300_architecture/reference/api_endpoints.md
index 463efb4..b927eec 100644
--- a/book/300_architecture/reference/api_endpoints.md
+++ b/book/300_architecture/reference/api_endpoints.md
@@ -83,18 +83,12 @@
 
 **참고**: `rb8001/app/router/dm_endpoint.py:10,35,58`
 
-### Test
+### Test (개발용)
 | 엔드포인트 | 메서드 | 설명 |
 |-----------|--------|------|
-| `/api/test/router-message` | POST | Router 플로우 테스트 |
-| `/api/test/message` | POST | 메시지 처리 테스트 |
-| `/api/test/memory/store` | POST | 메모리 저장 테스트 |
-| `/api/test/memory/search` | POST | 메모리 검색 테스트 |
-| `/api/test/memory/stats` | GET | 메모리 통계 |
-| `/api/test/emotion` | POST | 감정 분석 테스트 |
-| `/api/test/health` | GET | 헬스체크 |
+| `/api/test/*` | * | 테스트 엔드포인트 (router-message, message, memory, emotion) |
 
-**참고**: `rb8001/app/router/test_endpoint.py:29,74,110,137,165,175,200`
+**참고**: `rb8001/app/router/test_endpoint.py`
 
 ---
 

From b2bd8602398c6bc3b26c37c48d52fb055ee53d8e Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 13:36:49 +0900
Subject: [PATCH 04/17] =?UTF-8?q?docs:=20api=5Fendpoints.md=20=EC=A0=95?=
 =?UTF-8?q?=ED=99=95=ED=95=9C=20=EC=A0=95=EB=B3=B4=20=EB=B3=B5=EC=9B=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 참조 문서는 정확성과 완전성이 우선
- 모든 엔드포인트 상세 정보 포함
- 100줄 제한보다 정확한 정보 우선
---
 book/300_architecture/reference/api_endpoints.md | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/book/300_architecture/reference/api_endpoints.md b/book/300_architecture/reference/api_endpoints.md
index b927eec..c3fc019 100644
--- a/book/300_architecture/reference/api_endpoints.md
+++ b/book/300_architecture/reference/api_endpoints.md
@@ -86,9 +86,15 @@
 ### Test (개발용)
 | 엔드포인트 | 메서드 | 설명 |
 |-----------|--------|------|
-| `/api/test/*` | * | 테스트 엔드포인트 (router-message, message, memory, emotion) |
+| `/api/test/router-message` | POST | Router 플로우 테스트 |
+| `/api/test/message` | POST | 메시지 처리 테스트 |
+| `/api/test/memory/store` | POST | 메모리 저장 테스트 |
+| `/api/test/memory/search` | POST | 메모리 검색 테스트 |
+| `/api/test/memory/stats` | GET | 메모리 통계 |
+| `/api/test/emotion` | POST | 감정 분석 테스트 |
+| `/api/test/health` | GET | 헬스체크 |
 
-**참고**: `rb8001/app/router/test_endpoint.py`
+**참고**: `rb8001/app/router/test_endpoint.py:29,74,110,137,165,175,200`
 
 ---
 

From 4bf36f6abf690f20e3b33da9a1fc30c3a95b11c8 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 17:11:05 +0900
Subject: [PATCH 05/17] =?UTF-8?q?docs:=20reference=20=EB=AC=B8=EC=84=9C=20?=
 =?UTF-8?q?=EC=9E=AC=EA=B5=AC=EC=84=B1=20(=ED=95=AD=EC=83=81=EC=84=B1/?=
 =?UTF-8?q?=EC=9B=90=EC=B9=99=EB=A7=8C=20=EC=9C=A0=EC=A7=80)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 네이밍 컨벤션, 로깅 규칙, 상수 구조, 배포 패턴만 유지
- 자주 변하는 정보(포트, 엔드포인트, 환경변수 값)는 각 서비스 README 참조로 변경
- 항상성(book/)에 맞게 원칙/패턴 중심으로 정리
---
 book/300_architecture/300_README.md           |  10 --
 .../reference/api_endpoints.md                | 140 ------------------
 book/300_architecture/reference/constants.md  |  30 ++--
 .../reference/deployment_patterns.md          |  82 ++++++++++
 .../reference/deployment_pipelines.md         |  99 -------------
 .../reference/environment_variables.md        | 110 --------------
 .../reference/infrastructure.md               |  96 ------------
 .../reference/logging_rules.md                |   2 +-
 .../reference/naming_conventions.md           |   4 +-
 9 files changed, 99 insertions(+), 474 deletions(-)
 delete mode 100644 book/300_architecture/reference/api_endpoints.md
 create mode 100644 book/300_architecture/reference/deployment_patterns.md
 delete mode 100644 book/300_architecture/reference/deployment_pipelines.md
 delete mode 100644 book/300_architecture/reference/environment_variables.md
 delete mode 100644 book/300_architecture/reference/infrastructure.md

diff --git a/book/300_architecture/300_README.md b/book/300_architecture/300_README.md
index f802662..d92c78a 100644
--- a/book/300_architecture/300_README.md
+++ b/book/300_architecture/300_README.md
@@ -20,16 +20,6 @@ Part 2에서 우리는 게임 메커니즘을 활용한 설계를 소개했습
 - 360_로빙_컨테이너_경량화_전략.md
 - 370_임베딩_서비스_분리_아키텍처.md
 
-## 참조 문서 (reference/)
-개발 시 빠른 참조를 위한 정리 문서:
-- [API 엔드포인트](./reference/api_endpoints.md)
-- [인프라](./reference/infrastructure.md)
-- [환경변수](./reference/environment_variables.md)
-- [배포 파이프라인](./reference/deployment_pipelines.md)
-- [상수/설정값](./reference/constants.md)
-- [네이밍 컨벤션](./reference/naming_conventions.md)
-- [로깅 규칙](./reference/logging_rules.md)
-
 ## 핵심 메시지
 컨테이너는 몸, 기억은 영혼. 100개의 로빙이 1개의 스킬 서비스를 공유하는 효율적 아키텍처.
 
diff --git a/book/300_architecture/reference/api_endpoints.md b/book/300_architecture/reference/api_endpoints.md
deleted file mode 100644
index c3fc019..0000000
--- a/book/300_architecture/reference/api_endpoints.md
+++ /dev/null
@@ -1,140 +0,0 @@
-# API 엔드포인트 참조
-
-**작성일**: 2025-12-06
-**목적**: 개발 시 API 엔드포인트 중복/오류 방지, 빠른 참조
-
----
-
-## rb8001 (메인 서비스, 8001)
-
-### 메시지 처리
-| 엔드포인트 | 메서드 | 설명 | 인증 |
-|-----------|--------|------|------|
-| `/api/message` | POST | Gateway/Frontend 메시지 처리 | JWT 필수 |
-| `/api/feedback/chat` | POST | 채팅 피드백 (좋아요/싫어요) | JWT 필수 |
-
-**참고**: `rb8001/app/router/message_endpoint.py:26`, `rb8001/main.py:85`
-
-### LLM
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/llm/generate` | POST | 텍스트 생성 |
-| `/api/llm/summarize` | POST | 요약 |
-| `/api/llm/complete` | POST | 완성 |
-| `/api/llm/health` | GET | 헬스체크 |
-
-**참고**: `rb8001/app/router/llm_endpoint.py:28,55,93,124`
-
-### 감정 분석
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/emotion/infer` | POST | 감정 추론 |
-| `/api/emotion/timeseries` | GET | 시계열 데이터 |
-| `/api/emotion/team-insight` | GET | 팀 인사이트 |
-| `/api/emotion/process-message` | POST | 메시지 처리 |
-| `/api/emotion/health` | GET | 헬스체크 |
-
-**참고**: `rb8001/app/router/emotion_endpoint.py:75,150,188,263,303`
-
-### 기억 온톨로지
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/v1/memory/event` | POST | 사건 저장 |
-| `/api/v1/memory/recall` | POST | 회상 |
-| `/api/v1/memory/stats` | GET | 통계 |
-
-**참고**: `rb8001/app/router/memory_ontology.py:69,118,181`
-
-### Intent 리뷰
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/intent-review/queue` | GET | 큐 조회 |
-| `/api/intent-review/{item_id}/label` | PUT | 라벨 업데이트 |
-| `/api/intent-review/stats` | GET | 통계 |
-
-**참고**: `rb8001/app/router/intent_review_endpoint.py:33,58,81`
-
-### IR Deck 평가
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/ir-deck/upload` | POST | PDF 업로드 |
-| `/api/ir-deck/evaluate` | POST | 평가 시작 |
-| `/api/ir-deck/evaluation/{evaluation_id}` | GET | 평가 결과 |
-| `/api/ir-deck/chat` | POST | 채팅 |
-| `/api/ir-deck/feedback` | POST | 피드백 |
-
-**참고**: `rb8001/app/router/ir_deck.py:109,169,263,297,344`
-
-### Slack
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/slack/events` | POST | Slack 이벤트 |
-| `/slack/slash` | POST | 슬래시 명령어 |
-| `/slack/health` | GET | 헬스체크 |
-
-**참고**: `rb8001/app/router/slack_endpoint.py:33,70,117`
-
-### DM (Direct Message)
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/dm/send` | POST | 모든 사용자 DM 전송 |
-| `/dm/send-to-user` | POST | 특정 사용자 DM 전송 |
-| `/dm/health` | GET | 헬스체크 |
-
-**참고**: `rb8001/app/router/dm_endpoint.py:10,35,58`
-
-### Test (개발용)
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/api/test/router-message` | POST | Router 플로우 테스트 |
-| `/api/test/message` | POST | 메시지 처리 테스트 |
-| `/api/test/memory/store` | POST | 메모리 저장 테스트 |
-| `/api/test/memory/search` | POST | 메모리 검색 테스트 |
-| `/api/test/memory/stats` | GET | 메모리 통계 |
-| `/api/test/emotion` | POST | 감정 분석 테스트 |
-| `/api/test/health` | GET | 헬스체크 |
-
-**참고**: `rb8001/app/router/test_endpoint.py:29,74,110,137,165,175,200`
-
----
-
-## skill-* 서비스
-
-| 서비스 | 포트 | 주요 엔드포인트 | 참고 |
-|--------|------|----------------|------|
-| skill-email | 8501 | `/health` | - |
-| skill-news | 8505 | `/health` | `skill_news/README.md:30` |
-| skill-slack | 8502 | `/health` | `skill-slack/README.md:23` |
-| skill-rag-file | 8508 | `/healthz`, `/api/upload`, `/api/search` | `skill-rag-file/app/main.py:60` |
-| skill-calendar | 8512 | `/health`, `/api/events` | `skill-calendar/README.md:23` |
-| skill-embedding | 8515 | `/health`, `/api/embed` | `skill-embedding/docker-compose.yml:14` |
-| skill-publish | 8511 | `/health` | `skill-publish/docker-compose.yml:9` |
-
----
-
-## robeing-monitor (9024)
-
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/health` | GET | 헬스체크 |
-| `/api/stats/{robeing_id}` | GET/PUT | 스탯 조회/업데이트 |
-| `/api/monitor/robeings` | GET | 로빙 상태 |
-| `/api/monitor/skills` | GET | 스킬 서비스 상태 |
-
-**참고**: `robeing-monitor/README.md:68`, `robeing-monitor/app/api/monitor.py`
-
----
-
-## Gateway (8100)
-
-| 엔드포인트 | 메서드 | 설명 |
-|-----------|--------|------|
-| `/gateway/slack/events` | POST | Slack 이벤트 프록시 |
-| `/gateway/*` | * | 각 서비스 프록시 |
-
-**참고**: `AGENTS.md:88-92`
-
----
-
-**업데이트**: 서비스 추가/변경 시 즉시 반영
-
diff --git a/book/300_architecture/reference/constants.md b/book/300_architecture/reference/constants.md
index 99cf102..bb9839b 100644
--- a/book/300_architecture/reference/constants.md
+++ b/book/300_architecture/reference/constants.md
@@ -1,11 +1,11 @@
-# 상수/설정값 참조
+# 상수/설정값 구조 원칙
 
 **작성일**: 2025-12-06
 **목적**: 코드 중복 방지, 일관성 유지
 
 ---
 
-## 스킬 레벨
+## 스킬 레벨 구조
 
 | 레벨 | 스킬 | 설명 |
 |------|------|------|
@@ -25,7 +25,7 @@
 
 ---
 
-## 스킬 타입
+## 스킬 타입 구조
 
 | 타입 | 설명 | 사용 위치 |
 |------|------|-----------|
@@ -40,7 +40,7 @@
 
 ---
 
-## 감정 분류
+## 감정 분류 구조
 
 | 감정 | 설명 |
 |------|------|
@@ -56,7 +56,7 @@
 
 ---
 
-## 스탯 요구사항
+## 스탯 요구사항 구조
 
 | 스킬 | Memory | React | Compute | Empathy |
 |------|--------|-------|---------|---------|
@@ -70,7 +70,7 @@
 
 ---
 
-## HTTP 상태 코드
+## HTTP 상태 코드 사용 원칙
 
 | 코드 | 의미 | 사용 예시 |
 |------|------|-----------|
@@ -82,19 +82,17 @@
 
 ---
 
-## 로그 레벨
+## 상수 관리 원칙
 
-| 레벨 | 설명 | 사용 시점 |
-|------|------|-----------|
-| `DEBUG` | 디버그 정보 | 개발 중 |
-| `INFO` | 일반 정보 | 정상 동작 |
-| `WARNING` | 경고 | 예상 가능한 문제 |
-| `ERROR` | 오류 | 처리 실패 |
-| `CRITICAL` | 치명적 오류 | 시스템 중단 |
+### 코드에서 관리
+- 상수 값은 코드의 변수/설정으로 관리
+- 각 서비스 README.md에 현재 값 참조
 
-**참고**: `rb8001/app/core/logger.py`
+### 문서 역할
+- 구조/패턴만 문서화
+- 실제 값은 코드/README 참조
 
 ---
 
-**업데이트**: 상수 추가/변경 시 즉시 반영
+**업데이트**: 구조 변경 시 즉시 반영
 
diff --git a/book/300_architecture/reference/deployment_patterns.md b/book/300_architecture/reference/deployment_patterns.md
new file mode 100644
index 0000000..c22523e
--- /dev/null
+++ b/book/300_architecture/reference/deployment_patterns.md
@@ -0,0 +1,82 @@
+# 배포 패턴 원칙
+
+**작성일**: 2025-12-06
+**목적**: 배포 프로세스 일관성 유지
+
+---
+
+## 배포 패턴 구조
+
+### 자동 배포 패턴
+```
+로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작
+```
+
+**참고**: `AGENTS.md:83-85`
+
+### 수동 배포 패턴
+```
+서버 접속 → git pull → docker compose down && docker compose up -d --build
+```
+
+**참고**: `AGENTS.md:32`
+
+---
+
+## 워크플로우 파일 구조
+
+### 위치
+- 경로: `.gitea/workflows/*.yml`
+- 예시: `rb8001/.gitea/workflows/cicd.yml`
+
+### 공통 패턴
+1. SSH 키 설정
+2. 서버 접속
+3. git pull
+4. docker 재시작
+5. 헬스체크
+
+**참고**: 각 서비스 `.gitea/workflows/` 디렉토리
+
+---
+
+## 배포 검증 원칙
+
+### 필수 확인
+- [ ] `docker ps`로 컨테이너 실행 확인
+- [ ] 헬스체크 엔드포인트 응답 확인
+- [ ] 로그 확인
+
+**주의**: Actions 성공 메시지만 믿지 말고 실제 컨테이너 상태 확인
+
+**참고**: `AGENTS.md:30-31`
+
+---
+
+## SSH Secrets 구조
+
+| Secret 이름 | 설명 | 사용 위치 |
+|------------|------|-----------|
+| `SSH_PRIVATE_KEY_51124` | 51124 서버 SSH 키 | Gitea Actions |
+| `SSH_HOST_51124` | 51124 서버 IP | Gitea Actions |
+| `SSH_USER_51124` | SSH 사용자 | Gitea Actions |
+
+**참고**: `DOCS/journey/plans/251206_skill_calendar_자동배포_구성.md`
+
+---
+
+## 배포 패턴 모범 사례
+
+### DO
+- `set -e`로 에러 즉시 중단
+- `.env` 파일 존재 확인
+- 헬스체크 재시도 로직
+
+### DON'T
+- Actions 성공 메시지만 믿기
+- 빌드 실패 시 로그 확인 생략
+
+---
+
+**업데이트**: 패턴 변경 시 즉시 반영
+
diff --git a/book/300_architecture/reference/deployment_pipelines.md b/book/300_architecture/reference/deployment_pipelines.md
deleted file mode 100644
index 1330bf1..0000000
--- a/book/300_architecture/reference/deployment_pipelines.md
+++ /dev/null
@@ -1,99 +0,0 @@
-# 배포 파이프라인 참조
-
-**작성일**: 2025-12-06
-**목적**: 배포 프로세스 빠른 참조
-
----
-
-## 자동 배포 (Gitea Actions)
-
-### 배포 대상 서비스
-- rb8001
-- robeing-monitor
-- skill_email
-- skill_news
-- skill-rag-file
-- skill-publish
-- skill-slack
-- fluent-bit
-- frontend-customer
-- frontend-ir-valuation
-
-**참고**: `AGENTS.md:28-29`
-
-### 배포 플로우
-1. 로컬에서 코드 수정
-2. `git push origin main`
-3. Gitea Actions 자동 실행 (51123 서버)
-4. SSH로 51124 서버 접속
-5. `git pull origin main`
-6. `docker compose down && docker compose up -d --build`
-7. 헬스체크 확인
-
-**참고**: `AGENTS.md:83-85`
-
-### 워크플로우 파일 위치
-- 경로: `.gitea/workflows/*.yml`
-- 예시: `rb8001/.gitea/workflows/cicd.yml`
-
----
-
-## 수동 배포
-
-### 배포 대상 서비스
-- skill-embedding
-- skill-calendar
-
-**참고**: `AGENTS.md:29`
-
-### 배포 절차
-```bash
-cd /home/admin/ivada_project/[서비스명]
-git pull origin main
-docker compose down && docker compose up -d --build
-docker ps  # 재시작 확인
-```
-
----
-
-## 배포 검증
-
-### 필수 확인 사항
-- [ ] `docker ps`로 컨테이너 실행 확인
-- [ ] 헬스체크 엔드포인트 응답 확인
-- [ ] 로그 확인 (`docker logs [컨테이너명] --tail 50`)
-
-**주의**: Actions 성공 메시지만 믿지 말고 실제 컨테이너 상태 확인
-
-**참고**: `AGENTS.md:30-31`
-
----
-
-## SSH Secrets
-
-| Secret 이름 | 설명 | 사용 위치 |
-|------------|------|-----------|
-| `SSH_PRIVATE_KEY_51124` | 51124 서버 SSH 키 | Gitea Actions |
-| `SSH_HOST_51124` | 192.168.219.52 | Gitea Actions |
-| `SSH_USER_51124` | admin | Gitea Actions |
-
-**참고**: `DOCS/journey/plans/251206_skill_calendar_자동배포_구성.md`
-
----
-
-## 트러블슈팅
-
-### Actions 캐시 문제
-- 증상: 워크플로우 수정이 반영되지 않음
-- 해결: `/root/.cache/act/` 삭제
-- 참고: `DOCS/journey/troubleshooting/250929_actions_cache_problem.md`
-
-### SSH 인증 실패
-- 증상: "Permission denied (publickey)"
-- 해결: Gitea Secrets의 SSH 키 확인
-- 참고: `DOCS/journey/troubleshooting/250728_happybell80_nginx프록시및CI배포문제해결.md`
-
----
-
-**업데이트**: 배포 프로세스 변경 시 즉시 반영
-
diff --git a/book/300_architecture/reference/environment_variables.md b/book/300_architecture/reference/environment_variables.md
deleted file mode 100644
index be00673..0000000
--- a/book/300_architecture/reference/environment_variables.md
+++ /dev/null
@@ -1,110 +0,0 @@
-# 환경변수 참조
-
-**작성일**: 2025-12-06
-**목적**: 환경변수 중복/오류 방지, 빠른 참조
-
----
-
-## 공통 환경변수
-
-| 변수명 | 필수 | 설명 | 예시 |
-|--------|------|------|------|
-| `SERVICE_NAME` | 예 | 서비스 이름 | `skill-slack` |
-| `PORT` | 예 | 서비스 포트 | `8502` |
-| `LOG_LEVEL` | 선택 | 로그 레벨 | `INFO` |
-| `DATABASE_URL` | 예* | PostgreSQL 연결 문자열 | `postgresql://...` |
-| `JWT_SECRET_KEY` | 예* | JWT 시크릿 키 | - |
-
-*일부 서비스만 필수
-
----
-
-## rb8001
-
-| 변수명 | 필수 | 설명 | 참고 |
-|--------|------|------|------|
-| `DATABASE_URL` | 예 | PostgreSQL 연결 | `rb8001/docker-compose.yml` |
-| `JWT_SECRET_KEY` | 예 | JWT 인증 | `rb8001/app/auth.py` |
-| `NEO4J_PASSWORD` | 선택 | Neo4j 비밀번호 | `rb8001/docker-compose.yml` |
-| `TAVILY_API_KEY` | 선택 | Tavily API 키 | `rb8001/docker-compose.yml` |
-| `USE_EMOTION_ANALYSIS` | 선택 | 감정 분석 활성화 | `true/false` |
-| `GEMINI_API_KEY` | 선택 | Gemini API 키 | - |
-| `SLACK_BOT_TOKEN` | 선택 | Slack 봇 토큰 | - |
-| `OPENAI_API_KEY` | 선택 | OpenAI API 키 | - |
-| `ANTHROPIC_API_KEY` | 선택 | Anthropic API 키 | - |
-
----
-
-## skill-* 서비스
-
-### skill-slack
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `SERVICE_API_KEY` | 예 | 서비스 인증 키 |
-| `SLACK_BOT_TOKEN` | 예 | Slack 봇 토큰 |
-| `JWT_SECRET_KEY` | 예 | JWT 검증 |
-
-**참고**: `skill-slack/app/core/config.py`, `skill-slack/docker-compose.yml`
-
-### skill-rag-file
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `DATABASE_URL` | 예 | PostgreSQL 연결 |
-| `CHROMA_PORT` | 선택 | ChromaDB 포트 (기본: 8000) |
-
-**참고**: `skill-rag-file/docker-compose.yml:11`
-
-### skill-calendar
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `DATABASE_URL` | 예 | PostgreSQL 연결 (51123) |
-
-**참고**: `skill-calendar/docker-compose.yml:14`
-
-### skill-news
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `GEMINI_API_KEY` | 예 | Gemini API 키 |
-| `DATABASE_URL` | 예 | PostgreSQL 연결 |
-
-**참고**: `skill_news/README.md:36-39`
-
-### skill-embedding
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `PORT` | 예 | 서비스 포트 (8515) |
-| `SERVICE_NAME` | 예 | 서비스 이름 |
-
-**참고**: `skill-embedding/docker-compose.yml:14-15`
-
-### skill-publish
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `PORT` | 예 | 서비스 포트 (8511) |
-
-**참고**: `skill-publish/docker-compose.yml:9`
-
----
-
-## robeing-monitor
-
-| 변수명 | 필수 | 설명 |
-|--------|------|------|
-| `DATABASE_URL` | 예 | PostgreSQL 연결 |
-| `ROBEING_URLS` | 예 | 로빙 서비스 URL 목록 |
-| `SKILL_URLS` | 예 | 스킬 서비스 URL 목록 |
-
-**참고**: `robeing-monitor/README.md:37-42`
-
----
-
-## 주의사항
-
-- **민감 정보 하드코딩 금지**: API 키, 토큰, 비밀번호는 `.env` 파일에만 저장
-- **기본값 사용 금지**: 환경변수 미설정 시 명시적 에러 처리
-- **참고**: `DOCS/book/300_architecture/311_FastAPI_구조_원칙.md` 섹션 12
-
----
-
-**업데이트**: 환경변수 추가/변경 시 즉시 반영
-
diff --git a/book/300_architecture/reference/infrastructure.md b/book/300_architecture/reference/infrastructure.md
deleted file mode 100644
index d493e57..0000000
--- a/book/300_architecture/reference/infrastructure.md
+++ /dev/null
@@ -1,96 +0,0 @@
-# 인프라 참조
-
-**작성일**: 2025-12-06
-**목적**: 서버/포트/네트워크 정보 빠른 참조
-
----
-
-## 서버 구성
-
-| 서버 | IP | 역할 | 주요 서비스 |
-|------|-----|------|------------|
-| 51123 | 192.168.219.45 | 메인 서버 | nginx, Gitea, auth-server, robeing-gateway, frontend-base, PostgreSQL |
-| 51124 | 192.168.219.52 | 로빙/스킬 서버 | rb8001, robeing-monitor, skill-*, ChromaDB |
-
-**참고**: `AGENTS.md:78-81`, `DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md:27-30`
-
----
-
-## 포트 매핑
-
-### 51123 서버
-| 서비스 | 포트 | 프로토콜 | 설명 |
-|--------|------|----------|------|
-| nginx | 80, 443 | HTTP/HTTPS | 웹 서버 |
-| Gitea | 3000 | HTTP | Git 저장소 |
-| robeing-gateway | 8100 | HTTP | API 게이트웨이 |
-| frontend-base | 8000 | HTTP | 관리자 대시보드 |
-| auth-server | 9000 | HTTP | 인증 서버 |
-| PostgreSQL | 5432 | TCP | 데이터베이스 |
-| Neo4j | 7687 | TCP | 그래프 DB |
-
-### 51124 서버
-| 서비스 | 포트 | 프로토콜 | 설명 |
-|--------|------|----------|------|
-| rb8001 | 8001 | HTTP | 메인 로빙 서비스 |
-| robeing-monitor | 9024 | HTTP | 모니터링 서비스 |
-| skill-email | 8501 | HTTP | 이메일 스킬 |
-| skill-news | 8505 | HTTP | 뉴스 스킬 |
-| skill-slack | 8502 | HTTP | Slack 스킬 |
-| skill-rag-file | 8508 | HTTP | RAG 파일 스킬 |
-| skill-calendar | 8512 | HTTP | 캘린더 스킬 |
-| skill-embedding | 8515 | HTTP | 임베딩 스킬 |
-| skill-publish | 8511 | HTTP | 퍼블리싱 스킬 |
-| ChromaDB | 8000 | HTTP | 벡터 DB |
-
-**참고**: `AGENTS.md:78-81`, 각 서비스 `docker-compose.yml`
-
----
-
-## 네트워크 플로우
-
-### 배포 플로우
-```
-로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작
-```
-
-**참고**: `AGENTS.md:83-85`
-
-### Admin Dashboard 라우팅
-```
-사용자 → nginx (51123) → robeing-gateway (8100) → frontend-base (8000)
-```
-
-**참고**: `AGENTS.md:88-92`
-
-### API 프록시
-```
-Frontend → nginx (/gateway/) → Gateway (8100) → 각 서비스
-```
-
----
-
-## SSH 접속
-
-| 서버 | SSH 포트 | 사용자 | 용도 |
-|------|----------|--------|------|
-| 51124 | 51124 | admin | 배포 (Gitea Actions) |
-
-**참고**: `AGENTS.md:28-29`, Gitea Actions 워크플로우
-
----
-
-## 데이터베이스
-
-| DB | 서버 | 포트 | 데이터베이스명 | 사용자 |
-|----|------|------|---------------|--------|
-| PostgreSQL | 51123 | 5432 | main_db | robeings |
-| Neo4j | 51123 | 7687 | - | neo4j |
-| ChromaDB | 51124 | 8000 | - | - |
-
-**참고**: `DOCS/book/300_architecture/database/tables.md`
-
----
-
-**업데이트**: 서버/포트 변경 시 즉시 반영
-
diff --git a/book/300_architecture/reference/logging_rules.md b/book/300_architecture/reference/logging_rules.md
index bddcdd7..2576bd3 100644
--- a/book/300_architecture/reference/logging_rules.md
+++ b/book/300_architecture/reference/logging_rules.md
@@ -1,4 +1,4 @@
-# 로깅 규칙 참조
+# 로깅 규칙 원칙
 
 **작성일**: 2025-12-06
 **목적**: 로그 일관성 유지, 디버깅 효율성 향상
diff --git a/book/300_architecture/reference/naming_conventions.md b/book/300_architecture/reference/naming_conventions.md
index c084fc5..c9204a3 100644
--- a/book/300_architecture/reference/naming_conventions.md
+++ b/book/300_architecture/reference/naming_conventions.md
@@ -1,4 +1,4 @@
-# 네이밍 컨벤션 참조
+# 네이밍 컨벤션 원칙
 
 **작성일**: 2025-12-06
 **목적**: 코드 일관성 유지, 가독성 향상
@@ -74,7 +74,7 @@ MAX_RETRIES = 3  # 상수
 - **UPPER_SNAKE_CASE**: 대문자, 언더스코어
 - **명확한 의미**: `DATABASE_URL`, `JWT_SECRET_KEY`
 
-**참고**: `DOCS/book/300_architecture/reference/environment_variables.md`
+**참고**: 각 서비스 README.md
 
 ---
 

From 8fdf4152d613baaadd10ca3897717aaf3f44c21f Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 17:11:18 +0900
Subject: [PATCH 06/17] =?UTF-8?q?docs:=20300=5FREADME.md=EC=97=90=20refere?=
 =?UTF-8?q?nce=20=EB=AC=B8=EC=84=9C=20=EB=A7=81=ED=81=AC=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 book/300_architecture/300_README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/book/300_architecture/300_README.md b/book/300_architecture/300_README.md
index d92c78a..9ca4f43 100644
--- a/book/300_architecture/300_README.md
+++ b/book/300_architecture/300_README.md
@@ -20,6 +20,15 @@ Part 2에서 우리는 게임 메커니즘을 활용한 설계를 소개했습
 - 360_로빙_컨테이너_경량화_전략.md
 - 370_임베딩_서비스_분리_아키텍처.md
 
+## 참조 문서 (reference/)
+항상성/원칙 문서 (변하지 않는 패턴/규칙):
+- [네이밍 컨벤션](./reference/naming_conventions.md) - 파일명, 변수명, API 경로 규칙
+- [로깅 규칙](./reference/logging_rules.md) - 로그 레벨, 포맷, 보관 원칙
+- [상수/설정값 구조](./reference/constants.md) - 스킬 레벨, 타입, 감정 분류 구조
+- [배포 패턴](./reference/deployment_patterns.md) - 배포 프로세스 패턴
+
+**참고**: 자주 변하는 정보(포트, 엔드포인트, 환경변수 값)는 각 서비스 README.md 참조
+
 ## 핵심 메시지
 컨테이너는 몸, 기억은 영혼. 100개의 로빙이 1개의 스킬 서비스를 공유하는 효율적 아키텍처.
 

From f197919684ec4f781c4ba142da39a8efb09c1c23 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 17:26:31 +0900
Subject: [PATCH 07/17] =?UTF-8?q?docs:=20reference/=20=E2=86=92=20guidelin?=
 =?UTF-8?q?es/=EB=A1=9C=20=EB=94=94=EB=A0=89=ED=86=A0=EB=A6=AC=EB=AA=85=20?=
 =?UTF-8?q?=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 로빙을 만드는 데 지키고 싶은 개발 가이드라인이라는 의미 명확화
- '원칙'보다 더 구체적이고 실용적인 이름
---
 book/300_architecture/300_README.md                  | 12 ++++++------
 .../{reference => guidelines}/constants.md           |  0
 .../{reference => guidelines}/deployment_patterns.md |  0
 .../{reference => guidelines}/logging_rules.md       |  0
 .../{reference => guidelines}/naming_conventions.md  |  0
 5 files changed, 6 insertions(+), 6 deletions(-)
 rename book/300_architecture/{reference => guidelines}/constants.md (100%)
 rename book/300_architecture/{reference => guidelines}/deployment_patterns.md (100%)
 rename book/300_architecture/{reference => guidelines}/logging_rules.md (100%)
 rename book/300_architecture/{reference => guidelines}/naming_conventions.md (100%)

diff --git a/book/300_architecture/300_README.md b/book/300_architecture/300_README.md
index 9ca4f43..ccf8155 100644
--- a/book/300_architecture/300_README.md
+++ b/book/300_architecture/300_README.md
@@ -20,12 +20,12 @@ Part 2에서 우리는 게임 메커니즘을 활용한 설계를 소개했습
 - 360_로빙_컨테이너_경량화_전략.md
 - 370_임베딩_서비스_분리_아키텍처.md
 
-## 참조 문서 (reference/)
-항상성/원칙 문서 (변하지 않는 패턴/규칙):
-- [네이밍 컨벤션](./reference/naming_conventions.md) - 파일명, 변수명, API 경로 규칙
-- [로깅 규칙](./reference/logging_rules.md) - 로그 레벨, 포맷, 보관 원칙
-- [상수/설정값 구조](./reference/constants.md) - 스킬 레벨, 타입, 감정 분류 구조
-- [배포 패턴](./reference/deployment_patterns.md) - 배포 프로세스 패턴
+## 개발 가이드라인 (guidelines/)
+로빙을 만드는 데 지키고 싶은 개발 가이드라인 (변하지 않는 패턴/규칙):
+- [네이밍 컨벤션](./guidelines/naming_conventions.md) - 파일명, 변수명, API 경로 규칙
+- [로깅 규칙](./guidelines/logging_rules.md) - 로그 레벨, 포맷, 보관 원칙
+- [상수/설정값 구조](./guidelines/constants.md) - 스킬 레벨, 타입, 감정 분류 구조
+- [배포 패턴](./guidelines/deployment_patterns.md) - 배포 프로세스 패턴
 
 **참고**: 자주 변하는 정보(포트, 엔드포인트, 환경변수 값)는 각 서비스 README.md 참조
 
diff --git a/book/300_architecture/reference/constants.md b/book/300_architecture/guidelines/constants.md
similarity index 100%
rename from book/300_architecture/reference/constants.md
rename to book/300_architecture/guidelines/constants.md
diff --git a/book/300_architecture/reference/deployment_patterns.md b/book/300_architecture/guidelines/deployment_patterns.md
similarity index 100%
rename from book/300_architecture/reference/deployment_patterns.md
rename to book/300_architecture/guidelines/deployment_patterns.md
diff --git a/book/300_architecture/reference/logging_rules.md b/book/300_architecture/guidelines/logging_rules.md
similarity index 100%
rename from book/300_architecture/reference/logging_rules.md
rename to book/300_architecture/guidelines/logging_rules.md
diff --git a/book/300_architecture/reference/naming_conventions.md b/book/300_architecture/guidelines/naming_conventions.md
similarity index 100%
rename from book/300_architecture/reference/naming_conventions.md
rename to book/300_architecture/guidelines/naming_conventions.md

From 1db34dd8eabb53f28fe99ce3c6a27b39d0357921 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 17:43:19 +0900
Subject: [PATCH 08/17] =?UTF-8?q?docs:=20guidelines=EC=97=90=EC=84=9C=20?=
 =?UTF-8?q?=EA=B5=AC=EC=B2=B4=EC=A0=81=20=EA=B0=92=20=EC=A0=9C=EA=B1=B0,?=
 =?UTF-8?q?=20=EC=9B=90=EC=B9=99=EB=A7=8C=20=EC=9C=A0=EC=A7=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- constants.md: 스킬 레벨/스탯 요구사항 구체적 값 제거, 구조 원칙만 유지
- deployment_patterns.md: 구체적 배포 플로우/SSH Secrets 이름 제거, 패턴 원칙만 유지
- logging_rules.md: 구체적 경로/주소 제거, 원칙만 유지
- naming_conventions.md: 구체적 예시 제거, 원칙만 유지
- 실제 값은 각 서비스 README 참조로 변경
---
 book/300_architecture/guidelines/constants.md | 33 ++++---------
 .../guidelines/deployment_patterns.md         | 47 +++++++++----------
 .../guidelines/logging_rules.md               | 44 +++++------------
 .../guidelines/naming_conventions.md          |  6 ++-
 4 files changed, 47 insertions(+), 83 deletions(-)

diff --git a/book/300_architecture/guidelines/constants.md b/book/300_architecture/guidelines/constants.md
index bb9839b..3015e6a 100644
--- a/book/300_architecture/guidelines/constants.md
+++ b/book/300_architecture/guidelines/constants.md
@@ -5,23 +5,14 @@
 
 ---
 
-## 스킬 레벨 구조
+## 스킬 레벨 구조 원칙
 
-| 레벨 | 스킬 | 설명 |
-|------|------|------|
-| 1 | 기본 대화 | 기본 채팅 |
-| 2 | 이메일 읽기 | Gmail 읽기 |
-| 3 | Slack 대화 | Slack 연동 |
-| 4 | 이메일 전송 | Gmail 전송 |
-| 5 | 데일리 브리핑 | 뉴스 요약 |
-| 7 | 일정 관리 | 캘린더 |
-| 11 | 문서 작성/편집 | 문서 작업 |
-| 13 | 데이터 분석/차트 | 분석 |
-| 17 | 프로젝트 관리 | 프로젝트 |
-| 19 | AI 인사이트/예측 | 인사이트 |
-| 23 | 자동화 워크플로우 | 자동화 |
+- 레벨은 점진적으로 증가하는 구조
+- 낮은 레벨: 기본 기능
+- 높은 레벨: 고급 기능
+- 레벨 간격은 의미 있는 기능 차이를 반영
 
-**참고**: `DOCS/journey/troubleshooting/250830_skill_level_system_restructure.md:45-57`
+**참고**: 실제 레벨 값은 코드/README 참조, `DOCS/journey/troubleshooting/250830_skill_level_system_restructure.md`
 
 ---
 
@@ -56,15 +47,11 @@
 
 ---
 
-## 스탯 요구사항 구조
+## 스탯 요구사항 구조 원칙
 
-| 스킬 | Memory | React | Compute | Empathy |
-|------|--------|-------|---------|---------|
-| EMAIL | 10 | 5 | 5 | 5 |
-| NEWS | - | 10 | 5 | - |
-| SLACK | 15 | - | - | 10 |
-| ANALYSIS | 15 | - | 20 | - |
-| LLM | - | - | 15 | 10 |
+- 각 스킬은 Memory, React, Compute, Empathy 중 필요한 스탯만 요구
+- 스탯 요구사항은 스킬의 특성에 맞게 설계
+- 실제 값은 코드에서 관리
 
 **참고**: `rb8001/app/services/brain/decision_engine.py:560-565`
 
diff --git a/book/300_architecture/guidelines/deployment_patterns.md b/book/300_architecture/guidelines/deployment_patterns.md
index c22523e..0d7443b 100644
--- a/book/300_architecture/guidelines/deployment_patterns.md
+++ b/book/300_architecture/guidelines/deployment_patterns.md
@@ -5,38 +5,34 @@
 
 ---
 
-## 배포 패턴 구조
+## 배포 패턴 원칙
 
-### 자동 배포 패턴
-```
-로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작
-```
+### 자동 배포 원칙
+- 로컬 개발 → Git 푸시 → CI/CD 실행 → 서버 배포 → 컨테이너 재시작
+- 자동화된 배포는 일관성과 효율성 제공
 
-**참고**: `AGENTS.md:83-85`
+### 수동 배포 원칙
+- 서버 접속 → 코드 업데이트 → 컨테이너 재시작
+- 자동 배포가 불가능한 경우에만 사용
 
-### 수동 배포 패턴
-```
-서버 접속 → git pull → docker compose down && docker compose up -d --build
-```
-
-**참고**: `AGENTS.md:32`
+**참고**: `AGENTS.md:83-85,32`
 
 ---
 
-## 워크플로우 파일 구조
+## 워크플로우 파일 구조 원칙
 
 ### 위치
-- 경로: `.gitea/workflows/*.yml`
-- 예시: `rb8001/.gitea/workflows/cicd.yml`
+- CI/CD 워크플로우 파일은 표준 경로 사용
+- 각 서비스별로 독립적인 워크플로우 관리
 
 ### 공통 패턴
-1. SSH 키 설정
+1. 인증 설정
 2. 서버 접속
-3. git pull
-4. docker 재시작
-5. 헬스체크
+3. 코드 업데이트
+4. 서비스 재시작
+5. 검증
 
-**참고**: 각 서비스 `.gitea/workflows/` 디렉토리
+**참고**: 각 서비스 CI/CD 설정 참조
 
 ---
 
@@ -53,13 +49,12 @@
 
 ---
 
-## SSH Secrets 구조
+## 인증 Secrets 구조 원칙
 
-| Secret 이름 | 설명 | 사용 위치 |
-|------------|------|-----------|
-| `SSH_PRIVATE_KEY_51124` | 51124 서버 SSH 키 | Gitea Actions |
-| `SSH_HOST_51124` | 51124 서버 IP | Gitea Actions |
-| `SSH_USER_51124` | SSH 사용자 | Gitea Actions |
+- SSH 키: 서버 접속 인증
+- 호스트 정보: 배포 대상 서버
+- 사용자 정보: 서버 접속 사용자
+- 실제 Secret 이름은 CI/CD 설정 참조
 
 **참고**: `DOCS/journey/plans/251206_skill_calendar_자동배포_구성.md`
 
diff --git a/book/300_architecture/guidelines/logging_rules.md b/book/300_architecture/guidelines/logging_rules.md
index 2576bd3..0cb4153 100644
--- a/book/300_architecture/guidelines/logging_rules.md
+++ b/book/300_architecture/guidelines/logging_rules.md
@@ -37,51 +37,31 @@ logger.info(f"User {user_id} authenticated", extra={
 
 ---
 
-## 로그 위치
+## 로그 위치 원칙
 
-### 컨테이너 내부
-- 경로: `/code/logs/[서비스명].log`
-- 예시: `/code/logs/rb8001.log`
-
-### 호스트 (백업)
-- 경로: `/mnt/51123logs/[서비스명]/`
-- 백업 시간: 매일 03:00
+- 컨테이너 내부: 서비스별 로그 파일 분리
+- 호스트 백업: 정기적 백업 (일별 스케줄)
+- 실제 경로는 각 서비스 README 참조
 
 **참고**: `AGENTS.md:133-137`
 
 ---
 
-## 로그 확인 방법
+## 로그 확인 원칙
 
-### 실시간 로그
-```bash
-docker logs [컨테이너명] --tail 100
-```
-
-### 파일 로그
-```bash
-tail -f /code/logs/[서비스명].log
-```
-
-### 에러 필터링
-```bash
-docker logs [컨테이너명] | grep -iE "error|warn|fail"
-```
+- 실시간 로그: Docker 로그 명령어 사용
+- 파일 로그: 로그 파일 직접 확인
+- 에러 필터링: grep으로 에러/경고 필터링
 
 **참고**: `AGENTS.md:133-137`
 
 ---
 
-## 로그 보관
+## 로그 보관 원칙
 
-### Docker JSON 로그
-- 위치: `/var/lib/docker/containers/*/json.log`
-- 권한: sudo 필요
-
-### OpenSearch
-- 주소: http://192.168.219.45:9200
-- 인덱스: `dataprepper-static` (서비스 로그)
-- 일별 인덱스: `dataprepper-YYYY.MM.DD` (fluent-bit 로그)
+- Docker JSON 로그: 컨테이너별 자동 생성
+- 중앙 집중 로그: OpenSearch 등 외부 시스템 활용
+- 실제 주소/인덱스는 각 서비스 README 참조
 
 **참고**: `AGENTS.md:137-142`
 
diff --git a/book/300_architecture/guidelines/naming_conventions.md b/book/300_architecture/guidelines/naming_conventions.md
index c9204a3..bebc4cb 100644
--- a/book/300_architecture/guidelines/naming_conventions.md
+++ b/book/300_architecture/guidelines/naming_conventions.md
@@ -81,10 +81,12 @@ MAX_RETRIES = 3  # 상수
 ## 서비스명
 
 ### 컨테이너명
-- **kebab-case**: 소문자, 하이픈 (예: `skill-slack`, `robeing-monitor`)
+- **kebab-case**: 소문자, 하이픈 사용
+- 실제 이름은 각 서비스 README 참조
 
 ### 서비스 ID
-- **소문자**: `rb8001`, `skill-email`
+- **소문자**: 일관된 형식 유지
+- 실제 ID는 각 서비스 README 참조
 
 **참고**: `AGENTS.md:78-81`
 

From 73f5ffe8345bd80af47e3ffce40f05b07d0ce193 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 17:54:07 +0900
Subject: [PATCH 09/17] =?UTF-8?q?docs:=20=EA=B0=9C=EB=B0=9C=20=EA=B3=BC?=
 =?UTF-8?q?=EC=A0=95=EC=97=90=EC=84=9C=20=EB=AC=B8=EC=84=9C=20=EC=A0=95?=
 =?UTF-8?q?=EB=A6=AC=20=EC=9B=90=EC=B9=99=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 기능 개발 시 문서화 흐름 (scenarios → plans → troubleshooting → README → book → AGENTS.md)
- 문서 역할 구분 (항상성 vs 진화 vs 현재 상태 vs 룰)
- Journey 내부 흐름 명시
- 312_문서_작성_원칙.md 섹션 8로 추가
---
 .../312_문서_작성_원칙.md               | 58 ++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/book/300_architecture/312_문서_작성_원칙.md b/book/300_architecture/312_문서_작성_원칙.md
index 2fe7e39..125c980 100644
--- a/book/300_architecture/312_문서_작성_원칙.md
+++ b/book/300_architecture/312_문서_작성_원칙.md
@@ -207,7 +207,63 @@
 
 ---
 
-## 8. 참고 문서
+## 8. 개발 과정에서 문서 정리 원칙
+
+### 기능 개발 시 문서화 흐름
+
+새로운 기능을 만들 때 다음 순서로 문서를 작성/업데이트합니다:
+
+1. **`journey/scenarios/`**: UX 시나리오 작성 (만들기 전)
+   - 사용자 경험 관점에서 기능 정의
+   - "어떤 기능을 만들지" 먼저 정의
+
+2. **`journey/plans/`**: 구현 계획 작성 (만들기 전)
+   - 아키텍처/Phase/필요작업만
+   - 구현 완료 시 `troubleshooting/`으로 이동
+
+3. **`journey/troubleshooting/`**: 구현 과정 기록 (만들면서/만든 후)
+   - 문제 해결, 교훈, 테스트 결과
+   - 하나의 파일에 통합 (시나리오/테스트/리포트 별도 파일 금지)
+
+4. **서비스 README.md**: 핵심 사항 업데이트 (만든 후)
+   - 엔드포인트, 환경변수, 사용 방법
+   - 자주 변하는 구체적 정보
+
+5. **`book/`**: 원칙 변경 시 업데이트 (필요시)
+   - 아키텍처 원칙이 바뀌면 반영
+   - `guidelines/`에 개발 가이드라인 추가/수정
+
+6. **`AGENTS.md`**: 개발 원칙/운영 규칙 변경 시 업데이트 (필요시)
+   - 새로운 작업 규칙이 생기면 반영
+
+### 문서 역할 구분
+
+| 문서 종류 | 역할 | 변경 빈도 |
+|----------|------|----------|
+| `book/` | 항상성, 원칙, 철학 | 거의 변하지 않음 |
+| `journey/` | 진화 과정 (scenarios → ideas → research → plans → troubleshooting) | 계속 추가됨 |
+| 서비스 README.md | 현재 상태 (포트, 엔드포인트, 환경변수) | 자주 변함 |
+| `AGENTS.md` | 개발자별 룰, 운영 규칙 | 필요시 변경 |
+
+### Journey 내부 흐름
+
+```
+scenarios/ (UX 정의)
+    ↓
+ideas/ (아이디어 탐색)
+    ↓
+research/ (이론적 기반)
+    ↓
+plans/ (구현 계획)
+    ↓
+troubleshooting/ (실제 구현)
+```
+
+**참고**: 각 단계는 필수가 아니며, 필요에 따라 생략 가능
+
+---
+
+## 9. 참고 문서
 
 - AGENTS.md: 전체 개발 가이드
 - 311_FastAPI_구조_원칙.md: 코드 구조 원칙

From 17cd0e34b437bf02075eb4c4291e34c035df0c80 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Sat, 6 Dec 2025 18:04:09 +0900
Subject: [PATCH 10/17] =?UTF-8?q?docs:=20=EA=B5=AC=EC=A1=B0=ED=99=94?=
 =?UTF-8?q?=EB=90=9C=20=EC=A0=95=EB=B3=B4=20=ED=98=95=EC=8B=9D=20=EC=9B=90?=
 =?UTF-8?q?=EC=B9=99=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 표, 파일명:줄번호, 명확한 키워드 사용 권장
- JSON/XML 같은 기계적 형식 금지 명시
- AI와 사람 모두 읽기 좋은 구조화 원칙 추가
---
 book/300_architecture/312_문서_작성_원칙.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/book/300_architecture/312_문서_작성_원칙.md b/book/300_architecture/312_문서_작성_원칙.md
index 125c980..0ff2dec 100644
--- a/book/300_architecture/312_문서_작성_원칙.md
+++ b/book/300_architecture/312_문서_작성_원칙.md
@@ -68,6 +68,18 @@
 - 관련 정보는 링크로 참조 (중복 작성 금지)
 - **같은 내용인 경우 새로운 파일 생성하지 말고 기존 파일 수정하여 깔끔하게 정리**
 
+### 구조화된 정보 형식 (AI/사람 모두 읽기 좋게)
+
+**권장 형식**:
+- **표**: 비교, 목록, 역할 구분 등 구조화된 정보 표현
+- **파일명:줄번호**: 코드 위치 명확히 참조
+- **명확한 키워드**: 검색 가능하도록 핵심 단어 명시
+- **목록/부제목**: 정보 계층 구조화
+
+**금지 형식**:
+- JSON/XML 같은 기계적 형식 (사람이 읽기 어려움)
+- 암호화된 코드나 해시값 직접 노출
+
 ### 절대 금지 사항
 
 | 금지 | 이유 |

From 2c8cf707d2609f2ef6ed398ab36f02b80814cfde Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 15:06:09 +0900
Subject: [PATCH 11/17] =?UTF-8?q?docs:=20=EC=9D=BC=EA=B8=B0=20=EC=A0=80?=
 =?UTF-8?q?=EC=9E=A5=20=EA=B2=BD=EB=A1=9C=EB=A5=BC=20journey/diary/rb8001/?=
 =?UTF-8?q?yymmdd=5F=EC=A3=BC=EC=A0=9C.md=20=ED=98=95=EC=8B=9D=EC=9C=BC?=
 =?UTF-8?q?=EB=A1=9C=20=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- book은 원칙/철학 중심, journey는 진화 과정 중심 원칙 반영
- 로빙별 구분으로 확장성 확보
- 파일명에 날짜 포함으로 정렬/검색 용이
---
 journey/plans/251117_claude_robeing_diary_시스템_계획.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/journey/plans/251117_claude_robeing_diary_시스템_계획.md b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
index f5ae26c..69b220b 100644
--- a/journey/plans/251117_claude_robeing_diary_시스템_계획.md
+++ b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
@@ -47,7 +47,7 @@
 
 ### 3. 저장
 - **DB**: `robeing_diary(date, robeing_id, summary, dominant_emotion, stats JSONB)`
-- **파일**: `/logs/diary/YYYY/MM/robeing_diary_YYYY-MM-DD.md`
+- **파일**: `DOCS/journey/diary/rb8001/yymmdd_오늘주제.md` (예: `251209_오늘의_성장.md`)
 
 ### 4. 조회
 - 1단계: 서버에서 md 파일 직접 조회

From 98af2b019bdd63b42c95e085ccdfd9d3ee174342 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 16:10:30 +0900
Subject: [PATCH 12/17] =?UTF-8?q?docs:=20=EB=A1=9C=EB=B9=99=20=EC=9D=BC?=
 =?UTF-8?q?=EA=B8=B0=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20=EA=B3=84=ED=9A=8D=20?=
 =?UTF-8?q?=EC=83=81=EC=84=B8=ED=99=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- activity_log 테이블 추가 (스킬 실행 자동 기록)
- 생성 시간 오전 2시/3시로 변경
- DB만 저장 + API 동적 생성 방식으로 변경
- 관리자 대시보드 상세 추가
- 전날 00:00~23:59:59 시간 범위 명시
- 모든 활동 기록 목적 명확화
---
 ...7_claude_robeing_diary_시스템_계획.md | 54 ++++++++++++-------
 1 file changed, 35 insertions(+), 19 deletions(-)

diff --git a/journey/plans/251117_claude_robeing_diary_시스템_계획.md b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
index 69b220b..54d4f65 100644
--- a/journey/plans/251117_claude_robeing_diary_시스템_계획.md
+++ b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
@@ -27,31 +27,44 @@
 
 ## 요구사항
 
-1. **자동 생성**: 하루/세션 단위 자동 일기 생성
-2. **감정 반영**: 주요 감정, 감정 변화 요약
-3. **문제 정리**: 장애/실패/리뷰 큐 기반 "배운 점" 서술
-4. **저장**: 마크다운 파일 + DB (robeing_diary 테이블)
-5. **조회**: 운영자 md 파일 조회, 향후 대시보드 확장
+1. **자동 생성**: 매일 오전 2시 또는 3시에 전날(00:00~23:59:59) 일기 자동 생성
+2. **모든 활동 기록**: 사용자 대화, 자동 스킬 실행(이메일 요약, 뉴스 게시, 브리핑 등), 스케줄러 작업, 에러/경고 로그 포함
+3. **감정 반영**: 주요 감정, 감정 변화 요약
+4. **문제 정리**: 장애/실패/리뷰 큐 기반 "배운 점" 서술
+5. **저장**: DB만 저장 (robeing_diary 테이블), 조회 시 API로 마크다운 동적 생성
+6. **조회**: 관리자 대시보드 일기 목록/상세 페이지, 선택적으로 DOCS 동기화
 
 ---
 
 ## 아키텍처
 
 ### 1. 데이터 수집
-- rb8001의 대화/감정/리뷰 큐/에러 로그 집계
-- Diary Aggregator 함수
+- **대화 데이터**: `conversation_log` (사용자 대화, intent, confidence)
+- **활동 데이터**: `activity_log` (자동 스킬 실행: 이메일 요약, 뉴스 게시, 브리핑 등)
+- **감정 데이터**: `emotion_readings` (감정 변화, 지배적 감정, 엔트로피)
+- **성장 데이터**: `robeing` 테이블 (스탯, 경험치, 레벨업)
+- **문제 데이터**: `intent_review_queue` (리뷰 이슈), 애플리케이션 로그 (ERROR/WARNING)
+- **시간 범위**: 전날 00:00:00 ~ 23:59:59
+- **Diary Aggregator 함수**: 모든 데이터 집계
 
-### 2. 요약·서술
+### 2. 활동 로그 기록
+- 스킬 실행 시 자동으로 `activity_log` 테이블에 기록 (스킬명, 실행 시간, 결과, 에러 발생 여부)
+- 모든 로빙 활동을 추적하여 일기 집계에 포함
+
+### 3. 요약·서술
 - 구조화 데이터(JSON) → 일기 텍스트
 - 템플릿 + LLM 조합
+- 섹션: "오늘 한 일", "감정 상태", "문제와 배운 점", "내일 계획"
 
-### 3. 저장
-- **DB**: `robeing_diary(date, robeing_id, summary, dominant_emotion, stats JSONB)`
-- **파일**: `DOCS/journey/diary/rb8001/yymmdd_오늘주제.md` (예: `251209_오늘의_성장.md`)
+### 4. 저장
+- **DB**: `robeing_diary(date, robeing_id, summary, dominant_emotion, stats JSONB, full_content TEXT)`
+- **파일**: 저장하지 않음 (API로 동적 생성)
+- **로빙별 구분**: `robeing_id` 컬럼으로 각 로빙별 일기 관리
 
-### 4. 조회
-- 1단계: 서버에서 md 파일 직접 조회
-- 2단계: 관리자 대시보드 일기 목록/상세 보기
+### 5. 조회
+- **API**: rb8001에 `/api/diary/{date}` 엔드포인트 추가 (DB 조회 후 마크다운 동적 생성)
+- **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
+- **DOCS 동기화**: 선택적으로 별도 스크립트로 `DOCS/journey/diary/rb8001/yymmdd_주제.md`에 주기적 동기화
 
 ---
 
@@ -77,11 +90,14 @@
 
 ## 구현 단계
 
-1. Diary Aggregator 스키마 정의
-2. TDD 테스트 작성
-3. 집계 로직 + md 템플릿 구현
-4. DB/파일 저장 연결
-5. 스케줄러 등록 (매일 자정)
+1. **DB 테이블 생성**: `robeing_diary` 테이블, `activity_log` 테이블 생성
+2. **활동 로그 기록**: 스킬 실행 시 `activity_log`에 자동 기록 로직 추가
+3. **Diary Aggregator 구현**: 모든 데이터 소스 집계 로직 구현
+4. **일기 생성 로직**: LLM으로 일기 텍스트 생성, `robeing_diary`에 저장
+5. **API 엔드포인트**: rb8001에 `/api/diary/{date}` 추가 (마크다운 동적 생성)
+6. **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
+7. **스케줄러 등록**: 매일 오전 2시 또는 3시에 전날 일기 생성
+8. **DOCS 동기화 스크립트**: 선택적으로 별도 스크립트로 DOCS 동기화
 
 ---
 

From 7d5382baeaa02dc2a1db2508112414d3c86494c8 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 16:13:38 +0900
Subject: [PATCH 13/17] =?UTF-8?q?docs:=20=EB=A1=9C=EB=B9=99=20=EC=9D=BC?=
 =?UTF-8?q?=EA=B8=B0=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20UX=20=EC=8B=9C?=
 =?UTF-8?q?=EB=82=98=EB=A6=AC=EC=98=A4=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 자동 생성, 운영자 조회, 활동 로그 기록, DOCS 동기화 시나리오
- 문서 작성 원칙 준수 (간결, 핵심만)
---
 ...7_claude_robeing_diary_시스템_계획.md | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/journey/plans/251117_claude_robeing_diary_시스템_계획.md b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
index 54d4f65..63a63f3 100644
--- a/journey/plans/251117_claude_robeing_diary_시스템_계획.md
+++ b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
@@ -101,6 +101,28 @@
 
 ---
 
+## UX 시나리오
+
+### 1. 자동 생성 (매일 오전 2시 또는 3시)
+- rb8001이 전날(00:00~23:59:59) 데이터 집계
+- `conversation_log`, `activity_log`, `emotion_readings`, `robeing`, `intent_review_queue`, 애플리케이션 로그 수집
+- LLM으로 일기 생성 후 `robeing_diary` 테이블에 저장
+
+### 2. 운영자 조회 (관리자 대시보드)
+- `https://ro-being.com/admin/diary` 접속
+- 일기 목록 페이지: 날짜별 목록(최신순, 로빙별 필터)
+- 상세 페이지: `/api/diary/{date}` 호출 → 마크다운 렌더링
+- 필터/검색: 감정, 키워드, 로빙별
+
+### 3. 활동 로그 기록
+- 스킬 실행 시 `activity_log` 테이블에 자동 기록
+- 일기 집계 시 "오늘 한 일" 섹션에 포함
+
+### 4. DOCS 동기화 (선택적)
+- 별도 스크립트로 `DOCS/journey/diary/rb8001/yymmdd_주제.md`에 주기적 동기화
+
+---
+
 ## 참고
 
 - `book/600_appendix/610_로빙_성장_일지_예시.md`

From da0049ad4177f7d08a7974bba087ffcedcd07104 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 16:20:42 +0900
Subject: [PATCH 14/17] =?UTF-8?q?docs:=20=EB=A1=9C=EB=B9=99=20=EC=9D=BC?=
 =?UTF-8?q?=EA=B8=B0=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20=EA=B5=AC=ED=98=84=20?=
 =?UTF-8?q?=EC=83=81=EC=84=B8=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DB 테이블 스키마 (robeing_diary, activity_log)
- 스킬 실행 로그 기록 위치/방법
- API 엔드포인트 요청/응답 형식
- 스케줄러 등록 방법
- LLM 프롬프트 템플릿 구조
- 구현 단계별 파일 위치 명시
- 기존 코드 참고 링크 추가
---
 ...7_claude_robeing_diary_시스템_계획.md | 104 +++++++++++++++++-
 1 file changed, 98 insertions(+), 6 deletions(-)

diff --git a/journey/plans/251117_claude_robeing_diary_시스템_계획.md b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
index 63a63f3..20fb36c 100644
--- a/journey/plans/251117_claude_robeing_diary_시스템_계획.md
+++ b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
@@ -88,15 +88,107 @@
 
 ---
 
+## 구현 상세
+
+### DB 테이블 스키마
+
+**robeing_diary 테이블**:
+```sql
+CREATE TABLE robeing_diary (
+    id SERIAL PRIMARY KEY,
+    date DATE NOT NULL,
+    robeing_id VARCHAR(50) NOT NULL,
+    summary TEXT,
+    dominant_emotion VARCHAR(50),
+    stats JSONB DEFAULT '{}',
+    full_content TEXT NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(date, robeing_id)
+);
+CREATE INDEX idx_robeing_diary_date ON robeing_diary(date DESC);
+CREATE INDEX idx_robeing_diary_robeing ON robeing_diary(robeing_id);
+```
+
+**activity_log 테이블**:
+```sql
+CREATE TABLE activity_log (
+    id SERIAL PRIMARY KEY,
+    robeing_id VARCHAR(50) NOT NULL,
+    activity_type VARCHAR(50) NOT NULL,  -- 'skill', 'scheduler', 'internal'
+    skill_name VARCHAR(100),
+    status VARCHAR(20) NOT NULL,  -- 'success', 'error', 'partial'
+    result_summary TEXT,
+    error_message TEXT,
+    metadata JSONB DEFAULT '{}',
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX idx_activity_log_robeing_date ON activity_log(robeing_id, created_at DESC);
+CREATE INDEX idx_activity_log_type ON activity_log(activity_type);
+```
+
+**참고**: `rb8001/app/state/database.py:44-57` (ConversationLog 모델), `rb8001/app/models/intent_review_model.py:11-32` (IntentReviewQueue 모델)
+
+### 스킬 실행 로그 기록
+
+**위치**: 스킬 실행 래퍼 함수 또는 미들웨어
+- `rb8001/app/services/skills/` 내 각 스킬의 `handle()` 메서드 시작/종료 시 기록
+- 또는 `rb8001/app/router/router.py`의 스킬 호출 부분에 데코레이터/미들웨어 추가
+
+**기록 내용**: 스킬명, 실행 시간, 결과(success/error), 에러 메시지(있을 경우), 메타데이터
+
+### API 엔드포인트
+
+**rb8001**: `GET /api/diary/{date}?robeing_id=rb8001`
+- 요청: `date` (YYYY-MM-DD), `robeing_id` (선택, 기본값: rb8001)
+- 응답: `{"date": "2025-12-09", "robeing_id": "rb8001", "content": "# 로빙 일기...", "summary": "...", "dominant_emotion": "happiness"}`
+- 구현 위치: `rb8001/app/router/diary.py` (새 파일) 또는 `rb8001/app/router/router.py`
+
+**참고**: `rb8001/app/state/state_service.py:179-207` (conversation 로그 API 패턴)
+
+### 스케줄러 등록
+
+**위치**: `rb8001/main.py:146-195` (startup_event 함수)
+- `rb8001/app/scheduler/jobs/diary_generator.py` 생성
+- `scheduler.add_job(diary_generator.generate_diary, 'cron', hour=2, minute=0, id='daily_diary')` 등록
+
+**참고**: `rb8001/app/scheduler/jobs/naverworks_briefing.py` (스케줄러 작업 예시)
+
+### LLM 프롬프트 템플릿
+
+**입력**: 집계된 데이터 (JSON)
+**출력**: 마크다운 형식 일기
+**템플릿 구조**:
+```
+다음 데이터를 바탕으로 로빙의 하루 일기를 작성하세요:
+- 대화: {conversations_summary}
+- 활동: {activities_summary}
+- 감정: {emotions_summary}
+- 문제: {issues_summary}
+- 성장: {growth_summary}
+
+형식:
+# 로빙 일기 – {date}
+## 오늘 한 일
+...
+## 감정 상태
+...
+## 문제와 배운 점
+...
+## 내일 계획
+...
+```
+
+---
+
 ## 구현 단계
 
-1. **DB 테이블 생성**: `robeing_diary` 테이블, `activity_log` 테이블 생성
+1. **DB 테이블 생성**: `robeing_diary`, `activity_log` 테이블 생성 스크립트 작성
 2. **활동 로그 기록**: 스킬 실행 시 `activity_log`에 자동 기록 로직 추가
-3. **Diary Aggregator 구현**: 모든 데이터 소스 집계 로직 구현
-4. **일기 생성 로직**: LLM으로 일기 텍스트 생성, `robeing_diary`에 저장
-5. **API 엔드포인트**: rb8001에 `/api/diary/{date}` 추가 (마크다운 동적 생성)
-6. **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
-7. **스케줄러 등록**: 매일 오전 2시 또는 3시에 전날 일기 생성
+3. **Diary Aggregator 구현**: `rb8001/app/services/diary/aggregator.py` 생성, 모든 데이터 소스 집계
+4. **일기 생성 로직**: `rb8001/app/services/diary/generator.py` 생성, LLM으로 일기 텍스트 생성
+5. **스케줄러 등록**: `rb8001/app/scheduler/jobs/diary_generator.py` 생성, `main.py`에 등록
+6. **API 엔드포인트**: `rb8001/app/router/diary.py` 생성, `/api/diary/{date}` 구현
+7. **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
 8. **DOCS 동기화 스크립트**: 선택적으로 별도 스크립트로 DOCS 동기화
 
 ---

From b846fb9980228f0e4650521c9bb3f0e9ce0991ae Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 16:41:16 +0900
Subject: [PATCH 15/17] =?UTF-8?q?docs:=20=EB=A1=9C=EB=B9=99=20=EC=9D=BC?=
 =?UTF-8?q?=EA=B8=B0=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20=EC=A7=84=ED=96=89=20?=
 =?UTF-8?q?=EC=83=81=ED=99=A9=20=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DB 테이블 및 Repository 구현 완료 표시
- 진행 상황 섹션 추가
- 구현 단계 체크리스트 업데이트
---
 ...7_claude_robeing_diary_시스템_계획.md | 25 +++++++++++++------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/journey/plans/251117_claude_robeing_diary_시스템_계획.md b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
index 20fb36c..8367a6f 100644
--- a/journey/plans/251117_claude_robeing_diary_시스템_계획.md
+++ b/journey/plans/251117_claude_robeing_diary_시스템_계획.md
@@ -182,14 +182,23 @@ CREATE INDEX idx_activity_log_type ON activity_log(activity_type);
 
 ## 구현 단계
 
-1. **DB 테이블 생성**: `robeing_diary`, `activity_log` 테이블 생성 스크립트 작성
-2. **활동 로그 기록**: 스킬 실행 시 `activity_log`에 자동 기록 로직 추가
-3. **Diary Aggregator 구현**: `rb8001/app/services/diary/aggregator.py` 생성, 모든 데이터 소스 집계
-4. **일기 생성 로직**: `rb8001/app/services/diary/generator.py` 생성, LLM으로 일기 텍스트 생성
-5. **스케줄러 등록**: `rb8001/app/scheduler/jobs/diary_generator.py` 생성, `main.py`에 등록
-6. **API 엔드포인트**: `rb8001/app/router/diary.py` 생성, `/api/diary/{date}` 구현
-7. **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
-8. **DOCS 동기화 스크립트**: 선택적으로 별도 스크립트로 DOCS 동기화
+1. ✅ **DB 테이블 생성**: `robeing_diary`, `activity_log` 테이블 생성 완료 (`rb8001/app/state/diary_repository.py`)
+2. ⏳ **활동 로그 기록**: 스킬 실행 시 `activity_log`에 자동 기록 로직 추가
+3. ⏳ **Diary Aggregator 구현**: `rb8001/app/services/diary/aggregator.py` 생성, 모든 데이터 소스 집계
+4. ⏳ **일기 생성 로직**: `rb8001/app/services/diary/generator.py` 생성, LLM으로 일기 텍스트 생성
+5. ⏳ **스케줄러 등록**: `rb8001/app/scheduler/jobs/diary_generator.py` 생성, `main.py`에 등록
+6. ⏳ **API 엔드포인트**: `rb8001/app/router/diary.py` 생성, `/api/diary/{date}` 구현
+7. ⏳ **관리자 대시보드**: admin-dashboard에 일기 목록/상세 페이지 추가
+8. ⏳ **DOCS 동기화 스크립트**: 선택적으로 별도 스크립트로 DOCS 동기화
+
+## 진행 상황
+
+**완료 (2025-12-09)**:
+- DB 테이블 스키마 정의 및 생성 (`_ensure_tables()`)
+- Repository 함수 구현 (`save_diary`, `get_diary`, `save_activity_log`)
+- 테스트 완료 (더미 데이터 저장/조회 검증)
+
+**다음 단계**: Diary Aggregator 및 일기 생성 로직 구현
 
 ---
 

From ccc4d13a907fd041036954d6045c236f4fd5199a Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 16:43:51 +0900
Subject: [PATCH 16/17] =?UTF-8?q?docs:=20=EC=9D=BC=EA=B8=B0=20=EC=8B=9C?=
 =?UTF-8?q?=EC=8A=A4=ED=85=9C=20=ED=85=8C=EC=9D=B4=EB=B8=94=20=EC=A0=95?=
 =?UTF-8?q?=EB=B3=B4=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- robeing_diary 테이블 스키마 추가
- activity_log 테이블 스키마 추가
- 인덱스 및 제약조건 명시
---
 book/300_architecture/database/tables.md | 40 ++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/book/300_architecture/database/tables.md b/book/300_architecture/database/tables.md
index f00eb0b..4644e9f 100644
--- a/book/300_architecture/database/tables.md
+++ b/book/300_architecture/database/tables.md
@@ -222,6 +222,46 @@ SemanticIntentClassifier는 위 테이블에서 활성화된 의도를 불러오
 
 **인덱스**:
 - `rb_news_pkey`: PRIMARY KEY (id)
+
+### robeing_diary
+- **용도**: 로빙 일기(성장 일지) 저장
+- **Primary Key**: id (INTEGER)
+
+| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
+|--------|------|------|--------|------|
+| id | INTEGER | NO | | PK, SERIAL |
+| date | DATE | NO | | 일기 날짜 |
+| robeing_id | VARCHAR(50) | NO | | 로빙 식별자 |
+| summary | TEXT | YES | | 일기 요약 |
+| dominant_emotion | VARCHAR(50) | YES | | 지배적 감정 |
+| stats | JSONB | YES | '{}' | 통계 데이터 |
+| full_content | TEXT | NO | | 전체 일기 내용 (마크다운) |
+| created_at | TIMESTAMPTZ | YES | NOW() | 생성 시간 |
+
+**인덱스**:
+- `idx_robeing_diary_date`: (date DESC)
+- `idx_robeing_diary_robeing`: (robeing_id)
+- UNIQUE: (date, robeing_id)
+
+### activity_log
+- **용도**: 로빙 활동 로그 (스킬 실행, 스케줄러 작업 등)
+- **Primary Key**: id (INTEGER)
+
+| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
+|--------|------|------|--------|------|
+| id | INTEGER | NO | | PK, SERIAL |
+| robeing_id | VARCHAR(50) | NO | | 로빙 식별자 |
+| activity_type | VARCHAR(50) | NO | | 'skill', 'scheduler', 'internal' |
+| skill_name | VARCHAR(100) | YES | | 스킬명 (activity_type='skill'일 때) |
+| status | VARCHAR(20) | NO | | 'success', 'error', 'partial' |
+| result_summary | TEXT | YES | | 결과 요약 |
+| error_message | TEXT | YES | | 에러 메시지 (status='error'일 때) |
+| meta | JSONB | YES | '{}' | 메타데이터 |
+| created_at | TIMESTAMPTZ | YES | NOW() | 생성 시간 |
+
+**인덱스**:
+- `idx_activity_log_robeing_date`: (robeing_id, created_at DESC)
+- `idx_activity_log_type`: (activity_type)
 - `rb_news_url_key`: UNIQUE (url)
 - `idx_rb_news_url`: btree (url)
 - `idx_rb_news_slack_message_ts`: btree (slack_message_ts)

From 8e01c3d2726ca6396eaa7893300c3bea6cb39bf6 Mon Sep 17 00:00:00 2001
From: Claude-51124 <claude@51124.local>
Date: Tue, 9 Dec 2025 17:10:57 +0900
Subject: [PATCH 17/17] docs: add rb8001 calendar intent overlap plan

---
 ...209_rb8001_calendar_intent_overlap_plan.md | 82 +++++++++++++++++++
 1 file changed, 82 insertions(+)
 create mode 100644 journey/plans/251209_rb8001_calendar_intent_overlap_plan.md

diff --git a/journey/plans/251209_rb8001_calendar_intent_overlap_plan.md b/journey/plans/251209_rb8001_calendar_intent_overlap_plan.md
new file mode 100644
index 0000000..78e2276
--- /dev/null
+++ b/journey/plans/251209_rb8001_calendar_intent_overlap_plan.md
@@ -0,0 +1,82 @@
+# rb8001 캘린더 조회/생성 의도 경계 세부 설계
+
+**날짜**: 2025-12-09
+**목표**: calendar_query vs calendar_event 경계 케이스를 UX/TDD 기준으로 명확히 정의하고, 3단계 의도 아키텍처와 일관되게 구현한다.
+
+---
+
+## 1. 현재 상태 정리
+
+- FastPath 정규식이 `calendar_query`를 `calendar_event`보다 우선 매칭하여, 조회·생성이 섞인 문장도 대부분 `calendar_query`로 고정됨.  
+  - 의도 패턴: `rb8001/app/services/brain/decision_engine.py:120-180`
+- 3단계 의도 파이프라인(Goal → ActionPlan → SkillSequence)은 도입되었지만, 캘린더 조회/생성 경계에는 아직 적극적으로 사용되지 않음.  
+  - 메타데이터 파이프라인: `rb8001/app/services/brain/decision_engine.py:540-629`
+- 기존 캘린더 테스트는 조회 vs 생성 분리, all-day 파싱, 승인 플로우에 초점.  
+  - 조회 vs 생성 TDD: `rb8001/tests/test_calendar_query_vs_create.py:1-220`  
+  - 로그 기반 시나리오: `rb8001/tests/test_intent_scenarios_from_logs.py:1-220`  
+  - 겹침 케이스 실험 스크립트: `rb8001/tests/test_calendar_intent_overlap_cases.py:1-80`
+
+---
+
+## 2. UX/의도 기준
+
+- **조회 중심 문장**: "등록돼 있는지 확인", "일정 전체 확인", "스케줄 보여줘" → 기본 intent는 `calendar_query`.  
+- **생성 중심 문장**: "일정 등록해줘/잡아줘/넣어줘" + 날짜·시간·타이틀 정보가 충분 → 기본 intent는 `calendar_event`.  
+- **조회+생성 혼합 문장**: "있나 확인하고, 없으면 잡아줘", "필요하면 등록해줘" → 단일 intent로 강제하지 않고, ① 조회 → ② 조건부 생성 멀티 액션으로 다룬다.  
+- UX 원칙: 애매하면 조용히 잘못 실행하지 말고, 한 번 더 물어보는 clarify를 사용한다.
+
+---
+
+## 3. 설계 방향
+
+### 3.1 FastPath 의도 판정 조정
+
+- 조회/생성 정규식이 **동시에 매칭**되는 경우를 감지한다.  
+- 이 경우 FastPath에서 바로 `calendar_query` 또는 `calendar_event`로 확정하지 않고, 상위 카테고리(예: `SCHEDULE_MANAGEMENT`) + 낮은 confidence로 내려 보낸다.  
+- `"없으면 잡아줘"`, `"필요하면 등록해줘"` 등 조건부 생성 패턴은 별도 플래그로 표시하여 후속 단계에서 ActionPlan에 반영한다.
+
+### 3.2 3단계 파이프라인 활용
+
+- IntentAnalyzer/ActionPlanner에서 조회+생성 혼합 메시지를 **Goal: SCHEDULE_MANAGEMENT**로 해석한다.  
+- ActionPlanner는 플래그/슬롯을 기준으로 다음 두 가지 플랜을 만든다.  
+  - Plan A: `[QUERY_CALENDAR]` (조회만)  
+  - Plan B: `[QUERY_CALENDAR, CONDITIONAL_CREATE_EVENT]` (없으면 등록)  
+- SkillSelector는 Plan B에 대해 `CALENDAR.get_events` 후, 결과가 비어 있을 때만 `CALENDAR.create_event`를 실행하는 시퀀스를 생성한다.
+
+### 3.3 Clarify·승인 흐름
+
+- FastPath/IntentAnalyzer에서 의도 불확실(conf 낮거나 혼합)하면, LLM 기반 clarify 메시지를 생성한다.  
+- 예: "먼저 내일 일정이 등록돼 있는지 확인하고, 없으면 일정까지 등록해드릴까요?"  
+- 사용자가 "응/ㅇㅇ/그래" 등으로 승인하면 `calendar_approval`이 원래 Plan A/B를 기억한 상태에서 적절한 액션을 선택하도록 한다.
+
+---
+
+## 4. 작업 항목 (하위 설계)
+
+1. **의도 패턴/슬롯 확장**  
+   - 조회/생성 동시 매칭, `"없으면 잡아줘"`, `"필요하면 등록해줘"` 등을 감지하는 보조 패턴/슬롯 추가.  
+   - 위치: `rb8001/app/services/brain/decision_engine.py` 및 `app/services/brain/intent` 하위 모듈.
+2. **FastPath 의사결정 로직 개선**  
+   - `analyze_intent()`에서 캘린더 혼합 문장에 대해 단일 intent 강제 대신 상위 카테고리 + 플래그 반환.
+3. **ActionPlanner 확장**  
+   - `ActionPlanner.plan()`에서 SCHEDULE_MANAGEMENT + 플래그를 입력받아 `[QUERY]` vs `[QUERY→CONDITIONAL_CREATE]`를 구분.  
+   - 위치: `rb8001/app/services/brain/intent/action_planner.py`.
+4. **SkillSelector 멀티 액션 시퀀스**  
+   - `SkillSelector.select()`에서 CONDITIONAL_CREATE_EVENT를 지원하고, get_events 결과에 따라 create_event 실행 여부를 결정.  
+   - 위치: `rb8001/app/services/brain/intent/skill_selector.py`.
+5. **calendar_approval 행동 분기**  
+   - `DecisionEngine.decide_skill_sequence()` 또는 intent 파이프라인에서 `calendar_approval`이 직전 Plan A/B를 기억하도록 메타데이터 연결.  
+6. **의도 경계 TDD 케이스 추가**  
+   - 위 10개 문장을 포함해 `"등록돼 있는지 확인"`, `"없으면 잡아줘"` 패턴을 `test_calendar_query_vs_create.py`, `test_intent_scenarios_from_logs.py`에 기대 intent/액션으로 고정.  
+7. **리뷰 큐 연동 규칙**  
+   - calendar_query vs calendar_event margin이 작거나, 사용자 피드백(wrong/down)이 붙은 캘린더 케이스를 IntentReviewQueue에 자동 적재.  
+   - 위치: `rb8001/app/services/brain/intent_review.py`, `app/state/conversation_repository.py`.
+
+---
+
+## 5. 검증·운영
+
+- `pytest rb8001/tests/test_calendar_query_vs_create.py rb8001/tests/test_intent_scenarios_from_logs.py`로 회귀 여부를 상시 확인한다.  
+- 관리자용 Intent 리뷰 화면에서 캘린더 관련 샘플을 필터링하여, 조회↔생성 경계 오류를 집중 라벨링한다.  
+- 일정 기간 운영 후, 리뷰 큐/로그 데이터를 기반으로 FastPath 정규식·threshold를 재튜닝하고 이 계획 문서를 `troubleshooting/` 문서로 승격한다.
+