@su-record/vibe 2.9.14 → 2.9.16

package/README.ko.md

@@ -1,199 +1,171 @@
-# VIBE
-
-**바이브 코딩은 쉽게. 최소 품질은 보장.**
-
-[![npm](https://img.shields.io/npm/v/@su-record/vibe)](https://www.npmjs.com/package/@su-record/vibe)
-[![npm downloads](https://img.shields.io/npm/dt/@su-record/vibe.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@su-record/vibe)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
-
-Vibe는 AI 코딩 도구를 위한 품질 하네스입니다. Claude Code, Codex, Cursor, Gemini CLI를 감싸고, 타입 안전성, 코드 품질, 보안을 자동으로 강제합니다. 빠르게 바이브 코딩하되, 엉망인 코드가 나가지 않게.
-
-```bash
-npm install -g @su-record/vibe
-vibe init
-```
-
----
-
-## 워크플로우
-
-진입점 하나. 나머지는 자동.
-
-```
-/vibe.spec "커피 브랜드 랜딩 페이지"
-     |
-     v
-  인터뷰    ─── "타깃은 누구?" "어떤 섹션?" "다크 모드?" ───
-     |                   (사용자가 "그만"할 때까지 반복)
-     v
-  기획서    ─── 구조화된 마크다운 기획서 (.claude/vibe/plans/)
-     |
-     v
-  SPEC     ─── PTCF 명세 + BDD 피처, GPT+Gemini 병렬 리서치
-     |
-     v
-  리뷰     ─── Race Review (GPT vs Gemini), 품질 게이트 (100점, 수렴까지 루프)
-     |
-     +──────────────────────────────┐
-     v                              v
-  /vibe.run (로직)             /vibe.figma (UI)
-  SPEC 기반 구현               Figma 디자인 ↔ 코드
-  12개 에이전트 리뷰            읽기 또는 쓰기
-     |                              |
-     v                              v
-  /vibe.verify ──── /vibe.trace ──── 완료
-```
-
-**Smart Resume** — 아무 단계에서나 멈추고, 세션을 닫고, 나중에 돌아오세요. `/vibe.spec`이 중단된 위치를 자동 감지하고 이어서 진행합니다. feature 이름을 외울 필요 없음.
-
-**ultrawork** — 어느 명령이든 `ultrawork`를 붙이면 모든 확인 게이트를 건너뛰고 전체 파이프라인을 자동 실행합니다.
-
----
-
-## 빠른 시작
-
-```bash
-# 설치
-npm install -g @su-record/vibe
-
-# 프로젝트 초기화 (스택 자동 감지)
-cd your-project
-vibe init
-
-# AI 코딩 도구 시작
-claude
-
-# 워크플로우 실행
-/vibe.spec "사용자 인증 추가"
-```
-
----
-
-## Figma ↔ 코드
-
-양방향. Figma에서 디자인을 읽거나, 기획서에서 Figma에 디자인을 쓰거나.
-
-```bash
-# READ — 기존 프로젝트에 UI 추가 (프로젝트 컨벤션 준수)
-/vibe.figma <figma-url> <figma-url>
-
-# READ — 신규 독립 페이지 (독립 스타일)
-/vibe.figma --new <figma-url>
-
-# WRITE — 기획서에서 Figma 디자인 생성
-/vibe.figma plan.md --create                 # Full (와이어 + 비주얼 디자인)
-/vibe.figma plan.md --create-storyboard      # 와이어만
-/vibe.figma plan.md --create-design          # 비주얼 디자인만
-```
-
-**READ 동작**: Figma REST API로 노드 트리 + 30개 CSS 속성 추출. Auto Layout → Flexbox 1:1 기계적 매핑. 스크린샷은 검증용 — 트리가 원천.
-
-**WRITE 동작**: 기획서의 Look & Feel, 레이아웃, 반응형 전략 섹션을 파싱하여 와이어프레임을 먼저 그리고 (구조 검토), 그 위에 디자인 시스템 컴포넌트로 비주얼 적용. 멱등성 보장 — 기획서 수정 후 재실행하면 변경된 섹션만 갱신.
-
----
-
-## 품질 게이트
-
-모든 도구 호출마다 3계층 방어:
-
-| 계층 | 차단 대상 |
-|------|----------|
-| Pre-commit 훅 | `any` 타입, `@ts-ignore`, `console.log`, 50줄 초과 함수 |
-| 리뷰 에이전트 | 12개 전문 리뷰어 병렬 실행 (보안, 성능, 접근성, 복잡도, ...) |
-| 수렴 루프 | 리뷰 findings P1=0까지 루프. 라운드 캡 없음. Stuck이면 사용자에게 질문, 절대 조용히 넘어가지 않음. |
-
----
-
-## 주요 기능
-
-**40+ 에이전트** — 탐색, 구현, 아키텍처, 병렬 코드 리뷰, UI/UX 분석, 보안 감사, Figma 분석/빌드.
-
-**44개 스킬** — 한 번에 다 로드되지 않음. 3-tier 시스템으로 컨텍스트 과부하 방지:
-
-| 티어 | 로드 시점 | 용도 | 예시 |
-|------|----------|------|------|
-| **Core** | 항상 활성 | 버그 방지, 워크플로 진입 | 품질 게이트, 인터뷰, 기획 |
-| **Standard** | `vibe init`이 스택별 선택 | 스택/역할 지원 | figma, design-audit, techdebt |
-| **Optional** | 명시적 `/skill` 호출만 | 레퍼런스, 래퍼 | chub-usage, context7 |
-
-**멀티 LLM** — Claude가 오케스트레이션, GPT가 추론, Gemini가 리서치. 가용 모델에 따라 자동 라우팅. 기본값은 Claude 단독. vibe-codex 또는 Coco 환경(GPT 주관)에서는 Claude CLI가 보조로 전환되어 cross-validation 수행 — `ANTHROPIC_BASE_URL` 또는 `~/.coco/` 감지로 역할 자동 역전.
-
-**스택 감지** — 24개 프레임워크 자동 감지 (Next.js, Django, Rails, Go, Rust, Flutter 등) 후 프레임워크별 규칙과 스킬 적용.
-
-**세션 메모리** — 결정, 제약, 목표가 SQLite + FTS5 검색으로 세션 간 유지.
-
-**Smart Resume** — `.last-feature` 포인터가 마지막 작업을 추적. 인자 없이 `/vibe.spec`을 호출하면 중단된 위치를 보여주거나 진행 중 feature 목록을 제시.
-
----
-
-## Codex Proxy
-
-ChatGPT Pro 모델(gpt-5.4, gpt-5.3-codex 등)을 Claude Code의 백엔드로 사용합니다. Codex Responses API를 통해 ChatGPT Pro 구독으로 과금 — API 토큰 과금 없음.
-
-```bash
-# 최초 설정 (codex login 인증 자동 감지)
-vibe codex --setup
-
-# ChatGPT Pro 모델로 Claude Code 실행
-vibe-codex
-```
-
-**동작 원리**: 로컬 프록시가 Anthropic Messages API ↔ Codex Responses API를 변환합니다. Claude Code가 프록시에 요청하면, 프록시가 ChatGPT Pro OAuth 토큰으로 `chatgpt.com/backend-api/codex/responses`에 전달합니다.
-
-**모델 자동 선택**: Codex CLI의 모델 캐시에서 항상 최신 모델을 사용합니다. OpenAI가 새 모델을 출시하면 다음 실행 시 자동 반영 — 재설정 불필요.
-
-**모델 슬롯**: Claude Code의 `/model` 선택기가 각각 다른 ChatGPT Pro 모델에 자동 매핑됩니다:
-
-| 슬롯 | 매핑 대상 | 용도 |
-|------|-----------|------|
-| Opus | 최신 플래그십 (예: gpt-5.4) | 최고 성능 |
-| Sonnet | 최신 codex (예: gpt-5.3-codex) | 코딩 특화 |
-| Haiku | 최신 codex-spark (예: gpt-5.3-codex-spark) | 고속 응답 (1000+ tok/s) |
-
-**지원 프로바이더**: ChatGPT Pro (`codex login` 자동 감지), OpenAI API Key, Gemini API Key, 커스텀 OpenAI 호환 엔드포인트.
-
----
-
-## 지원 도구
-
-| CLI | 상태 |
-|-----|------|
-| [Claude Code](https://claude.ai/code) | 전체 지원 |
-| Coco (`~/.coco/`) | 전체 지원 (자동 감지) |
-| [Codex](https://github.com/openai/codex) | 플러그인 |
-| [Cursor](https://cursor.sh) | 에이전트 + 룰 |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 에이전트 + 스킬 |
-
----
-
-## 명령어
-
-| 명령어 | 용도 |
-|--------|------|
-| `/vibe.spec` | 단일 진입점 — 인터뷰, 기획, SPEC, 리뷰, 그리고 구현까지 |
-| `/vibe.run` | SPEC 기반 구현 |
-| `/vibe.figma` | Figma ↔ 코드 (읽기 또는 쓰기, 3가지 모드) |
-| `/vibe.verify` | 구현이 SPEC에 맞는지 검증 |
-| `/vibe.trace` | 요구사항 추적 매트릭스 |
-
----
-
-## 문서
-
-상세 가이드, 스킬 레퍼런스, 설정 방법은 [Wiki](https://github.com/su-record/vibe/wiki)를 참고하세요.
-
-- [README (English)](README.md)
-- [릴리스 노트](RELEASE_NOTES.md)
-
----
-
-## 요구사항
-
-- Node.js >= 18.0.0
-- Claude Code (필수)
-- GPT, Gemini (선택)
-
-## 라이선스
-
-MIT — Copyright (c) 2025 Su
+# VIBE
+
+**바이브 코딩은 쉽게. 최소 품질은 보장.**
+
+[![npm](https://img.shields.io/npm/v/@su-record/vibe)](https://www.npmjs.com/package/@su-record/vibe)
+[![npm downloads](https://img.shields.io/npm/dt/@su-record/vibe.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@su-record/vibe)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
+
+Vibe는 AI 코딩 도구를 위한 품질 하네스입니다. Claude Code, Codex, Cursor, Gemini CLI를 감싸고, 타입 안전성, 코드 품질, 보안을 자동으로 강제합니다. 빠르게 바이브 코딩하되, 엉망인 코드가 나가지 않게.
+
+```bash
+npm install -g @su-record/vibe
+vibe init
+```
+
+---
+
+## 워크플로우
+
+진입점 하나. 나머지는 자동.
+
+```
+/vibe.spec "커피 브랜드 랜딩 페이지"
+     |
+     v
+  인터뷰    ─── "타깃은 누구?" "어떤 섹션?" "다크 모드?" ───
+     |                   (사용자가 "그만"할 때까지 반복)
+     v
+  기획서    ─── 구조화된 마크다운 기획서 (.claude/vibe/plans/)
+     |
+     v
+  SPEC     ─── PTCF 명세 + BDD 피처, GPT+Gemini 병렬 리서치
+     |
+     v
+  리뷰     ─── Race Review (GPT vs Gemini), 품질 게이트 (100점, 수렴까지 루프)
+     |
+     +──────────────────────────────┐
+     v                              v
+  /vibe.run (로직)             /vibe.figma (UI)
+  SPEC 기반 구현               Figma 디자인 ↔ 코드
+  12개 에이전트 리뷰            읽기 또는 쓰기
+     |                              |
+     v                              v
+  /vibe.verify ──── /vibe.trace ──── 완료
+```
+
+**Smart Resume** — 아무 단계에서나 멈추고, 세션을 닫고, 나중에 돌아오세요. `/vibe.spec`이 중단된 위치를 자동 감지하고 이어서 진행합니다. feature 이름을 외울 필요 없음.
+
+**ultrawork** — 어느 명령이든 `ultrawork`를 붙이면 모든 확인 게이트를 건너뛰고 전체 파이프라인을 자동 실행합니다.
+
+---
+
+## 빠른 시작
+
+```bash
+# 설치
+npm install -g @su-record/vibe
+
+# 프로젝트 초기화 (스택 자동 감지)
+cd your-project
+vibe init
+
+# AI 코딩 도구 시작
+claude
+
+# 워크플로우 실행
+/vibe.spec "사용자 인증 추가"
+```
+
+---
+
+## Figma ↔ 코드
+
+양방향. Figma에서 디자인을 읽거나, 기획서에서 Figma에 디자인을 쓰거나.
+
+```bash
+# READ — 기존 프로젝트에 UI 추가 (프로젝트 컨벤션 준수)
+/vibe.figma <figma-url> <figma-url>
+
+# READ — 신규 독립 페이지 (독립 스타일)
+/vibe.figma --new <figma-url>
+
+# WRITE — 기획서에서 Figma 디자인 생성
+/vibe.figma plan.md --create                 # Full (와이어 + 비주얼 디자인)
+/vibe.figma plan.md --create-storyboard      # 와이어만
+/vibe.figma plan.md --create-design          # 비주얼 디자인만
+```
+
+**READ 동작**: Figma REST API로 노드 트리 + 30개 CSS 속성 추출. Auto Layout → Flexbox 1:1 기계적 매핑. 스크린샷은 검증용 — 트리가 원천.
+
+**WRITE 동작**: 기획서의 Look & Feel, 레이아웃, 반응형 전략 섹션을 파싱하여 와이어프레임을 먼저 그리고 (구조 검토), 그 위에 디자인 시스템 컴포넌트로 비주얼 적용. 멱등성 보장 — 기획서 수정 후 재실행하면 변경된 섹션만 갱신.
+
+---
+
+## 품질 게이트
+
+모든 도구 호출마다 3계층 방어:
+
+| 계층 | 차단 대상 |
+|------|----------|
+| Pre-commit 훅 | `any` 타입, `@ts-ignore`, `console.log`, 50줄 초과 함수 |
+| 리뷰 에이전트 | 12개 전문 리뷰어 병렬 실행 (보안, 성능, 접근성, 복잡도, ...) |
+| 수렴 루프 | 리뷰 findings P1=0까지 루프. 라운드 캡 없음. Stuck이면 사용자에게 질문, 절대 조용히 넘어가지 않음. |
+
+---
+
+## 주요 기능
+
+**40+ 에이전트** — 탐색, 구현, 아키텍처, 병렬 코드 리뷰, UI/UX 분석, 보안 감사, Figma 분석/빌드.
+
+**44개 스킬** — 한 번에 다 로드되지 않음. 3-tier 시스템으로 컨텍스트 과부하 방지:
+
+| 티어 | 로드 시점 | 용도 | 예시 |
+|------|----------|------|------|
+| **Core** | 항상 활성 | 버그 방지, 워크플로 진입 | 품질 게이트, 인터뷰, 기획 |
+| **Standard** | `vibe init`이 스택별 선택 | 스택/역할 지원 | figma, design-audit, techdebt |
+| **Optional** | 명시적 `/skill` 호출만 | 레퍼런스, 래퍼 | chub-usage, context7 |
+
+**멀티 LLM** — Claude가 오케스트레이션, GPT가 추론, Gemini가 리서치. 가용 모델에 따라 자동 라우팅. 기본값은 Claude 단독. coco 환경(GPT 주관)에서는 Claude CLI가 보조로 전환되어 cross-validation 수행 — `~/.coco/` 감지로 역할 자동 역전.
+
+**스택 감지** — 24개 프레임워크 자동 감지 (Next.js, Django, Rails, Go, Rust, Flutter 등) 후 프레임워크별 규칙과 스킬 적용.
+
+**세션 메모리** — 결정, 제약, 목표가 SQLite + FTS5 검색으로 세션 간 유지.
+
+**Smart Resume** — `.last-feature` 포인터가 마지막 작업을 추적. 인자 없이 `/vibe.spec`을 호출하면 중단된 위치를 보여주거나 진행 중 feature 목록을 제시.
+
+---
+
+## 지원 도구
+
+| CLI | 상태 |
+|-----|------|
+| [Claude Code](https://claude.ai/code) | 전체 지원 |
+| coco (`~/.coco/`) | 전체 지원 (자동 감지) |
+| [Codex](https://github.com/openai/codex) | 플러그인 |
+| [Cursor](https://cursor.sh) | 에이전트 + 룰 |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 에이전트 + 스킬 |
+
+---
+
+## 명령어
+
+| 명령어 | 용도 |
+|--------|------|
+| `/vibe.spec` | 단일 진입점 — 인터뷰, 기획, SPEC, 리뷰, 그리고 구현까지 |
+| `/vibe.run` | SPEC 기반 구현 |
+| `/vibe.figma` | Figma ↔ 코드 (읽기 또는 쓰기, 3가지 모드) |
+| `/vibe.verify` | 구현이 SPEC에 맞는지 검증 |
+| `/vibe.trace` | 요구사항 추적 매트릭스 |
+
+---
+
+## 문서
+
+상세 가이드, 스킬 레퍼런스, 설정 방법은 [Wiki](https://github.com/su-record/vibe/wiki)를 참고하세요.
+
+- [README (English)](README.md)
+- [릴리스 노트](RELEASE_NOTES.md)
+
+---
+
+## 요구사항
+
+- Node.js >= 18.0.0
+- Claude Code (필수)
+- GPT, Gemini (선택)
+
+## 라이선스
+
+MIT — Copyright (c) 2025 Su