@su-record/vibe 2.10.0 → 2.10.2

package/hooks/scripts/llm-orchestrate.js

@@ -112,7 +112,6 @@ function resolveModel(providerName, config) {
  *
  * true인 경우:
  * - vibe-codex: ANTHROPIC_BASE_URL이 localhost (프록시 모드)
- * - coco: ~/.coco/ 존재 또는 COCO_HOME 설정
  * - 명시적: VIBE_SECONDARY_LLM=claude
  */
 function useClaudeAsSecondary() {
@@ -121,10 +120,6 @@ function useClaudeAsSecondary() {
   // 2. vibe-codex 프록시 모드
   const baseUrl = process.env.ANTHROPIC_BASE_URL || '';
   if (baseUrl.includes('localhost') || baseUrl.includes('127.0.0.1')) return true;
-  // 3. coco 환경
-  if (process.env.COCO_HOME) return true;
-  const cocoDir = path.join(os.homedir(), '.coco');
-  if (fs.existsSync(cocoDir)) return true;
   return false;
 }
 
@@ -601,10 +596,10 @@ async function main() {
     // 명시적 claude 호출
     providerChain = ['claude', 'gemini'];
   } else if (isGpt) {
-    // GPT 주관 → claude fallback (vibe-codex/coco), gemini fallback (직접 모드)
+    // GPT 주관 → claude fallback (vibe-codex), gemini fallback (직접 모드)
     providerChain = claudeSecondary ? [provider, 'claude'] : [provider, 'gemini'];
   } else {
-    // gemini 주관 → claude fallback (vibe-codex/coco), gpt fallback (직접 모드)
+    // gemini 주관 → claude fallback (vibe-codex), gpt fallback (직접 모드)
     providerChain = claudeSecondary ? ['gemini', 'claude'] : ['gemini', 'gpt'];
   }
 

package/hooks/scripts/prompt-dispatcher.js

@@ -42,11 +42,11 @@ try {
 
 if (!prompt) process.exit(0);
 
-// 레거시 SSOT 통합 — `/vibe.*` 진입 시 `.claude/vibe/`·`.coco/vibe/` → `.vibe/` 자동 이동.
+// 레거시 SSOT 통합 — `/vibe.*` 진입 시 `.claude/vibe/` → `.vibe/` 자동 이동.
 // `vibe init`/`update` 와 동일한 `consolidateLegacyVibe` (dist/cli/setup/LegacyMigration.js) 를 직접 재사용. Idempotent.
 if (/^\s*\/vibe\b/i.test(prompt)) {
   try {
-    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || process.cwd();
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
     const utils = await import('./utils.js');
     const CLI_BASE = utils.getCliBaseUrl();
     const { consolidateLegacyVibe } = await import(`${CLI_BASE}setup/LegacyMigration.js`);
@@ -183,7 +183,7 @@ if (!matched) {
   setImmediate(async () => {
     try {
       const utils = await import('./utils.js');
-      const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || '.';
+      const projectDir = process.env.CLAUDE_PROJECT_DIR || '.';
       const configPath = utils.projectVibePath(projectDir, 'config.json');
       let gapEnabled = true;
       try {

package/hooks/scripts/utils.js

@@ -17,7 +17,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const DETECTED_VIBE_PATH = path.resolve(__dirname, '..', '..');
 
 export const VIBE_PATH = process.env.VIBE_PATH || DETECTED_VIBE_PATH;
-export const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.env.COCO_PROJECT_DIR || '.';
+export const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || '.';
 
 // ~/.vibe/ 디렉토리 경로
 const VIBE_HOME_DIR = path.join(os.homedir(), '.vibe');
@@ -25,16 +25,14 @@ const VIBE_HOME_DIR = path.join(os.homedir(), '.vibe');
 /**
  * 프로젝트 내 Vibe 에셋 루트 해석.
  *
- * 신규 SSOT: `<project>/.vibe/` — CLI(Claude/coco)와 무관한 공용 디렉토리.
+ * 신규 SSOT: `<project>/.vibe/` — CLI(Claude/Codex)와 무관한 공용 디렉토리.
  * Legacy fallback:
  *   - `<project>/.claude/vibe/`  (Claude Code 프로젝트 초기화 흔적)
- *   - `<project>/.coco/vibe/`    (coco 프로젝트 초기화 흔적)
  *
  * 해석 규칙 — **읽기**(lookup) 시:
  *   1) `.vibe/` 가 존재하면 그 경로
  *   2) `.claude/vibe/` 가 존재하면 그 경로
- *   3) `.coco/vibe/` 가 존재하면 그 경로
- *   4) 아무것도 없으면 기본값 `.vibe/` (생성 대상)
+ *   3) 아무것도 없으면 기본값 `.vibe/` (생성 대상)
  *
  * **쓰기**(write) 시에는 항상 새 SSOT 인 `.vibe/` 로 수렴시키는 것이 원칙이지만,
  * 기존 프로젝트의 legacy 파일이 있으면 해당 위치에 쓰는 것이 덜 파괴적이다.
@@ -48,8 +46,6 @@ export function projectVibeRoot(projectDir = PROJECT_DIR) {
     if (fs.existsSync(vibeRoot)) return vibeRoot;
     const claudeVibe = path.join(projectDir, '.claude', 'vibe');
     if (fs.existsSync(claudeVibe)) return claudeVibe;
-    const cocoVibe = path.join(projectDir, '.coco', 'vibe');
-    if (fs.existsSync(cocoVibe)) return cocoVibe;
   } catch { /* ignore */ }
   return path.join(projectDir, '.vibe');
 }
@@ -66,14 +62,13 @@ export function projectVibePath(projectDir = PROJECT_DIR, ...sub) {
 
 /**
  * 프로젝트 메모리 DB 디렉토리 해석.
- * `.vibe/memories/` (신규) → `.claude/memories/` (legacy Claude) → `.coco/memories/` (legacy coco) → 기본 `.vibe/memories/`
+ * `.vibe/memories/` (신규) → `.claude/memories/` (legacy Claude) → 기본 `.vibe/memories/`
  */
 export function projectMemoryDir(projectDir = PROJECT_DIR) {
   try {
     const candidates = [
       path.join(projectDir, '.vibe', 'memories'),
       path.join(projectDir, '.claude', 'memories'),
-      path.join(projectDir, '.coco', 'memories'),
     ];
     for (const c of candidates) if (fs.existsSync(c)) return c;
   } catch { /* ignore */ }
@@ -95,7 +90,7 @@ export function readVibeConfig() {
 }
 
 /**
- * 프로젝트 설정(.vibe/config.json) 읽기 — legacy `.claude/vibe/`, `.coco/vibe/` fallback 포함
+ * 프로젝트 설정(.vibe/config.json) 읽기 — legacy `.claude/vibe/` fallback 포함
  * @returns {object} 파싱된 config 또는 빈 객체
  */
 export function readProjectConfig() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@su-record/vibe",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "description": "AI Coding Framework for Claude Code — 56 agents, 45 skills, multi-LLM orchestration",
   "type": "module",
   "main": "dist/cli/index.js",

package/skills/docs/SKILL.md

@@ -106,9 +106,9 @@ graph TD
 | CLI | File | Support |
 |---|---|---|
 | Claude Code | `CLAUDE.md` | 100% (Primary) |
-| coco | `AGENTS.md` | 100% (Primary) |
+| Codex | `AGENTS.md` | 100% (Primary) |
 
-Gemini CLI / Codex CLI / Cursor are not supported — do not generate or check `GEMINI.md`.
+Gemini CLI / Cursor are not supported — do not generate or check `GEMINI.md`.
 
 **Source of truth:**
 - **`CLAUDE.md` is the content SSOT.** Always edit it first; `AGENTS.md` is a regenerated derivative.
@@ -120,7 +120,7 @@ Gemini CLI / Codex CLI / Cursor are not supported — do not generate or check `
 2. **For `AGENTS.md`**:
    - **If missing** → create by cloning `CLAUDE.md` + applying CLI substitution (below).
    - **If exists** → regenerate from current `CLAUDE.md` + substitution, preserving user-specific additions outside the VIBE block.
-3. **CLI substitution for `AGENTS.md`** (coco): `Claude Code` → `coco` · `~/.claude/` → `~/.coco/` · `.claude/` → `.coco/` · `CLAUDE.md` → `AGENTS.md`. `CLAUDE.md` itself gets no substitution.
+3. **CLI substitution for `AGENTS.md`** (Codex): `Claude Code` → `Codex` · `~/.claude/` → `~/.codex/` · `.claude/` → `.codex/` · `CLAUDE.md` → `AGENTS.md`. `CLAUDE.md` itself gets no substitution.
 4. **Validate every touched file (whether newly created or modified)** via the `claude-md-guide` → `agents-md` skill chain — see validation block below. **Never write or save without running this step.**
 5. Report per file: created / updated / skipped / validation warnings.
 

package/skills/test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: test
-description: vibe 자가검진 본체 — 대상 harness(~/.claude/~/.coco)의 모든 command/skill/hook/agent 프로빙 → pass/fail 리포트 → ~/.vibe/test-reports/.
+description: vibe 자가검진 본체 — 대상 harness(~/.claude/~/.codex)의 모든 command/skill/hook/agent 프로빙 → pass/fail 리포트 → ~/.vibe/test-reports/.
 when_to_use: /vibe.test 진입점에서 체인 호출. 직접 호출 금지.
 user-invocable: false
 tier: core
@@ -12,7 +12,7 @@ Probe every shipped vibe surface in one install dir and emit a pass/fail report.
 
 ## Why this exists
 
-When vibe ships new commands, skills, hooks, or agents, one side (CC or coco) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
+When vibe ships new commands, skills, hooks, or agents, one side (CC or Codex) can end up out of sync with the other, frontmatter can drift, and hook tests can silently break. `/vibe.test` is the single mechanical check: does every surface in the target install actually load and pass its own tests?
 
 ## Target harness
 
@@ -20,15 +20,15 @@ The argument selects which install dir to probe:
 
 | Arg | Probed dir |
 |---|---|
-| (empty) | current harness — CC: `~/.claude/`, coco: `~/.coco/` |
+| (empty) | current harness — CC: `~/.claude/`, Codex: `~/.codex/` |
 | `cc` | `~/.claude/` |
-| `coco` | `~/.coco/` |
+| `codex` | `~/.codex/` |
 
 If the target dir does not exist, print a clear message and exit with guidance (not an error). Example:
 
 ```
-~/.coco/ not found — coco isn't installed on this machine.
-  To install: pnpm add -g @su-record/vibe-coco
+~/.codex/ not found — Codex isn't installed on this machine.
+  To install: npm i -g @openai/codex
 ```
 
 ## Probes
@@ -118,8 +118,8 @@ If `failed` is empty, replace the Failures section with `_All probes passed._`.
 
 ## Steps
 
-1. **Resolve target**: argument (`cc` / `coco` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
-2. **Resolve install dir**: `cc` → `~/.claude`, `coco` → `~/.coco`. If missing → print guidance + exit.
+1. **Resolve target**: argument (`cc` / `codex` / empty). Empty → detect current harness (`$CLAUDE_PROJECT_DIR` set → `cc`; else fall back to `cc`).
+2. **Resolve install dir**: `cc` → `~/.claude`, `codex` → `~/.codex`. If missing → print guidance + exit.
 3. **Read `vibe_version`** from `package.json` in the current repo.
 4. **Walk each category**, run its check, append `{ name, status, error? }` to `probes.<category>`.
 5. **Compute** `summary` counts and the flat `failed[]` list.

package/skills/vibe/SKILL.md

@@ -26,6 +26,8 @@ user-invocable: true
 
 - **단일 슬래시 진입점**: `/vibe` 하나로 모든 워크플로 시작. 다른 `/vibe.*` 도 그대로 존재하지만 power user 가 명시적으로 phase 호출하고 싶을 때 쓰는 advanced 경로.
 - **동적 파이프라인**: 의도/입력 종류에 따라 매번 다른 스킬 체인 구성. 미리 정해진 고정 흐름 아님.
+- **무제한 라우팅**: 라우팅 표는 빠른 경로일 뿐 닫힌 화이트리스트가 아니다. 설치된 모든 `vibe.*` 스킬이 라우팅 후보이며, 표에 없는 요구사항도 description 기반 의미 매칭으로 처리한다 (Catch-all).
+- **하네스 정규화 (추론 앞단)**: vibe는 CC(추론)·Codex(직역) 어느 하네스의 암묵적 동작에도 의존하지 않는다. `/vibe`가 모호한 NL을 **명시적·직역 가능한 지시로 먼저 전개**하고, 하위 skill은 모호한 입력을 받지 않는다. 이로써 모든 하네스에서 동일 결과 + CC급 편의를 제공한다. 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
 - **Smart Resume**: `.vibe/{interviews,plans,specs,features}/` 감지하여 "이어서 진행?" 자동 제안.
 - **1회 승인 게이트**: 파이프라인을 설계해서 사용자에게 보여주고 OK 받은 뒤 실행. `ultrawork` 키워드 있으면 skip.
 - **위임자 역할**: `/vibe` 본인은 코드를 직접 쓰지 않는다. 라우팅·설계·실행 위임만 한다.
@@ -61,12 +63,26 @@ user-invocable: true
 | **scaffold** | "프로젝트 만들기", "셋업", "초기 구조" | scaffold |
 | **docs sync** | "문서 갱신", "README", "AGENTS.md" | docs |
 | **analyze** | "분석", "조사", "이건 뭐야" + 파일/URL | analyze |
+| **reason** | "추론", "깊게 생각", "트레이드오프", "어떻게 접근" 등 복잡한 사고 요청 | reason |
+| **event** | "이벤트", "커뮤니티", "D-Day", "행사 자동화" | event |
 | **harness check** | "하네스", "환경 점검" | harness |
-| **test self** | "vibe 테스트", "CC ↔ coco 비교" | test |
+| **test self** | "vibe 테스트", "CC ↔ Codex 비교" | test |
 | **utils** | "이어서", "메모리", "체크포인트" | utils |
 
 복수 의도면 우선순위: resume > figma-driven > new feature > 기타.
 
+> **⚠️ 위 표는 닫힌 화이트리스트가 아니라 "흔한 케이스 빠른 경로"다.** 표에 없는 요구사항이라도 막지 말고 **Catch-all 라우팅**(아래)으로 처리한다.
+
+### Catch-all 라우팅 (표에 없는 의도)
+
+입력이 위 표 어느 행과도 명확히 매칭되지 않으면:
+
+1. **의미 매칭**: 사용 가능한 모든 `vibe.*` 스킬의 `description` 을 읽어 요구사항과 의미적으로 가장 가까운 스킬을 고른다. (표는 참고용일 뿐, 실제 라우팅 후보는 설치된 전체 `vibe.*`)
+2. **복합 설계**: 단일 스킬로 안 되면 여러 스킬을 조합한 파이프라인을 동적으로 설계한다.
+3. **되묻기는 최후**: 어떤 스킬과도 매칭이 안 될 때만 사용자에게 "어떤 작업인지" 명확화 질문을 한다.
+
+> 새 `vibe.*` 스킬이 추가되어 위 표에 행이 없더라도, Catch-all 이 description 기반으로 자동 라우팅하므로 기능이 막히지 않는다. 표 누락 = 기능 제한이 되어선 안 된다.
+
 ### Phase 2: Smart Resume 감지
 
 ```
@@ -91,7 +107,13 @@ user-invocable: true
 
 ### Phase 3: 파이프라인 설계
 
-분류된 의도 + resume 상태 + magic keyword 를 종합해 실행 계획 작성:
+**먼저 입력을 정규화한다 (하네스 무관 명시화):**
+
+- **예시·placeholder 표기**: 사용자가 설명용으로 던진 예시 텍스트를 실데이터로 넘기지 않는다. `<예시>`, `[채워넣을 값]` 로 명시. (직역 하네스가 그대로 데이터로 쓰는 것 방지)
+- **research 명시**: 조사가 필요하면 파이프라인에 명시적 탐색 단계를 넣는다. planning mode 같은 하네스 스위치에 의존하지 않는다.
+- **도메인 지식 흡수**: 사용자가 준 라이브러리·함수·파일 위치를 SPEC 입력으로 전달한다.
+
+이어서 분류된 의도 + resume 상태 + magic keyword 를 종합해 실행 계획 작성:
 
 ```
 📋 Pipeline Plan

package/skills/vibe.run/SKILL.md

@@ -124,6 +124,8 @@ Scenario 3 → Implement → Verify ❌ → Fix → ✅
 All pass = Quality guaranteed
 ```
 
+> **하네스-안전 증분 (Dual-Harness Doctrine)**: 시나리오는 **가장 작은 검증 단위**다. 한 시나리오 구현 → 즉시 검증 → 다음. 여러 시나리오를 묶어 빅뱅으로 구현하지 않는다 — Codex(직역) 에서 성공률이 급락하고 CC 에서도 디버깅 비용만 늘린다. `ultrawork` 모드라도 이 단위는 무너뜨리지 않는다 (병렬은 시나리오 간, 검증은 시나리오별). 전문: `vibe/rules/principles/dual-harness-doctrine.md`.
+
 ### Automated Verification (Closed Loop)
 
 **자율적 AI 코딩 = 구현 + 검증 + 반복. 검증을 AI에게 맡기는 순간 루프가 닫힌다.**

package/skills/vibe.test/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: vibe.test
 description: Self-test vibe — probe every command/skill/hook/agent in the target harness install dir and write a pass/fail report
-argument-hint: "[cc|coco]  (empty = current harness)"
+argument-hint: "[cc|codex]  (empty = current harness)"
 user-invocable: true
 ---
 
@@ -14,10 +14,10 @@ user-invocable: true
 ```
 /vibe.test         # Test current harness (auto-detect)
 /vibe.test cc      # Force-test ~/.claude/
-/vibe.test coco    # Force-test ~/.coco/
+/vibe.test codex   # Force-test ~/.codex/
 ```
 
-No subcommands. No CC-vs-coco comparison semantics. One command, one report.
+No subcommands. No CC-vs-Codex comparison semantics. One command, one report.
 
 ## Report
 
@@ -34,7 +34,7 @@ Markdown summary is also printed to the console when the run finishes.
 
 Load skill `test` with target harness: `$ARGUMENTS`
 
-- If `$ARGUMENTS` is empty, detect the current harness (CC vs coco) and use that.
+- If `$ARGUMENTS` is empty, detect the current harness (CC vs Codex) and use that.
 - If the target install dir is missing, exit cleanly with guidance (not an error).
 
 See `skills/test/SKILL.md` for the probe spec and the report template.

package/vibe/rules/principles/dual-harness-doctrine.md

@@ -0,0 +1,50 @@
+# Dual-Harness Doctrine
+
+> vibe는 여러 하네스(Claude Code, Codex, Gemini) 위에서 동작한다.
+> 차이는 경로·파일명 같은 **인프라**가 아니라 **인지 방식**에 있다.
+
+## 비대칭의 본질
+
+| | Claude Code | Codex |
+|---|---|---|
+| 모호한 요청 | 의도를 **추론**해 알아서 채움 | **직역** — 지시한 그대로만, 예시 텍스트도 실데이터로 |
+| research 트리거 | planning mode를 켜야 시작 | 모드 없이 **자발적** 탐색 |
+| 작업 단위 | 한 번에 working solution → 끝에 QA | **작게 순차** + 단계별 검증이 성공률 높음 |
+| 도메인 지식 | 탐색을 맡겨도 됨 | 직접 주입할수록(라이브러리·함수·위치) 정확도↑ |
+
+## Core Principle
+
+> **vibe는 어떤 하네스의 *암묵적 동작*에도 의존하지 않는다.**
+> **추론은 `/vibe` 디스패처가 앞단에서 한 번 하고, skill 본문은 모든 것을 명시적으로 쓴다.**
+
+= **"명시성 공통분모 + 추론 앞단"** 모델
+
+- **skill 본문 = 낮은 공통분모**: 명시적·직역-안전. Codex에서 안전하고 CC에서도 여전히 정확.
+- **`/vibe` 디스패처 = 추론 레이어**: 모호한 자연어를 명시적 지시로 *먼저* 펼쳐, 모든 하네스에서 CC급 편의를 제공.
+
+## Operating Rules
+
+1. **추론은 앞단에서 단 한 번.** `/vibe`가 모호한 NL → 명시적·직역 가능한 지시로 전개한다. 하위 skill은 모호한 입력을 받지 않는다.
+2. **예시·placeholder는 명시 표기.** 직역 하네스가 실데이터로 넣을 수 있는 예시 텍스트를 무표기로 쓰지 않는다. `<예시>`, `[채워넣을 값]`, `{{placeholder}}` 사용. (Codex는 무표기 예시를 그대로 테스트 데이터에 넣는다.)
+3. **research는 명시적으로 트리거.** "planning mode" 스위치에 의존하지 않는다. 조사·탐색이 필요한 단계는 skill이 말로 지시한다.
+4. **가장 작은 검증 단위로 분해.** 구현 → 검증 → 다음. 여러 단위를 묶지 않는다. (`vibe.run`의 시나리오 루프가 이미 이 방식 — ultrawork가 빅뱅으로 무너뜨리지 않게 유지.)
+5. **도메인 지식은 SPEC에 주입.** SPEC/plan은 구체적 라이브러리명·함수명·파일 위치를 담는다. 선택이 아닌 **의무 출력** — Codex 정확도가 여기에 비례한다.
+
+## Hooks Across Harnesses
+
+CC의 풍부한 hook 모델(PreToolUse/PostToolUse/UserPromptSubmit/Stop)에는 Codex에 완전한 등가물이 없다. hook의 **의도**별로 하네스에 맞는 메커니즘에 매핑한다.
+
+| hook 의도 | Claude Code | Codex |
+|---|---|---|
+| 라이프사이클 (turn 완료, 세션 시작/종료) | `Stop` / `SessionStart` hook | `config.toml`의 `notify` 프로그램 (agent-turn-complete 시 JSON 발화) |
+| pre-edit / scope guard | `PreToolUse` (동기 deny) | ❌ 동기 인터셉트 없음 → AGENTS.md 운영 규칙 + notify 기반 사후 검증 |
+| 키워드 디스패치 (ralph/ultrawork) | `UserPromptSubmit` | AGENTS.md 지시 (Codex가 직역 실행) |
+| 금지 패턴 차단 | `PreToolUse` | AGENTS.md 규칙 + 에이전트에게 실행하라 지시한 check 명령 |
+
+**핵심 통찰: Codex의 직역 성향이 AGENTS.md "soft hook"을 신뢰성 있게 만든다.** CC는 soft 지시를 가끔 무시해 hard hook이 필요하지만, Codex는 적힌 대로 실행한다. 따라서:
+
+- **하드 라이프사이클 이벤트** → Codex `config.toml notify` (실제·결정적). `stop-dispatcher` 로직(auto-commit, devlog, review gate) 재사용 가능.
+- **행동 가드** → AGENTS.md 운영 규칙. 직역이라 *오히려* 신뢰성 있음.
+- **진짜 동기 pre-edit 차단은 Codex에서 불가** — 사후 검증을 완화책으로 수용한다.
+
+> **Action item (미구현):** `.codex/settings.local.json`에 죽은 hook을 쓰는 것을 중단하고, 대신 `.codex/config.toml`에 `notify` 핸들러를 생성해 `stop-dispatcher` 로직을 재사용하며, 가드 규칙은 AGENTS.md로 방출한다.