𝗙𝗿𝗼𝗺 𝗩𝟭.𝟬 𝘁𝗼 𝗩𝟮.𝟬: 𝗔 𝗥𝗲𝘁𝗵𝗶𝗻𝗸 𝗼𝗳 𝘁𝗵𝗲 𝗩𝗶𝗯𝗲 𝗖𝗼𝗱𝗶𝗻𝗴 𝗣𝗶𝗽𝗲𝗹𝗶𝗻𝗲
Onlangs heb ik een kleine typefout hersteld in mijn open-source project, vibe-coding-universal. Ik heb een label veranderd van v2.0 (oud) naar v1.0 (oud).
Deze kleine wijziging legde een groot probleem bloot. Zelf wist ik zelfs de naam van mijn eigen versie niet. Als ik in de war ben, zullen je gebruikers dat ook zijn.
Mijn eerste versie was simpel. Het gebruikte 7 vragen om AI te helpen bij het begrijpen van de vereisten. Het produceerde één gidsbestand voor tools zoals Claude Code of Cursor. Het werkte, maar het had gebreken:
- AI moest kleuren, lettertypen en spatiëring raden.
- Design en taken stonden in één enkel bestand.
- AI vertrouwde op het eigen geheugen in plaats van op echte designsystemen.
Versie 2.0 is niet zomaar een update. Het is een nieuwe manier van werken.
V1.0 vs V2.0:
V1.0:
- 7 rondes met vragen over de vereisten.
- Geen designregels.
- Eén enkel gidsbestand.
- Geen externe referenties.
V2.0:
- 7 rondes met vereisten + 7 rondes met designvoorkeuren.
- Volledige DESIGN_SPEC.md met kleuren, lettertypen en lay-outregels.
- Een compleet Build Spec-pakket (PRD, Design, Architectuur, Taken).
- Toegang tot 71 brand designsystemen zoals Stripe, Linear en Apple.
- Precieze CSS-tokens voor AI om te gebruiken.
De meeste mensen schrijven slechte AI-prompts. Ze vragen: "Welke designstijl vind je leuk?" Dit is te breed.
V2.0 gebruikt in plaats daarvan multiple-choice. Elke ronde stelt één vraag met 4 tot 6 opties.
- Ronde 1: Projecttype (SaaS, Dashboard, AI-tool, etc.).
- Ronde 2: Visuele referentie (Stripe, Apple, Vercel, etc.).
- Ronde 3: Kleurstemming (Koel, Warm, Neutraal).
Na 7 rondes haalt het systeem design tokens op uit 71 brand systemen. Het produceert een lijst met CSS-variabelen. Dit geeft de AI exacte instructies.
De versiefout ontstond omdat de kloof tussen V1.0 en V2.0 te groot was. Ik zag ze allebei als de "huidige" versie.
Als je project een enorme verschuiving ondergaat, gebruik dan duidelijke versie-labels. Gebruikers zullen geen 5 minuten besteden aan het bestuderen van je structuur. Ze geven je 10 seconden.
Stel jezelf voor je volgende update de vraag:
Kan een nieuwe gebruiker deze vergelijking in 3 seconden begrijpen?
Als het antwoord nee is, verbeter dan je tekst voordat je je code verbetert.
Optionele leercommunity: https://t.me/GyaanSetuAi