minimal-vibe-coding-kit 0.3.0 → 0.4.1

package/backbone.yml

@@ -1,11 +1,11 @@
-# Minimal Vibe Coding Kit backbone. See .vbkit-docs/BACKBONE_REFERENCE.md for details.
+# Minimal Vibe Coding Kit backbone. See .vibekit/docs/BACKBONE_REFERENCE.md for details.
 version: 2
 meta:
   template_status: initialized
   initialized_at: 2026-05-27T01:36:21.898Z
   template_source: minimal-vibe-coding-kit
   schema_version: 3
-  init_runbook: FIRST_TIME_INIT.md
+  init_runbook: .vibekit/init/FIRST_TIME_INIT.md
   init_done_marker: .vibekit/INIT_DONE
 
 project:
@@ -24,7 +24,7 @@ paths:
     - .
   source: []
   tests: []
-  docs: [README.md, .vbkit-docs/]
+  docs: [README.md, .vibekit/docs/]
   generated: [node_modules/, dist/, build/, coverage/]
 
 conventions:
@@ -51,6 +51,7 @@ conventions:
     rule: "No localization convention was detected; follow nearby copy patterns and ask before introducing a project-wide i18n layer."
   custom_rules:
     - Add team-specific rules here during init review; future agents must follow them.
+    - Use path-sensitive-shell-safety before editing shell/deploy/installer/repair logic that joins remote base paths, repo folders, checkout paths, or destructive commands such as rm/mv/cp/rsync/find/git cleanup.
 
 commands:
   install: npm install
@@ -82,8 +83,8 @@ agent_surfaces:
   cursor: .cursor/
   codex: .agents/
   codex_plugin: .codex-plugin/plugin.json
-  shared_skills: skills/
-  shared_commands: .vbkit-commands/
+  shared_skills: .vibekit/skills/
+  shared_commands: .vibekit/commands/
 
 automation:
   autoresearch:
@@ -97,7 +98,7 @@ automation:
   finalize:
     cleanup_dir: _vibekit-cleanup
     marker: .vibekit/FINALIZE_DONE
-    one_time_files: [FIRST_TIME_INIT.md, FIRST_PROMPT.md, PUSH_TO_GITHUB.md, CLAUDE-template.md]
+    one_time_files: [.vibekit/init/FIRST_TIME_INIT.md, .vibekit/init/FIRST_PROMPT.md, .vibekit/init/PUSH_TO_GITHUB.md, .vibekit/init/CLAUDE-template.md]
   security:
-    probe: node .vbkit-scripts/agentshield-probe.mjs .
+    probe: node .vibekit/scripts/agentshield-probe.mjs .
     scan: npx ecc-agentshield scan --path . --format text --min-severity medium

package/bin/mvck.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import '../.vbkit-scripts/mvck.mjs';
+import '../.vibekit/scripts/mvck.mjs';

package/bin/vibe-kit.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import '../.vbkit-scripts/mvck.mjs';
+import '../.vibekit/scripts/mvck.mjs';

package/docs/README.vi.md

@@ -0,0 +1,268 @@
+<div align="center">
+
+**Đọc bằng:** [English](../README.md) · **Tiếng Việt**
+
+# Minimal Vibe Coding Kit
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
+[![npm](https://img.shields.io/badge/npm-minimal--vibe--coding--kit-cb3837?logo=npm)](https://www.npmjs.com/package/minimal-vibe-coding-kit)
+[![Version](https://img.shields.io/badge/version-0.4.1-2ea44f.svg)](../CHANGELOG.md)
+![Claude](https://img.shields.io/badge/Claude%20Code-Commands%20%26%20Skills-111111)
+![Cursor](https://img.shields.io/badge/Cursor-Rules%20%26%20Commands-1f6feb)
+![Codex](https://img.shields.io/badge/Codex-AGENTS.md%20%26%20Plugin-6f42c1)
+![AgentShield](https://img.shields.io/badge/Security-AgentShield-d62828)
+![Node](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)
+
+**Một bộ kit AI-coding cài một lần cho Claude Code, Cursor và Codex — mọi repo, mọi ngôn ngữ.**
+
+Cài đặt → dán một prompt → duyệt đề xuất → code với guardrails.
+
+</div>
+
+---
+
+## Bộ kit này là gì?
+
+Một bộ kit nhỏ gồm **rules**, **skills**, **commands** dùng chung, cộng một manifest **`backbone.yml`**, giúp Claude Code, Cursor và Codex hiểu project của bạn theo cùng một cách.
+
+- Không bao giờ ghi đè `CLAUDE.md` / `AGENTS.md` sẵn có — chỉ thêm managed block.
+- Mọi thao tác ghi khi setup đều chờ bạn duyệt.
+- Rà soát bảo mật bề mặt agent (AgentShield) là một phần của workflow bình thường.
+- Xóa an toàn mặc định: `rm` bị deny-list cho Claude Code và Cursor, mọi agent ưu tiên lệnh `trash` (khôi phục được; init sẽ kiểm tra và gợi ý cách cài nếu thiếu).
+- Init lần đầu hỏi hai tùy chọn — dùng `trash` thay `rm`, và mức giải thích mặc định (0–5, đổi bất cứ lúc nào với `/coding-level N`) — rồi lưu cả hai vào `backbone.yml`.
+
+## Bắt đầu nhanh
+
+Ba bước, khoảng hai phút.
+
+**1. Cài vào project của bạn** (không cần clone):
+
+```bash
+npx --yes minimal-vibe-coding-kit@latest install /path/to/your-project
+```
+
+Đã chạy `npm i minimal-vibe-coding-kit`, hoặc muốn cài từ GitHub / bản clone? Xem [Cài từ npm](#cài-từ-npm).
+
+**2. Mở project trong Claude Code, Cursor hoặc Codex và dán:**
+
+```text
+Read .vibekit/init/FIRST_TIME_INIT.md and initialize this repo with Minimal Vibe Coding Kit.
+First print the requirements you will check. Then run detection, propose one diff
+for backbone.yml and managed instruction blocks, and wait for my yes before writing.
+```
+
+**3. Review diff được đề xuất và trả lời `yes`.**
+
+Agent điền `backbone.yml` với stack và quy ước đã dò được, rồi chuyển sang `initialized`. Xong — mọi phiên sau tự động đọc file này và bỏ qua bước init.
+
+Kiểm tra sức khỏe bất cứ lúc nào:
+
+```bash
+node .vibekit/scripts/mvck.mjs doctor .
+```
+
+## Cài từ npm
+
+Kit được publish trên npm với tên [`minimal-vibe-coding-kit`](https://www.npmjs.com/package/minimal-vibe-coding-kit). Đây là **CLI scaffolding, không phải library** — file nằm trong `node_modules/` tự nó không làm gì cả. Chạy `install` một lần sẽ copy kit vào repo root của bạn, giống hệt installer từ GitHub.
+
+**Cách A — chạy một phát (khuyến nghị).** Không thêm gì vào dependencies của project:
+
+```bash
+npx --yes minimal-vibe-coding-kit@latest install /path/to/your-project
+```
+
+**Cách B — cài như dependency.** Nếu bạn đã (hoặc muốn) `npm i` package, cần thêm đúng một lệnh nữa:
+
+```bash
+npm i -D minimal-vibe-coding-kit
+npx mvck install .        # bắt buộc — copy kit từ node_modules ra repo của bạn
+```
+
+> **Quan trọng:** `npm i` một mình chỉ tải kit vào `node_modules/` — chưa có gì hoạt động.
+> `mvck install` mới là bước copy `.claude/`, `.cursor/`, `.agents/`, `.vibekit/` và `backbone.yml` vào repo root.
+
+Sau đó, lệnh ngắn `mvck` (alias: `vibe-kit`) dùng được qua `npx`:
+
+| Lệnh ngắn | Chức năng |
+| --- | --- |
+| `npx mvck install .` | Copy kit vào repo (`--profile`, `--dry-run`, `--force`) |
+| `npx mvck update .` | Làm mới file thuộc kit khi có bản phát hành mới |
+| `npx mvck doctor .` | Health check chỉ-đọc |
+| `npx mvck validate .` | Validate cấu trúc |
+
+Rồi tiếp tục **bước 2** của Bắt đầu nhanh (dán prompt init).
+
+Các cách cài khác: `npx github:giang6283623/minimal-vibe-coding-kit install /path/to/your-project`, hoặc từ bản clone `./install.sh /path/to/your-project` (Windows: `./install.ps1 -Target C:\path\to\your-project`).
+
+## Những gì được cài vào repo của bạn
+
+Cài đặt chỉ thêm đúng những mục sau — không đụng vào bất cứ thứ gì khác:
+
+```text
+your-project/
+├── backbone.yml              ← bản đồ project mà agent đọc đầu tiên (nguồn sự thật duy nhất)
+├── AGENTS.md                 ← hướng dẫn chung cho agent (managed block)
+├── CLAUDE.md                 ← ngắn gọn; import AGENTS.md (chỉ tạo khi chưa có)
+├── .gitignore                ← các entry của kit thêm trong managed block
+├── .claude/                  ← Claude Code: rules, commands, agents, skills
+├── .cursor/                  ← Cursor: rules, commands, skills
+├── .agents/                  ← skills cho Codex / portable
+├── .codex/  .codex-plugin/   ← config mẫu Codex + plugin manifest
+└── .vibekit/                 ← mọi thứ thuộc kit, trong MỘT thư mục
+    ├── skills/               ← shared skills canonical (mirror sang các harness)
+    ├── commands/             ← prompt command dùng chung
+    ├── scripts/              ← CLI mvck, init, validate, doctor, security probe
+    ├── docs/                 ← tài liệu tham khảo sâu hơn
+    └── init/                 ← file onboarding một lần (xóa được bằng /vibe-finalize)
+```
+
+File sẵn có không bao giờ bị thay thế — kit chỉ merge managed block (`BEGIN/END: minimal-vibe-coding-kit`) và bỏ qua những gì thuộc về bạn.
+
+## Các mảnh ghép kết nối thế nào
+
+```text
+Bạn (prompt) ──▶ Claude Code / Cursor / Codex
+                      │  đọc đầu tiên
+                      ▼
+        backbone.yml  +  AGENTS.md / CLAUDE.md  +  rules
+                      │  load khi cần
+                      ▼
+        skills (quy trình)  +  commands (phím tắt)
+                      │  được bảo vệ bởi
+                      ▼
+        protected paths · đề xuất-trước-khi-ghi · AgentShield probe
+```
+
+- **`backbone.yml`** — đường dẫn, quy ước, protected paths, và lệnh validate của repo bạn.
+- **Rules** — guardrails ngắn, luôn được load (đọc backbone trước, diff nhỏ, security review khi sửa bề mặt agent).
+- **Skills** — quy trình lặp lại được, chỉ load khi task cần.
+- **Commands** — phím tắt một từ cho các skill hay dùng nhất.
+
+## Hướng dẫn — sử dụng hằng ngày
+
+1. **Cứ code bình thường.** Yêu cầu feature/fix như thường lệ; agent theo quy ước trong `backbone.yml` và giữ diff nhỏ.
+2. **Task lớn hoặc mơ hồ?** Bắt đầu với skill `clearthought` hoặc `sequential-thinking` để có kế hoạch trước.
+3. **Câu hỏi toàn repo hoặc review lớn?** Dùng `parallel-analysis` — chia các lane phân tích chỉ-đọc chạy song song rồi xác minh kết quả gộp.
+4. **Đã sửa `.claude/`, skills, hooks, hoặc script installer?** Chạy `/security-scan` trước khi merge.
+5. **Muốn cải tiến đo được?** Chạy `/autoresearch-coding` với metric và budget.
+6. **Giữ setup luôn sắc bén:** `/daily-enhance` đề xuất cải tiến — không bao giờ tự áp dụng.
+7. **Onboarding xong hẳn?** `/vibe-finalize` dọn các file bootstrap một lần.
+
+## Commands
+
+| Command | Chức năng | Ví dụ |
+| --- | --- | --- |
+| `/init-vibe` | Init lần đầu hoặc sửa chữa: đề xuất một diff, chờ duyệt. | `/init-vibe` — review diff rồi trả lời `yes`. |
+| `/security-scan` | AgentShield probe chỉ-đọc + scanner tùy chọn cho bề mặt agent. | `/security-scan` trước khi merge thay đổi `.claude/**` hoặc skills. |
+| `/daily-enhance` | Báo cáo chỉ-đề-xuất để cải tiến rules, skills, workflows. | `/daily-enhance` — review diff đề xuất rồi duyệt. |
+| `/autoresearch-coding` | Vòng lặp thử nghiệm theo metric với baseline và budget. | `/autoresearch-coding` Goal: giảm lỗi lint. Budget: 3. |
+| `/council` | Phối hợp các agent reviewer/researcher/analyst thành một kế hoạch gộp. | `/council` trên diff của branch này. |
+| `/vibe-finalize` | Tốt nghiệp project: chuyển file bootstrap một lần vào `_vibekit-cleanup/`. | `/vibe-finalize` — xem trước, áp dụng sau khi duyệt. |
+
+## Skills
+
+Cả 12 skill nằm trong `.vibekit/skills/` và được mirror cho từng tool. Gọi bằng tên ("Use the X skill…") hoặc qua các command ở trên.
+
+| Skill | Dùng khi | Prompt ví dụ |
+| --- | --- | --- |
+| `vibekit-init` | Setup lần đầu, hoặc `backbone.yml` / managed blocks cần sửa. | "Use the vibekit-init skill. Propose one diff and wait for my yes." |
+| `parallel-analysis` | Câu hỏi toàn repo, review diff lớn, audit tính nhất quán. | "Use parallel-analysis: where is auth handled and what depends on it?" |
+| `agentshield-security-review` | Audit config agent, skills, hooks, MCP, commands trước khi merge. | "Use agentshield-security-review on .claude/** and .vibekit/skills/**." |
+| `autoresearch-coding` | Cải tiến repo qua các thử nghiệm đo được. | "Use autoresearch-coding. Metric: `npm test`. Direction: higher. Budget: 3." |
+| `daily-workflow-curator` | Tune-up định kỳ cho rules, skills, workflows (chỉ đề xuất). | "Use daily-workflow-curator and propose today's improvements." |
+| `path-sensitive-shell-safety` | Trước khi sửa logic shell/installer/deploy có biến path hoặc `rm`/`mv`/`rsync`. | "Use path-sensitive-shell-safety before changing this cleanup script." |
+| `visual-design-loop` | Polish UI: render → screenshot → review → fix, theo vòng lặp. | "Use visual-design-loop on /dashboard. Budget 3 loops." |
+| `clearthought` | Yêu cầu mơ hồ, tradeoff thiết kế, quyết định rủi ro. | "Use clearthought. Operation: implementation_plan. Split this feature into safe tasks." |
+| `sequential-thinking` | Chia nhỏ công việc phức tạp theo từng bước. | "Use sequential-thinking. Break this refactor into ordered steps with tests." |
+| `reviewing-4p-priorities` | Triage bug/finding theo thứ tự fix P0–P4. | "Use reviewing-4p-priorities. Classify these findings and give a fix sequence." |
+| `memento` | Task nhiều ngày: lưu ngữ cảnh trước khi dừng, resume phiên sau. | "/memento — write MEMENTO.md with Goal, Done, Stuck, Next." |
+| `coding-level` | Chỉnh độ chi tiết khi giải thích (0 = ELI5 … 5 = chuyên gia). | "/coding-level 2" |
+
+## Nâng cao
+
+### Profile cài đặt
+
+Chỉ cài các bề mặt bạn dùng (mặc định là `all`):
+
+```bash
+npx --yes minimal-vibe-coding-kit@latest install . --profile claude          # chỉ Claude Code
+npx --yes minimal-vibe-coding-kit@latest install . --profile claude,cursor   # Claude + Cursor
+npx --yes minimal-vibe-coding-kit@latest install . --profile codex           # Codex / agent dùng AGENTS.md
+```
+
+Cờ: `--force` (ghi đè file kit sẵn có), `--dry-run` (xem trước), `--json` (kế hoạch dạng máy đọc).
+
+### Cập nhật project đã cài
+
+Chạy trong project của bạn khi kit có skill hoặc script mới:
+
+```bash
+npx --yes minimal-vibe-coding-kit@latest update . --dry-run   # xem trước
+npx --yes minimal-vibe-coding-kit@latest update .             # áp dụng
+```
+
+`update` chỉ làm mới **file thuộc kit**, không bao giờ đụng `backbone.yml` hay nội dung của bạn, cập nhật managed block tại chỗ, và backup file bị thay vào `.vibekit/update-backup/<timestamp>/`. Chi tiết: [.vibekit/docs/INSTALL.md](../.vibekit/docs/INSTALL.md).
+
+### Vòng lặp Autoresearch
+
+```text
+Use the autoresearch-coding skill.
+Goal: improve maintainability. Metric command: <lệnh validate của bạn>. Direction: higher.
+Editable paths: src/ docs/. Protected paths: .git .env* node_modules lockfiles.
+Budget: 3.
+```
+
+Hợp đồng: baseline trước → mỗi lần một thử nghiệm nhỏ → chỉ giữ thay đổi cải thiện metric → log tất cả.
+
+### Rà soát bảo mật (AgentShield)
+
+```bash
+node .vibekit/scripts/agentshield-probe.mjs .                          # probe chỉ-đọc, nhanh
+npx ecc-agentshield scan --path . --format text --min-severity medium  # scan đầy đủ, tùy chọn
+```
+
+Mọi thay đổi tới `CLAUDE.md`, `AGENTS.md`, `.claude/**`, `.cursor/**`, `.agents/**`, `.codex-plugin/**`, hoặc `.vibekit/skills|commands|scripts/**` đều nên kích hoạt review. Mô hình: [.vibekit/docs/SECURITY_MODEL.md](../.vibekit/docs/SECURITY_MODEL.md).
+
+### Doctor và báo cáo
+
+```bash
+node .vibekit/scripts/mvck.mjs doctor .                 # health check chỉ-đọc
+node .vibekit/scripts/mvck.mjs doctor . --write-report  # ghi VIBE_REPORT.md
+node .vibekit/scripts/daily-enhance.mjs . --write-report
+```
+
+### Cho người phát triển kit
+
+```bash
+npm test                # syntax + test cài đặt thật vào thư mục tạm + validate cấu trúc
+npm run validate:all    # npm test + AgentShield probe + npm pack dry-run
+```
+
+Checklist publish: [.vibekit/init/PUSH_TO_GITHUB.md](../.vibekit/init/PUSH_TO_GITHUB.md). Tài liệu sâu hơn: [.vibekit/docs/](../.vibekit/docs/).
+
+<details>
+<summary><strong>Khắc phục sự cố</strong></summary>
+
+| Triệu chứng | Cách xử lý |
+| --- | --- |
+| Agent bỏ qua luồng init | Chạy lại installer, hoặc copy [.vibekit/init/CLAUDE-template.md](../.vibekit/init/CLAUDE-template.md) thành `CLAUDE.md`. |
+| Agent hỏi init lại mỗi phiên | Chạy init và duyệt; xác nhận `meta.template_status: initialized` trong `backbone.yml`. |
+| Dò sai stack | Xóa lockfile cũ, hoặc sửa `backbone.yml` trực tiếp. |
+| Agent chạm path không nên | Thêm path vào `policy.protected_paths` trong `backbone.yml` (hỗ trợ glob). |
+| AgentShield probe cảnh báo | Cài Python 3, hoặc bỏ qua — là warning, không phải failure. |
+| Thiếu script sau khi cài | Chạy lại install với `--force`, hoặc copy thủ công `.vibekit/scripts/`. |
+
+</details>
+
+## Đóng góp
+
+Issue và PR luôn welcome tại [`giang6283623/minimal-vibe-coding-kit`](https://github.com/giang6283623/minimal-vibe-coding-kit). Trước khi mở PR: mirror thay đổi skill giữa `.claude/`, `.cursor/`, `.agents/`, giữ template trung lập, và chạy `npm run validate:all`. Xem [CONTRIBUTING.md](../CONTRIBUTING.md), [SECURITY.md](../SECURITY.md), [CODE_OF_CONDUCT.md](../CODE_OF_CONDUCT.md).
+
+**Tác giả:** [GiangBV](https://www.linkedin.com/in/buivangiang1992), [AuPMH](https://www.linkedin.com/in/pham-au-2a1bb1162)
+**Powered by:** Caffeine, Determination, AI Collaboration, và những đêm code cuối tuần.
+
+## Giấy phép
+
+MIT. Xem [LICENSE](../LICENSE).
+
+> 🇻🇳 *Nếu bạn yêu Việt Nam và con người Việt Nam, bạn hoàn toàn được dùng miễn phí mọi thứ trong đây.*

package/install.ps1

@@ -11,4 +11,4 @@ $ArgsList = @("install", $Target, "--profile", $Profile)
 if ($Force) { $ArgsList += "--force" }
 if ($DryRun) { $ArgsList += "--dry-run" }
 if ($Json) { $ArgsList += "--json" }
-node (Join-Path $ScriptDir ".vbkit-scripts/mvck.mjs") @ArgsList
+node (Join-Path $ScriptDir ".vibekit/scripts/mvck.mjs") @ArgsList

package/install.sh

@@ -1,8 +1,10 @@
 #!/usr/bin/env sh
 set -eu
-TARGET="${1:-.}"
-if [ "$#" -gt 0 ]; then
+# Target is the first argument only when it is not an option; flags may come in any position.
+TARGET="."
+if [ "$#" -gt 0 ] && [ "${1#-}" = "$1" ]; then
+  TARGET="$1"
   shift
 fi
 SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
-node "$SCRIPT_DIR/.vbkit-scripts/mvck.mjs" install "$TARGET" --profile all "$@"
+node "$SCRIPT_DIR/.vibekit/scripts/mvck.mjs" install "$TARGET" --profile all "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-vibe-coding-kit",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Project-agnostic AI coding workflow kit for Claude Code, Cursor, and Codex with AgentShield security review.",
   "type": "module",
   "bin": {
@@ -9,18 +9,18 @@
     "vibe-kit": "./bin/vibe-kit.js"
   },
   "scripts": {
-    "install:repo": "node .vbkit-scripts/mvck.mjs install",
-    "init:backbone": "node .vbkit-scripts/init-backbone.mjs . --propose",
-    "doctor": "node .vbkit-scripts/doctor.mjs .",
-    "daily": "node .vbkit-scripts/daily-enhance.mjs . --write-report",
-    "check:syntax": "node --check .vbkit-scripts/mvck.mjs && node --check .vbkit-scripts/init-backbone.mjs && node --check .vbkit-scripts/daily-enhance.mjs && node --check .vbkit-scripts/validate-kit.mjs && node --check .vbkit-scripts/doctor.mjs && node --check .vbkit-scripts/test-install.mjs && node --check .vbkit-scripts/agentshield-probe.mjs && node --check .vbkit-scripts/pack-dry-run.mjs && node --check .vbkit-scripts/vibekit-finalize.mjs && node --check bin/mvck.js && node --check bin/vibe-kit.js",
-    "test:install": "node .vbkit-scripts/test-install.mjs",
+    "install:repo": "node .vibekit/scripts/mvck.mjs install",
+    "init:backbone": "node .vibekit/scripts/init-backbone.mjs . --propose",
+    "doctor": "node .vibekit/scripts/doctor.mjs .",
+    "daily": "node .vibekit/scripts/daily-enhance.mjs . --write-report",
+    "check:syntax": "node --check .vibekit/scripts/mvck.mjs && node --check .vibekit/scripts/init-backbone.mjs && node --check .vibekit/scripts/daily-enhance.mjs && node --check .vibekit/scripts/validate-kit.mjs && node --check .vibekit/scripts/doctor.mjs && node --check .vibekit/scripts/test-install.mjs && node --check .vibekit/scripts/agentshield-probe.mjs && node --check .vibekit/scripts/pack-dry-run.mjs && node --check .vibekit/scripts/vibekit-finalize.mjs && node --check bin/mvck.js && node --check bin/vibe-kit.js",
+    "test:install": "node .vibekit/scripts/test-install.mjs",
     "test": "npm run check:syntax && npm run test:install && npm run validate",
-    "validate": "node .vbkit-scripts/validate-kit.mjs .",
-    "security:probe": "node .vbkit-scripts/agentshield-probe.mjs .",
-    "pack:dry-run": "node .vbkit-scripts/pack-dry-run.mjs",
+    "validate": "node .vibekit/scripts/validate-kit.mjs .",
+    "security:probe": "node .vibekit/scripts/agentshield-probe.mjs .",
+    "pack:dry-run": "node .vibekit/scripts/pack-dry-run.mjs",
     "validate:all": "npm test && npm run security:probe && npm run pack:dry-run",
-    "pack:repo": "node .vbkit-scripts/validate-kit.mjs . && npm pack"
+    "pack:repo": "node .vibekit/scripts/validate-kit.mjs . && npm pack"
   },
   "keywords": [
     "vibe-coding",
@@ -37,9 +37,9 @@
   },
   "files": [
     "bin/",
-    ".vbkit-scripts/",
-    "skills/",
-    ".vbkit-commands/",
+    ".vibekit/scripts/",
+    ".vibekit/skills/",
+    ".vibekit/commands/",
     ".claude/agents/",
     ".claude/commands/",
     ".claude/rules/",
@@ -51,30 +51,34 @@
     ".claude/skills/clearthought/",
     ".claude/skills/sequential-thinking/",
     ".claude/skills/reviewing-4p-priorities/",
+    ".claude/skills/path-sensitive-shell-safety/",
     ".claude/skills/visual-design-loop/",
     ".claude/skills/memento/",
     ".claude/skills/coding-level/",
+    ".claude/skills/parallel-analysis/",
     ".cursor/rules/",
     ".cursor/commands/",
     ".cursor/settings.json",
     ".cursor/skills/clearthought/",
     ".cursor/skills/sequential-thinking/",
     ".cursor/skills/reviewing-4p-priorities/",
+    ".cursor/skills/path-sensitive-shell-safety/",
     ".cursor/skills/memento/",
     ".cursor/skills/coding-level/",
+    ".cursor/skills/parallel-analysis/",
     ".agents/",
     ".codex/",
     ".codex-plugin/",
-    ".vbkit-docs/",
+    ".vibekit/docs/",
     "AGENTS.md",
-    "CLAUDE-template.md",
-    "FIRST_TIME_INIT.md",
-    "FIRST_PROMPT.md",
+    ".vibekit/init/CLAUDE-template.md",
+    ".vibekit/init/FIRST_TIME_INIT.md",
+    ".vibekit/init/FIRST_PROMPT.md",
     "backbone.yml",
     "install.sh",
     "install.ps1",
     "README.md",
-    "README.vi.md",
+    "docs/README.vi.md",
     "SECURITY.md",
     "CONTRIBUTING.md",
     "CODE_OF_CONDUCT.md",

package/.vbkit-commands/vibe-finalize.md

@@ -1,3 +0,0 @@
-# vibe-finalize
-
-Graduate this project once init and the first prompt are complete. Run `node .vbkit-scripts/vibekit-finalize.mjs . --propose` to preview, then `--write --yes` to move one-time bootstrap files (FIRST_TIME_INIT.md, FIRST_PROMPT.md, PUSH_TO_GITHUB.md, CLAUDE-template.md) into `_vibekit-cleanup/` for deletion. It refuses to run on the kit source repo and is reversible with `--restore --write`.