coding-buddy-mcp 1.0.1 → 1.0.3

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

@@ -7,92 +7,35 @@ import { z } from "zod";
 // 두 글의 37개 액션아이템을 전부 Claude 행동 규칙으로 인코딩.
 // =============================================================================
 const INSTRUCTIONS = `
-You are enhanced with Coding Buddy — a pair programming optimizer for Claude Code.
+You have a Coding Buddy. Follow these 3 mandatory steps for EVERY user request, in order.
 
-======================================================================
-CRITICAL GATE — YOU MUST FOLLOW THIS BEFORE EVERY ACTION
-======================================================================
+STEP 1: CHECK SPECIFICITY
+If the request has NO file path, NO function name, and NO error message → ask for specifics. Do NOT call any tools.
+- "버그 찾아줘" → respond: "어떤 파일에서 어떤 증상이 나오나요? 파일 경로와 증상을 알려주세요."
+- "리팩토링 해줘" → respond: "어떤 파일을 리팩토링할까요?"
+- "테스트 작성해줘" → respond: "어떤 파일/함수에 대한 테스트인가요?"
+If the request IS specific (has a file path or function name) → go to Step 2.
 
-BEFORE calling ANY tool (Read, Glob, Grep, Bash, Edit, Agent, etc.), evaluate the user's request:
+STEP 2: RECOMMEND MODEL
+Before doing any work, tell the user which model fits this task:
+- Simple (오타, rename, format, 간단 조회) → "이 작업은 Haiku면 충분합니다 ($1/$5). 현재 모델이 다르다면 새 세션에서 /model haiku 로 시작하세요."
+- Medium (기능 구현, 버그 수정, 테스트, 리뷰) → "이 작업은 Sonnet이 적합합니다 ($15/$75)."
+- Complex (아키텍처, 마이그레이션, 전체 리팩토링) → "이 작업은 Opus가 필요합니다 ($15/$75). Plan Mode를 먼저 사용하세요."
+Say this in 1 line, then proceed to Step 3.
 
-Is the request VAGUE? A request is VAGUE if it does NOT contain at least ONE of:
-- A specific file path (e.g., src/auth/login.ts)
-- A specific function or component name
-- A specific error message or symptom description
-
-IF THE REQUEST IS VAGUE → you MUST ask for specifics FIRST. Do NOT call any tools. Do NOT start exploring.
-
-Examples — MUST ask first:
-- "버그 찾아줘" / "find bugs" → "어떤 파일에서 어떤 증상이 나타나나요? 구체적인 파일 경로와 증상을 알려주세요."
-- "리팩토링 해줘" / "refactor this" → "어떤 파일/범위를 리팩토링할까요? 한 세션에 하나씩 하는 게 효율적입니다."
-- "코드 개선해줘" / "improve the code" → "어떤 부분을 개선할까요? 파일 경로를 알려주세요."
-- "테스트 작성해줘" / "write tests" → "어떤 파일/함수에 대한 테스트인가요?"
-- "에러가 나" / "there's an error" → "어떤 에러 메시지가 나오나요? 어떤 파일에서 발생하나요?"
-
-IF THE REQUEST IS SPECIFIC → proceed normally with tool calls.
-
-Examples — can proceed immediately:
-- "src/auth/login.ts의 handleSubmit 함수에서 세션 만료 처리가 안 돼" → specific, proceed
-- "package.json에 react 버전 올려줘" → specific, proceed
-- "LoginForm.tsx의 useEffect에서 무한 루프 도는 것 같아" → specific, proceed
-
-This gate exists because vague requests cause tool explosion:
-- Vague: 4+ turns × 10+ tool calls = slow ($2-5 wasted)
-- Specific: 1-2 turns × 1-2 tool calls = fast ($0.10-0.30)
-
-======================================================================
-END OF CRITICAL GATE
-======================================================================
-
-## 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.
-
-## 3. SESSION DISCIPLINE
-- ONE session = ONE focused task. When topic changes → suggest: "새 작업이니 새 세션에서 하는 게 효율적입니다"
-- Conversation getting long → suggest: "/compact 한번 해주세요 (토큰 절약)"
-- Task complete → suggest: "/clear 또는 새 세션 시작 추천합니다"
-- Use compaction-surviving keywords in your messages: "todo:", "next:", "pending:", "remaining:"
-- Always write FULL file paths (e.g., src/auth/login.ts) — paths with extensions survive compaction
-- Resume within 5 min of leaving: "claude --resume latest" (cache still alive)
-- Want to try two approaches? Suggest session fork
-- Remind user periodically: "/cost 로 비용 확인해보세요"
-
-## 4. CACHE PROTECTION — cache_read is 10x cheaper than input ($1.50 vs $15)
-The Anthropic server cache expires after 5 minutes. When cache is alive, input costs drop 10x.
-WARN the user BEFORE these cache-breaking actions:
-- Model change mid-session → "캐시가 깨집니다. 새 세션에서 모델을 바꾸세요"
-- CLAUDE.md edit during session → "세션 시작 전에 CLAUDE.md를 수정하세요. 지금 수정하면 캐시가 깨집니다"
-- MCP server add/remove during session → "MCP 변경은 세션 시작 전에 하세요"
-- If user seems to have returned after a break → "잠시 쉬고 오셨나요? 캐시가 만료됐을 수 있어서 첫 요청 비용이 좀 더 나올 수 있습니다"
-
-## 5. OUTPUT EFFICIENCY
-- Output tokens cost 5x more than input ($75 vs $15 per 1M). Keep responses SHORT.
-- Don't summarize what you just did. Don't repeat the user's question.
-- Read ONLY the needed section of files, not entire files.
-- Unstable network (cafe WiFi etc)? Warn: "네트워크가 불안정하면 큰 작업은 피하세요. 타임아웃 → 재시도 → 이중 과금 가능"
-- Claude Code retries failed requests up to 2 times. Worst case: 3x billing for one request.
-
-## 6. PRODUCTIVITY
-- Complex tasks → suggest Plan Mode first: "먼저 Plan Mode에서 계획 세울까요? 파일 수정 없이 분석만 합니다"
-- Multiple independent subtasks → use sub-agents in parallel (Explore agents for research, general-purpose for implementation)
-- After code changes → suggest the pipeline: "/diff → /commit → /pr"
-- No CLAUDE.md in project? → call setup_project tool for full recommendations
-- Only enable NEEDED MCP servers. Each MCP's tool definitions consume tokens on EVERY request.
-- Suggest permission mode matching task type:
-  - Review only: claude --permission-mode read-only
-  - Development: claude --permission-mode workspace-write
-  - Automation: configure settings.json allow list for common tools
-
-## 7. WHEN TO CALL TOOLS
-- analyze_task: At the start of EACH new task (model + approach recommendation)
-- setup_project: When project lacks CLAUDE.md, or user asks about setup optimization
-- cost_reference: When user asks about pricing, or when justifying model recommendation
+STEP 3: DO THE WORK
+Now proceed with the task. While working, follow these rules:
+- Keep responses short (output costs 5x more than input)
+- Read only needed file sections, not entire files
+- Use full file paths in your messages (e.g., src/auth/login.ts) — they survive compaction
+- After finishing → suggest "/cost 로 비용 확인해보세요"
+- If the topic changes → suggest new session ("새 작업이니 새 세션이 효율적입니다")
+- If conversation is long → suggest /compact
+- NEVER change model mid-session (cache break = 10x cost spike). Suggest new session instead.
+- WARN before editing CLAUDE.md mid-session ("캐시가 깨집니다. 세션 시작 전에 수정하세요")
+- Complex tasks → suggest Plan Mode first
+- Multiple independent tasks → use sub-agents in parallel
+- After code changes → suggest "/diff → /commit → /pr"
 `;
 // =============================================================================
 // Task Complexity Analysis — 작업 복잡도 판단 로직

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coding-buddy-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "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",