[docs] docs: 사장님 에이전트 사용 안내 추가 — 말로 할 수 있는 일 목록(AGENT_GUIDE.md)

AGENT.md 는 개발자용 설계 문서라 "왜" 를 다루고, 운영자·CS 가 "카톡으로 무엇을 시킬 수 있나"
를 찾을 자리가 없었다. 무엇을 할 수 있는지만 새 파일에 두고, 동작 근거는 AGENT.md 로 링크한다
(한 사실은 한 곳에).

- docs/AGENT_GUIDE.md: 연결·가게 선택 · 업종별 수정 항목 · 가게 정보 · 섹션 조회/켜기·끄기/옮기기 ·
  사진 · 발행 · 여러 요청 · 할 수 없는 것. 기준 커밋(091d5d9)과 항목 목록의 원본(category_schema) 표기
- docs/AGENT.md: 머리에 사용 안내 링크
- AGENTS.md: 문서 표에 한 줄

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

AGENTS.md

@@ -19,6 +19,7 @@
 | 장애가 나면 누가·어떻게 아나 | [docs/ALERTS.md](docs/ALERTS.md) |
 | **미니 블로그**(AI 자동 포스트) 기획 | [docs/MINI_BLOG.md](docs/MINI_BLOG.md) |
 | **사장님 에이전트**(카톡으로 관리) · 신원 연결 | [docs/AGENT.md](docs/AGENT.md) |
+| 카톡으로 **무엇을 시킬 수 있나** (운영자·CS 용) | [docs/AGENT_GUIDE.md](docs/AGENT_GUIDE.md) |
 
 ---
 

docs/AGENT.md

@@ -1,5 +1,8 @@
 # 사장님 에이전트 — 신원 연결 · 도구 · 런타임
 
+> 사장님이 말로 **무엇을 시킬 수 있는지**(운영자·CS 용 목록)는 [AGENT_GUIDE.md](AGENT_GUIDE.md).
+> 이 문서는 **왜 그렇게 동작하는지**를 다룬다.
+
 사장님이 말로 사이트를 운영하는 것이 목표다 — 내용 고치기, 사진 내리기, 발행, SNS 게재까지.
 **에이전트는 카카오톡 안에 있지 않다.** 카톡은 입구 하나이고, 같은 에이전트가 빌더 화면에도
 붙는다. 그래야 채널·챗봇 심사 전에 전부 검증된다.

docs/AGENT_GUIDE.md

@@ -0,0 +1,185 @@
+# 사장님 에이전트 — 말로 할 수 있는 일
+
+> 기준: 2026-09-30 · `fix/agent-multi-action` (`091d5d9`)
+> 카카오톡 채널과 빌더 대화창([말로 고치기])은 같은 에이전트다 — 아래는 둘 다에 해당한다.
+> 카카오톡에서만 해당하는 것은 **(카톡)** 으로 표시한다.
+
+운영자·CS 가 "사장님이 말로 무엇을 시킬 수 있나" 를 확인하는 목록이다. **왜 그렇게 동작하는지**
+(등급 · 게이트 · 조용히 틀리는 함정)는 [AGENT.md](AGENT.md)가 단일 출처다 — 여기에 옮겨 적지 않는다.
+도구를 바꾸는 커밋에서 이 파일도 같이 고친다.
+
+---
+
+## 카카오톡 연결 · 가게 선택 (카톡)
+
+동작 : 빌더 [내 사이트]에서 받은 6자리 코드를 카카오톡 채널에 보내기
+행동 : 계정을 연결하고 관리 중인 홈페이지 목록과 발행 여부를 보여 줌 (코드는 10분간 유효, 1회만 사용 가능)
+
+동작 : 가게 이름 버튼 누르기 또는 가게 이름 그대로 보내기
+행동 : 그 가게를 대화 대상으로 기억함 (가게가 하나면 자동 선택)
+
+동작 : "목록", "가게 바꿔줘", "다른 가게"
+행동 : 언제든 홈페이지 목록으로 돌아가 다시 고르게 함
+
+동작 : 지금 가게가 아닌 다른 내 가게 이름을 말하기 ("둘째가게 휴무 바꿔줘")
+행동 : 실행하지 않고 "먼저 골라 주세요"라고 안내 (지금 가게가 잘못 바뀌는 것을 막음)
+
+---
+
+## 업종별 수정 가능 항목
+
+> 항목 목록의 원본은 `solution/backend/common/category_schema/resources/*.json` 의 `scope: "place"` 필드다.
+> 객실·메뉴·시술 단위(`scope: "unit"`) 값은 대화로 고칠 수 없다.
+
+숙박
+체크인, 체크아웃, 취소·환불 규정, 취사, 반려동물, 흡연, 인원 추가 요금, 바비큐 이용·이용료, 프런트 운영시간, 주차 가능·주차 대수, 와이파이, 조식, 유아용품, 픽업, 부대시설, 객실 수, 수용 인원, 규모, 숙소 소개
+
+카페
+영업시간, 휴무일, 브레이크타임, 라스트오더, 반려동물, 아동, 주차, 무료 주차 시간, 장시간 이용, 결제 수단, 휠체어, 좌석 수, 와이파이, 콘센트, 테라스, 테이크아웃, 배달, 대표 메뉴, 가격대, 카페 소개
+
+음식점
+영업시간, 휴무일, 브레이크타임, 라스트오더, 예약 필수, 예약 방법, 반려동물, 아동, 콜키지, 룸·별실, 단체석 최대 인원, 주차, 주차 대수, 포장, 배달, 결제 수단, 대표 메뉴, 가격대, 휠체어, 가게 소개
+
+피부과·성형외과
+진료시간, 휴진일, 진료과목, 의료진, 예약 필수, 예약 방법, 상담료, 보험, 취소 규정, 야간·주말 진료, 외국어 상담, 주차, 휠체어, 병원 소개
+
+---
+
+## 가게 정보 조회 · 수정
+
+동작 : "지금 저장된 정보 보여줘", "주차 정보 뭐로 돼 있어?"
+행동 : 저장된 값을 최대 20개까지 보여 줌 (키워드를 말하면 그 항목만)
+
+동작 : "체크인 오후 3시로 바꿔줘", "체크인 15시 30분", "체크인 3시 반"
+행동 : 시각으로 저장 (15:00 / 15:30). "3시"처럼 오전인지 오후인지 모르면 되물음
+
+동작 : "반려동물 이제 돼요", "흡연 안 돼요"
+행동 : 가능 / 불가로 저장. "소형견만"처럼 가능·불가로 볼 수 없는 말이면 되물음
+
+동작 : "추가 인원 2만원", "바비큐 2만 5천원", "바비큐 무료"
+행동 : 숫자로 저장 (20000 / 25000 / 0). "문의"처럼 숫자가 아니면 되물음
+
+동작 : "숙소 소개 ○○로 바꿔줘"
+행동 : 말한 문장을 그대로 저장
+
+동작 : "객실 요금 바꿔줘", "메뉴 가격 바꿔줘"
+행동 : 객실·메뉴별 값이라 "대화로는 아직 고칠 수 없어요"로 안내
+
+> 고친 값은 곧바로 저장되지만 **사이트에는 다시 발행해야 반영된다.** 답에 재발행 안내가 붙는다.
+
+---
+
+## 섹션 조회
+
+동작 : "홈페이지 구성 보여줘"
+행동 : 보이는 순서대로 번호를 붙여 보여 주고, 꺼진 섹션은 따로 모아 보여 줌 (히어로는 "항상 맨 위", SNS는 "항상 맨 아래"로 표시)
+
+동작 : "숨긴 거 뭐 있어?"
+행동 : 꺼져 있는 섹션만 보여 줌
+
+---
+
+## 섹션 켜기 · 끄기(숨기기)
+
+동작 : "날씨 빼줘", "영상 숨겨줘"
+행동 : 섹션을 삭제하지 않고 끔 (언제든 다시 켤 수 있음)
+
+동작 : "갤러리랑 날씨 숨겨줘"
+행동 : 여러 섹션을 한 번에 끔 (하나라도 못 찾거나 끌 수 없으면 아무것도 바꾸지 않고 어느 것이 문제인지 안내)
+
+동작 : "영상 다시 켜줘"
+행동 : 꺼진 섹션을 다시 켬
+
+동작 : "히어로 빼줘", "기본 정보 빼줘", "오시는 길 빼줘"
+행동 : 꼭 있어야 하는 섹션이라 "끌 수 없어요"로 안내
+
+동작 : 이미 꺼진 섹션을 또 끄라고 하기
+행동 : "이미 꺼져 있어요"로 안내하고 재발행을 권하지 않음
+
+---
+
+## 섹션 옮기는 방법
+
+동작 : "갤러리 맨 위로", "갤러리 맨 아래로"
+행동 : 해당 섹션을 맨 앞 / 맨 뒤로 이동
+
+동작 : "갤러리를 소개 앞으로", "갤러리를 소개 다음으로"
+행동 : 지정한 섹션의 바로 앞 / 바로 뒤로 이동
+
+동작 : "갤러리 한 칸 위로", "소개 두 칸 아래로"
+행동 : 말한 칸 수만큼 이동 (보이는 순서 기준, 꺼진 섹션은 칸 이동 불가)
+
+동작 : "날씨 세 번째로", "날씨 첫 번째로"
+행동 : 구성 목록의 해당 번호 자리로 이동 (없는 번호면 되물음)
+
+동작 : "소개랑 갤러리 자리 바꿔줘"
+행동 : 두 섹션의 위치를 맞바꿈
+
+동작 : "히어로 맨 아래로", "SNS 게시글 맨 위로"
+행동 : 항상 맨 위 / 맨 아래에 고정된 섹션이라 "옮길 수 없어요"로 안내
+
+동작 : 이미 그 자리에 있는 섹션을 옮기라고 하기
+행동 : "이미 맨 위에 있어요"로 안내하고 재발행을 권하지 않음
+
+---
+
+## 사진 조회 · 수정
+
+동작 : "사진 목록 보여줘"
+행동 : 최대 15장까지 보여 줌 (대표 사진과 숨긴 사진을 표시)
+
+동작 : "대표 사진 수영장으로 바꿔줘"
+행동 : 해당 사진을 대표로 지정 (객실·메뉴 전용 사진, 숨긴 사진은 불가)
+
+동작 : "객실 사진 내려줘"
+행동 : 사진을 삭제하지 않고 숨김 (이미 숨겼으면 "이미 안 나가고 있어요"로 안내)
+
+동작 : 이름이 비슷한 사진이 여러 장일 때 ("객실 A", "객실 B" 중 "객실")
+행동 : 추측하지 않고 되물음 (이름이 정확히 맞는 사진이 한 장이면 그 사진을 선택)
+
+> 사진은 Vision 이 붙인 라벨(예: "외관", "수영장")로 지목한다.
+
+---
+
+## 발행
+
+동작 : "홈페이지 발행됐어?"
+행동 : 발행 여부, 주소, 마지막 발행 시각을 알려 줌
+
+동작 : "발행해줘"
+행동 : 바로 실행하지 않고 [네, 해주세요] / [아니요]로 한 번 확인한 뒤 발행
+
+동작 : 정보나 섹션을 고친 직후 (카톡)
+행동 : "다시 발행해야 반영돼요" 안내와 [네, 발행해주세요] 버튼을 붙임 (3분 안에 누르면 발행, 3분이 지나거나 다른 말을 하면 취소)
+
+---
+
+## 한 번에 여러 요청
+
+동작 : "체크인 3시로 바꾸고 날씨 빼줘"
+행동 : 시킨 순서대로 처리 (한 번에 최대 5가지, 재발행 안내는 한 번만)
+
+동작 : "체크인 오후 3시로 바꾸고 전화번호도 바꿔줘"
+행동 : 되는 것은 처리하고, 안 되는 것은 "'전화번호 변경' 은(는) 대화로는 아직 할 수 없어요"로 안내
+
+동작 : 중간에 하나가 실패함
+행동 : 거기서 멈추고 앞의 변경은 유지. 남은 요청은 "아직 하지 않았어요"로 안내
+
+동작 : "갤러리 빼고, 발행하고, 체크인 오후 3시로"
+행동 : 발행 앞까지만 처리하고 발행 확인을 받음 (발행 뒤에 남은 요청은 확인 전에 미리 안내)
+
+동작 : "체크인 3시… 아니 4시로"
+행동 : 마지막 값 하나만 처리 (옮기기는 합치지 않고 시킨 순서대로 모두 실행)
+
+---
+
+## 대화로 할 수 없는 것
+
+- 객실·메뉴·시술별 값 (요금, 인원 등)
+- 가게 이름·주소·전화번호
+- 템플릿·색·서체
+- 사진 올리기·교체, 섹션 새로 추가, 가게·섹션·사진 완전 삭제
+- 이용 후기·엽서 쓰기 끄기 (섹션 목록에 없고 항상 표시됨)
+- 여러 가게 동시 수정, SNS 게시
+
+위 기능을 요청하면 할 수 없다고 안내하고, 다른 요청과 섞여 있으면 되는 것만 처리한다.