배포 절차 문서화 — public clone 전제 정리

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: MinsungIM

CLAUDE.md

@@ -25,6 +25,22 @@ PYTHONPATH=src uv run python src/run.py     # .env 의 APP_HOST/APP_PORT (8084)
 uv run pytest tests/ -q
 ```
 
+## 배포 (sm-api-01 — worker-prep-vision 방식)
+
+서버 디렉토리 `/usr/service/source/scenemaker/agent/agent-compose` 가 GitHub
+`SceneMakerAI/agent-compose`(public)의 clone (소유자 agent). **정본은 GitHub main** —
+로컬 수정은 commit+push 후 서버에서:
+
+```bash
+deploy/update.sh            # origin/main 신규 커밋 있으면 sync+재기동, 없으면 no-op
+deploy/update.sh --force    # 강제 재기동
+```
+
+- `.env` 는 미추적이라 `reset --hard` 에도 보존 (서버 값: Milvus·DB 사설, LLM/embed GA).
+- systemd 유닛(`agent-compose.service`)도 `deploy/` 가 정본 — 달라지면 자동 설치.
+- readyz 게이트는 embed(GPU)·Milvus 원격 프로브 포함 — **GPU 야간 자동 중지 시간대엔
+  실패가 정상** (배포 실패 아님, 스크립트 경고 문구 참조).
+
 ## API
 
 - `POST /api/v1/ingest {v_id}` → 202. 증거 수집→임베딩→Milvus v_id 교체 (멱등).

deploy/update.sh

@@ -8,8 +8,8 @@
 #   deploy/update.sh --force    # 변경 없어도 sync + 재기동 강제
 #
 # 전제:
-#   - 배포 디렉토리가 GitHub 를 origin 으로 둔 git clone, 소유자 agent
-#     (최초 1회 부트스트랩·deploy key 는 CLAUDE.md 참조)
+#   - 배포 디렉토리가 GitHub(public) 를 origin 으로 둔 git clone, 소유자 agent
+#     (최초 1회 부트스트랩은 CLAUDE.md 참조)
 #   - .env 는 gitignore(미추적)라 reset --hard 에도 보존된다
 set -euo pipefail
 

src/flow/prompts.py

@@ -12,8 +12,9 @@
 from flow import vocab
 
 # 어휘 — plan 이 아는 말의 전부 (판별불가는 발행에 없으므로 제외, bench4 나열 순서 유지)
-TAG_VOCAB = ("홈런, 안타, 번트, 볼넷, 사구, 삼진, 범타, 도루, 폭투·포일, 견제, 실책, "
-             "호수비, 비디오 판독·리플레이")
+TAG_VOCAB = (
+    "홈런, 안타, 번트, 볼넷, 사구, 삼진, 범타, 도루, 폭투·포일, 견제, 실책, 호수비, 비디오 판독·리플레이"
+)
 LABEL_VOCAB = ", ".join(vocab.LABELS)
 
 PLAN_SYSTEM = f"""\
@@ -49,8 +50,9 @@
 """
 
 
-def plan_user(query: str, game_line: str, inventory: str, budget: int,
-              feedback: str = "", evidence_block: str = "") -> str:
+def plan_user(
+    query: str, game_line: str, inventory: str, budget: int, feedback: str = "", evidence_block: str = ""
+) -> str:
     """plan 유저 프롬프트 — 경기 한 줄 + 인벤토리 + (벡터 후보) + (피드백) + 질의."""
     fb = f"\n[이전 시도 피드백]\n{feedback}\n" if feedback else ""
     ev = f"\n{evidence_block}\n" if evidence_block else ""