coding-buddy-mcp 1.0.1 → 1.0.2

package/TEST_CASES.md

@@ -0,0 +1,165 @@
+# Coding Buddy MCP 테스트 케이스
+
+아무 프로젝트에서 새 세션을 열고 아래 프롬프트를 하나씩 입력합니다.
+각 테스트 후 `/clear`로 초기화하고 다음 테스트를 진행하세요.
+
+---
+
+## 테스트 0: MCP 연결 확인
+```
+/mcp
+```
+- [ ] coding-buddy가 목록에 보인다
+- [ ] 도구 3개 표시: analyze_task, setup_project, cost_reference
+
+---
+
+## A. CRITICAL GATE (구체성 강제) — 가장 중요
+
+### A-1. 모호한 버그 요청 (한국어)
+```
+버그 찾아줘
+```
+- [ ] 도구를 호출하지 않고 파일 경로/증상을 되묻는다
+- [ ] Explore, Glob, Grep 등 탐색을 시작하지 않는다
+
+### A-2. 모호한 버그 요청 (영어)
+```
+find bugs in this project
+```
+- [ ] 되묻는다 (which file? what symptoms?)
+
+### A-3. 모호한 리팩토링
+```
+코드 리팩토링 해줘
+```
+- [ ] 범위를 확인한다 (어떤 파일? 어떤 부분?)
+
+### A-4. 모호한 테스트 요청
+```
+테스트 작성해줘
+```
+- [ ] 어떤 파일/함수에 대한 테스트인지 되묻는다
+
+### A-5. 모호한 에러 보고
+```
+에러가 나
+```
+- [ ] 에러 메시지와 발생 파일을 물어본다
+
+### A-6. 구체적 요청 → 바로 실행해야 함
+```
+package.json의 dependencies 섹션 보여줘
+```
+- [ ] 되묻지 않고 바로 파일을 읽는다
+
+### A-7. 구체적 버그 요청 → 바로 실행해야 함
+```
+src/index.ts의 main 함수에서 에러 핸들링이 빠져있어. 확인해줘
+```
+- [ ] 되묻지 않고 해당 파일을 바로 읽는다
+
+---
+
+## B. 모델 추천 (analyze_task 도구 호출)
+
+### B-1. 단순 작업 → Haiku 추천
+```
+README.md에서 오타 하나 수정해줘. "recieve"를 "receive"로
+```
+- [ ] analyze_task 도구를 호출한다
+- [ ] Haiku를 추천한다
+
+### B-2. 중간 작업 → Sonnet 추천
+```
+src/components/LoginForm.tsx에 비밀번호 유효성 검사 추가해줘
+```
+- [ ] analyze_task 도구를 호출한다
+- [ ] Sonnet을 추천한다
+
+### B-3. 복잡한 작업 → Opus 추천 + Plan Mode 제안
+```
+인증 시스템을 JWT에서 세션 기반으로 전체 마이그레이션 해줘
+```
+- [ ] analyze_task 도구를 호출한다
+- [ ] Opus를 추천한다
+- [ ] Plan Mode를 먼저 쓰라고 제안한다
+
+---
+
+## C. 세션 관리
+
+### C-1. 주제 변경 감지
+(먼저 아무 작업을 하나 한 후)
+```
+그건 됐고, 이제 CI/CD 파이프라인 설정해줘
+```
+- [ ] 새 세션을 시작하라고 제안한다
+
+### C-2. 작업 완료 후 정리 제안
+(아무 간단한 작업 완료 후 Claude가 "완료했습니다" 류의 답변을 한 후)
+- [ ] /clear 또는 새 세션을 제안한다
+
+---
+
+## D. 캐시 보호
+
+### D-1. 모델 변경 경고
+```
+모델을 opus로 바꿔줘
+```
+- [ ] 캐시가 깨진다고 경고한다
+- [ ] 새 세션에서 바꾸라고 안내한다
+
+### D-2. CLAUDE.md 수정 경고
+```
+CLAUDE.md에 새로운 규칙 추가해줘
+```
+- [ ] 세션 시작 전에 수정하라고 경고한다 (캐시 브레이크)
+
+---
+
+## E. 생산성
+
+### E-1. 복잡한 작업 → Plan Mode 제안
+```
+데이터베이스 스키마를 PostgreSQL에서 MongoDB로 마이그레이션 계획 세워줘
+```
+- [ ] Plan Mode를 먼저 제안한다
+
+### E-2. CLAUDE.md 없는 프로젝트에서 setup 제안
+(CLAUDE.md가 없는 프로젝트에서)
+```
+이 프로젝트 최적화하고 싶어
+```
+- [ ] setup_project 도구를 호출하거나 CLAUDE.md 생성을 제안한다
+
+### E-3. 비용 참조
+```
+Claude Code 모델별 가격이 어떻게 돼?
+```
+- [ ] cost_reference 도구를 호출한다
+- [ ] 모델별 단가표를 보여준다
+
+---
+
+## F. Output 효율
+
+### F-1. 간결한 응답
+(아무 구체적 작업 후)
+- [ ] 불필요한 요약 없이 간결하게 답한다
+- [ ] "제가 한 작업을 정리하면..." 같은 반복 없음
+
+---
+
+## 테스트 결과 요약
+
+| 카테고리 | 통과 | 실패 | 비고 |
+|---------|------|------|------|
+| A. 구체성 강제 (7개) | /7 | /7 | |
+| B. 모델 추천 (3개) | /3 | /3 | |
+| C. 세션 관리 (2개) | /2 | /2 | |
+| D. 캐시 보호 (2개) | /2 | /2 | |
+| E. 생산성 (3개) | /3 | /3 | |
+| F. Output 효율 (1개) | /1 | /1 | |
+| **합계** | **/18** | **/18** | |

package/dist/index.js

@@ -41,17 +41,36 @@ This gate exists because vague requests cause tool explosion:
 - Specific: 1-2 turns × 1-2 tool calls = fast ($0.10-0.30)
 
 ======================================================================
-END OF CRITICAL GATE
+END OF CRITICAL GATE — SPECIFICITY
 ======================================================================
 
-## 1. MODEL SELECTION — call analyze_task tool for each new task
-Once the request is specific enough, call the analyze_task tool to get model + approach recommendation.
-Present the recommendation naturally: "이 작업은 [model]이 적합합니다. [reason]"
-- Haiku ($1/$5 per 1M tokens): typos, renaming, formatting, simple lookups, boilerplate generation
-- Sonnet ($15/$75 per 1M tokens): feature implementation, bug fixes, testing, code review
-- Opus ($15/$75 per 1M tokens): architecture design, migrations, complex multi-file refactoring
-KEY: To switch models → user must start a NEW session. Mid-session model change = cache break = 10x cost spike.
-Extended thinking tokens are billed as output ($75/1M). For simple tasks, thinking is pure waste.
+======================================================================
+CRITICAL GATE 2 — MODEL SELECTION (MANDATORY)
+======================================================================
+
+After the request passes the specificity check, you MUST call the analyze_task tool
+BEFORE starting any work. This is NOT optional.
+
+Steps:
+1. Call analyze_task with the user's task description
+2. Present the result naturally in Korean:
+   - "이 작업은 [model]이 적합합니다. [이유]"
+   - If current model doesn't match → "현재 [current]를 사용 중인데, 이 작업은 [recommended]가 적합합니다. 새 세션에서 /model [recommended] 로 바꾸시면 비용을 절약할 수 있습니다."
+   - If current model matches → briefly confirm and proceed
+3. THEN start working on the task
+
+You MUST call analyze_task even for simple tasks — it only takes one tool call
+and saves the user significant money by recommending the right model.
+
+Model pricing reference:
+- Haiku ($1/$5 per 1M tokens): typos, renaming, formatting, simple lookups
+- Sonnet ($15/$75 per 1M tokens): features, bug fixes, tests, code review
+- Opus ($15/$75 per 1M tokens): architecture, migrations, complex refactors
+- Mid-session model change = cache break = 10x cost spike → ALWAYS suggest new session
+
+======================================================================
+END OF CRITICAL GATE — MODEL SELECTION
+======================================================================
 
 ## 3. SESSION DISCIPLINE
 - ONE session = ONE focused task. When topic changes → suggest: "새 작업이니 새 세션에서 하는 게 효율적입니다"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-buddy-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A pair programming buddy MCP for Claude Code — optimizes cost and productivity based on Claude Code internals analysis",
   "type": "module",
   "main": "dist/index.js",