From d37274a31be34bed81e2c1e77f967ccaafc21f71 Mon Sep 17 00:00:00 2001
From: Chaim <chaim@marcus-law.co.il>
Date: Sat, 6 Jun 2026 16:11:41 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=D7=9B=D7=9C=D7=9C=20=D7=A7=D7=A9=D7=99?=
 =?UTF-8?q?=D7=97=20=E2=80=94=20=D7=9B=D7=9C=20=D7=A1=D7=A9=D7=9F=20=D7=A2?=
 =?UTF-8?q?=D7=95=D7=91=D7=93=20=D7=91-worktree=20=D7=9E=D7=91=D7=95=D7=93?=
 =?UTF-8?q?=D7=93=20(=D7=9E=D7=A0=D7=99=D7=A2=D7=AA=20=D7=9E=D7=99=D7=A8?=
 =?UTF-8?q?=D7=95=D7=A5-=D7=A2=D7=A0=D7=A3=20=D7=91=D7=A2=D7=A5=20=D7=9E?=
 =?UTF-8?q?=D7=A9=D7=95=D7=AA=D7=A3)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

כמה סשנים (chaim + סוכני Paperclip) רצים במקביל על אותו עץ-עבודה ~/legal-ai.
עץ אחד = ענף אחד משותף → סשן מחליף branch/משאיר WIP בזמן שאחר עובד → דריסה
ומירוץ-ענף. הכלל: כל עבודת-כתיבה דרך `git worktree add` ייעודי מ-origin/main;
אסור לערוך/לתייק בעץ הראשי כשייתכן שסשן אחר פעיל; ניקוי אחרי מיזוג.

מעלה את [[feedback_shared_worktree_branch_race]] מ"אמת branch לפני commit"
לכלל-בידוד מלא.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index a3a9a4e..49ec951 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -99,6 +99,30 @@
 
 ---
 
+## בידוד-סשנים — worktree מבודד חובה ⚠️
+
+> **כלל קשיח.** בכל רגע נתון רצים **כמה סשנים במקביל** על אותו עץ-עבודה (`~/legal-ai`) — סשנים אינטראקטיביים של chaim **וגם** סוכני Paperclip. עץ-עבודה אחד = ענף-גיט אחד משותף, כך שסשן אחד מחליף branch / משאיר שינויים לא-מתויקים תוך כדי שאחר עובד → **דריסה הדדית ומירוץ-ענף** ([[feedback_shared_worktree_branch_race]]).
+
+**לכן — כל סשן שעומד לכתוב/לשנות קוד או תיעוד חייב לעבוד ב-git worktree מבודד משלו. אסור לערוך/לתייק בעץ-העבודה הראשי `~/legal-ai` כשייתכן שסשן אחר פעיל.**
+
+הפרוטוקול:
+1. **בתחילת עבודת-כתיבה** — צור worktree ייעודי מ-`main` עדכני:
+   ```bash
+   cd ~/legal-ai && git fetch origin
+   git worktree add -b <branch-name> ~/legal-ai-wt-<slug> origin/main
+   cd ~/legal-ai-wt-<slug>     # כל העריכות, ה-commit וה-push מכאן
+   ```
+2. **אמת ענף לפני כל commit** — `git branch --show-current` (גם ב-worktree, הרגל).
+3. **push + PR + merge** כרגיל ([[feedback_always_pr_merge]]) — PR תמיד ל-`main`.
+4. **נקה אחרי מיזוג** — `cd ~/legal-ai && git worktree remove ~/legal-ai-wt-<slug> && git worktree prune && git branch -D <branch-name>`.
+5. **קריאה-בלבד** (חקירה, סריקה, הרצת בדיקות ללא שינוי) — מותר בעץ הראשי; אין צורך ב-worktree.
+6. **אל תיגע** בשינויים לא-מתויקים שאינם שלך בעץ הראשי — הם של סשן אחר. אם העץ הראשי על ענף זר — אל תתייק עליו.
+
+> מוסכמות: location `~/legal-ai-wt-<slug>`, branch לפי הפרוסה (`fix/...`, `feat/...`, `docs/...`). ה-worktree חולק את אותו `.git` והיסטוריה — בידוד-קבצים בלבד, לא בידוד-repo. הקם מ-`origin/main` (לא מהענף שבעץ הראשי) כדי לקבל בסיס נקי ועדכני.
+> חריג: סוכני Paperclip שמופעלים עם `cwd` מוכתב ע"י ה-runtime — שם הבידוד נאכף ברמת ה-runtime/issue, לא ידנית.
+
+---
+
 ## שרת Nautilus (158.178.131.193)
 
 | שירות | תפקיד | כתובת |
-- 
2.49.1