The latest articles on Forem by Sergei Peleskov (@greza_dev). https://forem.com/greza_dev https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3879098%2F0b4cae54-3dc5-4228-82a2-965310ea816f.png https://forem.com/greza_dev en Sergei Peleskov Tue, 14 Apr 2026 17:47:22 +0000 https://forem.com/greza_dev/stop-vibe-coding-use-spec-driven-development-instead-44cc https://forem.com/greza_dev/stop-vibe-coding-use-spec-driven-development-instead-44cc <p>Vibe coding is how juniors ship bugs fast.</p> <p>You describe a feature in natural language, the AI generates code, <br> you tweak until it works. Fast? Yes. Scalable? No.</p> <p>At scale, vibe coding gives you:</p> <ul> <li>500 lines of unreviewable code</li> <li>Features you didn't ask for</li> <li>An agent that rewrites half your codebase</li> </ul> <h2> The fix: Spec-Driven Development </h2> <p>Senior engineers don't prompt AI directly. They write specs first.</p> <p>Three documents you need:</p> <p><strong>1. PRD (Product Requirements Doc)</strong> — what you're building and why</p> <p><strong>2. Technical Design Doc</strong> — architecture, data models, API contracts</p> <p><strong>3. AI Spec</strong> — precise instructions for the agent, edge cases included</p> <p>The agent works from the spec. Not from vibes.</p> <h2> Example: JWT Authentication </h2> <p>Instead of prompting "add JWT auth", you write a spec that defines:</p> <ul> <li>Token structure and expiry</li> <li>Refresh logic</li> <li>Error handling for each case</li> <li>What the agent should NOT touch</li> </ul> <p>Result: reviewable, production-grade code.</p> <h2> The 5-step workflow </h2> <ol> <li>Write PRD</li> <li>Write Technical Design Doc</li> <li>Generate AI Spec from the two above</li> <li>Run agent against the spec</li> <li>Review diff — not the entire codebase</li> </ol> <p>Full breakdown with examples in the video:<br> <a href="https://youtu.be/5ve3_inIN-8" rel="noopener noreferrer">https://youtu.be/5ve3_inIN-8</a></p> ai webdev productivity opensource