coding-buddy-mcp 1.0.2 → 1.1.0

package/dist/index.js

@@ -7,111 +7,39 @@ import { z } from "zod";
 // 두 글의 37개 액션아이템을 전부 Claude 행동 규칙으로 인코딩.
 // =============================================================================
 const INSTRUCTIONS = `
-You are enhanced with Coding Buddy — a pair programming optimizer for Claude Code.
-
-======================================================================
-CRITICAL GATE — YOU MUST FOLLOW THIS BEFORE EVERY ACTION
-======================================================================
-
-BEFORE calling ANY tool (Read, Glob, Grep, Bash, Edit, Agent, etc.), evaluate the user's request:
-
-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 — SPECIFICITY
-======================================================================
-
-======================================================================
-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: "새 작업이니 새 세션에서 하는 게 효율적입니다"
-- 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
+You have a Coding Buddy. A UserPromptSubmit hook injects IMPORTANT hints before each message.
+You MUST follow every IMPORTANT hint from the hook — they come from the user's configured rules.
+
+Additionally, follow these rules while working:
+
+## 비용 최적화
+- Output은 input보다 5배 비싸다 ($75 vs $15/1M). 응답을 짧게 유지하라.
+- 파일 전체를 읽지 말고 필요한 섹션만 읽어라.
+- 불필요한 요약을 하지 마라 ("제가 한 작업을 정리하면..." 금지).
+- Thinking 토큰도 output 단가로 과금된다. 단순 작업에 과도한 사고는 낭비다.
+
+## 캐시 보호
+- 5분 자리비움 후 복귀 시 → "캐시가 만료됐을 수 있습니다"
+- 네트워크 불안정 시 → "큰 작업은 피하세요. 타임아웃→재시도→이중과금 가능"
+
+## 세션 관리
+- 작업 완료 후 → "/clear 또는 새 세션을 추천합니다"
+- 대화 길어지면 → "/compact 한번 해주세요"
+- 5분 이내 이어하기 → "claude --resume latest"
+- 두 가지 방향 시도 → 세션 fork 제안
+- /cost 로 비용 확인 주기적으로 안내
+
+## 압축 생존
+- 메시지에 todo:, next:, pending: 키워드 사용 (압축 후에도 보존됨)
+- 파일 경로를 정확히 언급 (src/auth/login.ts 형태, 최대 8개 보존됨)
+
+## 생산성
+- 독립적 다중 작업 → 서브에이전트로 병렬 실행
+- 코드 변경 완료 후 → "/diff → /commit → /pr 파이프라인" 안내
+- CLAUDE.md 없는 프로젝트 → setup_project 도구 호출 또는 /init 제안
+- 권한 모드: 리뷰=read-only, 개발=workspace-write
+- settings.json에 자주 쓰는 도구 자동 허용 안내
+- 필요한 MCP만 켜라 (각 MCP 도구 정의가 매 요청 토큰 차지)
 `;
 // =============================================================================
 // Task Complexity Analysis — 작업 복잡도 판단 로직

package/package.json

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

package/scripts/buddy-hook.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+# Coding Buddy - UserPromptSubmit Hook
+# 37개 액션아이템 중 강제성이 필요한 항목을 훅으로 실행한다.
+# 매 유저 프롬프트마다 실행되어 Claude에게 리마인더를 주입한다.
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | python3 -c "
+import sys,json
+d = json.load(sys.stdin)
+print(d.get('message', d.get('prompt', d.get('content', d.get('text', '')))))
+" 2>/dev/null)
+
+if [ -z "$PROMPT" ]; then
+  exit 0
+fi
+
+LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+HINTS=""
+
+# ==========================================================
+# 1. 모호한 요청 감지 (도구 폭발 방지)
+# ==========================================================
+HAS_PATH=false
+echo "$PROMPT" | grep -qE '[a-zA-Z0-9_-]+/[a-zA-Z0-9_.-]+\.[a-zA-Z]{1,5}' && HAS_PATH=true
+echo "$PROMPT" | grep -qE '\.[tj]sx?$|\.(rs|py|go|json|md|css|html|vue|svelte)' && HAS_PATH=true
+
+VAGUE=false
+if [ "$HAS_PATH" = false ]; then
+  if echo "$LOWER" | grep -qiE '버그.*(찾|fix)|리팩토링|refactor|개선|improve|테스트.*작성|write.*test|에러가 나|error|코드.*리뷰|review|설명해|explain.*code|분석해|analyz'; then
+    VAGUE=true
+  fi
+fi
+
+if [ "$VAGUE" = true ]; then
+  HINTS="${HINTS}IMPORTANT: 이 요청은 구체적이지 않습니다. 도구를 호출하지 말고 파일 경로와 증상을 먼저 물어보세요. 모호한 요청은 4+턴 10+도구호출로 비용이 낭비됩니다.\n"
+fi
+
+# ==========================================================
+# 2. 주제 변경 감지 (세션 분리)
+# ==========================================================
+if echo "$LOWER" | grep -qiE '그건 됐고|이제 다른|다음으로|다른 작업|다른 거|이건 끝|이건 됐|넘어가|다음 할|다른 주제|그만하고|전환|switch to|move on|next task|different thing|change topic'; then
+  HINTS="${HINTS}IMPORTANT: 주제가 바뀌는 것 같습니다. 반드시 이렇게 안내하세요: '새 작업이니 새 세션에서 시작하는 게 효율적입니다. 한 세션에 한 작업이 비용과 품질 모두 유리합니다.'\n"
+fi
+
+# ==========================================================
+# 3. 작업 복잡도 분석 → 모델 추천
+# ==========================================================
+COMPLEXITY="medium"
+if echo "$LOWER" | grep -qiE '오타|typo|rename|이름.*변경|format|포맷|간단|simple|삭제.*줄|주석|comment|import|복사|copy|move file|간단히|quick'; then
+  COMPLEXITY="simple"
+elif echo "$LOWER" | grep -qiE 'migrat|마이그레이션|architect|아키텍처|전체.*리팩|redesign|rewrite|스키마|schema|from scratch|전체 구조|시스템.*설계|데이터베이스|다시 만들|overhaul'; then
+  COMPLEXITY="complex"
+fi
+
+case $COMPLEXITY in
+  simple)
+    MODEL_REC="Haiku (\$1/\$5 per 1M)"
+    MODEL_CMD="/model haiku"
+    ;;
+  complex)
+    MODEL_REC="Opus (\$15/\$75 per 1M)"
+    MODEL_CMD="/model opus"
+    ;;
+  *)
+    MODEL_REC="Sonnet (\$15/\$75 per 1M)"
+    MODEL_CMD="/model sonnet"
+    ;;
+esac
+
+if [ "$VAGUE" = false ]; then
+  HINTS="${HINTS}IMPORTANT: 응답 첫 줄에 반드시 포함 → 💡 모델 추천: ${MODEL_REC}. 현재 모델이 다르면 새 세션에서 ${MODEL_CMD} 을 안내하세요.\n"
+fi
+
+# ==========================================================
+# 4. 복잡한 작업 → Plan Mode 제안
+# ==========================================================
+if [ "$COMPLEXITY" = "complex" ]; then
+  HINTS="${HINTS}IMPORTANT: 복잡한 작업입니다. 반드시 Plan Mode를 먼저 제안하세요: '먼저 Plan Mode에서 영향받는 파일을 파악한 후 실행하는 게 효율적입니다.'\n"
+fi
+
+# ==========================================================
+# 5. CLAUDE.md 수정 감지 → 캐시 브레이크 경고
+# ==========================================================
+if echo "$LOWER" | grep -qiE 'claude\.md.*(수정|추가|변경|편집|update|edit|modify|add)|claude\.md.*rule|규칙.*claude'; then
+  HINTS="${HINTS}IMPORTANT: CLAUDE.md 수정은 캐시 브레이크를 유발합니다. 반드시 경고하세요: '세션 시작 전에 CLAUDE.md를 수정하세요. 지금 수정하면 캐시가 깨져서 비용이 10배 올라갑니다.'\n"
+fi
+
+# ==========================================================
+# 6. 모델 변경 요청 감지 → 캐시 브레이크 경고
+# ==========================================================
+if echo "$LOWER" | grep -qiE '모델.*(바꿔|변경|전환|switch)|haiku로|sonnet으로|opus로|change.*model|switch.*model'; then
+  HINTS="${HINTS}IMPORTANT: 세션 중 모델 변경은 캐시 브레이크(비용 10배)를 유발합니다. 반드시 안내: '새 세션에서 모델을 바꾸세요. 세션 중간에 바꾸면 캐시가 깨집니다.'\n"
+fi
+
+# ==========================================================
+# 7. MCP 변경 감지 → 캐시 브레이크 경고
+# ==========================================================
+if echo "$LOWER" | grep -qiE 'mcp.*(추가|삭제|켜|끄|설정|변경|add|remove|enable|disable)'; then
+  HINTS="${HINTS}IMPORTANT: MCP 변경은 캐시 브레이크를 유발합니다. 안내: 'MCP 설정은 세션 시작 전에 하세요.'\n"
+fi
+
+# ==========================================================
+# 8. 전체 프로젝트 탐색 요청 → 범위 축소 유도
+# ==========================================================
+if echo "$LOWER" | grep -qiE '전체 구조|프로젝트 전체|전체 파일|모든 파일|entire project|all files|whole project|전체.*파악|프로젝트.*설명'; then
+  HINTS="${HINTS}IMPORTANT: 전체 프로젝트 탐색은 비용이 큽니다. 구체적인 디렉토리나 파일을 지정하도록 안내하세요.\n"
+fi
+
+# ==========================================================
+# 출력
+# ==========================================================
+if [ -n "$HINTS" ]; then
+  printf "$HINTS"
+fi
+
+exit 0