@su-record/vibe 2.7.8 → 2.7.10

package/package.json

@@ -1,121 +1,121 @@
-{
-  "name": "@su-record/vibe",
-  "version": "2.7.8",
-  "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
-  "type": "module",
-  "main": "dist/cli/index.js",
-  "exports": {
-    ".": "./dist/cli/index.js",
-    "./agent": {
-      "types": "./dist/agent/index.d.ts",
-      "default": "./dist/agent/index.js"
-    },
-    "./tools": "./dist/tools/index.js",
-    "./tools/memory": "./dist/tools/memory/index.js",
-    "./tools/convention": "./dist/tools/convention/index.js",
-    "./tools/semantic": "./dist/tools/semantic/index.js",
-    "./tools/ui": "./dist/tools/ui/index.js",
-    "./tools/time": "./dist/tools/time/index.js",
-    "./tools/interaction": "./dist/tools/interaction/index.js",
-    "./orchestrator": "./dist/infra/orchestrator/index.js",
-    "./interface": {
-      "types": "./dist/interface/index.d.ts",
-      "default": "./dist/interface/index.js"
-    },
-    "./router": {
-      "types": "./dist/router/index.d.ts",
-      "default": "./dist/router/index.js"
-    },
-    "./memory": {
-      "types": "./dist/infra/lib/memory/index.d.ts",
-      "default": "./dist/infra/lib/memory/index.js"
-    },
-    "./policy": {
-      "types": "./dist/infra/policy/index.d.ts",
-      "default": "./dist/infra/policy/index.js"
-    },
-    "./lib/gpt": "./dist/infra/lib/gpt-api.js",
-    "./lib/gemini": "./dist/infra/lib/gemini-api.js"
-  },
-  "bin": {
-    "vibe": "dist/cli/index.js"
-  },
-  "scripts": {
-    "build": "tsc && chmod +x dist/cli/index.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build",
-    "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
-    "release": "pnpm version patch && npm publish --access public"
-  },
-  "keywords": [
-    "ai",
-    "core",
-    "coding",
-    "spec-driven",
-    "claude",
-    "agent",
-    "requirements",
-    "user-story",
-    "ultrawork",
-    "parallel-agents",
-    "memory-management",
-    "knowledge-graph",
-    "code-analysis",
-    "code-quality"
-  ],
-  "author": "Su",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/su-record/vibe.git"
-  },
-  "homepage": "https://github.com/su-record/vibe#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "optionalDependencies": {
-    "@ast-grep/napi": "^0.40.5"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.6",
-    "@clack/prompts": "^1.0.0",
-    "better-sqlite3": "^12.6.2",
-    "chalk": "^5.3.0",
-    "glob": "^13.0.1",
-    "node-cron": "^3.0.3",
-    "papaparse": "^5.5.3",
-    "playwright": "^1.58.2",
-    "ts-morph": "^26.0.0",
-    "uuidv7": "^1.1.0",
-    "vscode-languageserver-protocol": "^3.17.5",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.0.0",
-    "@types/node-cron": "^3.0.11",
-    "@types/papaparse": "^5.5.2",
-    "ajv": "^8.17.1",
-    "typescript": "^5.5.4",
-    "vitest": "^4.0.9"
-  },
-  "files": [
-    "dist/",
-    "vibe/",
-    "languages/",
-    "commands/",
-    "agents/",
-    "skills/",
-    "hooks/",
-    ".env.example",
-    ".env",
-    "CLAUDE.md",
-    "README.md",
-    "LICENSE"
-  ]
-}
+{
+  "name": "@su-record/vibe",
+  "version": "2.7.10",
+  "description": "AI Coding Framework for Claude Code — 49 agents, 41+ tools, multi-LLM orchestration",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "exports": {
+    ".": "./dist/cli/index.js",
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
+    },
+    "./tools": "./dist/tools/index.js",
+    "./tools/memory": "./dist/tools/memory/index.js",
+    "./tools/convention": "./dist/tools/convention/index.js",
+    "./tools/semantic": "./dist/tools/semantic/index.js",
+    "./tools/ui": "./dist/tools/ui/index.js",
+    "./tools/time": "./dist/tools/time/index.js",
+    "./tools/interaction": "./dist/tools/interaction/index.js",
+    "./orchestrator": "./dist/infra/orchestrator/index.js",
+    "./interface": {
+      "types": "./dist/interface/index.d.ts",
+      "default": "./dist/interface/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "default": "./dist/router/index.js"
+    },
+    "./memory": {
+      "types": "./dist/infra/lib/memory/index.d.ts",
+      "default": "./dist/infra/lib/memory/index.js"
+    },
+    "./policy": {
+      "types": "./dist/infra/policy/index.d.ts",
+      "default": "./dist/infra/policy/index.js"
+    },
+    "./lib/gpt": "./dist/infra/lib/gpt-api.js",
+    "./lib/gemini": "./dist/infra/lib/gemini-api.js"
+  },
+  "bin": {
+    "vibe": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build",
+    "postinstall": "node -e \"import('./dist/cli/postinstall/main.js').then(m=>m.main()).catch(()=>{})\"",
+    "release": "pnpm version patch && npm publish --access public"
+  },
+  "keywords": [
+    "ai",
+    "core",
+    "coding",
+    "spec-driven",
+    "claude",
+    "agent",
+    "requirements",
+    "user-story",
+    "ultrawork",
+    "parallel-agents",
+    "memory-management",
+    "knowledge-graph",
+    "code-analysis",
+    "code-quality"
+  ],
+  "author": "Su",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/su-record/vibe.git"
+  },
+  "homepage": "https://github.com/su-record/vibe#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@ast-grep/napi": "^0.40.5"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.6",
+    "@clack/prompts": "^1.0.0",
+    "better-sqlite3": "^12.6.2",
+    "chalk": "^5.3.0",
+    "glob": "^13.0.1",
+    "node-cron": "^3.0.3",
+    "papaparse": "^5.5.3",
+    "playwright": "^1.58.2",
+    "ts-morph": "^26.0.0",
+    "uuidv7": "^1.1.0",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
+    "@types/papaparse": "^5.5.2",
+    "ajv": "^8.17.1",
+    "typescript": "^5.5.4",
+    "vitest": "^4.0.9"
+  },
+  "files": [
+    "dist/",
+    "vibe/",
+    "languages/",
+    "commands/",
+    "agents/",
+    "skills/",
+    "hooks/",
+    ".env.example",
+    ".env",
+    "CLAUDE.md",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/skills/agents-md/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: agents-md
+description: "Optimize AGENTS.md / CLAUDE.md by removing discoverable info and keeping only gotchas. Based on Addy Osmani's AGENTS.md principles. Activates on agents.md, claude.md, context file optimization."
+triggers: [agents.md, claude.md, context file, optimize agents, optimize claude]
+priority: 50
+---
+
+# agents-md — Context File Optimizer
+
+AGENTS.md / CLAUDE.md를 최적화한다.
+근거: https://addyosmani.com/blog/agents-md/
+
+## 핵심 원칙
+
+**한 줄 테스트**: "에이전트가 코드를 읽어서 스스로 알 수 있는가?" → Yes면 삭제.
+
+## Step 1: 대상 파일 찾기
+
+프로젝트 루트에서 다음 파일을 탐색한다:
+
+```
+Glob: pattern="AGENTS.md"
+Glob: pattern="CLAUDE.md"
+Glob: pattern=".cursorrules"
+Glob: pattern=".github/copilot-instructions.md"
+Glob: pattern=".windsurfrules"
+```
+
+대상 파일이 없으면 새로 생성할지 사용자에게 확인한다.
+
+## Step 2: 현재 내용 분류
+
+파일의 각 항목을 다음 기준으로 분류한다:
+
+### 삭제 (Discoverable)
+
+에이전트가 코드 탐색으로 발견 가능한 정보:
+
+| 유형 | 예시 | 발견 경로 |
+|------|------|----------|
+| 디렉토리 구조 | "src/에 컴포넌트가 있다" | `ls`, `Glob` |
+| 기술 스택 | "React + TypeScript 사용" | `package.json`, 파일 확장자 |
+| Phase/진행 테이블 | "Phase 1 ✅, Phase 2 ✅..." | 이력일 뿐, 행동 지침 아님 |
+| 빌드/테스트 커맨드 | "npm test로 테스트 실행" | `package.json` scripts |
+| API 엔드포인트 목록 | "POST /api/users" | 라우터 코드 |
+| 기능별 상세 설명 | "Phase 3에서 서킷브레이커 구현" | 해당 코드 읽으면 파악 가능 |
+| 아키텍처 다이어그램 | ASCII 박스 다이어그램 | 개념적 설명, 실수 방지 효과 없음 |
+
+### 유지 (Non-discoverable)
+
+에이전트가 코드만으로 알 수 없는 함정과 규칙:
+
+| 유형 | 예시 |
+|------|------|
+| 런타임 함정 | "Bun이다, Node가 아니다" (package.json에 명시 안 됨) |
+| 금지 패턴 | "require() 쓰지 말 것", "React 패턴 금지" |
+| SSOT 위치 | "model-registry.ts만 수정할 것, 하드코딩 금지" |
+| 불변 순서/규칙 | "우선순위: A → B → C, 이 순서 변경 금지" |
+| 재시도/폴백 제한 | "최대 2회, 3회 이상 금지" |
+| 도구 선택 | "Zod만 사용, joi/yup 금지" |
+| 네이밍 컨벤션 | 비표준 패턴 (표준이면 삭제) |
+| 프로젝트 한 줄 소개 | 코드만으로 목적 파악 어려운 경우 |
+| 언어/응답 지시 | "한글로 답변" 같은 선호 |
+
+### 앵커링 주의
+
+기술 이름을 언급하면 에이전트가 해당 기술로 편향된다. "무엇을 쓰지 말라"는 유용하지만, "우리는 X를 쓴다"는 코드에서 이미 보인다면 불필요.
+
+## Step 3: 재구성
+
+다음 구조로 재작성한다:
+
+```markdown
+# {프로젝트명} — {한 줄 소개}
+
+{프로젝트가 무엇을 하는지 1-2문장. 코드만으로 목적 파악이 어려운 경우에만.}
+
+# Gotchas
+
+- **{함정 제목}.** {구체적 금지/규칙 설명}.
+- ...
+
+# Naming
+
+{비표준 네이밍 패턴이 있을 때만. 표준(camelCase 등)이면 생략.}
+```
+
+규칙:
+- 섹션은 최대 3개 (소개, Gotchas, Naming)
+- Gotchas 항목은 각각 **볼드 제목 + 구체적 do/don't**
+- "~를 사용한다" 보다 "~를 쓰지 말 것"이 더 유용
+- 전체 50줄 이내 목표
+
+## Step 4: CLAUDE.md 분리 (해당 시)
+
+CLAUDE.md가 존재하면 Claude 전용 지시만 남긴다:
+
+```markdown
+{Claude 전용 지시. 예: "답변은 반드시 한글로 답변할 것."}
+```
+
+공통 규칙은 AGENTS.md에 둔다. Claude Code는 둘 다 읽는다.
+
+## Step 5: 결과 보고
+
+```markdown
+## AGENTS.md 최적화 결과
+
+| 지표 | Before | After |
+|------|--------|-------|
+| 줄 수 | N | N |
+| 삭제 항목 | - | N개 (discoverable) |
+| 유지 항목 | - | N개 (gotchas) |
+
+### 삭제된 항목
+- {항목}: {삭제 이유}
+
+### 유지/추가된 항목
+- {항목}: {유지 이유}
+```

package/skills/brand-assets/SKILL.md

@@ -1,138 +1,146 @@
----
-name: brand-assets
-description: "Auto-generate app icons and favicons from SPEC brand information using Gemini Image API"
-triggers: [icon, favicon, brand, logo, app icon, branding, assets]
-priority: 65
----
-# Brand Assets Generation Skill
-
-Auto-generate app icons and favicons based on SPEC brand information.
-
-## When to Use
-
-- First-time project setup with `/vibe.run`
-- When SPEC contains brand/design information
-- When Gemini API key is configured
-
-## Prerequisites
-
-- Gemini API key configured (`vibe gemini auth`)
-- SPEC with brand context (app name, colors, style)
-
-## Generated Assets
-
-### Web
-- `favicon.ico` (16x16, 32x32, 48x48)
-- `favicon-16x16.png`
-- `favicon-32x32.png`
-- `apple-touch-icon.png` (180x180)
-- `android-chrome-192x192.png`
-- `android-chrome-512x512.png`
-
-### Mobile (if applicable)
-- iOS: `AppIcon.appiconset/` with all sizes
-- Android: `mipmap-*/` adaptive icons
-
-## SPEC Brand Section
-
-For best results, include brand info in your SPEC:
-
-```yaml
-<context>
-Brand:
-  - App Name: MyApp
-  - Primary Color: #2F6BFF
-  - Style: Modern, minimal, flat design
-  - Icon Concept: Abstract geometric shape representing connectivity
-</context>
-```
-
-## Generation Flow
-
-```
-SPEC Brand Info
-      |
-      v
-Extract: name, colors, style keywords
-      |
-      v
-Generate Prompt: "App icon for [name], [style], [colors]..."
-      |
-      v
-Gemini Image API (gemini-2.5-flash-image)
-      |
-      v
-Resize & Convert: All platform sizes
-      |
-      v
-Save to: public/ or assets/
-```
-
-## Auto-Trigger Conditions
-
-1. First `/vibe.run` execution (no existing icons)
-2. SPEC contains brand/design context
-3. Gemini API key is available
-4. `--generate-icons` flag passed
-
-## Skip Conditions
-
-- Icons already exist (unless `--regenerate-icons`)
-- No brand info in SPEC
-- Gemini API not configured
-
-## Prompt Template
-
-```
-Create a modern app icon for "[APP_NAME]".
-
-Style: [STYLE_KEYWORDS]
-Primary color: [PRIMARY_COLOR]
-Design: Minimalist, professional, suitable for mobile app
-Format: Square, clean edges, simple recognizable shape
-Background: Solid color or subtle gradient
-
-Requirements:
-- Works at small sizes (16x16 to 512x512)
-- No text or letters
-- Single focal element
-- High contrast for visibility
-```
-
-## Manual Usage
-
-```bash
-# [LLM_SCRIPT] = {{CORE_PATH}}/hooks/scripts/llm-orchestrate.js
-# Generate via llm-orchestrate (when Gemini configured)
-node "[LLM_SCRIPT]" gemini image "App icon for MyApp, primary color #2F6BFF, square format 1:1, simple recognizable design, works well at small sizes, no text or letters, solid or gradient background, modern minimalist" --output "./public/app-icon.png"
-```
-
-## Integration with /vibe.run
-
-During Phase 1 (Setup), if brand assets don't exist:
-
-1. Parse SPEC for brand context
-2. Generate icon via Gemini Image API
-3. Create all size variants
-4. Place in appropriate directories
-5. Update manifest files if needed
-
-## Fallback Strategy
-
-If Gemini Image fails:
-1. Generate text-based monogram icon (first letter)
-2. Use project primary color as background
-3. Create simple geometric placeholder
-
-## Output Structure
-
-```
-public/
-  favicon.ico
-  favicon-16x16.png
-  favicon-32x32.png
-  apple-touch-icon.png
-  android-chrome-192x192.png
-  android-chrome-512x512.png
-  site.webmanifest
-```
+---
+name: brand-assets
+description: "Auto-generate app icons and favicons from SPEC brand information using Gemini Image API"
+triggers: [icon, favicon, brand, logo, app icon, branding, assets]
+priority: 65
+---
+# Brand Assets Generation Skill
+
+Auto-generate app icons and favicons based on SPEC brand information.
+
+## When to Use
+
+- First-time project setup with `/vibe.run`
+- When SPEC contains brand/design information
+- When Gemini API key is configured
+
+## Prerequisites
+
+- Gemini API key configured (`vibe gemini auth`)
+- SPEC with brand context (app name, colors, style)
+
+## Generated Assets
+
+### Web
+- `favicon.ico` (16x16, 32x32, 48x48)
+- `favicon-16x16.png`
+- `favicon-32x32.png`
+- `apple-touch-icon.png` (180x180)
+- `android-chrome-192x192.png`
+- `android-chrome-512x512.png`
+
+### Mobile (if applicable)
+- iOS: `AppIcon.appiconset/` with all sizes
+- Android: `mipmap-*/` adaptive icons
+
+## SPEC Brand Section
+
+For best results, include brand info in your SPEC:
+
+```yaml
+<context>
+Brand:
+  - App Name: MyApp
+  - Primary Color: #2F6BFF
+  - Style: Modern, minimal, flat design
+  - Icon Concept: Abstract geometric shape representing connectivity
+</context>
+```
+
+## Generation Flow
+
+```
+SPEC Brand Info
+      |
+      v
+Extract: name, colors, style keywords
+      |
+      v
+Generate Prompt: "App icon for [name], [style], [colors]..."
+      |
+      v
+Gemini Image API (gemini-2.5-flash-image)
+      |
+      v
+Resize & Convert: All platform sizes
+      |
+      v
+Save to: public/ or assets/
+```
+
+## Auto-Trigger Conditions
+
+1. First `/vibe.run` execution (no existing icons)
+2. SPEC contains brand/design context
+3. Gemini API key is available
+4. `--generate-icons` flag passed
+
+## Skip Conditions
+
+- Icons already exist (unless `--regenerate-icons`)
+- No brand info in SPEC
+- Gemini API not configured
+
+## Prompt Template
+
+```
+Create a modern app icon for "[APP_NAME]".
+
+Style: [STYLE_KEYWORDS]
+Primary color: [PRIMARY_COLOR]
+Design: Minimalist, professional, suitable for mobile app
+Format: Square, clean edges, simple recognizable shape
+Background: Solid color or subtle gradient
+
+Requirements:
+- Works at small sizes (16x16 to 512x512)
+- No text or letters
+- Single focal element
+- High contrast for visibility
+```
+
+## Manual Usage
+
+```bash
+# [LLM_SCRIPT] = {{CORE_PATH}}/hooks/scripts/llm-orchestrate.js
+# Generate via llm-orchestrate (when Gemini configured)
+node "[LLM_SCRIPT]" gemini image "App icon for MyApp, primary color #2F6BFF, square format 1:1, simple recognizable design, works well at small sizes, no text or letters, solid or gradient background, modern minimalist" --output "./public/app-icon.png"
+```
+
+## Integration with /vibe.run
+
+During Phase 1 (Setup), if brand assets don't exist:
+
+1. Parse SPEC for brand context
+2. Generate icon via Gemini Image API
+3. Create all size variants
+4. Place in appropriate directories
+5. Update manifest files if needed
+
+## Fallback Strategy
+
+If Gemini Image fails:
+1. Generate text-based monogram icon (first letter)
+2. Use project primary color as background
+3. Create simple geometric placeholder
+
+## Output Structure
+
+```
+public/
+  favicon.ico
+  favicon-16x16.png
+  favicon-32x32.png
+  apple-touch-icon.png
+  android-chrome-192x192.png
+  android-chrome-512x512.png
+  site.webmanifest
+```
+
+## Done Criteria (K4)
+
+- [ ] All required sizes generated (16x16 through 512x512)
+- [ ] Icons work at small sizes (recognizable at 16x16)
+- [ ] No text/letters in icon (illegible at small sizes)
+- [ ] `site.webmanifest` updated with icon paths
+- [ ] Fallback generated if Gemini API unavailable