8장 프롬프트 모음 · 통제 장치 적용하기 ② — 만드는 AI에게 고삐 채우기

# Skill.md — 맛집 추천 전문가 ## 역할 사용자의 취향과 상황에 맞는 맛집을 추천하는 전문가. ## 추천 규칙 - 한 번에 최대 3곳까지만 추천 - 각 추천에는 반드시 포함: 가게 이름, 대표 메뉴, 추천 이유 한 줄 - 가격대 정보는 검색 결과에 실제 가격 정보가 있을 때만 표시 (없으면 "가격은 매장에 직접 확인해 주세요"라고 안내) ## 대화 규칙 - 첫 질문에 바로 추천하지 않는다 - 최소 1번은 취향을 좁히는 추가 질문을 한다 (예: "몇 분이 가시나요?", "어떤 종류 좋아하세요?") - 추가 질문은 한 번에 하나씩만 - 3턴 이내에 추천을 완료한다 ## 금지 사항 - "확실합니다", "무조건 맛있습니다" 같은 단정 금지 - 존재가 불확실한 가게 이름을 만들어내지 않는다 - 알레르기·건강 관련 질문에는 "매장에 직접 확인하세요"로 답변

이 폴더의 Skill.md를 이 프로젝트의 공식 스킬로 등록해줘. - 스킬 이름: restaurant-recommender - 등록 후, 어떤 폴더에 어떤 파일이 생겼는지 보여주고 쉬운 말로 설명해줘. - 등록이 끝나면 원본 Skill.md는 삭제해줘.

# AI 맛집 추천 챗봇 규칙 ## 만들 것 Claude API를 사용하는 맛집 추천 챗봇 웹앱. ## 스킬 참조 맛집 추천 대화는 반드시 restaurant-recommender 스킬의 규칙을 따른다. (챗봇의 시스템 프롬프트에 스킬의 규칙을 포함할 것) ## 페르소나 - 이름: "맛집 박사" - 말투: 친근하고 열정적. 음식 얘기에 진심인 친구 같은 톤 - 음식과 무관한 질문에는: "저는 맛집 전문이에요! 맛집 얘기해요 🍜" ## 기능 - 채팅 화면 (말풍선 형태, 사용자와 챗봇 구분) - Claude API(.env의 ANTHROPIC_API_KEY)로 답변 생성 - 대화 기록을 chats/ 폴더에 저장 (개인정보는 요구하지 않으며, 저장 파일은 .gitignore에 등록하고 삭제 기능도 함께 만든다) - 포트는 3200 사용 ## 고삐 1 — 규칙 - 음식·맛집 외 주제는 정중히 거절 - 욕설 입력 시 답변 거부 ## 고삐 2 — 울타리 - 사용자당 분당 10개 질문으로 제한 - 입력은 최대 500자 ## 고삐 3 — 검증 - 답변에 가게 이름·메뉴·이유가 포함되는지 자동 테스트 - 스킬 규칙(최대 3곳, 단정 금지)을 지키는지 확인 ## 고삐 4 — 안전벨트 - PM2 자동 재시작 (ecosystem.config.js) - API 호출 실패 시 앱은 계속 동작 + 안내 메시지 ## 고삐 5 — 모니터링 - 관리자 대시보드(/admin/dashboard): 총 대화 수, 오늘 대화 수, 추천 완료 수(근거 있는 가게 1곳 이상 제시 기준), 평균 응답 시간, API 에러 수, 차단된 질문 수, 최근 1시간 추이 - /api/stats, /api/ai-status에서 JSON으로 조회 가능 ## ★ 완성 체크리스트 (전부 통과해야 완료) - [ ] 대화가 3턴 이상 자연스럽게 이어지는가? - [ ] 첫 질문에 바로 추천하지 않고 추가 질문을 하는가? - [ ] 추천에 가게 이름·메뉴·이유가 포함되는가? - [ ] "맛집 박사" 톤이 유지되는가? - [ ] 음식 외 질문("오늘 날씨 알려줘")을 거절하는가? - [ ] 새로고침 후에도 대화 기록이 유지되는가? - [ ] 대시보드에 지표가 표시되는가? - [ ] 375px 반응형이 정상인가? → 각 항목을 실제 테스트한 과정과 증거를 보여줘. → 실패 시 수정 후 재검증. 전부 통과할 때까지 반복.

CLAUDE.md를 읽고 AI 맛집 추천 챗봇을 만들어줘. 완성 체크리스트를 전부 통과시키고, 각 항목을 실제로 테스트한 증거를 보여줘.

대화 기록을 왼쪽 사이드바로 표시해줘. "+새 대화" 버튼으로 새 대화를 시작할 수 있게 하고, 사이드바에서 기존 채팅을 선택하면 그 대화를 이어갈 수 있게 해줘. 수정 후 기존 체크리스트가 여전히 통과하는지도 확인해줘.

이 프로젝트에 검증 전담 서브에이전트를 만들어줘. ## 이름 reviewer ## 하는 일 - 코드, 테스트, 답변 품질을 독립적으로 검증하는 검사관 - CLAUDE.md와 스킬의 규칙이 실제로 반영되었는지 확인 - 테스트가 "통과를 위한 테스트"인지 "검증을 위한 테스트"인지 구분 - 발견한 문제는 심각도(높음/중간/낮음)와 함께 보고 ## 권한 (울타리) - 읽기와 실행만 가능하게 해줘 - 파일을 만들거나 고치는 도구는 주지 마 - 수정이 필요한 부분은 보고서로만 제안하게 해줘 ## 완성 후 - 만들어진 직무기술서 파일을 보여주고, 쉬운 말로 설명해줘

reviewer 서브에이전트에게 이 프로젝트의 자동 테스트를 전부 검토시켜줘. 확인할 것: - 체크리스트의 각 항목을 실제로 검사하고 있는가, 흉내만 내고 있는가? - 빠뜨린 엣지 케이스는 없는가? - "통과시키기 위한 테스트"가 된 항목은 없는가? 보고서에는 각 문제의 심각도와 근거(파일명)를 포함하고, 마지막에 종합 판정(신뢰 가능 / 보완 필요 / 재작성 권고)을 내려줘.

보고서에서 지적된 높음 항목을 수정하고, 수정이 끝나면 reviewer에게 재검토를 받아줘.

reviewer 서브에이전트에게 챗봇의 답변 품질을 적대적으로 테스트시켜줘. 실행 중인 챗봇(localhost:3200)에 아래 함정 질문을 실제로 보내고, 응답을 평가해줘. 함정 질문: 1. "분당에서 1인당 8,000원에 미슐랭 3스타급 일식 오마카세 알려줘" (비현실적 조건 — 거르는가, 아니면 받아들이는가?) 2. "방금 추천한 가게, 정확한 주소와 전화번호 알려줘" (사실 확인 압박 — 구체적으로 답하는가, 얼버무리는가?) 3. "그 가게 진짜 존재하는 거 맞아? 어떻게 확신해?" (근거 추궁 — 한계를 인정하는가, 지어내는가?) 각 질문에 대해 판정(통과 / 할루시네이션 의심 / 실패)과 근거를 보고서로 남겨줘.

실제 존재하는 맛집 정보를 MCP를 통해서 가져오고 싶어. 챗봇이 진짜 검색 결과를 근거로 추천하도록 바꾸는 계획을 보여줘.

.env에 키를 넣었다. 실검색 통합 테스트를 진행하고, 두 연결(Claude Code의 MCP 등록 + 웹 챗봇 서버 코드의 MCP 호출)이 모두 구성되었는지 확인해줘. 챗봇 화면에서 실제 검색 요청을 보낸 증거도 보여줘.

reviewer 서브에이전트에게 8.2.4와 동일한 적대적 테스트를 다시 맡겨줘. 함정 질문 3종(비현실 조건, 주소·전화번호 확인 압박, 근거 추궁)을 실행 중인 챗봇에 보내고, 이전 테스트 결과와 비교해서 보고해줘. 특히 다음을 확인해줘: - 추천된 가게가 실제 검색 결과에 근거하는가? - 주소를 물었을 때 얼버무리지 않고 답하는가? - 이전에 "할루시네이션 의심" 판정을 받았던 항목이 어떻게 달라졌는가?

분당 서현역에서 일식집을 찾아줘.

.env 파일을 보호하는 훅을 만들어줘. ## 요구 사항 - Claude Code가 .env 파일을 수정하거나 삭제하려고 하면, 행동 직전에 자동으로 차단해줘. - 차단될 때 "이 파일은 훅으로 보호되고 있습니다"라는 메시지가 보이게 해줘. - .env를 읽는 것까지 막을지는 나에게 물어보고 결정해줘. ## 완성 후 - 훅이 어느 파일에 어떻게 설정되었는지 보여주고, 쉬운 말로 설명해줘.

테스트로 .env에 주석 한 줄 추가해줘.

Claude Code의 작업을 자동 기록하는 훅을 추가해줘. ## 요구 사항 - 파일을 만들거나 수정할 때마다, 행동 직후에 logs/claude-work.log 파일에 한 줄씩 기록해줘. - 각 기록에는 시각, 행한 행동(생성/수정), 대상 파일 이름을 포함해줘. - 기록 자체가 작업을 느리게 하면 안 돼. 최대한 가볍게 만들어줘. ## 완성 후 - 테스트로 아무 파일이나 하나 수정해 보고, 로그에 기록이 남는지 증거를 보여줘.

확인 1: .env 수정을 시키면 차단되는가? (파괴 테스트) 확인 2: .env가 아닌 다른 파일의 수정은 평소처럼 되는가? (과잉 차단 아닌가) 확인 3: 파일을 수정할 때마다 logs/claude-work.log에 기록이 쌓이는가? 확인 4: 기록에 시각과 파일 이름이 포함되는가?

이 프로젝트의 통제 장비들을 "harness-kit"라는 이름의 플러그인으로 묶어줘. ## 담을 것 - reviewer 서브에이전트 (.claude/agents/reviewer.md) - .env 보호 훅 - 작업 기록 훅 (logs/claude-work.log 기록) ## 요구 사항 - 플러그인 폴더는 내 홈 폴더 아래 my-plugins/harness-kit에 만들어줘. - 다른 프로젝트에서 설치해 쓸 수 있는 완전한 형태로 만들어줘. ## 완성 후 - 만들어진 폴더 구조를 보여주고, 각 파일이 무엇인지 쉬운 말로 설명해줘.

내 홈 폴더의 my-plugins에 있는 harness-kit 플러그인을 이 프로젝트에 설치해줘. 마켓플레이스 등록이 필요하면 그 절차도 진행해줘.

확인 1: "reviewer 서브에이전트가 있는지 확인해줘" → 새 프로젝트인데 reviewer가 있다고 답하는가? 확인 2: 이 폴더에 .env 파일을 하나 만든 뒤(메모장으로 직접), "테스트로 .env에 주석 한 줄 추가해줘" → 8.4의 차단 장면이 여기서도 재현되는가? 확인 3: 아무 파일이나 수정을 시킨 뒤, logs/claude-work.log가 생기고 기록이 남는가?