𝗙𝗿𝗼𝗺 𝗩𝟭.𝟬 𝘁𝗼 𝗩𝟮.𝟬: 𝗔 𝗥𝗲𝘁𝗵𝗶𝗻𝗸 𝗼𝗳 𝘁𝗵𝗲 𝗩𝗶𝗯𝗲 𝗖𝗼𝗱𝗶𝗻𝗴 𝗣𝗶𝗽𝗲𝗹𝗶𝗻𝗲
Hivi karibuni nilirekebisha kosa dogo la uandishi (typo) katika mradi wangu wa chanzo huru (open source), vibe-coding-universal. Nilibadilisha lebo kutoka v2.0 (zamani) kwenda v1.0 (zamani).
Mabadiliko haya madogo yalifichua tatizo kubwa. Hata mimi sikujua jina la toleo langu mwenyewe. Ikiwa mimi nimechanganyikiwa, watumiaji wako pia watapotea.
Toleo langu la kwanza lilikuwa rahisi. Lilitumia maswali 7 kusaidia AI kuelewa mahitaji. Lilitoa faili moja ya mwongozo kwa ajili ya zana kama Claude Code au Cursor. Lilifanya kazi, lakini lilikuwa na kasoro:
- AI ililazimika kukisia rangi, fonti, na nafasi (spacing).
- Muundo (design) na kazi zilikuwa kwenye faili moja tu.
- AI ilitegemea kumbukumbu yake badala ya mifumo halisi ya muundo (design systems).
Toleo la 2.0 si mabadiliko tu (update). Ni njia mpya ya kufanya kazi.
V1.0 dhidi ya V2.0:
V1.0:
- Mizunguko 7 ya maswali ya mahitaji.
- Hakuna sheria za muundo (design rules).
- Faili moja tu ya mwongozo.
- Hakuna marejeleo ya nje.
V2.0:
- Mizunguko 7 ya mahitaji + mizunguko 7 ya mapendeleo ya muundo (design preferences).
- DESIGN_SPEC.md kamili yenye rangi, fonti, na sheria za mpangilio (layout rules).
- Kifurushi kamili cha Build Spec (PRD, Design, Architecture, Tasks).
- Ufikiaji wa mifumo ya muundo ya chapa 71 kama Stripe, Linear, na Apple.
- Token za CSS sahihi kwa ajili ya AI kutumia.
Watu wengi huandika maelekezo (prompts) mabaya ya AI. Huuliza, "Unapenda mtindo gani wa muundo?" Hii ni pana mno.
Badala yake, V2.0 hutumia chaguzi nyingi (multiple choice). Kila mzunguko huuliza swali moja lenye chaguzi 4 hadi 6.
- Mzunguko 1: Aina ya mradi (SaaS, Dashboard, AI tool, n.k.).
- Mzunguko 2: Marejeleo ya picha (Stripe, Apple, Vercel, n.k.).
- Mzunguko 3: Hali ya rangi (Cool, Warm, Neutral).
Baada ya mizunguko 7, mfumo unachukua design tokens kutoka kwenye mifumo ya chapa 71. Unatoa orodha ya CSS variables. Hii inampa AI maelekezo sahihi.
Kosa la toleo lilitokea kwa sababu pengo kati ya V1.0 na V2.0 lilikuwa kubwa mno. Niliona zote mbili kama toleo la "sasa".
Ikiwa mradi wako unapitia mabadiliko makubwa, tumia lebo za toleo zilizo wazi. Watumiaji hawataitumia dakika 5 kusoma muundo wako. Wanakupeka sekunde 10 tu.
Kabla ya mabadiliko yako yanayofuata, jiulize:
Je, mtumiaji mpya anaweza kuelewa ulinganisho huu ndani ya sekunde 3?
Ikiwa jibu ni hapana, rekebisha maandishi yako kabla ya kurekebisha kodi yako.
Jumuia ya kujifunza ya hiari: https://t.me/GyaanSetuAi