System Architecture for Vibe Coders: A Senior Engineer's Guide

A senior software engineer with a decade of experience posted on r/ClaudeAI about how they would approach learning to build apps using Claude Code if starting from scratch today. Their advice: don't start with code. Start at the highest level — system architecture.

The Four Components

The post breaks every application into four layers:

• Front end — what the user sees (website, mobile app, etc.)
• Back end — the main logic and rules of the app
• Database — where the data lives
• The plumbing — how everything connects and stays standing

The author focuses on the plumbing because AI agents like Claude Code can easily scaffold frontend, backend, and database, but they'll skip the plumbing unless you explicitly ask for it.

The Plumbing: Four Questions You Must Answer

1. How does everything talk to each other?

Your frontend, backend, and database are separate pieces that pass messages. For most applications this is done via APIs — the set of doors your frontend uses to ask the backend for things (e.g., "give me this user's orders"). Other methods exist, but APIs are what you should focus on first.

2. Where does it live, and how does it get online?

Getting your app from your laptop to the internet requires:

• Hosting — where your app actually runs so the world can reach it (servers).
• Domains & DNS — your custom address (yourapp.com) and how it points to your servers.
• Deployment — the pipeline that takes your code and safely publishes it for users to see.
• Environment variables & secrets — where you stash passwords and API keys so they're not sitting in your code. People get burned by this constantly.

3. Who's allowed in, and is it safe?

This is the part the author begs you not to skip. Vibe coding makes it dangerously easy to ship something insecure without realizing it. The post hints at existing ways to handle this (not from scratch) — presumably auth frameworks, OAuth, JWT, or managed identity providers — but the original post only mentions that these solutions exist.

Key Takeaway

The post emphasizes that knowing these plumbing concepts by name is what separates a weekend toy from something real people can trust with their data and money. If you can answer the four questions above for your app, you're already ahead of most vibe coders shipping today.