חוזה עבודה לקובץ CLAUDE.md

1. מה הקובץ עושה

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

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

2. מה נכנס לקובץ

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

3. מה לא נכנס

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

4. שלד להעתקה

# Project Instructions

## What This Project Does
[משפט אחד על המוצר, המשתמש, והבעיה]

## Run Commands
- Dev: [command]
- Typecheck: [command]
- Build: [command]
- Tests: [command]

## Before Editing
- Read [files]
- Check [existing pattern]
- Keep changes inside [scope]

## Do Not Touch Without Approval
- [billing / payments / customers]
- [production config]
- [external send / publish / delete]

## Coding Rules
- Keep changes scoped.
- Reuse existing helpers.
- No secrets in code.
- Report unrelated dirty files without changing them.

## Done Means
- [verification command]
- [browser check if user-facing]
- [known risk reported]
- [files changed listed]

5. בדיקה מהירה

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