אפיון לפני קוד

שלושת קבצי האפיון הם תבניות reference לבניית כל פרויקט תוכנה עם Claude Code, בשיטת "context לפני code". הם מתאימים לכל טכנולוגיה: web, מובייל, backend, כל שפה.

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

הקבצים

• 01-project-overview.md: התמונה הגדולה. מה המוצר, למי הוא מיועד, הזרימות, הארכיטקטורה, החוקים.
• 02-backend-spec.md: צד השרת. מודל הנתונים, כל endpoint, לוגיקה עסקית, ולידציה, הרשאות.
• 03-frontend-spec.md: צד הלקוח. כל מסך, שפת העיצוב, קומפוננטות, מצבי UI.

בנו אותם בסדר הזה: ה-overview נותן context לשני האחרים.

הזרימה, שלב אחר שלב

שלב 1: כתבו תיאור קצר של הפרויקט

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

אפליקציה למעקב הרגלים. משתמשים יוצרים הרגלים, מסמנים אותם כל יום, ורואים רצפים. טכנולוגיה: React ו-Vite ל-frontend, Node ו-Express ל-backend, PostgreSQL.

שלב 2: ייצרו את ה-overview

ב-Claude Code, תנו לו את 01-project-overview.md כ-reference יחד עם התיאור שלכם, ובקשו:

השתמש בקובץ 01-project-overview.md המצורף כ-reference מבני, וכתוב project-overview.md לפרויקט שלי שתיארתי למעלה. עקוב אחרי המבנה והכותרות שלו בדיוק, אבל מלא כל סעיף בפרטים האמיתיים של הפרויקט שלי. לכל דבר שלא החלטתי, הוסף אותו תחת Open questions במקום להניח.

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

שלב 3: ייצרו את אפיון ה-backend

תנו ל-Claude Code גם את project-overview.md המוכן שלכם וגם את 02-backend-spec.md כ-reference:

השתמש ב-02-backend-spec.md כ-reference מבני וב-project-overview.md שלי כ-context, וכתוב backend-spec.md לפרויקט שלי. הגדר כל entity וכל endpoint במלואם. התחייב לטכנולוגיה שלי. שים כל דבר שלא הוחלט תחת Open questions.

שלב 4: ייצרו את אפיון ה-frontend

תנו ל-Claude Code את project-overview.md, את backend-spec.md ואת 03-frontend-spec.md:

השתמש ב-03-frontend-spec.md כ-reference מבני, וב-overview וב-backend spec שלי כ-context, וכתוב frontend-spec.md לפרויקט שלי. פרט כל מסך עם מקור הנתונים שלו, הפעולות, וכל מצבי ה-UI. התחייב לשפת העיצוב שלי.

שלב 5: בנו מתוך האפיונים

עכשיו יש לכם שלושה קבצי אפיון אמיתיים שמתארים את כל הפרויקט. הפנו את Claude Code אליהם ובנו בחלקים:

קרא את project-overview.md, backend-spec.md ו-frontend-spec.md. בנה קודם את מודל הנתונים ו-endpoints ה-CRUD של ה-backend, לפי האפיונים בדיוק. אל תעצור לשאלות: קבל החלטות סבירות והמשך.

בנו שכבה אחת בכל פעם: מודל נתונים, אחר כך endpoints, אחר כך לוגיקה עסקית, אחר כך שלד frontend, אחר כך מסכים. לכל קובץ אפיון יש סדר בנייה מומלץ בסוף.

למה זה עובד: השיטה

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

האפיונים גם הופכים לתיעוד חי: כשתוסיפו פיצ'ר בעתיד, תעדכנו את האפיון, תחזירו אותו ל-Claude Code, והוא יישאר מיושר עם כל המערכת.

טיפים

• שמרו את האפיונים ב-repo (למשל בתיקייה docs/ או specs/). הם חלק מהפרויקט.
• פיצ'ר אחד בכל פעם. אל תבקשו את כל האפליקציה בפרומפט אחד: בנו בסדר שכל אפיון מציע.
• ענו על השאלות הפתוחות. כל Open question שה-AI מעלה היא החלטה שרק אתם יכולים לקבל. לפתור אותן: שם הערך האמיתי.
• עדכנו את האפיונים תוך כדי. כשמשהו משתנה, שנו קודם את האפיון, אחר כך את הקוד.
• השתמשו ב-auto-accept mode ב-Claude Code לריצות בנייה ארוכות, כדי שלא יעצור בכל שלב. אבל הריצו במקום בטוח או מבודד, ושמרו checkpoint ב-git כדי שתוכלו לחזור אחורה.