@su-record/vibe 2.9.16 → 2.9.17

package/CLAUDE.md

@@ -1,13 +1,12 @@
 # VIBE
 
-> Source code for `@su-record/vibe` npm package. Modify files in THIS repository only — never the installed copies (`~/.claude/`, `~/.codex/`, `~/.gemini/`, `~/.coco/`, `~/.vibe/`).
+> Source code for `@su-record/vibe` npm package. Modify files in THIS repository only — never the installed copies (`~/.claude/`, `~/.coco/`, `~/.vibe/`).
 >
 > **File-to-CLI mapping:**
 > - `CLAUDE.md` — **Claude Code** (100% supported) · **content SSOT**
-> - `AGENTS.md` — **coco** (100% supported, primary) · Codex CLI (best-effort)
-> - `GEMINI.md` — Gemini CLI (best-effort)
+> - `AGENTS.md` — **coco** (100% supported)
 >
-> `AGENTS.md` and `GEMINI.md` are regenerated from this file via `/vibe.docs agent`. Edit here first.
+> `AGENTS.md` is regenerated from this file via `/vibe.docs agent`. Edit here first.
 
 ## Hard Rules
 

package/commands/vibe.docs.md

@@ -14,7 +14,7 @@ Generate or update project documentation by analyzing the actual codebase.
 /vibe.docs guide      # 사용자 가이드 (docs/GUIDE.md)
 /vibe.docs arch       # 아키텍처 문서 + Mermaid 다이어그램 (docs/ARCHITECTURE.md)
 /vibe.docs release    # 릴리즈 노트 (git history 기반)
-/vibe.docs agent      # CLAUDE.md / AGENTS.md / GEMINI.md 생성·동기화 (claude-md-guide + agents-md 검증 필수)
+/vibe.docs agent      # CLAUDE.md / AGENTS.md 생성·동기화 (claude-md-guide + agents-md 검증 필수)
 ```
 
 ## Pipeline Position

package/package.json

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

package/skills/vibe-docs/SKILL.md

@@ -99,7 +99,7 @@ graph TD
     Infra --> API[External APIs]
 ```
 
-### `/vibe.docs agent` — Agent Instruction Files (CLAUDE.md / AGENTS.md / GEMINI.md)
+### `/vibe.docs agent` — Agent Instruction Files (CLAUDE.md / AGENTS.md)
 
 **CLI ↔ file mapping:**
 
@@ -107,31 +107,20 @@ graph TD
 |---|---|---|
 | Claude Code | `CLAUDE.md` | 100% (Primary) |
 | coco | `AGENTS.md` | 100% (Primary) |
-| Codex CLI | `AGENTS.md` (shared with coco) | Best-effort |
-| Gemini CLI | `GEMINI.md` | Best-effort |
-| Cursor | (none yet) | Best-effort |
 
-Note: `AGENTS.md` is coco's **primary** file AND Codex's compat file — treat edits with coco-level care.
+Gemini CLI / Codex 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` and `GEMINI.md` are regenerated derivatives.
+- **`CLAUDE.md` is the content SSOT.** Always edit it first; `AGENTS.md` is a regenerated derivative.
 - Behavioral block: `skills/vibe-docs/templates/behavioral-principles.md` (4 Karpathy principles, wrapped in `<!-- VIBE-BEHAVIORAL:START/END -->` markers).
 
 **Procedure (applies to both creation and modification):**
 
-1. **Detect state** — enumerate which of `CLAUDE.md` / `AGENTS.md` / `GEMINI.md` exist in project root. **`CLAUDE.md` is always the SSOT**; if missing, create it first (never derive from AGENTS.md/GEMINI.md).
-2. **Per derivative file (`AGENTS.md`, `GEMINI.md`)**:
+1. **Detect state** — check which of `CLAUDE.md` / `AGENTS.md` exist in project root. **`CLAUDE.md` is always the SSOT**; if missing, create it first (never derive from AGENTS.md).
+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.
-   - Each derivative must include a **compatibility-file notice** in the header stating that `CLAUDE.md` is the SSOT and this CLI is best-effort (not 100% supported).
-3. **CLI substitution (apply to derived copies, not the SSOT)**:
-
-   | Target | Swap |
-   |---|---|
-   | `AGENTS.md` (Codex) | `Claude Code` → `Codex CLI` · `~/.claude/` → `~/.codex/` · `.claude/` → `.codex/` · `CLAUDE.md` → `AGENTS.md` |
-   | `GEMINI.md` (Gemini) | `Claude Code` → `Gemini CLI` · `~/.claude/` → `~/.gemini/` · `.claude/` → `.gemini/` · `CLAUDE.md` → `GEMINI.md` · `PreToolUse`→`BeforeTool` · `PostToolUse`→`AfterTool` · `UserPromptSubmit`→`BeforeAgent` |
-   | `CLAUDE.md` | no substitution |
-
+3. **CLI substitution for `AGENTS.md`** (coco): `Claude Code` → `coco` · `~/.claude/` → `~/.coco/` · `.claude/` → `.coco/` · `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.
 
@@ -154,9 +143,9 @@ Note: `AGENTS.md` is coco's **primary** file AND Codex's compat file — treat e
 Report line ranges to trim per file. Do not auto-delete; surface findings for user approval before finalizing.
 
 **When to run:**
-- After `vibe init` / `vibe update` if any of the three files are missing or out of sync.
+- After `vibe init` / `vibe update` if `CLAUDE.md` or `AGENTS.md` is missing or out of sync.
 - After upgrading `@su-record/vibe` when the behavioral template changes.
-- Whenever the SSOT file is edited — re-sync derivatives.
+- Whenever the SSOT file is edited — re-sync `AGENTS.md`.
 - User explicitly asks to refresh agent instructions.
 
 ### `/vibe.docs release` — Release Notes
@@ -213,7 +202,7 @@ When `/vibe.trace` completes with all scenarios passing, suggest:
 - Use changelog-writer agent for `/vibe.docs release`
 - Use api-documenter agent for API-heavy projects
 - Use diagrammer agent for `/vibe.docs arch` Mermaid generation
-- Use `claude-md-guide` → `agents-md` chain for `/vibe.docs agent` — applies equally to CLAUDE.md, AGENTS.md, GEMINI.md
+- Use `claude-md-guide` → `agents-md` chain for `/vibe.docs agent` — applies equally to CLAUDE.md and AGENTS.md
 
 ### DON'T
 - Don't generate placeholder text ("Lorem ipsum", "TODO: fill in")