טריק שיום אחד פשוט שעוצר ריקבון קוד
הפסיקו לקרוא למחלקות שלכם Service, Manager, או Handler.
השמות האלו מעורפלים. הם משמשים כאישור לעיצוב גרוע.
אם תקראו למחלקה UserService, תוכלו לשים בתוכה כל דבר שקשור למשתמש. אתם עשויים להוסיף איפוס סיסמאות, הקצאת תפקידים וחישוב הנחות. כל אלו כוללים משתמש, ולכן השם מרגיש נכון.
אבל למשימות האלו יש כללים ותלויות שונים. UserService בודד הופך לבלגן ענק.
נסו במקום זאת שיום המבוסס על פעולה (agentive naming). השתמשו בשמות שמתארים פעולה ספציפית:
• UserRegistrar • PasswordResetter • RoleAssigner • DiscountCalculator
השמות האלו יוצרים חיכוך. אם PasswordResetter זקוק פתאום לכלי להפקת חשבוניות, הטעות תהיה ברורה. השם הופך את העיצוב הגרוע לקשה להתעלמות.
שם מעורפל כמו UserService הוא כמו הטיפוס "any" בתכנות. הוא מקבל הכל. שמות מדויקים יוצרים גבולות.
זה חשוב יותר עכשיו בגלל ה-AI.
סוכני קוד מבוססי AI מסתכלים על הקוד הקיים שלכם כדי להחליט היכן להוסיף לוגיקה חדשה. אם תתנו ל-AI את ה-UserService, הוא יוסיף תכונות חדשות לאותה מחלקה מבולגנת. הוא יעשה זאת מהר מאוד.
אם תתנו ל-AI את ה-PasswordResetter, הוא יישאר בתוך הגבול הספציפי הזה.
בסיס הקוד שלכם הוא Prompt עבור ה-AI. שמות מעורפלים מלמדים עיצוב מעורפל.
שמות לא יוצרים ארכיטקטורה טובה. הם הופכים ארכיטקטורה גרועה לנראית לעין.
תנו לכל אחריות שם מדויק מספיק, כך שקוד לא קשור ייראה לא אמין.
Source: https://dev.to/caeus/one-simple-naming-trick-that-keeps-vibe-coded-code-from-rotting-5hf5
Optional learning community: https://t.me/GyaanSetuAi