Good Principles for Vibe Coders

The most dangerous moment in an AI-coding session isn't when the model refuses to help. It's when it says "fixed!" and the thing is subtly broken — and you can't undo it because there's no history to go back to.

This guide is for people building real things with Claude Code, Cursor, ChatGPT, or Replit, who haven't come up through traditional software engineering. You don't need to learn to code to use it. You need the small number of habits that keep your work safe, your secrets off the internet, and your setup reproducible the next time the AI sits down at the keyboard.

Inside you'll find 7 principles covering:

  1. Why version control matters more for you than for developers
  2. The minimum viable Git workflow
  3. Secrets — the one rule that matters
  4. .gitignore — what to keep out of history
  5. Folder structure — one project, one folder
  6. Rules files — how to make the AI remember
  7. What NOT to learn yet

🎗️ How to use this guide


🧭 Git and GitHub — a one-minute primer

Before we get into the habits, two quick definitions, because the rest of this guide uses both words and they're not the same thing.

Git is a program that lives on your computer. It tracks every change you make to a folder, so you can go backwards in time whenever you need to. The name isn't an acronym — Linus Torvalds, who built it for the Linux kernel back in 2005, famously named it after British slang for an unpleasant person, mostly as a joke. You don't need to care about the name. You need to know it's the engine underneath everything that follows.

GitHub is a website. It stores copies of your Git history in the cloud, adds a social layer on top (issues, pull requests, collaboration), and is where most of the open-source code in the world currently lives. It's owned by Microsoft, and it's free for most solo use. Alternatives exist — GitLab, Codeberg, Bitbucket — and for what this guide covers they're interchangeable.

The short version. Git is the version-control tool. GitHub is one of several places to park copies of your Git history so it's not only on your laptop. You use Git locally every day. GitHub is optional but worth it for the off-site backup alone.


✨ The Principles


📚 Further reading

The pieces that informed this guide, ordered roughly easiest → most opinionated:

⚡️ About

Made with ❤️ in Valencia by Jim Christian. For feedback, please reach out to [email protected].

Want the weekly issue of Signal Over Noise where this guide was first teased? Subscribe here.

⚡️ Notion AI for Business

This guide lives in Notion because Notion is where I keep the things I want to share. If you're building a personal knowledge system, running a business, or just want a workspace that handles the messy stuff well — try Notion with my affiliate link and you'll be supporting Signal Over Noise at the same time.