הנחיות: לכתוב מפרט, לא לחש

מבנה שעובד

מה התפקיד ומה המטרה; מה הקלט ומאיפה; כללי החלטה מפורשים כולל מה לעשות כשחסר מידע; מבנה הפלט המדויק; ושתיים־שלוש דוגמאות שמדגימות בדיוק את מקרי הגבול.

דוגמאות עדיפות על תארים. "קצר ועובדתי" מעורפל; דוגמה של פלט רצוי אינה.

מה משפר בפועל

לבקש פלט במבנה קבוע ולאמת אותו בקוד. לתת למודל דרך לומר "אין לי מספיק מידע" — בלעדיה הוא ימציא. ולפרק משימה מורכבת לשני שלבים במקום להעמיס הכול על פנייה אחת.

היגיינה

גרסה מסומנת לכל הנחיה, מזהה שנרשם בכל קריאה, והרצה של סט ההערכה לפני שינוי בפרודקשן. הנחיה שנערכת ידנית בשרת היא לוגיקה עסקית בלי בקרת גרסאות.