LESSONS.md - יומן החלטות וכאבים
מה זה עושה: מתעד החלטות ארכיטקטוניות, באגים שחזרו, ומלכודות שהקוד למד בדרך הקשה. הקובץ שמונע מ-Claude Code לחזור על אותן טעויות. משך: 10-20 דקות.
הפרומפט
# יצירת LESSONS.md
צור LESSONS.md - יומן החלטות וכאבים. למה עשינו ככה,
ולמה לא לחזור על טעויות.
## איסוף מידע
### Git
git log --oneline -100
git log --grep="fix" --grep="bug" --grep="regression" -i --oneline -50
git log --grep="revert" -i --oneline -20
### דוקומנטציה
- CLAUDE.md - "iron rules"?
- CHANGELOG.md - regressions
- lessons-learned/, post-mortems/, decisions/, adr/
### בקוד
grep -rn "TODO\|FIXME\|HACK\|⚠️\|WARNING\|DO NOT\|IMPORTANT"
grep -rn "regression\|broke\|fixed\|workaround" --include="*.md"
## מבנה הקובץ
🔴 כללי ברזל - אסור לשבור
🟡 החלטות ארכיטקטוניות
🟠 Regressions - באגים שחזרו
⚠️ מלכודות נפוצות
🔧 חלקים שבירים בקוד (3-5 הכי קריטיים)
📚 לקחים חוצי-דומיינים
לכל פריט: מה + למה + מה קרה כשנשבר
## כללים
✅ iron rules מ-CLAUDE.md
✅ באגים שתוקנו ביותר מ-commit אחד
✅ regressions מתועדים
❌ typos, סטיילינג, dependencies רגילים
❌ ניחושים
אל תמציא לקחים. אין ראיות = אל תכתוב.
## אחרי שסיימת
1. כמה לקחים בכל קטגוריה
2. דפוסים? ("5 מתוך 7 regressions ב-state")
3. פרויקט בן פחות משבועיים? - תגיד במפורש
4. סקציה ריקה - מחק
5. רק LESSONS.mdמתי להשתמש
- ✅ כן — בפרויקט שיש בו היסטוריית git משמעותית (חודש+)
- ✅ כן — אחרי באג חמור או regression שחזר
- ✅ כן — לפני שמצטרף מפתח חדש לפרויקט עם היסטוריה
- ❌ לא — בפרויקט בן פחות משבועיים (אין מספיק ראיות)
פלט מצופה
קובץ LESSONS.md בשורש הפרויקט עם 6 קטגוריות (🔴 🟡 🟠 ⚠️ 🔧 📚). כל לקח: מה + למה + מה קרה כשנשבר. סקציה ריקה — נמחקת.
→ קשור ל: vibeview, codeatlas