A humorous yet practical guide to AI-assisted development. DON'T PANIC.
View the Project on GitHub HermeticOrmus/hitchhikers-guide-to-vibe-engineering
“In the beginning the Universe was created. This has made a lot of people very angry and been widely regarded as a bad move.”
The same could be said of AI-assisted coding.
The large, friendly letters on the cover of this Guide say DON’T PANIC for a very good reason.
When you first start vibe coding, you will experience:
Most developers get stuck oscillating between phases 1 and 2 indefinitely. The purpose of this Guide is to help you reach phase 3 and stay there.
When the AI generates something unexpected, your first instinct might be to:
None of these are helpful.
Instead, remember: the AI is a very sophisticated autocomplete. It predicts what tokens should come next based on patterns. It doesn’t “understand” your codebase, your requirements, or the existential weight of your sprint deadline.
Every vibe coder will have a “towel moment”—a situation where everything seems lost, the code is broken, and you’re not sure if the AI is helping or making things worse.
In these moments, remember:
“A towel is about the most massively useful thing an interstellar hitchhiker can have… Any man who can hitch the length and breadth of the galaxy, rough it, slum it, struggle against terrible odds, win through, and still know where his towel is, is clearly a man to be reckoned with.”
Your towel in vibe coding is version control.
git status
git diff
git stash
git checkout .
These four commands will save you more times than you can count.
Don’t ask for an entire application. Ask for one function. Then another. Build incrementally.
The AI will generate code confidently. That confidence means nothing. Read every line before executing.
Write a test. Run it. If it fails, you’ve learned something. If it passes, you’ve verified something.
The more context you give, the more the AI has to hallucinate about. Be specific. Be concise.
Sometimes the AI can’t help. That’s okay. You have a brain. Use it.
When in doubt, the answer is probably 42.
Or more practically: slow down, think, verify, iterate.
Next: The Towel Principle