Skip to content

isumitsoni/vibe-coding-playbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Vibe Coding Playbook

A PM-first playbook for choosing the right AI build tool by job-to-be-done.

Not tool tutorials. Cross-tool decision frameworks for PMs and founders making real execution tradeoffs.

Maintained by Sumit Soni · LinkedIn


Who this is for

  • Product Managers who ship, not just spec — you own the build decisions, not just the roadmap
  • Non-technical founders who want to move from prototype to production without a full engineering team
  • NOT engineers or ML practitioners (there are better resources for you)

What this covers

Tool-selection matrix

When to use Claude Code vs Codex vs Gemini CLI vs v0 vs Bolt — by product stage and job-to-be-done.

Tool Best for Avoid when
Claude Code Structured SDLC, repo-level context, production builds Quick throwaway prototypes
OpenAI Codex Agentic experiments, broad code exploration Precision edits to existing codebases
Gemini CLI Large-context analysis, research, multimodal Speed-critical coding tasks
v0.dev UI-first prototyping, React components Backend logic or data pipelines
Bolt.new Full-stack browser prototyping, fast demos Production-hardened deployments

Core Playbooks

  1. Discovery to prototype — PRD → clickable prototype in under 2 hours using v0 + Claude Code
  2. Feedback to fixes — User feedback → prioritized fixes shipped in 1 day using Codex + triage templates
  3. Codebase audit to decision memo — Large-codebase audit → PM decision memo using Gemini CLI
  4. Prototype to production — Prototype → production-hardening checklist using Claude Code + promptfoo eval gates
  5. Cost spike to model routing — Cost spike diagnosis → model-routing redesign using telemetry + tiered fallback strategy
  6. Debugging to root cause — Claude-generated code breaks; diagnose and fix it without guessing
  7. Spec to sprint — Feature spec to sprint-ready tasks with acceptance criteria an engineer can act on

Quick-start paths (coming soon)

  • Founder path — no engineering team, shipping first AI product
  • PM in startup path — small team, fast iteration cycles
  • PM in larger org path — stakeholder management, eval discipline, rollback plans

What this is NOT


Why this is different

Most vibe-coding repos optimize for engineers. They skip:

  • PM artifacts — problem framing, acceptance criteria, launch readiness
  • Tool-choice heuristics by product phase
  • Evaluation discipline for PM-owned quality decisions
  • Stakeholder narrative layer — how PMs communicate risks and tradeoffs

This repo fills those gaps.


Contributing

PRs welcome if you bring workflow evidence, not just opinions.

Requirements:

  • Include a real scenario with context (what stage, what team size, what constraints)
  • Include failure mode notes — what breaks and how you caught it
  • No generic "use AI to move faster" advice

Related repos


Star this repo if you find it useful. Playbook content shipping weekly.

About

5 practical playbooks for PMs and founders who build with AI coding tools — from discovery to production. Covers Claude Code, Codex, Cursor, and more.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors