𝗙𝗿𝗼𝗺 𝗩𝟭.𝟬 𝘁𝗼 𝗩𝟮.𝟬: 𝗔 𝗥𝗲𝘁𝗵𝗶𝗻𝗸 𝗼𝗳 𝘁𝗵𝗲 𝗩𝗶𝗯𝗲 𝗖𝗼𝗱𝗶𝗻𝗴 𝗣𝗶𝗽𝗲𝗹𝗶𝗻𝗲
Niedawno poprawiłem małą literówkę w moim projekcie open source, vibe-coding-universal. Zmieniłem etykietę z v2.0 (stara) na v1.0 (stara).
Ta mała zmiana ujawniła duży problem. Nawet ja nie znałem nazwy własnej swojej wersji. Jeśli ja czuję się zagubiony, Twoi użytkownicy również będą.
Moja pierwsza wersja była prosta. Wykorzystywała 7 pytań, aby pomóc AI zrozumieć wymagania. Generowała jeden plik przewodnika dla narzędzi takich jak Claude Code czy Cursor. Działało to, ale miało wady:
- AI musiało zgadywać kolory, czcionki i odstępy.
- Design i zadania znajdowały się w jednym pliku.
- AI polegało na własnej pamięci zamiast na rzeczywistych systemach projektowych.
Wersja 2.0 to nie tylko aktualizacja. To nowy sposób pracy.
V1.0 vs V2.0:
V1.0:
- 7 rund pytań o wymagania.
- Brak zasad projektowania.
- Jeden plik przewodnika.
- Brak zewnętrznych odniesień.
V2.0:
- 7 rund wymagań + 7 rund preferencji projektowych.
- Pełny plik DESIGN_SPEC.md z kolorami, czcionkami i zasadami układu.
- Kompletny pakiet Build Spec (PRD, Design, Architektura, Zadania).
- Dostęp do 71 systemów projektowych marek takich jak Stripe, Linear i Apple.
- Precyzyjne tokeny CSS do wykorzystania przez AI.
Większość ludzi pisze złe prompty dla AI. Pytają: „Jaki styl projektowania lubisz?”. To zbyt ogólne.
V2.0 zamiast tego wykorzystuje wielokrotny wybór. Każda runda zawiera jedno pytanie z 4 do 6 opcjami.
- Runda 1: Typ projektu (SaaS, Dashboard, narzędzie AI itp.).
- Runda 2: Referencje wizualne (Stripe, Apple, Vercel itp.).
- Runda 3: Nastrój kolorystyczny (Chłodny, Ciepły, Neutralny).
Po 7 rundach system pobiera tokeny projektowe z 71 systemów marek. Generuje listę zmiennych CSS. Daje to AI dokładne instrukcje.
Błąd wersji wystąpił, ponieważ różnica między V1.0 a V2.0 była zbyt duża. Obie postrzegałem jako wersję „bieżącą”.
Jeśli Twój projekt przechodzi ogromną zmianę, używaj jasnych etykiet wersji. Użytkownicy nie poświęcą 5 minut na analizowanie Twojej struktury. Dają Ci tylko 10 sekund.
Przed kolejną aktualizacją zadaj sobie pytanie:
Czy nowy użytkownik zrozumie to porównanie w 3 sekundy?
Jeśli odpowiedź brzmi „nie”, napraw tekst, zanim naprawisz kod.
Opcjonalna społeczność edukacyjna: https://t.me/GyaanSetuAi