GALACTIC GRID

Back to Master Journal IndexVolume II // Entry #07
Volume II: AI Development Workflows & Systems Architecture

The Vibe Coder's Playbook: Writing an "Architectural Bible"

Transitioning from rapid v0 prototyping to Cursor IDE full-stack builds, enforcing system guardrails, and using the Read-Back Protocol.

By Chris, Lead Product & UX Architect (with Scott, Lead Data Engineer)

By Chris, Lead Product & UX Architect (with Scott, Lead Data Engineer)

At the tail end of 2024, when Scott and I began building Galactic Grid, vibe coding was still in its infancy. I came into this project with zero traditional software development experience. I did not know how to construct complex React state trees, write TypeScript interfaces from scratch, or configure API routes. What I had was a clear vision, deep domain passion, and access to artificial intelligence assistants.

In the very early days of prototyping, tools like v0 felt like absolute magic. You could speak an idea into existence, and within seconds, a glowing, interactive visual frontend appeared on screen. v0 was an incredible launchpad for helping us map out our initial UI concepts and visualize how a 3x3 grid terminal would feel.

However, as our application grew and we began integrating real backend database logic, API routes, and complex state management, we hit a natural boundary. v0, while brilliant at rapid frontend scaffolding, began struggling with deep full-stack architecture.

We transitioned our development stack into dedicated AI-powered IDEs, using Cursor on the backend alongside tools like Antigravity, Grok, and Gemini.

That transition brought a whole new realization: AI coding assistants are extraordinarily powerful, but without explicit architectural guardrails, they will interpret your instructions in ways you never intended.

The Misunderstanding Phase: Learning What You Don't Know

When you are learning to code alongside AI, your biggest hurdle is not knowing what you do not know.

In the beginning, I did not experience a single dramatic code catastrophe where an AI wiped out my entire database. Instead, I faced a slow, repetitive friction. I would ask an AI assistant to make a minor UI layout adjustment, and it would misinterpret my intent, rewrite core component states, or struggle with mobile viewport layouts until we abandoned rigid inline styles and switched entirely to a clean CSS and Tailwind process for mobile responsiveness: solving our layout hitches instantly.

I found myself repeatedly typing: "No, that is not what I mean. Undo that. Read what I asked for again."

The AI was not failing because it was unintelligent; it was failing because I had not yet learned how to structure my directives. As I learned the tools and gained clarity on how web applications operate, our iteration speed accelerated dramatically.

I realized that if I wanted AI assistants to act as reliable execution partners, I had to stop prompting on the fly and start building an Architectural Bible: a centralized instruction set that governs every AI interaction across our project.

The Three Non-Negotiable Directives

We established a master skills and instructions file that was passed into our AI development environments. Across every prompt, three foundational rules sat at the very top of the hierarchy:

Rule #1 (The Legal Shield): Never create or execute anything that compromises or weakens our Fair Use defense. Zero proprietary trademarks, zero official logos, and zero external graphic SVGs.

Rule #2 (The Experience Threshold): Create the absolute best user interface and user experience possible, provided it never violates Rule #1.

Rule #3 (Expert Design Guidance): Channel the expertise of the world's leading game designers and UI engineers to keep layouts clean, responsive, and intuitive.

Master System Guardrails (Project Context)
- Theme Architecture: Enforce strict "Sci-Fi Neutral" styling.
Primary palette relies exclusively on Cyan (#5bc0de) and pure High-Contrast White (#FFFFFF) over dark space canvas (#030712).
- Data Provenance: All lore data must validate against public Wookieepedia CC-BY-SA entries.
- UI Layout Constraint: Maintain single-file React component architecture for primary page views to preserve LLM context windows during iterations.
- Legal Safety: Do not suggest, generate, or import trademarked graphics, official film logos, or proprietary font files.

By cementing these rules into our project context files, we eliminated the need to constantly repeat ourselves. The AI tools immediately understood the boundaries of our design language, respecting our cyan-and-white color palette and keeping our legal constraints intact.

The Read-Back Protocol: Forcing AI to Explain Its Plan

In late 2024 and early 2025, before modern AI IDEs featured built-in step-by-step planning modes as a default, we ran into a persistent problem: AI models would read a prompt, make immediate assumptions about what we wanted, and start editing code across multiple files instantly.

If the AI misinterpreted a single sentence in my prompt, I would have to spend twenty minutes unwinding broken code changes.

To solve this, I installed an explicit operational directive into our AI workflow: The Read-Back Protocol.

Before executing any code changes, editing files, or writing new scripts, you must first read back your plan in plain text. Explain exactly which files you intend to modify, why you are making those changes, and wait for my explicit confirmation to proceed.

Communication Protocol
1. Analyze the user request.
2. Formulate an execution plan.
3. OUTPUT THE PLAN FIRST in 3-4 bullet points.
4. STOP and await user confirmation before modifying the codebase.

This single workflow shift changed everything.

Instead of watching an AI execute a flawed interpretation of my prompt, I could read its three-bullet plan in ten seconds. If the plan missed the mark, I could reply, "Adjustment: Keep the current state logic and only modify the Tailwind container padding." Once the AI adjusted its plan and confirmed it understood, I gave the green light. The AI executed the exact code needed on the first try.

Shifting from Overzealous Assistant to Executive Director

Once our Architectural Bible and Read-Back Protocol were fully deployed, my daily role as a vibe coder completely transformed.

I was no longer fighting with an overzealous assistant that kept altering core application logic. I had shifted into the role of an Executive Director. I provided the high-level product vision, game design philosophy, and user experience goals, while the AI tools handled the technical implementation under strict supervision.

Our development workflow settled into a clean, predictable rhythm:

Frontend Prototyping: Scaffolding components using rapid visual tools like v0 to test layout concepts.

Full-Stack Assembly: Bringing frontend components into dedicated AI IDEs (like Cursor) alongside Scott's MongoDB API routes.

Context Preservation: Keeping core page logic centralized in unified single-file components during major feature builds, ensuring the LLM never lost sight of the global application state.

Controlled Execution: Using skill files and plan read-backs to ship clean code commits without breaking existing features.

Key Takeaways for Aspiring Vibe Coders

If you are a non-technical founder, designer, or aspiring developer using AI to build your first web application, mastering AI direction is far more important than memorizing syntax.

Document Your Rules Early: Do not rely on memory or repetitive prompting. Create a content/instructions.md or .cursorrules file on Day 1 containing your non-negotiable legal, visual, and architectural constraints.

Use the Right Tool for the Stage: Rapid frontend generators like v0 are fantastic for initial visual sparks, but be prepared to transition to full-featured AI IDEs like Cursor or Antigravity when wiring up real backend logic.

Enforce a Plan Read-Back: Never let an AI model rewrite code blindly. Require it to explain its execution plan in plain text before touching a single file in your codebase.

Embrace the Director Mindset: Your job as a vibe coder is to guide, evaluate, and refine. When you set clear boundaries and demand clear communication, AI becomes an unbelievable force multiplier for turning ideas into reality.

By establishing an Architectural Bible and holding our AI tools to strict operational standards, Scott and I built a complex, full-stack game engine in quiet hobby hours without prior coding experience.