Skip to content

v0.2.0

Choose a tag to compare

View all tags
@rizukirr rizukirr released this 25 Apr 15:38
· 92 commits to main since this release
v0.2.0
6c833ef

Vibekit grows from a 10-skill pipeline into a 13-skill plugin with cross-cutting durable state, an autonomous-driver peer to /vibe, parallel-group dispatch, and a four-axis authoring discipline. Backward-compatible — no skill renames, no removed operations; only additive surface plus internal discipline tightening.

Highlights

  • /ralph-loop <intent> — bounded autonomous re-runs of /vibe with a blocker classifier and thrashing critic. Same gates, same review-pack sign-off, no shortcuts.
  • memory-dual — durable project knowledge under .vibekit/memory/. Atomic facts and compound documents in one storage convention, plus a working notepad. Keyword + tag + type search; [[key]] cross-links; audit pass.
  • vibekit-doctor — cross-runtime health diagnostic. Skill files, runtime registrations, .vibekit/ health, docs/ subdirs, authoring contracts. Read-only by default; --fix for safe repairs.
  • Parallel-group dispatch — fused into exec-dispatch. Plans opt into parallelism via <!-- parallel-group: <name> --> markers with mandatory rationale and disjoint-files invariant.
  • Karpathy-aligned discipline — four behavioral principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) injected across the pipeline at multiple enforcement points.
  • Four-axis authoring contract — PEG (substance) + Karpathy (behavior) + Caveman (style) + Quad-Adapter (cross-runtime portability) under skills/_authoring/.

New skills

Skill Role
memory-dual Durable project knowledge — atomic facts, compound documents, working notepad — under one file-backed convention. Operations: read, query, list, write, supersede, delete, classify, audit. Default classify verdict is surface: none to prevent dump-style overfilling.
vibekit-doctor Health check across 10 categories (skill files, runtime registrations, plugin manifests, docs/ subdirs, .vibekit/ health, authoring contracts, external/ integrity, skill-count consistency, hooks hygiene, git state). Verbatim YAML output for CI parseability.
ralph-loop Autonomous-driver peer to /vibe. Bounded persistence loop with classifier (retry-task / re-plan / escalate) and thrashing critic. Halts on block_finding, escalate, thrashing, or any budget exhaustion. Never bypasses review-pack sign-off.

Karpathy injection points (cross-cutting)

Four principles, four-layer redundancy on the most safety-critical ones:

Principle Enforcing skills (in pipeline order)
1. Think Before Coding brainstorm-lean — Pushback turn before approaches
2. Simplicity First review-pack — Pass 4, in Reflexion checklist
3. Surgical Changes brief-compiler → exec-dispatch → review-pack Pass 5 → verify-gate Step 3b (RTCO CONSTRAINTS → per-task Gate-1 → review detection → fail-closed verification)
4. Goal-Driven plan-write (→ verify: clause mandatory) → vibe post-plan gate → exec-dispatch step 1a

Parallel-group dispatch

Plans opt into parallelism per group, not per task:

<!-- parallel-group: ui-pieces
     rationale: ThemeToggle, ThemeMenu, ThemeProvider have disjoint Files sections -->
### Task 2: ThemeToggle component → verify: ThemeToggle.test.tsx passes
### Task 3: ThemeMenu component → verify: ThemeMenu.test.tsx passes
### Task 4: ThemeProvider context → verify: ThemeProvider.test.tsx passes
<!-- /parallel-group -->

exec-dispatch enforces files-disjoint, no-ordering-dependencies, no-shared-installs invariants before fanning out. Plans that fail invariants are rejected, not best-effort dispatched.

Cross-runtime portability (quad-adapter contract)

skills/_authoring/quad-adapter.md is the new authoring contract for runtime-coupled skills. Every such skill ships:

  1. A capability matrix — required primitives × per-runtime support.
  2. A documented fallback for every "no" cell.
  3. A verbatim degradation warning — never compressed, never silently skipped.

Concrete results in v0.2.0:

Capability Claude Code Codex Gemini CLI opencode
Parallel subagent dispatch (exec-dispatch) native native sequential fallback w/ warning provider-dependent
Native loop primitive (ralph-loop) native native degraded checkpoint mode w/ warning degraded checkpoint mode w/ warning

Phase 1 / 2 stability fixes (also in this release)

  • brainstorm-lean: pushback turn added; never-compress list expanded.
  • plan-write: mandatory → verify: per-task clause; optional parallel-group markers; self-review items added.
  • brief-compiler: RTCO CONSTRAINTS template ships three surgical-change rules in every dispatched brief.
  • exec-dispatch: step 1a verify-clause gate; Gate-1 self-review checks the verify criterion is observably met; surgical constraints inherited per-task.
  • review-pack: passes 4 (Simplicity) and 5 (Surgical-diff) added; block-severity findings halt the handoff.
  • verify-gate: Step 3b surgical-diff self-consistency pass; orphans listed verbatim in the Repo-level checks; ready-verdict rule updated.
  • vibe: post-plan gate now checks → verify: clauses and parallel-group integrity before advancing.

Documentation

  • README.md — refreshed for 13 skills; intro reframed as "discipline-first vibe-coding plugin" with token-efficiency scoped precisely (per feature, not per session).
  • INSTALL.gemini.md — gains "Configure context file" section with copy-pasteable minimum GEMINI.md listing all 13 skills. Closes the onboarding gap caused by GEMINI.md being gitignored as per-user local context.
  • AGENTS.md — skill table and skill count updated.

Internal cleanup

  • wiki-dual (briefly shipped, then merged) — collapsed into memory-dual after a Karpathy "Simplicity First" audit found the two skills shared 90% storage convention, discipline, and callers. One unified surface, one storage path, one classify pass.
  • Stale references swept across peg-cheatsheet, quad-adapter, CLAUDE.md ship-order, and Karpathy injection map.

Manifests bumped

  • .claude-plugin/plugin.json
  • .claude-plugin/marketplace.json
  • .codex-plugin/plugin.json
  • gemini-extension.json
  • package.json

Upgrade notes

No skill renames, no removed operations, no behavioral changes for users of /vibe. Existing plans, specs, verification reports remain valid. Three reasons to upgrade:

  1. The pipeline is more honest about defects (Karpathy block-severity surgical-diff and simplicity passes).
  2. /ralph-loop removes the manual click between iterations on long verify-fix cycles.
  3. memory-dual and wiki-dual-style content now share one file-backed surface — durable project knowledge that survives across runs.

20 commits since v0.1.0; 25 files changed; ~1,400 lines added across skill prose and authoring contracts.

Assets 2
Loading