vibekit

A guardrailed pipeline for coding agents. It turns a one-line intent into a design you approved, a plan you approved, code written by an agent that never saw the plan being written, and a verdict backed by output you can read. Dependency free: bare Node and whichever agent CLI you already use.

The problem it solves is not bad code. It is the claim of being done. vibekit puts a gate in front of every such claim and makes the evidence part of the answer.

How it works

Six skills, each one a gate. Every stage hands to the next, and no stage can skip the one before it.

/vibekit:vibe "add a dark mode toggle"
        │
        ▼
  brainstorm ──► plan ──► exec ──► verify ──► merge or PR
   (design)    (tasks)  (agents)  (evidence)
        ▲                   │         │
        └───── debug ◄──────┴─────────┘
              (a check failed)

• brainstorm asks questions one at a time, pushes back on your framing once, offers alternatives, and writes a spec with observable success criteria. No code before you approve it.
• plan turns the approved spec into numbered tasks. Every task carries a → verify: clause that is checkable before anything runs, and a plan may not state a value nobody has observed.
• exec dispatches one fresh agent per task. The author of a plan reads past its own contradictions. A fresh context reads it literally and stops. Every plan defect this project has found was found by a dispatched agent.
• verify runs the checks no single task could: the whole suite, the scope of the diff, every goal against its evidence. It returns ready or not ready, and unmeasured counts as not satisfied.
• debug takes over on a failed check. It finds one falsifiable cause, sends a read-only agent to refute it, and stops after two refutations rather than guessing a third time. It never edits.
• lazy and terse stay on once invoked. One governs how much you build, the other how much you say.

Two rules run through all of it. Evidence or it did not happen, because a check with no output to show is not a check. You may not write a value you have not observed, because a guess in a plan is a defect a later agent pays for.

Features

A hard gate refuses to proceed until its condition is met. none means the skill shapes behaviour without blocking anything.

Skills are discovered by globbing skills/*/SKILL.md. There is no registry anywhere in the repo, which is what makes registration drift impossible rather than merely detectable. Every derived file, including the runtime manifests, the command files, the trigger tables and this table, is generated by npm run generate and verified by npm run check.

Install

Each runtime installs separately. Installing for one does not affect any other.

Claude Code

/plugin marketplace add rizukirr/vibekit
/plugin install vibekit@vibekit-marketplace

Codex

codex plugin marketplace add rizukirr/vibekit
codex plugin add vibekit@vibekit

Verify with codex plugin list.

opencode

Add it to the plugin array in your opencode.json, global or project level:

{
  "plugin": ["vibekit@git+https://github.com/rizukirr/vibekit.git"]
}

Verify with opencode debug skill.

Gemini CLI

gemini extensions install https://github.com/rizukirr/vibekit

Pi

pi install git:github.com/rizukirr/vibekit

What has actually been checked

Two runtimes were probed against the real CLI and two were not. That distinction is kept per row because unit tests assert what we decided to emit, which says nothing about whether a host accepts it. That gap hid four integration defects until they were probed.

Evals

Skills are behaviour-shaping prompts, so the only way to know one works is to watch it fire in a real session.

npm run eval                                       # candidate only, deterministic
npm run eval -- --baseline v2 --candidate HEAD     # A/B two refs
npm run eval -- --dry-run                          # print the plan and cost, spawn nothing
npm run eval -- --judge                            # also grade whether the skill was followed

Variants are git refs materialised as throwaway worktrees, so there is never a second skills/ tree to drift. Sessions run in a disposable temp directory.

Run A/B rather than candidate-only whenever a rate is the point. A candidate rate of 1.00 once looked like a new rule working. Its baseline arm was also 1.00, because the model already did it.

This costs real money and needs an authenticated claude CLI, so it is a manual gate, not part of the free CI (check, test, check:hook).

Development

npm run generate    # regenerate every derived file
npm run check       # fail if any generated file is out of date
npm test            # unit tests

Adding a skill is creating one directory under skills/ with a SKILL.md, then running npm run generate. Never hand-edit a generated file.

License

MIT. Copyright (c) 2026 Rizki Rakasiwi. See LICENSE.