vibecrafted
$ curl -fsSLO https://raw.githubusercontent.com/VetCoders/vibecrafted/main/install.sh && bash install.sh

VibeCrafted The Founders' Framework

A convergence-driven system for shipping software with AI agents.

See the Evidence View on GitHub

It is not magic.
It is Computer Science.

The vocabulary is vivid because it was discovered in real founder workflows. Underneath it sits a rigorous operating model for context, variance reduction, and release truth.

01

AST-Augmented Context

LLMs fail when they code blind. By externalizing architectural memory into AST-augmented mappings, VibeCrafted keeps frontier models oriented precisely inside your repository.

02

Stochastic Convergence

Code generation is stochastic. The Marbles loop uses priority-weighted denoising loops to relentlessly reduce variance, forcing the system into a shippable state.

03

Vibecrafting (SHACE)

Structured Human-AI Collaborative Engineering. We wrap deterministic human checkpoints around stochastic generation. The result is a system you control and understand.

Runtime Foundations

The substrate underneath the framework.

The substrate that keeps frontier agents anchored to repo truth.

01

loctree

Perception Engine

AST-augmented architectural memory. The eyes for every agent — forces LLMs to see the full repo structure before modifying a single file.

loct.io
02

aicx-mcp

History Retrieval

Indexes decisions, intents, and outcomes from every AI session. Agents retrieve what was decided and why, ensuring session-to-session continuity.

github.com/VetCoders/ai-contexters
03

prview

Audit & Quality Gate

Generates durable PR review packs with line-level findings. The merge gate that turns terminal dumps into actual artifacts.

github.com/VetCoders/prview
04

ScreenScribe

Visual Reviewer

Turns narrated screencasts into structured engineering findings. The orchestrator's eye on the real product surface.

github.com/VetCoders/screenscribe
The Method

Craft → Converge → Ship

A founder-grade operating model for shaping, denoising, and releasing software with AI agents.

%% VibeCrafted Pipeline v1.0.4
flowchart LR
    subgraph "Craft"
        scaffold["Scaffold"] --> init["Init"]
        init --> workflow["Workflow"]
        workflow --> followup["Follow-up"]
    end

    followup --> marbles{{"Marbles Loop"}}
    marbles -->|P0/P1/P2 > 0| marbles
    marbles --> dou["DoU"]

    subgraph "Ship"
        dou --> decorate["Decorate"]
        decorate --> hydrate["Hydrate"]
        hydrate --> release(["Release"])
    end

Craft

Scaffold the architecture, init the context, and run the ERi workflow. Force agents to respect the AST and history.

Converge

Systematically reduce entropy through Marbles loops until all P0, P1, and P2 issues are resolved.

Ship

Audit the product surface with DoU, polish with Decorate, and package with Hydrate before final Release.

Skill Suite

16 Specialized Workflows

Hard-coded procedures born from pain. Powered by frontier models and Rust-based structural intelligence.

Phase 1 · Craft

vc-scaffold

Founder-first architecture planning. Maps the landscape and produces a scoped build plan for agents to execute.

architecturescopingMVP
"Scaffold: real-time dashboard" · "Zaplanuj to"
Phase 1 · Craft

vc-init

Bootstrap the agent session. Forces models to index history (AICX), read the AST (Loctree), and verify quality gates.

bootstrapcontextground truth
"Init session" · "Zainicjuj" · "Daj kontekst"
Phase 1 · Craft

vc-workflow

The ERi Pipeline: Examine → Research → Implement. Structured implementation with cumulative context feeding.

ERiloctreeresearch
"Workflow" · "Zbadaj i zaimplementuj" · "ERi"
Frontier Fleet

vc-agents

Spawn external fleet (Codex, Claude, Gemini) in real terminals with isolated context and durable artifacts.

frontierisolatedeval
"Spawn agents" · "Agent fleet" · "Odpal agentów"
Phase 1 · Craft

vc-research

Triple-agent triangulation. Throw all three models at the same problem and synthesize a gap-free research document.

triangulationSoTAtruth
"Research this" · "Zbadaj to" · "Triple research"
Phase 1 · Craft

vc-partner

Executive pairing. Shared brain mode for strategic debugging and architectural triage with delegated fieldwork.

partnerstrategyownership
"Partner mode" · "Idziemy razem" · "You drive"
E2E Delivery

vc-justdo

Autonomous delivery. Takes a mandate, decides, implements, verifies, and packages without ceremony.

autonomousdeliverywow effect
"Just do it" · "Zrób to" · "Dowieź to"
Phase 1 · Craft

vc-followup

The reality check. Post-implementation audit that gives a brutal GO / NO-GO verdict based on quality gates.

auditseverityreadiness
"Follow-up check" · "Czy są jeszcze luki?"
Phase 2 · Converge

vc-marbles

Iterative convergence. Loop until entropy is crushed (P0=0, P1=0, P2=0). Adaptive denoising for code.

diffusionconvergenceentropy
"Marbles" · "Kulki" · "Loop until done"
Phase 1 · Craft

vc-review

PR review pipeline. Generates prview artifacts and squeezes maximum findings with line-level evidence.

reviewprviewfindings
"Review PR" · "Daj findings" · "Run prview"
Phase 1 · Craft

vc-prune

Ruthless cleanup. Defines the runtime cone and cuts dead weight, experiments, and scar tissue without mercy.

prunecleanruntime cone
"Prune repo" · "Strip dead code" · "Wyczyść repo"
Fallback

vc-delegate

Safe native delegation using Claude's Task tool. In-session parallelization for small, bounded tasks.

nativeTask toolsandboxed
"Delegate safely" · "Native agents"
Phase 3 · Ship

vc-dou

Definition of Undone. Audits product surface, install paths, and SEO. Measures the gap to launch.

DoUPlague Scorefunnel
"DoU audit" · "Are we shippable?"
Phase 3 · Ship

vc-decorate

Visual coherence. Detects brand tokens and upgrades weak patterns into a premium interaction language.

smaczkipolishintentional
"Decorate" · "Udekoruj" · "Make it look good"
Phase 3 · Ship

vc-hydrate

Market packaging. Executes the non-code work: marketplace listings, SEO fixes, and onboarding flows.

packageSEOonboarding
"Hydrate" · "Make it shippable" · "Nawodnij"
Final Step

vc-release

Final milestone. Tags, changelogs, registry publishing, and go-to-market mechanics. Ship it to people.

shippublishmarket
"Release" · "Ship to market" · "Wypuść wersję"
Marbles

Denoise Until the Circle Is Full

AI agents are stochastic parrots. Every generation introduces noise. You cannot prompt your way out of it. You iterate.

The Isomorphism

Image diffusion:  noise → denoise × N → image
Code diffusion:   chaos → reduce_entropy × N → product

Step 0: Pure noise (no context, no structure)
Step 1: Init — gross shapes emerge
Step 2: Implement — detail generation
Step N: Converged — DoU < threshold = DoD

There is no fixed loop count. The loop runs until P0=P1=P2=0 — the circle is full. Early loops make large structural corrections; late loops make small refinements.

Interactive Playground

Open the convergence board as its own surface

The board is no longer squeezed into the landing page. The full-viewport playground is now the teaching surface: manual phases, command prompt, and board-first motion.

Enter framework playground

Board-first. Manual. Command-shaped. Built for the 1.3.0 direction.

Convergence Trajectory — loop until the circle is full

Loop 115
Loop 240
Loop 365
Loop 485
Loop 5100

Score: 15 → 40 → 65 → 85 → 100

DoU → DoD
DoU

The Definition of Undone

AI agents have solved the hardest part of software creation: making the thing work. They have not yet solved the second hardest part: making the thing reachable.

The gap is rarely code quality. It is the space between a working system and a product that people can discover, install, trust, and buy.

The Plague Diagnostic:

  • + Tests pass
  • + Architecture is sound
  • + README exists
  • – Nobody can find it from Google
  • – Nobody can install it without a toolchain
  • – Nobody can pay for it

Items 4–6 are the Definition of Undone. Phase 3 forces the system into the market.

Get VibeCrafted

Install the framework. Start the loop.

Bootstrap the control plane, verify the surface, and enter the first founder-grade workflow with the new command deck.

Step 1

Bootstrap the control plane

Stage the framework locally and let the installer walk through the real environment before it touches the system.

curl -fsSLO https://raw.githubusercontent.com/VetCoders/vibecrafted/main/install.sh
bash install.sh

Step 2

Enter through the command deck

The main front door is now vibecrafted. Daily skill surfaces are exposed as direct vc-* commands.

vibecrafted help
vc-init claude

Step 3

Converge the real work

Once context is anchored, drive the loop deliberately instead of improvising prompt-by-prompt.

vc-marbles codex --count 4 --depth 4
vibecrafted doctor
Quick Start FAQ GitHub
References

Ground Truth & Influences

The bibliography below follows the explicit influence list from VIBECRAFT.md.

  1. Morris, K.; Böckeler, B. (2026). Humans and Agents in Software Engineering Loops. Thoughtworks / Martin Fowler.

  2. Gong, L.; Elhoushi, M.; Cheung, A. (2024). AST-T5: Structure-Aware Pretraining for Code Generation.

  3. Fowler, M. (2009). Technical debt and the later debt literature.

  4. VetCoders (2026). The VibeCraft Manifesto.