THE WANTLIST BUILDER LIBRARY · VOL. 01

The vibe coding
compendium.

A field guide to turning an idea into software you understand, can improve and are ready to share.

By Wantlist editorialSources reviewed Editorial approach
01

LEARN BY BUILDING

Your next useful step.

Read in order, or start with the question in front of you.

02

CHOOSE YOUR ENVIRONMENT

A toolkit, with trade-offs.

Start with the kind of work you want to do. Test two tools on the same small task.

10 tools

App builders

Lovable

Prompt → web app

Build a web application from a natural-language description, with editable code and Git sync.

Consider it for
Explore an idea with an integrated app-building workflow.
Check before committing
Check the exported project, database permissions and costs of the services it uses.
A useful first trial

Describe a booking flow, then verify that two users cannot edit each other’s bookings.

App builders

Bolt

Build in the browser

Create and iterate on an application in a browser workspace.

Consider it for
Start a web prototype without setting up a local development environment.
Check before committing
Confirm support for your runtime and the steps needed to run the exported application.
A useful first trial

Create a small tracker, reload a saved record and try its deployed URL.

App builders

Replit Agent

Idea → hosted project

An agent inside Replit that can set up a project, implement changes and work toward deployment.

Consider it for
Keep the initial development environment and build workflow together.
Check before committing
Separate agent usage from hosting and connected-service costs.
A useful first trial

Build one authenticated workflow and repeat it outside the preview session.

App builders

v0

Interface → application

Vercel’s AI building environment for creating interfaces and applications with a live preview.

Consider it for
Explore an interface and develop its behavior in a visual feedback loop.
Check before committing
Check the generated stack, backend integrations and deployment assumptions.
A useful first trial

Build a dashboard from sample data, then replace one panel with a real persisted record.

Coding agents

Cursor

Work inside your repo

An agent that searches a codebase, edits files and runs commands in a coding environment.

Consider it for
Extend an existing project while inspecting the implementation.
Check before committing
Review the diff and test the changed behavior; local checkpoints are separate from Git history.
A useful first trial

Ask it to trace a failing save operation, fix the cause and show the regression check.

Coding agents

Codex

Inspect · edit · run

A coding agent with a CLI for exploring repositories, changing code and running development tools.

Consider it for
Implement a bounded feature or investigate a repository with repeatable verification.
Check before committing
Choose permissions for the task and preserve Git checkpoints before larger changes.
A useful first trial

Ask for a repository map, then implement one feature with explicit acceptance criteria.

Coding agents

Claude Code

Codebase → tested change

An agent that reads code, edits files and runs commands across terminal, IDE, desktop and web surfaces.

Consider it for
Work through a feature or bug spanning several files.
Check before committing
Keep instructions focused and confirm the permissions and environment of the chosen surface.
A useful first trial

Ask it to inspect an upload path and reproduce one failure before editing.

Coding agents

GitHub Copilot

Issue → reviewed change

Copilot’s cloud agent can work on a repository in an ephemeral environment and prepare a pull request.

Consider it for
Delegate a clear repository task into an established GitHub review workflow.
Check before committing
Check repository access, environment setup and plan availability.
A useful first trial

Assign a small issue with a failing example and review the resulting pull request.

Coding agents

Cline

Editor + terminal

An agent that can read and write files, run commands and use a browser from coding workflows.

Consider it for
Work with agent tools while choosing how to access models.
Check before committing
Review action permissions, model-provider billing and what context leaves your machine.
A useful first trial

Use it to make one interface change, then inspect the result in the browser.

Coding agents

Cascade · Devin Desktop

Context-aware editing

Cascade provides code and chat modes, tool use and checkpoints in Devin Desktop.

Consider it for
Explore an editor-based agent workflow with project context.
Check before committing
Windsurf’s Cascade documentation now redirects here; verify the current product and plan.
A useful first trial

Trace a feature across files and review a small implementation change.

Capabilities are summarized from official documentation. Fit and trial suggestions are Wantlist’s editorial judgment, not benchmark rankings. Categories overlap. Check current plans, limits and runtime support before committing.

03

GIVE THE AGENT SOMETHING CONCRETE

Better starting points.

Original templates to adapt to your project. Replace the brackets and keep secrets out.

Turn an idea into a build briefBefore the first implementation.
I am building [product] for [specific user]. Their current workaround is [workaround]. The first useful outcome is [outcome].

Draft a brief with: one user journey, in-scope and out-of-scope behavior, data ownership, failure states and five observable acceptance criteria. List assumptions and unresolved decisions. Do not implement yet.

Implement one complete behaviorWhen you have a repository and a clear next step.
Inspect the existing project and its instructions. Implement [one behavior] using the established stack and patterns.

Acceptance criteria: [inputs and expected results]. Include [failure case]. Preserve unrelated work. Run the relevant checks and report what you tested, what remains unverified and how to try the change.

Find the cause of a bugWhen repeated fixes have stopped helping.
Reproduce this failure: [steps]. Expected: [result]. Actual: [result]. Relevant error, with secrets removed: [error].

Trace the request through the interface, server and storage. State the evidence for the cause before editing. Make a focused fix, then repeat the failing case and the normal path. Report any remaining uncertainty.

Test private-data accessBefore real users store data.
In a test environment, create accounts A and B and one private record owned by A. Check list, direct read, update, delete and file access as B and signed out. Use the actual API as well as the UI.

Expect every unauthorized access to fail. Record the result and affected route for each test. Remove only your test fixtures. Do not use real customer data.

Prepare a portable handoffBefore switching tools or hosting.
Document how to run this application from a fresh checkout. Include exact runtime versions, install/build/start commands, required environment variable names without values, migration order, storage dependencies and authentication callbacks.

Identify platform-specific assumptions. Test the documented process in an isolated environment and report every step you could not verify.

Rehearse a hosted launchBefore inviting your first users.
Review the deployed test version at [URL]. Test this journey: [visitor action → signup → first useful outcome]. Check mobile layout, keyboard use, validation, persistence, account isolation and any confirmation email.

For each claim, report evidence, version, date and limitations. Separate passed, failed and untested checks. Do not charge a payment method or contact real users.

Explore all 18 prompts in the gallery →

04

PLAIN ENGLISH, PLEASE

The words behind the workflow.

Short working definitions, with the practical consequence attached.

20 terms

Vibe coding
Building through natural-language prompts and repeated trials of the generated result. The term does not establish how thoroughly the code was reviewed.
Agentic engineering
Our working term for AI-assisted development with explicit constraints, inspectable changes and evidence that the intended behavior works.
Coding agent
A system that can use tools to inspect a project, change files and run commands toward a coding task.
Context window
The information a model can work with in a request. Relevant files and concise decisions help more than an unfiltered history.
Context engineering
Choosing and maintaining the instructions, source material and tool results an agent needs for the current job.
Acceptance criteria
Observable conditions that decide whether a feature is complete, including what should happen when inputs or permissions are wrong.
Vertical slice
One small behavior implemented through all required layers, such as a form that saves a private record and reloads it correctly.
MCP
Model Context Protocol: a standard for connecting AI applications with external tools and data. A connection still needs appropriate access controls.
Skill
A reusable package of instructions and supporting resources for a recurring agent task. Support and execution rules vary by tool.
Agent harness
The environment around a model: tools, instructions, execution, permissions and feedback that let it carry out work.
Checkpoint
A recoverable state of your work. An agent’s local checkpoint may differ from a Git commit and may not include database contents.
Migration
A versioned change to a database schema or its data. Test the upgrade and recovery process against a representative copy.
Authentication
Establishing who is making a request, for example through a verified session.
Authorization
Deciding whether that identity may perform this action on this particular record or file.
Row-level security
Database policies restricting which rows a role can access. Some privileged PostgreSQL roles bypass these policies.
Idempotency
Making a repeated operation have the same intended effect as one execution, such as accepting a retry without creating a second order.
AI gateway
An intermediary for model requests that can provide shared routing and operational controls. It does not supply the model itself.
Evaluation
A repeatable assessment against defined examples or criteria. For an AI feature, include difficult cases and record failures.
Observability
Logs, metrics and traces that let you investigate what a running system did, how long it took and where it failed.
Portability
The practical ability to move source code, data, files and operating configuration into another supported environment.
05

FOLLOW THE EVIDENCE

Read the originals.

Provider documentation for capabilities; original Wantlist explanations for practice. This edition is a reviewed snapshot, not a live ranking.

We avoid copying third-party guides and do not infer app quality from provider claims. Sources support the associated topic, not a blanket endorsement. Pricing and model leaderboards are intentionally omitted because a useful comparison needs a current workload and billing assumptions.