@su-record/vibe 2.9.23 → 2.9.25

package/.env.example

@@ -1,37 +1,37 @@
-# ─── VIBE Configuration ─────────────────────────────────────────────
-#
-# All credentials, channels, and model overrides are stored in:
-#   ~/.vibe/config.json
-#
-# Use CLI commands to configure:
-#   vibe setup                    Interactive setup wizard
-#   vibe gpt auth                 GPT OAuth (Plus/Pro)
-#   vibe gpt key <key>            GPT API key
-#   vibe gemini auth              Gemini OAuth
-#   vibe gemini key <key>         Gemini API key
-#   vibe claude key <key>         Claude API key
-#   vibe telegram setup <token>   Telegram bot
-#   vibe slack setup <bot> <app>  Slack bot
-#   vibe status                   Check all status
-#
-# Config structure (~/.vibe/config.json):
-# {
-#   "version": "1",
-#   "credentials": {
-#     "gpt": { "apiKey": "sk-..." },
-#     "gemini": { "apiKey": "AIza..." }
-#   },
-#   "channels": {
-#     "telegram": { "botToken": "123:ABC", "allowedChatIds": ["-100..."] },
-#     "slack": { "botToken": "xoxb-...", "appToken": "xapp-..." }
-#   },
-#   "models": {
-#     "gpt": "gpt-5.4",
-#     "gemini": "gemini-3.1-pro-preview",
-#     "claudeBackground": "claude-sonnet-4-5"
-#   }
-# }
-#
-# Environment variables are still supported as fallback:
-#   OPENAI_API_KEY, GEMINI_API_KEY, GPT_MODEL, etc.
-# ────────────────────────────────────────────────────────────────────
+# ─── VIBE Configuration ─────────────────────────────────────────────
+#
+# All credentials, channels, and model overrides are stored in:
+#   ~/.vibe/config.json
+#
+# Use CLI commands to configure:
+#   vibe setup                    Interactive setup wizard
+#   vibe gpt auth                 GPT OAuth (Plus/Pro)
+#   vibe gpt key <key>            GPT API key
+#   vibe gemini auth              Gemini OAuth
+#   vibe gemini key <key>         Gemini API key
+#   vibe claude key <key>         Claude API key
+#   vibe telegram setup <token>   Telegram bot
+#   vibe slack setup <bot> <app>  Slack bot
+#   vibe status                   Check all status
+#
+# Config structure (~/.vibe/config.json):
+# {
+#   "version": "1",
+#   "credentials": {
+#     "gpt": { "apiKey": "sk-..." },
+#     "gemini": { "apiKey": "AIza..." }
+#   },
+#   "channels": {
+#     "telegram": { "botToken": "123:ABC", "allowedChatIds": ["-100..."] },
+#     "slack": { "botToken": "xoxb-...", "appToken": "xapp-..." }
+#   },
+#   "models": {
+#     "gpt": "gpt-5.4",
+#     "gemini": "gemini-3.1-pro-preview",
+#     "claudeBackground": "claude-sonnet-4-5"
+#   }
+# }
+#
+# Environment variables are still supported as fallback:
+#   OPENAI_API_KEY, GEMINI_API_KEY, GPT_MODEL, etc.
+# ────────────────────────────────────────────────────────────────────

package/CLAUDE.md

@@ -1,105 +1,106 @@
-# 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)
->
-> `AGENTS.md` is regenerated from this file via `/vibe.docs agent`. Edit here first.
-
-## Hard Rules
-
-### Behavior
-- **Modify only requested scope** — Every changed line traces to the user's request
-- **Edit existing files over creating new** — Fix at source
-- **Preserve existing style** — Match conventions even if you'd do it differently
-- **Respect Ctrl+C / Escape** — Previous task CANCELLED
-- **State assumptions, ask when uncertain** — Don't pick silently when ambiguity exists; push back if a simpler approach exists
-
-### Goal-Driven Execution
-Transform imperative tasks into verifiable goals **before** coding:
-
-| Instead of | Transform to |
-|---|---|
-| "Add validation" | "Tests for invalid inputs pass" |
-| "Fix the bug" | "A test reproducing it passes" |
-| "Refactor X" | "Tests pass before and after" |
-
-Weak criteria ("make it work") require constant clarification. Strong criteria let the loop run independently.
-
-### TypeScript (enforced by Quality Gate hooks)
-- No `any` / `as any` / `@ts-ignore` — use `unknown` + type guards; fix at root
-- Explicit return types on all functions
-
-### Complexity Limits
-Function ≤50 lines · Nesting ≤3 · Params ≤5 · Cyclomatic ≤10
-
-### Forbidden Patterns
-No `console.log` in commits · No hardcoded strings/numbers · No commented-out code · No incomplete code without TODO
-
-### Convergence (review / auto-fix loops)
-- **Loop until P1 = 0 AND no new findings** — no round cap
-- **Narrowing scope**: Round 1 full → Round 2 P1+P2 → Round 3+ P1 only
-- **Stuck detection** (same findings/score 2 rounds in a row) → ask user (fill values / approve sub-100 / abort). Never silently proceed sub-100
-- **`ultrawork` exception** — skip user prompt; record gaps as TODO to stay non-interactive
-- **Changed files only** — never full-project scan
-
-## Architecture (Non-Obvious)
-
-### Module System
-- ESM only (`"type": "module"`) — imports need `.js` extension
-- Build before test: `npm run build && npx vitest run`
-
-### Config Locations
-| Path | Purpose |
-|---|---|
-| `~/.vibe/config.json` | Global credentials, models (0o600) |
-| `.claude/vibe/config.json` | Project stacks, capabilities |
-| `.claude/settings.local.json` | Project hooks (auto-generated, don't commit) |
-
-### Gotchas
-- `better-sqlite3` WAL mode — synchronous API
-- `crypto.timingSafeEqual` requires same-length buffers — check length first
-- **Stack → asset SSOT**: `GLOBAL_SKILLS_*`, `STACK_TO_SKILLS`, `CAPABILITY_SKILLS` in `src/cli/postinstall/constants.ts`
-- **Hook dispatch order**: `prompt-dispatcher.js` → `keyword-detector.js` → `llm-orchestrate.js`
-
-## Workflow
-
-`/vibe.spec` is the single entry point — orchestrates interview → plan → spec → review → `/vibe.run` → `/vibe.verify` → `/vibe.contract` → `/vibe.trace`. For UI types (website/webapp/mobile), `/vibe.figma` branches in parallel. Smart Resume detects existing `.claude/vibe/{interviews,plans,specs}/*.md` to skip phases.
-
-**Quality-loop commands** (bug → prevention):
-- `/vibe.regress` — Regression test auto-evolution. Auto-registers on `/vibe.verify` failure; `generate` produces preventive tests; `cluster` promotes recurring patterns.
-- `/vibe.contract` — API contract drift detection. Compares the contract extracted from the SPEC against the implementation; P1 drift auto-propagates to `/vibe.regress`.
-- `/vibe.test` — vibe self-test across the CC ↔ coco harnesses. Subcommands: `parity` (static), `report` (runtime), `compare` (diff). P1 drift auto-propagates to `/vibe.regress`. Recommended before every release.
-
-| Task Size | Approach |
-|---|---|
-| 1–2 files | Plan Mode |
-| 3+ files | `/vibe.spec` |
-
-## Magic Keywords
-
-| Keyword | Effect |
-|---|---|
-| `ultrawork` / `ulw` | Parallel agents + auto-continue + Ralph Loop |
-| `ralph` | Iterate to 100% (no scope reduction) |
-| `ralplan` | Iterative planning + persistence |
-| `verify` | Strict verification mode |
-| `quick` | Fast mode, minimal verification |
-
-## Skill Tiers
-
-3 tiers prevent context overload: **core** (always active) / **standard** (project-setup selected) / **optional** (explicit `/skill` only). SSOT: `GLOBAL_SKILLS_CORE` + `GLOBAL_SKILLS_STANDARD` in `src/cli/postinstall/constants.ts`. Proactive triggers live in each skill's frontmatter.
-
-## Context Management
-
-- Exploration → Haiku · Implementation → Sonnet · Architecture → Opus
-- At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
-
-## Git
-
-**Include**: `.claude/vibe/{plans,specs,features,todos,research,regressions,contracts,test-reports}/`, `.claude/vibe/config.json`, `CLAUDE.md`
-**Exclude**: `~/.claude/{rules,commands,agents,skills}/`, `.claude/settings.local.json`
-
-<!-- VIBE:END -->
+# 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)
+>
+> `AGENTS.md` is regenerated from this file via `/vibe.docs agent`. Edit here first.
+
+## Hard Rules
+
+### Behavior
+- **Modify only requested scope** — Every changed line traces to the user's request
+- **Edit existing files over creating new** — Fix at source
+- **Preserve existing style** — Match conventions even if you'd do it differently
+- **Respect Ctrl+C / Escape** — Previous task CANCELLED
+- **State assumptions, ask when uncertain** — Don't pick silently when ambiguity exists; push back if a simpler approach exists
+
+### Goal-Driven Execution
+Transform imperative tasks into verifiable goals **before** coding:
+
+| Instead of | Transform to |
+|---|---|
+| "Add validation" | "Tests for invalid inputs pass" |
+| "Fix the bug" | "A test reproducing it passes" |
+| "Refactor X" | "Tests pass before and after" |
+
+Weak criteria ("make it work") require constant clarification. Strong criteria let the loop run independently.
+
+### TypeScript (enforced by Quality Gate hooks)
+- No `any` / `as any` / `@ts-ignore` — use `unknown` + type guards; fix at root
+- Explicit return types on all functions
+
+### Complexity Limits
+Function ≤50 lines · Nesting ≤3 · Params ≤5 · Cyclomatic ≤10
+
+### Forbidden Patterns
+No `console.log` in commits · No hardcoded strings/numbers · No commented-out code · No incomplete code without TODO
+
+### Convergence (review / auto-fix loops)
+- **Loop until P1 = 0 AND no new findings** — no round cap
+- **Narrowing scope**: Round 1 full → Round 2 P1+P2 → Round 3+ P1 only
+- **Stuck detection** (same findings/score 2 rounds in a row) → ask user (fill values / approve sub-100 / abort). Never silently proceed sub-100
+- **`ultrawork` exception** — skip user prompt; record gaps as TODO to stay non-interactive
+- **Changed files only** — never full-project scan
+
+## Architecture (Non-Obvious)
+
+### Module System
+- ESM only (`"type": "module"`) — imports need `.js` extension
+- Build before test: `npm run build && npx vitest run`
+
+### Config Locations
+| Path | Purpose |
+|---|---|
+| `~/.vibe/config.json` | Global credentials, models (0o600) |
+| `.claude/vibe/config.json` | Project stacks, capabilities |
+| `.claude/settings.local.json` | Project hooks (auto-generated, don't commit) |
+
+### Gotchas
+- `better-sqlite3` WAL mode — synchronous API
+- `crypto.timingSafeEqual` requires same-length buffers — check length first
+- **Stack → asset SSOT**: `GLOBAL_SKILLS_*`, `STACK_TO_SKILLS`, `CAPABILITY_SKILLS` in `src/cli/postinstall/constants.ts`
+- **Hook dispatch order**: `prompt-dispatcher.js` → `keyword-detector.js` → `llm-orchestrate.js`
+
+## Workflow
+
+`/vibe.spec` is the single entry point — orchestrates interview → plan → spec → review → `/vibe.run` → `/vibe.verify` → `/vibe.contract` → `/vibe.trace`. For UI types (website/webapp/mobile), `/vibe.figma` branches in parallel. Smart Resume detects existing `.claude/vibe/{interviews,plans,specs}/*.md` to skip phases.
+
+**Quality-loop commands** (bug → prevention):
+- `/vibe.regress` — Regression test auto-evolution. Auto-registers on `/vibe.verify` failure; `generate` produces preventive tests; `cluster` promotes recurring patterns.
+- `/vibe.contract` — API contract drift detection. Compares the contract extracted from the SPEC against the implementation; P1 drift auto-propagates to `/vibe.regress`.
+- `/vibe.test` — vibe self-test across the CC ↔ coco harnesses. Subcommands: `parity` (static), `report` (runtime), `compare` (diff). P1 drift auto-propagates to `/vibe.regress`. Recommended before every release.
+
+| Task Size | Approach |
+|---|---|
+| 1–2 files | Plan Mode |
+| 3+ files | `/vibe.spec` |
+
+## Magic Keywords
+
+| Keyword | Effect |
+|---|---|
+| `ultrawork` / `ulw` | Parallel agents + auto-continue + Ralph Loop |
+| `ralph` | Iterate to 100% (no scope reduction) |
+| `ralplan` | Iterative planning + persistence |
+| `verify` | Strict verification mode |
+| `quick` | Fast mode, minimal verification |
+
+## Skill Tiers
+
+3 tiers prevent context overload: **core** (always active) / **standard** (project-setup selected) / **optional** (explicit `/skill` only). SSOT: `GLOBAL_SKILLS_CORE` + `GLOBAL_SKILLS_STANDARD` in `src/cli/postinstall/constants.ts`. Proactive triggers live in each skill's frontmatter.
+
+## Context Management
+
+- Exploration → Haiku · Implementation → Sonnet · Architecture → Opus
+- At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
+
+## Git
+
+**Include**: `.claude/vibe/{plans,specs,features,todos,research,regressions,contracts}/`, `.claude/vibe/config.json`, `CLAUDE.md`
+**Vibe-global (not project-local)**: `~/.vibe/test-reports/` — `/vibe.test` artifacts live with the vibe install, not with the project
+**Exclude**: `~/.claude/{rules,commands,agents,skills}/`, `.claude/settings.local.json`
+
+<!-- VIBE:END -->

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Su
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Su
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,220 @@
+# VIBE
+
+**Easy vibe coding. Minimum quality guaranteed.**
+
+[![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 is a quality harness for AI coding tools. It wraps around Claude Code, Codex, Cursor, or Gemini CLI and automatically enforces type safety, code quality, and security — so you can vibe-code fast without shipping garbage.
+
+```bash
+npm install -g @su-record/vibe
+vibe init
+```
+
+---
+
+## The Workflow
+
+One entry point. Everything else is automatic.
+
+```
+/vibe.spec "coffee brand landing page"
+     |
+     v
+  Interview  ─── "Who's the audience?" "What sections?" "Dark mode?" ───
+     |                     (loops until you say stop)
+     v
+  Plan       ─── Structured planning document (.claude/vibe/plans/)
+     |
+     v
+  SPEC       ─── PTCF spec + BDD features, GPT+Gemini parallel research
+     |
+     v
+  Review     ─── Race review (GPT vs Gemini), quality gate (100-point, loop until perfect)
+     |
+     +──────────────────────────────┐
+     v                              v
+  /vibe.run (Logic)            /vibe.figma (UI)
+  Implement from SPEC          Figma design ↔ Code
+  12 agents review             Read or Write
+     |                              |
+     v                              v
+  /vibe.verify ──── /vibe.trace ──── Done
+```
+
+**Smart Resume** — Stop at any step, close the session, come back later. `/vibe.spec` auto-detects where you left off and picks up from there. No need to remember feature names.
+
+**ultrawork** — Add `ultrawork` to skip all confirmation gates and run the full pipeline hands-free.
+
+---
+
+## Quick Start
+
+```bash
+# Install
+npm install -g @su-record/vibe
+
+# Initialize (auto-detects your stack, generates project-aware CLAUDE.md)
+cd your-project
+vibe init
+
+# Start your AI coding tool
+claude
+
+# Run the workflow
+/vibe.spec "add user authentication"
+```
+
+---
+
+## Harness Engineering
+
+Vibe is built on the [Harness Engineering](https://anthropic.com/engineering/harness-design) principle — designing the working environment so AI operates effectively on its own.
+
+### The 6 Axes
+
+| Axis | What it covers | Vibe implementation |
+|------|---------------|---------------------|
+| **Scaffolding** | Project structure, tools, boundaries | `/vibe.scaffold` generates optimized folder structure (docs/, .dev/, layered src/) |
+| **Context** | What AI knows | `vibe init` generates project-aware CLAUDE.md from actual structure analysis |
+| **Planning** | What to build | `/vibe.spec` → interview → plan → SPEC → review pipeline |
+| **Orchestration** | How to execute | 40+ agents, 12 teams, skill-based dispatch |
+| **Verification** | How to trust | Hooks, convergence loops, RTM traceability |
+| **Compounding** | How to improve | Evolution engine, session memory, auto-generated skills |
+
+### Diagnose Your Project
+
+```bash
+/vibe.harness    # Score your project across all 6 axes (0-100)
+```
+
+Produces a detailed report with per-axis scores, grade (S/A/B/C/D), and auto-fixable improvement suggestions. Detects project type (app vs package/library) and adjusts scoring accordingly.
+
+---
+
+## Analyze Anything
+
+`/vibe.analyze` works on more than just source code:
+
+```bash
+/vibe.analyze "login"              # Feature/module code exploration
+/vibe.analyze --code               # Code quality analysis
+/vibe.analyze report.pdf           # Document analysis (PDF, slides, markdown)
+/vibe.analyze https://example.com  # Website analysis (UX, tech, SEO, a11y)
+/vibe.analyze https://figma.com/…  # Figma design analysis
+```
+
+Auto-detects input type (file extension → URL pattern → flag → string) and routes to the appropriate analysis mode with mode-specific quality gates.
+
+---
+
+## Figma ↔ Code
+
+Bidirectional. Read designs from Figma, or write designs to Figma from a plan.
+
+```bash
+# READ — Add UI to existing project (follows project conventions)
+/vibe.figma <figma-url> <figma-url>
+
+# READ — New standalone page (independent styles)
+/vibe.figma --new <figma-url>
+
+# WRITE — Create Figma design from plan document
+/vibe.figma plan.md --create                 # Full (wireframe + visual design)
+/vibe.figma plan.md --create-storyboard      # Wireframe only
+/vibe.figma plan.md --create-design          # Visual design only
+```
+
+**How READ works**: Extracts the Figma node tree + 30 CSS properties via REST API, maps Auto Layout to Flexbox 1:1, generates responsive SCSS. Screenshot is for verification only — the tree is the source of truth.
+
+**How WRITE works**: Parses plan document sections (Look & Feel, layout, responsive strategy), builds wireframe first for structure review, then applies visual design with design system components. Idempotent — re-run after editing the plan and only changed sections update.
+
+---
+
+## Quality Gates
+
+Three layers of defense on every tool call:
+
+| Layer | What it blocks |
+|-------|----------------|
+| Pre-commit hooks | `any` types, `@ts-ignore`, `console.log`, functions > 50 lines |
+| Review agents | 12 specialized reviewers run in parallel (security, performance, a11y, complexity, ...) |
+| Convergence loop | Review findings loop until P1 = 0. No round cap. Stuck = ask user, never silently proceed. |
+
+---
+
+## Key Features
+
+**40+ agents** — Exploration, implementation, architecture, parallel code review, UI/UX analysis, security audit, Figma analysis/building.
+
+**44 skills** — Not all loaded at once. 3-tier system prevents context overload:
+
+| Tier | When loaded | Purpose | Examples |
+|------|-------------|---------|----------|
+| **Core** | Always active | Bug prevention, workflow entry | quality gates, interview, plan |
+| **Standard** | `vibe init` selects by stack | Stack/capability support | figma, design-audit, techdebt |
+| **Optional** | Explicit `/skill` only | Reference, wrappers | chub-usage, context7 |
+
+**Multi-LLM** — Claude orchestrates, GPT reasons, Gemini researches. Auto-routes by availability. Works Claude-only by default. When running under coco (GPT as primary), Claude CLI becomes the secondary for cross-validation — roles automatically reverse based on `~/.coco/` detection.
+
+**Stack detection** — Auto-detects 24 frameworks (Next.js, Django, Rails, Go, Rust, Flutter, and more) and applies framework-specific rules and skills.
+
+**Project-aware CLAUDE.md** — `vibe init` and `vibe update` analyze your project's actual structure (folders, tech stack, build commands) and generate a tailored CLAUDE.md — not a static template.
+
+**Session memory** — Decisions, constraints, and goals persist across sessions via SQLite + FTS5 hybrid search.
+
+**Smart Resume** — `.last-feature` pointer tracks your latest work. `/vibe.spec` without arguments shows where you left off or lists all in-progress features.
+
+**Self-repair** — Skills include error recovery tables. `/vibe.harness` diagnoses gaps and chains to `/vibe.scaffold` → `vibe update` for automated fixes.
+
+---
+
+## Supported Tools
+
+| CLI | Status |
+|-----|--------|
+| [Claude Code](https://claude.ai/code) | Full support |
+| coco (`~/.coco/`) | Full support (auto-detect) |
+| [Codex](https://github.com/openai/codex) | Plugin |
+| [Cursor](https://cursor.sh) | Agents + Rules |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Agents + Skills |
+
+---
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/vibe.spec` | Single entry point — interview, plan, spec, review, then run |
+| `/vibe.run` | Implement from SPEC |
+| `/vibe.figma` | Figma ↔ Code (read or write, 3 modes) |
+| `/vibe.verify` | Verify implementation against SPEC |
+| `/vibe.trace` | Requirements traceability matrix |
+| `/vibe.analyze` | Analyze any target — code, documents, websites, Figma |
+| `/vibe.scaffold` | Generate or audit project folder structure |
+| `/vibe.harness` | Diagnose Harness Engineering maturity (6-axis scoring) |
+| `/vibe.docs` | Generate project documentation |
+
+---
+
+## Documentation
+
+Full guides, skill reference, and configuration details are in the [Wiki](https://github.com/su-record/vibe/wiki).
+
+- [README (Korean)](README.ko.md)
+- [Release Notes](RELEASE_NOTES.md)
+
+---
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Claude Code (required)
+- GPT, Gemini (optional)
+
+## License
+
+MIT — Copyright (c) 2025 Su