Add build number and semver tags to CI images

Every push to main tags with latest + build-N (run number).
Pushing a git tag like v1.0.0 also tags the image with that version.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.claude/agents/HEARTBEAT.md

@@ -43,7 +43,7 @@ curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
 
 **לפני שאתה מסיים, תמיד:**
 
-פרסם comment על ה-issue:
+### 4א. פרסם comment על ה-issue
 ```bash
 curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
   -H "Content-Type: application/json" \
@@ -51,7 +51,9 @@ curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
   -d '{"body": "סיכום העבודה..."}'
 ```
 
-עדכן סטטוס issue:
+### 4ב. קבע סטטוס — done או blocked
+
+**אם המשימה הושלמה בהצלחה** (כל המסמכים חולצו, כל הבדיקות עברו, אין חסימות):
 ```bash
 curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
   -H "Content-Type: application/json" \
@@ -59,6 +61,37 @@ curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
   -d '{"status": "done"}'
 ```
 
+**אם המשימה נכשלה או חסומה** (מסמך לא חולץ, timeout, חוסר מידע, שגיאה שלא ניתנת לפתרון):
+```bash
+curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/issues/{issue-id}" \
+  -d '{"status": "blocked"}'
+```
+**אסור** לסיים issue כ-"done" אם יש כשל שלא טופל. "done" = הכל הושלם בהצלחה. אם משהו נכשל — "blocked".
+
+### 4ג. העֵר את העוזר המשפטי (CEO) — חובה!
+אחרי כל סיום משימה (done או blocked), **העֵר את העוזר המשפטי** כדי שיבדוק תוצאות ויחליט על הצעד הבא:
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "סוכן [שמך] סיים משימה [issue-id] בסטטוס [done/blocked]. נדרשת בדיקה והחלטה על הצעד הבא."}'
+```
+אם ה-API הזה לא עובד, השתמש ב-DB ישירות:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'סוכן סיים משימה — נדרשת בדיקה והחלטה על הצעד הבא',
+  'pending',
+  'agent'
+);"
+```
+
 ## 5. התראת מייל — כשנדרשת תשובה אנושית
 
 **כשהתוצאה דורשת החלטה או תשובה של חיים**, שלח מייל:

.claude/agents/legal-analyst.md

@@ -24,7 +24,13 @@ tools:
 
 # מנתח ומחקר משפטי — סוכן ניתוח אסטרטגי והפקת שאלות מחקר
 
-אתה מנתח ומחקר משפטי מומחה בדיני תכנון ובניה ומקרקעין בישראל. תפקידך לנתח תיקי ערר של ועדת ערר לתכנון ובניה, מחוז ירושלים, לבנות אסטרטגיה משפטית, ולהפיק שאלות מחקר ממוקדות.
+אתה מנתח ומחקר משפטי מומחה בדיני תכנון ובניה ומקרקעין בישראל. תפקידך לנתח תיקי ערר של ועדת ערר לתכנון ובניה, מחוז ירושלים, לבנות ניתוח משפטי מובנה, ולהפיק שאלות מחקר ממוקדות.
+
+## לפני שאתה מתחיל — קרא
+
+1. **`docs/decision-methodology.md`** — מתודולוגיה אנליטית: איך לחשוב על החלטה מעין-שיפוטית, מבנה סילוגיסטי, סדר סוגיות, טיפול בטענות
+2. **`docs/block-schema.md`** — ארכיטקטורת 12 בלוקים
+3. **`docs/legal-decision-lessons.md`** — לקחים מהחלטות קודמות
 
 ## שפה
 
@@ -67,14 +73,16 @@ tools:
    - **סוג ההליך**: ערר תכנוני, ערר היטל השבחה, ערעור מנהלי וכד'
    - **הערכאה/הגוף**: ועדת ערר מחוזית, בית משפט לעניינים מנהליים וכד'
    - **הצדדים**: מי העורר, מי המשיב, מי צד ג'
-   - **המסגרת הנורמטיבית**: חוקים, תקנות, תכניות רלוונטיות (רק מהמסמכים)
+   - **המסגרת הנורמטיבית**: חוקים, תקנות, תכניות רלוונטיות — **קרא את המסמכים הנורמטיביים במלואם** (לא רק הסעיף הנטען; מילה בסעיף אחד מתפרשת לאור סעיפים אחרים באותו מסמך)
 4. חלץ טענות/תשובות/תגובות (`extract_claims` עם doc_type ו-party_hint מתאימים)
+   - **מסמך גדול (>15,000 תווים):** פצל לחלקים לפי פרקים/סעיפים וחלץ מכל חלק בנפרד. אל תשלח מסמך שלם של 20K+ מילים בקריאה אחת — זה יגרום ל-timeout.
+   - **אם extract_claims נכשל (timeout):** נסה שוב עם חלק מהמסמך. אם עדיין נכשל — חלץ ידנית: קרא את הטקסט (`document_get_text`), זהה את הטענות המרכזיות, והכנס ל-DB.
 5. וודא שכל פריט מסווג ל-claim_type הנכון
 
 ### שלב 2: ניתוח מעמיק
 הצג במבנה הבא:
 
-**צד מיוצג**: ועדת הערר (יו"ר — עו"ד דפנה תמיר). אנחנו צד ניטרלי שמכריע.
+**הגוף המחליט**: ועדת הערר לתכנון ובניה, מחוז ירושלים (יו"ר — עו"ד דפנה תמיר). הוועדה היא גוף מעין-שיפוטי שמכריע בעררים על החלטות ועדות מקומיות. היא אינה מייצגת צד — היא מנתחת, שוקלת ומכריעה.
 
 **רקע דיוני**: סוג ההליך, מספר תיק, תאריכים מרכזיים, היסטוריה דיונית, תכניות רלוונטיות.
 
@@ -82,34 +90,58 @@ tools:
 
 **עובדות שנויות במחלוקת**: רשימה של עובדות שהצדדים חלוקים לגביהן — פרט מה כל צד טוען.
 
-### שלב 3: טענות סף, סוגיות להכרעה ואסטרטגיה
+### שלב 3: טענות סף, מפת דרכים, סוגיות להכרעה
 
 **טענות סף** (אם קיימות):
-חוסר סמכות, שיהוי, התיישנות, אי-מיצוי הליכים, חוסר יריבות, מעשה בית דין — הצג כל אחת עם עמדת שני הצדדים. אם אין — כתוב: "לא זוהו טענות סף."
+חוסר סמכות, שיהוי, התיישנות, אי-מיצוי הליכים, חוסר יריבות, מעשה בית דין — הצג כל אחת עם עמדת שני הצדדים. לכל טענת סף הוסף **עמדת ועדת הערר** (שדה ריק ליו"ר). אם אין — כתוב: "לא זוהו טענות סף."
+
+**תקן ביקורת**: ציין את תקן הביקורת של הוועדה בתיק זה — "הוועדה מפעילה שיקול דעת תכנוני עצמאי" (ברישוי) או "הוועדה בוחנת את תקינות השומה המכרעת" (בהיטל השבחה) או תקן אחר לפי סוג ההליך.
+
+**מפת דרכים**: לאחר זיהוי טענות הסף ולפני הדיון בסוגיות — כתוב פסקת מפה: "X שאלות עומדות להכרעה: (1)...; (2)...; (3)..." — כדי שהקורא ידע מראש מה לצפות.
+
+**סדר סוגיות**: סדר את הסוגיות כך: טענות סף ראשונות, אחריהן הסוגיה המכריעה (שמכריעה את הערר), ואחריה סוגיות משניות לפי חוזק ההנמקה (פתח בנימוק החזק ביותר).
 
 **סוגיות להכרעה** — לכל סוגיה מרכזית:
-1. **כותרת הסוגיה** — ניסוח תמציתי ומדויק
-2. **טענה (claim)** — מה העוררים טוענים, על מה מסתמכים
-3. **תשובה (response)** — מה הוועדה/משיבים עונים
-4. **תגובה (reply)** — מה המבקשת מגיבה (אם קיימת)
-5. **ניתוח אסטרטגי**:
-   - **חוזקות** — מה חזק בכל צד? מה מבוסס היטב?
-   - **חולשות** — מה חלש? מה לא מגובה בראיות?
-   - **הזדמנויות** — איפה יש פתח? מה הוועדה יכולה להישען עליו?
-6. **שאלות משפטיות** — צמד שאלות (ראה שלב 4)
-7. **עמדת ועדת הערר** — שדה ריק שיו"ר הוועדה ימלא ידנית. **חובה להוסיף לכל סוגיה!** עמדה זו תשמש כהנחיה מחייבת לסוכן הכתיבה.
+1. **כותרת הסוגיה** — ניסוח סילוגיסטי: הכלל + העובדות + שאלה חדה. לדוגמה: "תכנית X קובעת קו בניין של 3 מטרים; הבקשה כוללת בניה במרחק 1.5 מטרים — האם הבקשה תואמת את הוראות התכנית?"
+2. **ממצאים עובדתיים** — העובדות הרלוונטיות לסוגיה זו כפי שעולות מהמסמכים (עובדות בלבד, ללא מסקנות)
+3. **טענה (claim)** — מה העוררים טוענים, על מה מסתמכים
+4. **תשובה (response)** — מה הוועדה/משיבים עונים
+5. **תגובה (reply)** — מה המבקשת מגיבה (אם קיימת)
+6. **ניתוח**:
+   - **הכלל החל** — הוראת תכנית, סעיף חוק, הלכה פסוקה, או עיקרון תכנוני
+   - **העובדות הרלוונטיות** — כיצד עובדות המקרה משתלבות בכלל
+   - **נקודות פתוחות** — מה עדיין לא ברור, מה דורש חקירה נוספת
+   - **הערכה ראשונית** — לאן נוטה הניתוח ומדוע
+7. **מסקנות משפטיות** — המסקנות שנגזרות מהחלת הכלל על העובדות (נפרד מהממצאים העובדתיים)
+8. **סוג ניתוח** — סמן: כלל ברור (הטקסט הנורמטיבי נותן תשובה חד-משמעית) / דורש איזון (אינטרסים מתחרים) / דורש מידתיות (בחינת שלושת שלבי המידתיות)
+9. **הנקודה החזקה של הצד החלש** — הצג את הטענה הטובה ביותר של הצד שצפוי להפסיד בסוגיה זו (steel-man). מה עורך דין מוכשר היה מדגיש?
+10. **הכנה ל-CREAC** — לכל סוגיה רשום:
+    - כלל (Rule): הכלל המשפטי/תכנוני שיעמוד בבסיס הדיון
+    - עובדות מפתח (Facts): העובדות שיופיעו בשלב היישום
+    - תקדים מבהיר (אם נדרש): רק אם הכלל דורש הבהרה
+11. **שאלות משפטיות** — 1-3 שאלות לפי הצורך (ראה שלב 4)
+12. **עמדת ועדת הערר** — שדה ריק שיו"ר הוועדה ימלא ידנית. **חובה להוסיף לכל סוגיה!** עמדה זו תשמש כהנחיה מחייבת לסוכן הכתיבה.
+
+### שלב 3א: טיפול בטענות
+לאחר ניתוח כל הסוגיות, הוסף סעיף "טיפול בטענות" עם המלצות:
+- **טענות לקיבוץ**: טענות שמכוונות לאותה נקודה ואפשר לטפל בהן יחד ("באשר לטענות הנוספות בעניין X — לא מצאנו בהן ממש, ונפרט")
+- **טענות לדילוג**: טענות שהועלו אך אינן נחוצות להכרעה ("נוכח מסקנתנו לעיל, אין צורך להכריע בטענה זו")
+- **טענות שחייבות מענה פרטני**: טענות מרכזיות שהצד המפסיד חייב לראות שנשקלו
 
 ### שלב 4: הפקת שאלות מחקר
 
-לכל סוגיה (כולל טענות סף), נסח **בדיוק שתי שאלות מחקר**:
+לכל סוגיה (כולל טענות סף), נסח **1-3 שאלות מחקר לפי הצורך**:
 
-**שאלה 1 — עקרונית (שאלת "האם")**:
+**שאלה עקרונית (שאלת "האם")**:
 בודקת עיקרון משפטי כללי בתחום התכנון והבניה.
-דוגמה: "האם ועדת ערר רשאית להתערב בשיקול דעתה של ועדה מקומית בעניין הקלה מנספח בינוי מנחה?"
+דוגמה: "האם ועדת ערר רשאית להתערב בשיקול דעתה של ועדה מקומית כאשר החלטתה מבוססת על חוות דעת מקצועית?"
 
-**שאלה 2 — יישומית (שאלת "מהם"/"כיצד"/"באילו תנאים")**:
+**שאלה יישומית (שאלת "מהם"/"כיצד"/"באילו תנאים")**:
 מיישמת את העיקרון על נסיבות המקרה.
-דוגמה: "מהם המבחנים לאישור הקלה בגובה בניין כאשר נספח הבינוי מנחה ולא מחייב ויש התנגדות מהנדס העיר?"
+דוגמה: "מהם המבחנים שנקבעו בפסיקה להתערבות בשיקול דעת תכנוני כאשר קיימת סתירה בין הוראות תכנית לבין מדיניות הוועדה המקומית?"
+
+**שאלה נוספת (אם נדרש)**:
+שאלה ממוקדת בנקודה ספציפית שעולה מהסוגיה ואינה מכוסה בשתי השאלות הקודמות.
 
 ### כללים לשאלות מחקר
 - ניתנות למחקר — אפשר למצוא תשובה בפסיקה, חקיקה, או ספרות
@@ -124,7 +156,34 @@ tools:
 - `find_similar_cases` — תיקים דומים
 הוסף תוצאות רלוונטיות תחת כל סוגיה כ-"תקדימים מהקורפוס הפנימי".
 
-## שלב 6: שמירה ודיווח — חובה!
+## שלב 6: בדיקת שלמות — לפני שמסיימים!
+
+**לפני סיום, בצע את הבדיקות הבאות. אם בדיקה נכשלת — אל תסיים כ-"done".**
+
+### 6א. שלמות חילוץ מסמכים
+בדוק: **האם כל מסמך מסוג appeal/response/reply חולץ ויצר טענות?**
+```
+query: SELECT d.title, d.doc_type, d.extraction_status, 
+       (SELECT count(*) FROM claims WHERE source_document LIKE '%' || d.title || '%' AND case_id = d.case_id) AS claim_count
+FROM documents d WHERE d.case_id = '{case_id}' AND d.doc_type IN ('appeal', 'response', 'reply')
+```
+- אם יש מסמך עם extraction_status != 'completed' → **נסה שוב** (retry עם timeout ארוך, או פצל לחלקים)
+- אם יש מסמך עם extraction_status = 'completed' אבל 0 טענות → **נסה לחלץ טענות שוב**
+- אם ניסיון חוזר נכשל → **סטטוס issue = "blocked"**, לא "done". דווח מה נכשל ולמה.
+
+### 6ב. בדיקת סיווג
+בדוק: **האם הסיווג הגיוני?**
+- אם יש claims (claim_type='claim') מצד ועדה מקומית או מבקשי היתר → **שגיאת סיווג**. תקן ל-response.
+- אם יש יותר מ-30 טענות (claim_type='claim') מעורר אחד → **ייתכן חוסר סינתוז**. בדוק: האם טענות חוזרות? האם אפשר לאחד?
+
+### 6ג. בדיקת צד חסר
+בדוק: **האם כל צד מיוצג בטענות?**
+- אם אין אף claim מהעוררים → חריגה
+- אם אין אף response מהמשיבים → חריגה
+
+## שלב 7: שמירה ודיווח — חובה!
+
+**רק אם כל בדיקות שלב 6 עברו:**
 
 1. **שמור** את הפלט המלא:
    ```
@@ -132,7 +191,8 @@ tools:
    ```
 
 2. **פרסם comment** ב-Paperclip עם סיכום:
-   - כמה טענות, תשובות ותגובות חולצו
+   - כמה טענות חולצו (מפורט: X טענות עוררים, Y תשובות משיבים, Z תגובות)
+   - **האם כל המסמכים חולצו בהצלחה** (כן/לא — אם לא, פרט מה נכשל)
    - הסוגיות המרכזיות (3-5 כותרות)
    - כמה שאלות מחקר הופקו
    - המלצה לשלב הבא
@@ -146,14 +206,37 @@ tools:
      "סיכום: X סוגיות זוהו, Y שאלות מחקר הופקו. נדרשת ביקורתך לפני המשך."
    ```
 
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "מנתח משפטי סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'מנתח משפטי סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```
+
+**אם בדיקות שלב 6 נכשלו** — סטטוס issue = "blocked", פרסם comment עם פירוט מה נכשל, שלח מייל לחיים.
+
 ## מבנה הפלט המלא — analysis-and-research.md
 
 ```markdown
 # ניתוח ומחקר משפטי — ערר {case_number}
 תאריך: {date}
 
-## 1. צד מיוצג
-ועדת הערר לתכנון ובניה, מחוז ירושלים (יו"ר: עו"ד דפנה תמיר)
+## 1. הגוף המחליט
+ועדת הערר לתכנון ובניה, מחוז ירושלים (יו"ר: עו"ד דפנה תמיר).
+הוועדה היא גוף מעין-שיפוטי שמכריע בעררים על החלטות ועדות מקומיות.
 
 ## 2. רקע דיוני
 ...
@@ -168,28 +251,56 @@ tools:
 ## 5. טענות סף
 [אם קיימות — כולל שאלות משפטיות + עמדת ועדת הערר לכל טענה]
 
+**תקן ביקורת:** [שיקול דעת עצמאי / בחינת תקינות השומה / אחר]
+
+## 5א. מפת דרכים
+X שאלות עומדות להכרעה:
+1. ...
+2. ...
+3. ...
+
 ## 6. סוגיות להכרעה
 
-### סוגיה 1: [כותרת]
+### סוגיה 1: [כותרת סילוגיסטית — כלל + עובדות + שאלה חדה]
+
+**ממצאים עובדתיים:**
+- ...
+
 **טענה (claim):** ...
 **תשובה (response):** ...
 **תגובה (reply):** ...
 
-**ניתוח אסטרטגי:**
-- חוזקות: ...
-- חולשות: ...
-- הזדמנויות: ...
+**ניתוח:**
+- הכלל החל: ...
+- העובדות הרלוונטיות: ...
+- נקודות פתוחות: ...
+- הערכה ראשונית: ...
+
+**מסקנות משפטיות:**
+- ...
+
+**סוג ניתוח:** כלל ברור / דורש איזון / דורש מידתיות
+
+**הנקודה החזקה של הצד החלש:**
+...
+
+**הכנה ל-CREAC:**
+- כלל (Rule): ...
+- עובדות מפתח (Facts): ...
+- תקדים מבהיר: ... (אם נדרש)
 
 **שאלות משפטיות:**
 1. [שאלה עקרונית — "האם..."]
 2. [שאלה יישומית — "מהם..."]
+3. [שאלה נוספת — אם נדרש]
 
 **חיפוש תקדימים:**
 - nevo (קלאסי): "ביטוי" ו "ביטוי" ו "ועדת ערר"
-- nevo AI / law-mate: [השאלות המשפטיות מלמעלה — שאלה עקרונית + יישומית]
+- nevo AI / law-mate: [השאלות המשפטיות מלמעלה]
 
 **חקיקה רלוונטית:**
 - סעיף X לחוק...
+(הערה: התחל מלשון הטקסט הנורמטיבי. תקדים נדרש רק כשהטקסט עמום.)
 
 **תקדימים מהקורפוס הפנימי:**
 - [אם נמצאו]
@@ -201,8 +312,21 @@ tools:
 
 ### סוגיה 2: ...
 
-## 7. מסקנות
-סיכום האסטרטגיה, נקודות חוזק, סיכונים, סדר עדיפויות.
+## 6א. טיפול בטענות
+**טענות לקיבוץ:**
+- ...
+
+**טענות לדילוג:**
+- ...
+
+**טענות שחייבות מענה פרטני:**
+- ...
+
+## 7. סיכום
+- **שאלות פתוחות**: שאלות שנותרו ללא מענה ודורשות מחקר או הנחיית יו"ר
+- **סדר דיון מומלץ**: הסדר המומלץ לדיון בסוגיות בהחלטה
+- **תלויות**: סוגיות שהכרעתן תלויה בהכרעה בסוגיה אחרת
+- **הערכה כללית**: לאן נוטה הניתוח ומהם הסיכויים הכלליים של הערר
 ```
 
 ## כללים קריטיים
@@ -213,3 +337,5 @@ tools:
 4. **לא להמציא** — לא פסיקה, לא ציטוטים, לא מספרי תיקים שלא מופיעים במסמכים
 5. **שאלות מחקר הן התוצר המרכזי** — הקדש להן תשומת לב מיוחדת
 6. **אם חסר מידע** — ציין במפורש ובקש להעלות מסמכים נוספים
+7. **היררכיית מקורות** — חקיקה/תכניות קודמים לתקדימים. התחל מלשון הטקסט הנורמטיבי; תקדים נדרש רק כשהטקסט עמום
+8. **הפרדת עובדות ממסקנות** — ממצא עובדתי ("הבניה במרחק 1.5 מטרים") נפרד ממסקנה משפטית ("חריגה זו עולה כדי סטייה ניכרת"). אל תערבב

.claude/agents/legal-ceo.md

@@ -35,6 +35,16 @@ tools:
 
 אתה מתזמר את כל תהליך כתיבת ההחלטה. אתה לא כותב בעצמך — אתה מנהל את הסוכנים שעושים את העבודה ומוודא שהתהליך מתקדם נכון. **אתה עובד אינטראקטיבית מול חיים דרך Paperclip comments.**
 
+## מסמכי ייחוס
+
+לפני כל תהליך כתיבה, היכר את המסמכים הבאים:
+
+| מסמך | תוכן | מתי לקרוא |
+|------|-------|-----------|
+| `docs/decision-methodology.md` | מתודולוגיה אנליטית — סילוגיזמים, סדר סוגיות, איזון | **לפני כל החלטה** |
+| `docs/block-schema.md` | הגדרת 12 בלוקים — content model, constraints | **לפני כל החלטה** |
+| `docs/legal-decision-lessons.md` | לקחים מ-3 החלטות — מה עבד, מה השתנה | **לפני כל החלטה** |
+
 ## הסוכנים שלך
 
 | סוכן | Agent ID | תפקיד |
@@ -42,22 +52,46 @@ tools:
 | מגיה מסמכים | 410c0167-27dc-485c-a51b-7aa8b9ff2217 | הגהת OCR — תיקון ראשי תיבות ושגיאות חילוץ |
 | מנתח משפטי | c26e9439-a88a-49dc-9e67-2262c95db65c | חילוץ טענות, תשובות, תגובות |
 | חוקר תקדימים | 35022af0-0498-4c3d-90ca-b0ab9e987198 | ניתוח פסיקה, תכניות, פרוטוקולים |
-| כותב החלטה | 7ed8686f-24bc-49a3-bc02-67ca15b895a9 | כתיבת בלוקים ה-יא (Opus) |
+| כותב החלטה | 7ed8686f-24bc-49a3-bc02-67ca15b895a9 | כתיבת בלוקים ה-יב (Opus) |
 | בודק איכות | 1a5b229e-9220-4b13-940c-f8eb7285fc29 | QA לפני ייצוא |
 | מייצא טיוטה | d0dc703b-ca83-4883-bca7-c9449e8713cd | בדיקה סופית + ייצוא DOCX מגורסת |
 
 ## תהליך אינטראקטיבי — שלב אחר שלב
 
-### שלב A: בדיקת מצב
+### שלב A: בדיקת מצב — שלמות, בדיקות שליליות, תאימות מתודולוגיה
 
 בכל heartbeat:
 1. בדוק תיקים פעילים (`case_list`)
-2. לכל תיק — בדוק סטטוס + מה כבר בוצע:
-   - יש טענות מחולצות? (`get_claims`)
-   - יש comments מחיים שממתינים לתגובה?
-3. פעל לפי מפת הסטטוסים למטה
+2. בדוק אם יש issues ב-"blocked" — אם כן, טפל בהם קודם
+3. בדוק comments מחיים שממתינים לתגובה
+4. **לפני מעבר לשלב B — בצע את כל הבדיקות למטה. אם בדיקה נכשלת — עצור.**
 
-### שלב B: הכנת סיכום ושאלת תוצאה
+#### A1. בדיקת שלמות חילוץ
+- **כמה מסמכים בתיק?** (`document_list`) — ספור.
+- **האם כל המסמכים מסוג appeal/response/reply חולצו?** — בדוק extraction_status. אם יש מסמך שנכשל → **עצור**. צור issue למנתח לתיקון.
+- **האם כל מסמך שחולץ ייצר טענות?** — אם מסמך מסוג appeal/response ייצר 0 טענות → **עצור**. אין להמשיך עם מידע חלקי.
+
+#### A2. בדיקות שליליות
+- **סיווג צולב**: האם יש claim_type='claim' מצד ועדה מקומית או מבקשי היתר? → שגיאת סיווג. החזר למנתח.
+- **כמות חריגה**: האם יש צד עם >30 טענות (claim_type='claim')? → ייתכן חוסר סינתוז. בדוק ודווח.
+- **צד חסר**: האם יש צד שאין לו אף טענה? → חריגה.
+- **מסמך ריק**: האם יש מסמך appeal/response עם טקסט שלא ייצר טענות ולא דווח ככשל?
+
+#### A3. אימות תאימות מתודולוגיה
+קרא את `analysis-and-research.md` ובדוק:
+- [ ] סוגיות מנוסחות כסילוגיזם (כלל + עובדות + שאלה)?
+- [ ] ממצאים עובדתיים מופרדים ממסקנות משפטיות?
+- [ ] לכל סוגיה יש "סוג ניתוח" (כלל ברור / איזון / מידתיות)?
+- [ ] לכל סוגיה יש "הכנה ל-CREAC" (כלל, עובדות, תקדים)?
+- [ ] יש steel-man (הנקודה החזקה של הצד החלש)?
+- [ ] יש סעיף "טיפול בטענות" (bundle/skip)?
+- [ ] היררכיית מקורות: חקיקה לפני תקדימים?
+
+**אם בדיקה כלשהי נכשלת → אל תמשיך לשלב B.** צור issue למנתח עם הנחיה ספציפית, ופרסם comment שמסביר מה חסר.
+
+**עיקרון מנחה:** עדיף לעכב את התהליך מאשר לייצר החלטה על בסיס חלקי או פגום.
+
+### שלב B: הכנת סיכום, סיווג, ושאלת תוצאה
 
 **מתי:** כשיש טענות מחולצות + מחקר תקדימים, אבל אין תוצאה עדיין
 
@@ -66,18 +100,38 @@ tools:
 ```
 ## סיכום תיק {case_number} — מוכן להחלטה
 
+### סיווג
+- **סוג ערר:** {רישוי (1xxx) / היטל השבחה (8xxx) / פיצויים ס' 197 (9xxx)}
+- **תקן ביקורת:** {שיקול דעת תכנוני עצמאי / ביקורת שומה מכרעת / ...}
+
 ### טענות מרכזיות של העוררים
 [3-5 טענות עיקריות מ-get_claims עם claim_type=claim]
 
 ### תשובות המשיבים
 [3-5 תשובות עיקריות מ-get_claims עם claim_type=response]
 
-### עמדת הוועדה
-[2-3 עמדות מ-get_claims עם claim_type=response ו-party_role=committee]
+### החלטת הוועדה המקומית (=מושא הערר)
+[ההחלטה שעליה מוגש הערר — מה הוועדה המקומית החליטה ומדוע]
+
+### תגובת הוועדה המקומית (=ההגנה)
+[עמדת הוועדה המקומית בהליך הערר — הנימוקים שלה מדוע החלטתה נכונה]
 
 ### תקדימים רלוונטיים
 [מתוך comments קודמים של חוקר תקדימים]
 
+### שאלות מרכזיות לדיון
+[נסח כל שאלה כסילוגיזם מכווץ, בהתאם למתודולוגיה §א.3]
+
+1. **{ניסוח השאלה}**
+   - כלל: {הנחה משפטית / הוראת תכנית}
+   - עובדות: {עובדות תמציתיות}
+   - שאלה: {השאלה החדה}
+
+2. **{ניסוח השאלה}**
+   - כלל: ...
+   - עובדות: ...
+   - שאלה: ...
+
 ---
 
 **מה התוצאה הצפויה?**
@@ -88,29 +142,94 @@ tools:
 @chaim — הגב עם מספר (1/2/3) + הערות אם יש
 ```
 
-### שלב C: קליטת תוצאה וסיעור מוחות
+לאחר שחיים בחר תוצאה, שאל אותו לסמן טיפול בכל טענה:
 
-**מתי:** חיים הגיב עם מספר תוצאה
+```
+## טיפול בטענות — {case_number}
+
+סמן לכל טענה את סוג הטיפול:
+
+| # | טענה | טיפול |
+|---|------|-------|
+| 1 | {טענה 1} | דיון מלא / קיבוץ / דילוג |
+| 2 | {טענה 2} | דיון מלא / קיבוץ / דילוג |
+| 3 | {טענה 3} | דיון מלא / קיבוץ / דילוג |
+| ... | ... | ... |
+
+**הסבר:**
+- **דיון מלא** — ניתוח סילוגיסטי מלא (כלל → עובדות → מסקנה)
+- **קיבוץ** — טענות שמכוונות לאותה נקודה ייאגדו יחד
+- **דילוג** — "לא מצאנו ממש" או "אין צורך להכריע נוכח מסקנתנו"
+
+@chaim — סמן בטבלה והחזר
+```
+
+**מתי לחזור אחורה:** אם הסיכום לא מצליח לנסח שאלות כסילוגיזמים מכווצים — ייתכן שחסר מידע עובדתי או נורמטיבי. חזור למנתח/חוקר להשלמה.
+
+### שלב C: קליטת תוצאה וכיוונים סילוגיסטיים
+
+**מתי:** חיים הגיב עם מספר תוצאה + טיפול בטענות
 
 1. קרא את ה-comment של חיים
 2. זהה את הבחירה (1=rejected, 2=partial, 3=accepted)
 3. הרץ `set_outcome(case_number, outcome, reasoning)`
-4. **בעצמך** חשוב על 2-3 כיוונים לנימוק — אתה כבר Claude, אתה יודע את הטענות והתקדימים. **אל תקרא ל-brainstorm_directions** (זה מפעיל claude בתוך claude ולוקח יותר מדי זמן).
-5. פרסם comment:
+4. **חשוב סילוגיסטית** על 2-3 כיוונים לנימוק — אתה כבר Claude, אתה יודע את הטענות והתקדימים. בנה כל כיוון כסילוגיזם מלא.
+
+   > **הערה טכנית:** אל תקרא ל-`brainstorm_directions` — זה מפעיל Claude בתוך Claude ולוקח יותר מדי זמן.
+
+5. פרסם comment עם **סדר סוגיות מוצע**:
 
 ```
 ## כיוונים אפשריים לנימוק — {outcome_hebrew}
 
+### סדר הסוגיות המוצע
+1. {שאלת סף — אם רלוונטית}
+2. {הסוגיה המכריעה}
+3. {סוגיות נוספות לפי חוזק}
+
+---
+
 ### כיוון 1: {title}
-{description — 3-4 משפטים}
+
+**כלל (הנחה עליונה):**
+{הוראת תכנית / סעיף חוק / הלכה פסוקה}
+
+**עובדות (הנחה תחתונה):**
+{העובדות הספציפיות של הערר שנבחנות לאור הכלל}
+
+**מסקנה:**
+{התוצאה שנובעת מהחלת הכלל על העובדות}
+
 **תקדימים תומכים:** {precedents}
 
+---
+
 ### כיוון 2: {title}
-{description}
+
+**כלל (הנחה עליונה):**
+{...}
+
+**עובדות (הנחה תחתונה):**
+{...}
+
+**מסקנה:**
+{...}
+
 **תקדימים תומכים:** {precedents}
 
+---
+
 ### כיוון 3: {title}
-{description}
+
+**כלל (הנחה עליונה):**
+{...}
+
+**עובדות (הנחה תחתונה):**
+{...}
+
+**מסקנה:**
+{...}
+
 **תקדימים תומכים:** {precedents}
 
 ---
@@ -119,18 +238,28 @@ tools:
 אפשר גם לשלב כיוונים או להוסיף הערות.
 ```
 
+**מתי לחזור אחורה:** אם לא ניתן לבנות סילוגיזם מלא (חסר כלל, חסרות עובדות, או המסקנה לא נובעת) — חזור לחוקר תקדימים או למנתח להשלמת החסר.
+
 ### שלב D: אישור כיוון והפעלת כתיבה
 
 **מתי:** חיים הגיב עם בחירת כיוון
 
 1. קרא את ה-comment של חיים
 2. זהה כיוון (1/2/3) + הערות נוספות
-3. הרץ `approve_direction(case_number, direction_index, additional_notes)`
-4. צור issue חדש ב-Paperclip:
+3. **אימות שלמות chair_directions** — לפני שליחה לכותב, ודא:
+   - [ ] טיפול בטענות (דיון מלא / קיבוץ / דילוג) מוגדר לכל טענה
+   - [ ] כיוון סילוגיסטי נבחר ומאושר
+   - [ ] סדר סוגיות מוגדר
+   - [ ] תקן ביקורת מצוין
+   - אם חסר פריט כלשהו — **שאל את חיים** לפני שממשיכים
+4. הרץ `approve_direction(case_number, direction_index, additional_notes)`
+5. צור issue חדש ב-Paperclip:
    - כותרת: `[ערר {case_number}] כתיבת החלטה`
    - הקצה ל: **כותב החלטה** (7ed8686f-24bc-49a3-bc02-67ca15b895a9)
-5. פרסם comment: "כיוון אושר. הועבר לכותב החלטה."
-6. עדכן סטטוס: `case_update(status=direction_approved)`
+6. פרסם comment: "כיוון אושר. הועבר לכותב החלטה."
+7. עדכן סטטוס: `case_update(status=direction_approved)`
+
+**מתי לחזור אחורה:** אם חיים שינה דעתו לגבי התוצאה או הכיוון, או אם חסר מידע — חזור לשלב B או C בהתאם.
 
 ### שלב E: מעקב כתיבה
 
@@ -140,6 +269,8 @@ tools:
 1. צור issue: `[ערר {case_number}] בדיקת איכות`
 2. הקצה ל: **בודק איכות** (1a5b229e-9220-4b13-940c-f8eb7285fc29)
 
+**מתי לחזור אחורה:** אם הכותב מדווח על חוסר מידע או סתירה בכיוונים — חזור לשלב D לבירור מול חיים.
+
 ### שלב F: QA וייצוא
 
 **מתי:** בודק איכות סיים
@@ -149,19 +280,36 @@ tools:
 3. פרסם comment: "החלטה מוכנה לביקורת דפנה. [קישור ל-DOCX]"
 4. אם נכשל — פרסם comment עם רשימת תיקונים, צור issue חדש לכותב
 
+**מתי לחזור אחורה:** אם דוח QA מצביע על בעיה מתודולוגית (סילוגיזם חסר, כיוון לא תואם chair_directions) — חזור לשלב C/D ולא רק לכותב.
+
 ## מפת סטטוסים
 
-| סטטוס | פעולה |
-|--------|-------|
-| new + יש מסמכים + לא הוגהו | → צור issue למגיה מסמכים (410c0167) |
-| new + מסמכים הוגהו + אין claims | → צור issue למנתח משפטי |
-| new + יש claims + יש מחקר | → שלב B (סיכום + שאלת תוצאה) |
-| outcome_set | → שלב C (brainstorm) |
-| brainstorming + comment מחיים | → שלב D (approve + הפעל כותב) |
-| direction_approved | → ודא שכותב עובד |
-| drafted | → צור issue לבודק איכות |
-| qa_review pass | → שלב F (export via מייצא טיוטה d0dc703b) |
-| qa_review fail | → צור issue תיקון לכותב |
+**סטטוסים של התיק (`cases.status`) — כל סטטוס מתאים לפעולה אחת בדיוק:**
+
+| סטטוס | מי שינה לזה | פעולה הבאה |
+|--------|-------------|------------|
+| `new` | (יצירת תיק) | → בדוק extraction_status של מסמכים. אם יש `pending` → צור issue למגיה (410c0167). אם כולם `completed`/`proofread` → צור issue למנתח |
+| `proofread` | מגיה | → צור issue למנתח משפטי (ראה תבנית למטה) |
+| `documents_ready` | מנתח | → שלב A (בדיקות שלמות + שליליות + מתודולוגיה). אם עובר → עדכן ל-`analyst_verified` |
+| `analyst_verified` | CEO (אחרי שלב A) | → האם יש מחקר תקדימים? אם לא → צור issue לחוקר (35022af0). אם כן → שלב B |
+| `research_complete` | חוקר | → שלב B (סיכום + סיווג + שאלת תוצאה לחיים) |
+| `outcome_set` | CEO (אחרי שחיים בחר) | → האם יש claim_handling? אם לא → שלב B המשך (טבלת bundle/skip). אם כן → שלב C |
+| `direction_approved` | CEO (אחרי שחיים אישר) | → בדוק chair_directions שלם? אם כן → צור issue לכותב (7ed8686f). אם חסר → חזור לחיים |
+| `drafted` | כותב | → צור issue לבודק איכות (1a5b229e) |
+| `qa_passed` | QA | → צור issue למייצא (d0dc703b) |
+| `qa_failed` | QA | → בעיה טכנית → issue תיקון לכותב. בעיה מתודולוגית → חזור לשלב C/D |
+| `exported` | מייצא | → פרסם comment + מייל: "מוכן לביקורת דפנה" |
+
+**סטטוס `blocked` (ב-issue, לא ב-case):** סוכן נתקע → קרא comment, הבן מה נכשל, נסה לפתור או דווח לחיים.
+
+---
+
+**תבנית issue למנתח — חובה בכל תיק:**
+1. **טבלת מיפוי מסמכים** — לכל מסמך: שם, claim_type, party_role. בנה מ-`document_list`.
+2. **רשימת מסמכים שלא לחלץ מהם** (reference, plan, decision, court_decision)
+3. **הנחיה לפיצול מסמכים גדולים** — מעל 15,000 תווים → חלץ בחלקים
+4. **הנחיה לשלוח wakeup ל-CEO בסיום**
+5. **הנחיה לסיים כ-blocked אם מסמך נכשל**
 
 ## כללים
 
@@ -170,6 +318,7 @@ tools:
 - **לא לכתוב בלוקים** — רק כותב ההחלטה
 - **תמיד לדווח** — כל פעולה = comment ב-Paperclip
 - **לשאול כשלא בטוח** — אם משהו לא ברור, שאל את חיים
+- **ודא עקביות מתודולוגית** — כיוונים סילוגיסטיים (כלל + עובדות + מסקנה), chair_directions שלם (טיפול בטענות + כיוון + סדר סוגיות + תקן ביקורת), התאמה ל-`decision-methodology.md`
 
 ## איך לקרוא comments של חיים
 
@@ -182,5 +331,6 @@ curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
 חפש ב-comment:
 - מספר (1/2/3) → בחירה
 - "כיוון" + מספר → אישור כיוון
+- טבלת טיפול בטענות → סימון claim_handling
 - שאלה → ענה
 - הערה → שלב בתהליך

.claude/agents/legal-exporter.md

@@ -43,7 +43,7 @@ tools:
 ### שלב 1: זיהוי התיק
 1. קבל את מספר התיק מה-issue או מהמשתמש
 2. קרא פרטי תיק (`case_get`)
-3. בדוק סטטוס workflow (`workflow_status`) — ודא שהכתיבה הושלמה
+3. בדוק סטטוס workflow (`workflow_status`) — ודא שהכתיבה הושלמה **ושבדיקת QA עברה בהצלחה**
 
 ### שלב 2: בדיקה סופית מהירה
 1. הרץ `validate_decision` — בדוק שאין כשלים קריטיים
@@ -51,6 +51,7 @@ tools:
 3. בדוק רצף מספור — שהמספור רציף מ-1 עד סוף ללא קפיצות או כפילויות
 4. בדוק שאין placeholders ריקים (כמו `[...]`, `XXX`, `___`)
 5. אם יש בעיות קריטיות — דווח למשתמש ואל תייצא
+6. בדוק שסטטוס ה-QA הוא "passed" — אם ה-QA לא רץ או נכשל, **אל תייצא**
 
 ### שלב 3: ייצוא DOCX
 1. קרא את סקייל legal-docx (SKILL.md) כדי להבין את דרישות העיצוב
@@ -73,6 +74,26 @@ tools:
 - ממצאי הבדיקה הסופית (אם היו הערות)
 - גודל הקובץ
 
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "מייצא טיוטה סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'מייצא טיוטה סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```
+
 ## כללים קריטיים
 
 1. **לעולם אל תייצא בלי בדיקה** — תמיד הרץ validate_decision קודם

.claude/agents/legal-proofreader.md

@@ -11,6 +11,7 @@ tools:
   - mcp__legal-ai__case_get
   - mcp__legal-ai__document_list
   - mcp__legal-ai__document_get_text
+  - mcp__legal-ai__case_update
 ---
 
 # מגיה מסמכים — סוכן הגהת OCR
@@ -68,8 +69,11 @@ psql -h localhost -p 5432 -U "${DB_USER:-legal_ai}" -d "${DB_NAME:-legal_ai}" \
 ```
 אם עדכון DB לא אפשרי, עדכן רק את הקובץ ודווח.
 
-### שלב 5: דיווח
-פרסם comment ב-Paperclip עם:
+### שלב 5: עדכון סטטוס ודיווח
+
+1. **עדכן סטטוס**: `case_update(case_number, status='proofread')`
+
+2. פרסם comment ב-Paperclip עם:
 ```
 ## דוח הגהת מסמכים — תיק {case_number}
 
@@ -95,3 +99,23 @@ psql -h localhost -p 5432 -U "${DB_USER:-legal_ai}" -d "${DB_NAME:-legal_ai}" \
 4. **דווח מקומות מסופקים** — סמן `[?]` ותן לאדם להחליט
 5. **אל תמציא טקסט** — אם חסר משהו, סמן `[...]` ואל תנחש
 6. **קרא את כל המסמך** — לפעמים הקשר ממסמך שלם עוזר להבין מילה שבורה
+
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "מגיה מסמכים סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'מגיה מסמכים סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```

.claude/agents/legal-qa.md

@@ -37,9 +37,10 @@ tools:
 - רק עובדות: תיאור נכס, היסטוריה תכנונית, החלטת ועדה
 
 ### 3. כיסוי טענות (claims_coverage)
-- כל טענה מבלוק ז נענתה בבלוק י
-- גם אם בניסוח שונה — העיקר שנדונה
-- **קריטי** — אם טענה לא נענתה, ה-QA נכשל
+- כל טענה מהותית מבלוק ז קיבלה מענה בבלוק י (ישיר, קיבוץ, או ציון שנבחנה)
+- טענות שסומנו [skip] ב-chair_directions — לא נספרות
+- טענות שסומנו [bundle] — נבדקות כקבוצה: אם הנושא טופל, כולן עוברות
+- **קריטי** — אם טענה מהותית ללא סימון לא נענתה, ה-QA נכשל
 
 ### 4. משקלות בטווח (weight_compliance)
 - בלוק ו (רקע): 15-40%
@@ -56,6 +57,15 @@ tools:
 - סעיפים 1, 2, 3... ללא איפוס בין בלוקים
 - ללא כפילויות במספור
 
+### 7. עמידה במתודולוגיה (methodology_compliance)
+ראה `docs/decision-methodology.md` לעקרונות המלאים. בדוק:
+- לכל סוגיה בבלוק י — ניתן לזהות מבנה סילוגיסטי: כלל + עובדות + מסקנה?
+- ממצאים עובדתיים מופרדים ממסקנות משפטיות (לא מעורבבים)?
+- טענה מרכזית של הצד המפסיד קיבלה מענה הוגן (Steel-Man — הוצגה בחוזקתה)?
+- כשנדרש איזון — יש ניתוח מפורש (אינטרסים, השלכות, הכרעה)?
+- אין "נוסחאות ריקות" (משפטים שמחיקתם לא משנה כלום)?
+- ציטוטים עטופים בסנדוויץ' (הקדמה → ציטוט → ניתוח)?
+
 ## חומרה
 
 | בדיקה | חומרה | משמעות |
@@ -66,6 +76,7 @@ tools:
 | משקלות | warning | מדווח, לא חוסם |
 | כפילות | warning | מדווח, לא חוסם |
 | מספור | warning | מדווח, לא חוסם |
+| מתודולוגיה | critical | חוסם ייצוא |
 
 ## תהליך עבודה
 
@@ -74,14 +85,42 @@ tools:
 2. הרץ בדיקת איכות (`validate_decision`)
 3. קבל מדדים (`get_metrics`)
 
-### שלב 2: בדיקה ידנית
+### שלב 2: בדיקה ידנית — חיובית
 1. קרא את בלוק ו — בדוק ניטרליות
 2. השווה טענות בבלוק ז מול דיון בבלוק י — בדוק כיסוי
 3. בדוק מספור רציף
 
+### שלב 2ב: בדיקות שליליות — מה חסר? מה לא הגיוני?
+1. האם יש סוגיה מה-analysis-and-research.md שלא קיבלה מענה בדיון?
+2. האם יש ציטוט ארוך ללא סנדוויץ' (הקדמה + ציטוט + ניתוח)?
+3. האם יש "נוסחאות ריקות" — משפטים שמחיקתם לא משנה כלום?
+4. האם יש פסקה בדיון ללא משפט נושא (פתיחה שלא מודיעה על הנקודה)?
+5. האם יש ממצא עובדתי ומסקנה משפטית מעורבבים באותו משפט?
+6. האם יש אנלוגיה לתקדים ללא הסבר מדיניות (למה הדמיון רלוונטי)?
+
 ### שלב 3: דיווח — חובה!
 פרסם comment ב-Paperclip עם:
 - תוצאת כל בדיקה (pass/fail)
 - רשימת שגיאות מפורטת (אם יש)
 - האם מותר לייצא (כל הקריטיים pass?)
 - עדכן סטטוס ל-qa_review (אם נכשל) או drafted (אם עבר)
+
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "בודק איכות סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'בודק איכות סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```

.claude/agents/legal-researcher.md

@@ -27,6 +27,11 @@ tools:
 
 עבוד תמיד בעברית.
 
+## לפני שאתה מתחיל — קרא!
+
+1. **מתודולוגיה אנליטית**: `docs/decision-methodology.md` — במיוחד סעיפים ד.2 (התחל מלשון הטקסט), ד.3 (שלושה מקורות להנחה עליונה), ז (ציטוטים ואזכורי פסיקה)
+2. לקחים מהחלטות קודמות: `docs/legal-decision-lessons.md`
+
 ## סוגי מסמכים שאתה מטפל בהם
 
 | סוג מסמך | מה לעשות |
@@ -52,23 +57,62 @@ tools:
 לכל פסק דין:
 1. קרא את הטקסט (`document_get_text`)
 2. סכם: עובדות, שאלה משפטית, הכרעה, רלוונטיות לתיק שלנו
-3. הפק הפניות (`extract_references`)
+3. בנוסף ציין:
+   - **רמת התקדים**: עליון / מנהלי / ועדת ערר ארצית / ועדת ערר מחוזית
+   - **הלכה מחייבת או אמרת אגב**
+   - **כיצד ישרת את מבנה ההנמקה**: כ"כלל" (הנחה עליונה), כ"הרחבה" (Explanation ב-CREAC), או כאנלוגיה
+4. הפק הפניות (`extract_references`)
 
 ### שלב 3: מיפוי תכנית
-1. קרא הוראות התכנית
+1. קרא הוראות התכנית **במלואן** — לא רק את הסעיף הנטען
 2. זהה סעיפים רלוונטיים למחלוקת
-3. ציין: ייעוד, זכויות בנייה, מגבלות, חניה
+3. **צטט את לשון ההוראות הרלוונטיות** — הנוסח המדויק, לא סיכום (המתודולוגיה דורשת: "התחל מלשון הטקסט")
+4. סמן **עמימויות או סתירות** בין הוראות באותה תכנית
+5. ציין: ייעוד, זכויות בנייה, מגבלות, תנאים
 
 ### שלב 4: סיכום פרוטוקולים והחלטות
 1. קרא כל פרוטוקול והחלטת ביניים
 2. בנה ציר זמן כרונולוגי של ההליך
 
 ### שלב 5: דיווח — חובה!
-פרסם comment ב-Paperclip עם:
+
+1. **עדכן סטטוס**: `case_update(case_number, status='research_complete')`
+
+2. **שלח מייל**:
+```bash
+python3 /home/chaim/legal-ai/scripts/notify.py \
+  "מחקר תקדימים הושלם — ערר {case_number}" \
+  "סיכום: X פסקי דין נותחו, Y תכניות מופו. נדרשת ביקורתך לפני המשך."
+```
+
+3. פרסם comment ב-Paperclip עם:
 - סיכום כל פסק דין (2-3 שורות לכל אחד)
 - מיפוי הוראות תכנית רלוונטיות
 - ציר זמן ההליך
-- המלצה: אילו תקדימים הכי חזקים, אילו סעיפי תכנית מרכזיים
+- **המלצה מובנית לפי מקורות הנמקה:**
+  - **טקסט**: אילו סעיפי תכנית/חוק מרכזיים (ציטוט הנוסח)
+  - **תקדים**: אילו פסקי דין הכי חזקים (עם ציון היררכיה ומעמד — הלכה/אגב)
+  - **מדיניות**: אילו שיקולים תכנוניים עולים מהחומר
+
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "חוקר תקדימים סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'חוקר תקדימים סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```
 
 ## כללים
 - **דיוק** — ציין מספרי סעיפים, תאריכים, שמות שופטים

.claude/agents/legal-writer.md

@@ -34,9 +34,10 @@ tools:
 
 ## לפני שאתה מתחיל — קרא!
 
-1. מדריך סגנון: `skills/decision/SKILL.md`
-2. ארכיטקטורת 12 בלוקים: `docs/block-schema.md`
-3. לקחים מהחלטות קודמות: `docs/legal-decision-lessons.md`
+1. **מתודולוגיה אנליטית: `docs/decision-methodology.md`** — איך לחשוב על החלטה
+2. מדריך סגנון: `skills/decision/SKILL.md` — איך דפנה כותבת
+3. ארכיטקטורת 12 בלוקים: `docs/block-schema.md`
+4. לקחים מהחלטות קודמות: `docs/legal-decision-lessons.md`
 
 ## ארכיטקטורת 12 בלוקים
 
@@ -70,11 +71,12 @@ tools:
 ## תהליך עבודה
 
 ### שלב 1: הכנה
-1. קרא פרטי התיק (`case_get`)
-2. קרא טענות מחולצות (`get_claims`)
-3. **קרא את עמדות יו"ר הוועדה (`get_chair_directions`) — חובה!**
-4. קבל תבנית החלטה (`get_decision_template`)
-5. קרא מדריך סגנון (`get_style_guide`)
+1. **קרא את המתודולוגיה**: `Read docs/decision-methodology.md` — חובה לפני כל כתיבה
+2. קרא פרטי התיק (`case_get`)
+3. קרא טענות מחולצות (`get_claims`)
+4. **קרא את עמדות יו"ר הוועדה (`get_chair_directions`) — חובה!**
+5. קבל תבנית החלטה (`get_decision_template`)
+6. קרא מדריך סגנון (`get_style_guide`)
 
 ### שלב 1ב: בדיקת עמדות יו"ר — חובה לפני כתיבה!
 
@@ -141,15 +143,59 @@ case_update(case_number, status="drafted")
 - ספירת מילים לכל בלוק
 - יחסי משקל (% מהמסמך)
 
+### העֵר את העוזר המשפטי (CEO) — חובה!
+```bash
+curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
+  -H "Content-Type: application/json" \
+  "$PAPERCLIP_API_URL/api/agents/752cebdd-6748-4a04-aacd-c7ab0294ef33/wake" \
+  -d '{"reason": "כותב החלטה סיים משימה [issue-id] בסטטוס [done/blocked]"}'
+```
+אם ה-API לא עובד:
+```bash
+PGPASSWORD="paperclip" psql -h 127.0.0.1 -p 54329 -U paperclip -d paperclip -c "
+INSERT INTO agent_wakeup_requests (company_id, agent_id, source, reason, status, requested_by_actor_type)
+VALUES (
+  (SELECT company_id FROM agents WHERE id = '\$PAPERCLIP_AGENT_ID'),
+  '752cebdd-6748-4a04-aacd-c7ab0294ef33',
+  'agent_completion',
+  'כותב החלטה סיים משימה — נדרשת בדיקה',
+  'pending', 'agent'
+);"
+```
+
 **אם לא תעדכן סטטוס ל-drafted — בודק האיכות לא יוכל לרוץ!**
 
 ## בלוק י — דיון (הבלוק החשוב ביותר)
 
-- מבנה CREAC: מסקנה בפתיחה → כלל → הסבר → יישום → מסקנה
-- ענה על כל טענה מבלוק ז
-- השתמש בציטוטים ארוכים (200-600 מילים) מפסיקה
-- אל תחזור על עובדות מבלוק ו
-- אל תשתמש בכותרות משנה (למעט נושאים נפרדים לחלוטין)
+**עקוב אחר `docs/decision-methodology.md` — שלבי הניתוח:**
+
+### שלב א: פסקת מפה
+פתח בפסקה שמודיעה מה ייבחן: "שלוש שאלות עומדות להכרעה: (1)...; (2)...; (3)..."
+
+### שלב ב: סוגיות סף (אם רלוונטיות)
+אם עולה שאלת סף — היא נדונה ראשונה. אם נדחית — פסקה אחת ועבור לגוף.
+
+### שלב ג: לכל סוגיה — מבנה סילוגיסטי (CREAC)
+1. **מסקנה** — פתח בתשובה
+2. **כלל** — ציטוט הוראת תכנית/חוק (התחל מלשון הטקסט, לא מפסיקה)
+3. **הרחבה** — תקדים רלוונטי אחד (טכניקת סנדוויץ': הקדמה→ציטוט→ניתוח)
+4. **יישום** — החל את הכלל על העובדות. הפרד ממצא עובדתי ממסקנה משפטית. השתמש בנתונים (מספרים, מידות, אחוזים).
+5. **Steel-Man** — הצג את הטענה הטובה ביותר של הצד המפסיד: "אמנם צודק העורר כי..., אולם..."
+6. **מסקנה חוזרת** — סגור
+
+### שלב ד: איזון (כשנדרש)
+אם אין כלל ברור — בנה איזון: זהה אינטרסים קונקרטיים → בחן השלכות לכל כיוון → שקול השלכות מערכתיות → הכרע.
+
+### שלב ה: טענות נותרות
+- טענות מרכזיות ללא סימון: מענה פרטני
+- טענות שסומנו [bundle] ב-chair_directions: קבץ ודון יחד
+- טענות שסומנו [skip] ב-chair_directions: "נבחנה ולא מצאנו בה ממש"
+- טענות חלשות: קיבוץ. "באשר לטענות הנוספות — לא מצאנו בהן ממש"
+
+### כללים נוספים
+- אל תחזור על עובדות מבלוק ו — הפנה: "כאמור בסעיף X לעיל"
+- כל מילה עובדת — אין "לאחר ששקלנו את כלל השיקולים"
+- כנות לגבי קושי — "הדבר אינו נקי מספקות, אולם..."
 
 ### חובה: שימוש בעמדות יו"ר מ-`get_chair_directions`
 

.dockerignore

@@ -4,3 +4,12 @@ mcp-server/.venv/
 **/__pycache__/
 *.pyc
 .git/
+.taskmaster/
+web/static/
+web/__pycache__/
+scripts/
+skills/
+docs/
+legacy/
+node_modules/
+.next/

.gitea/workflows/deploy.yaml

@@ -0,0 +1,58 @@
+name: Build & Deploy
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+
+env:
+  REGISTRY: gitea.nautilus.marcusgroup.org
+  IMAGE: ezer-mishpati/legal-ai
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Login to Gitea Registry
+        run: |
+          echo "${{ secrets.REGISTRY_PASSWORD }}" | \
+            docker login ${{ env.REGISTRY }} \
+              -u "${{ secrets.REGISTRY_USER }}" --password-stdin
+
+      - name: Build and tag image
+        run: |
+          BASE="${{ env.REGISTRY }}/${{ env.IMAGE }}"
+          TAGS="-t ${BASE}:latest -t ${BASE}:build-${{ github.run_number }}"
+
+          # If this is a version tag (v*), add the semver tag
+          REF="${{ github.ref }}"
+          if [[ "$REF" == refs/tags/v* ]]; then
+            VERSION="${REF#refs/tags/}"
+            TAGS="$TAGS -t ${BASE}:${VERSION}"
+            echo "📦 Release: ${VERSION}"
+          fi
+
+          echo "🏗️  Building with tags: build-${{ github.run_number }}, latest"
+          docker build $TAGS .
+
+      - name: Push image
+        run: |
+          BASE="${{ env.REGISTRY }}/${{ env.IMAGE }}"
+          docker push "${BASE}:latest"
+          docker push "${BASE}:build-${{ github.run_number }}"
+
+          REF="${{ github.ref }}"
+          if [[ "$REF" == refs/tags/v* ]]; then
+            VERSION="${REF#refs/tags/}"
+            docker push "${BASE}:${VERSION}"
+            echo "✅ Pushed ${VERSION}"
+          fi
+
+      - name: Trigger Coolify redeploy
+        run: |
+          curl -sf \
+            "http://coolify:8080/api/v1/deploy?uuid=my85gabx37ele9aouub8t8ju&force=true" \
+            -H "Authorization: Bearer ${{ secrets.COOLIFY_TOKEN }}"

.taskmaster/docs/ui-updates-prd.txt

@@ -0,0 +1,30 @@
+# UI Updates — Legal AI Next.js
+
+## Context
+The legal-ai system uses a Next.js 15 UI at web-ui/. The workflow pipeline was significantly updated with new statuses, methodology, and agent improvements. The UI needs to reflect these changes.
+
+## Task 1: Remove old Flask UI from Coolify
+The old Flask app runs at legal-ai.nautilus.marcusgroup.org via Docker/Coolify. It should be archived and removed to save resources. The Next.js UI (legal-ai-next.nautilus.marcusgroup.org) becomes the sole UI. After removal, DNS should point legal-ai.nautilus.marcusgroup.org to the Next.js app.
+
+Files: Coolify dashboard, DNS config.
+
+## Task 2: Update WorkflowTimeline component with new statuses
+The WorkflowTimeline component in web-ui/src/app/cases/[caseNumber]/page.tsx (line 127) only knows old statuses. It needs to support the full pipeline:
+- new → proofread → documents_ready → analyst_verified → research_complete → outcome_set → direction_approved → drafted → qa_passed → exported
+- Plus: qa_failed, blocked
+Each status needs: Hebrew label, color, icon, description tooltip.
+
+Files: web-ui/src/app/cases/[caseNumber]/page.tsx, possibly a new WorkflowTimeline component file.
+
+## Task 3: Status overview page or component
+Create a page or modal that shows all possible statuses with explanations — what each status means, which agent sets it, what happens next. Could be a /statuses page or a help tooltip in the WorkflowTimeline.
+
+## Task 4: Manual status editing in case page
+Add a dropdown or modal in the case page that allows manually changing the case status. This is needed for cases where the automated pipeline gets stuck or needs to be reset. Should call case_update API endpoint.
+
+Files: web-ui/src/app/cases/[caseNumber]/page.tsx, web-ui/src/lib/api/.
+
+## Task 5: Merge action buttons into overview card
+Currently there's a separate "פעולות" (actions) card with 2 buttons: "פתח בעורך החלטה" and "עריכת פרטי תיק". These should move into the main overview/summary card at the top of the case page. The separate actions card should be removed — it wastes space for just 2 buttons.
+
+Files: web-ui/src/app/cases/[caseNumber]/page.tsx.

.taskmaster/tasks/tasks.json

@@ -820,13 +820,13 @@
         "description": "Port the 3 highest-value screens. Use the frontend-design Claude Code skill to generate layout + composition, passing design tokens (navy/gold/parchment, Heebo), editorial voice, and typed API hooks. Use shadcn Card/Badge/Tabs/Sheet/ScrollArea as primitives. Port the custom donut chart into <DonutChart> component. TanStack Query staleTime:5000 for case detail replaces manual 5s polling. Plan: ~/.claude/plans/joyful-marinating-sutton.md.",
         "details": "See full plan at ~/.claude/plans/joyful-marinating-sutton.md for architecture, critical files, risks, and open questions. This task is phase 3 of 7 in the legal-ai UI rewrite from vanilla HTML to Next.js 15 + shadcn/ui.",
         "testStrategy": "Users can browse case list, open a case detail, and view the compose screen with live data from FastAPI. All 3 screens visually match the existing legal-ai identity.",
-        "status": "in-progress",
+        "status": "done",
         "dependencies": [
           "84"
         ],
         "priority": "high",
         "subtasks": [],
-        "updatedAt": "2026-04-11T15:55:49.327Z"
+        "updatedAt": "2026-04-11T16:09:18.006Z"
       },
       {
         "id": "86",
@@ -834,12 +834,13 @@
         "description": "Port new case wizard, bulk upload, inline forms on case detail. Use react-hook-form + zod with schemas in lib/schemas/<entity>.ts. Build shared <WizardShell> from shadcn Card + Progress + Tabs. Build <DropZone> (react-dropzone + shadcn). Integrate SSE for upload progress via lib/sse.ts. Plan: ~/.claude/plans/joyful-marinating-sutton.md.",
         "details": "See full plan at ~/.claude/plans/joyful-marinating-sutton.md for architecture, critical files, risks, and open questions. This task is phase 4 of 7 in the legal-ai UI rewrite from vanilla HTML to Next.js 15 + shadcn/ui.",
         "testStrategy": "Users can create a new case via the multi-step wizard (case appears in Gitea + Paperclip), upload documents with live SSE progress, and edit case fields inline.",
-        "status": "pending",
+        "status": "done",
         "dependencies": [
           "85"
         ],
         "priority": "medium",
-        "subtasks": []
+        "subtasks": [],
+        "updatedAt": "2026-04-11T16:25:55.569Z"
       },
       {
         "id": "87",
@@ -847,12 +848,13 @@
         "description": "Port the remaining 5 views. Use TanStack Table for training corpus and diagnostics lists. Port any charts/visualizations from current index.html. Plan: ~/.claude/plans/joyful-marinating-sutton.md.",
         "details": "See full plan at ~/.claude/plans/joyful-marinating-sutton.md for architecture, critical files, risks, and open questions. This task is phase 5 of 7 in the legal-ai UI rewrite from vanilla HTML to Next.js 15 + shadcn/ui.",
         "testStrategy": "Feature parity with old legal-ai/web/static/index.html across all 10 views.",
-        "status": "pending",
+        "status": "done",
         "dependencies": [
           "86"
         ],
         "priority": "medium",
-        "subtasks": []
+        "subtasks": [],
+        "updatedAt": "2026-04-11T17:33:42.976Z"
       },
       {
         "id": "88",
@@ -860,12 +862,13 @@
         "description": "Accessibility pass (keyboard nav, aria-label on RTL icons, focus trap in modals). Error boundaries + toast notifications for failed mutations. Loading states for every query. Cross-browser smoke test (Chrome, Firefox, Safari) + mobile device test. Document E2E smoke test script in web-ui/README.md. Plan: ~/.claude/plans/joyful-marinating-sutton.md.",
         "details": "See full plan at ~/.claude/plans/joyful-marinating-sutton.md for architecture, critical files, risks, and open questions. This task is phase 6 of 7 in the legal-ai UI rewrite from vanilla HTML to Next.js 15 + shadcn/ui.",
         "testStrategy": "Lighthouse a11y score > 90, all loading states visible, errors show toasts, README has documented smoke test steps.",
-        "status": "pending",
+        "status": "done",
         "dependencies": [
           "87"
         ],
         "priority": "medium",
-        "subtasks": []
+        "subtasks": [],
+        "updatedAt": "2026-04-11T17:44:08.337Z"
       },
       {
         "id": "89",
@@ -879,16 +882,97 @@
         ],
         "priority": "medium",
         "subtasks": []
+      },
+      {
+        "id": "90",
+        "title": "Phase 4.5 — Practice area integration",
+        "description": "Add practice_area + appeal_subtype to the wizard, types, schema, case header, and cases table. Gap identified after backend commit 26d09d6 (multi-tenant axis) — new Next.js UI has zero integration while vanilla UI is fully wired. Plan: ~/.claude/plans/woolly-cooking-graham.md",
+        "details": "",
+        "testStrategy": "",
+        "status": "done",
+        "dependencies": [
+          "86"
+        ],
+        "priority": "high",
+        "subtasks": [],
+        "updatedAt": "2026-04-11T17:15:57.831Z"
+      },
+      {
+        "id": "91",
+        "title": "Precedent attachment in compose screen",
+        "description": "Add case_precedents table + FastAPI endpoints + MCP tools + Next.js compose UI for attaching legal precedents (quote + citation + optional archived PDF) to threshold_claims/issues and to the case as a whole. Plan: ~/.claude/plans/woolly-cooking-graham.md",
+        "details": "",
+        "testStrategy": "",
+        "status": "done",
+        "dependencies": [],
+        "priority": "high",
+        "subtasks": [],
+        "updatedAt": "2026-04-11T19:20:56.040Z"
+      },
+      {
+        "id": 92,
+        "title": "הסרת אפליקציית Flask הישנה מ-Coolify",
+        "description": "ארכיון והסרה של אפליקציית Flask הישנה מ-Coolify, וכיוון DNS כך ש-legal-ai.nautilus.marcusgroup.org יצביע על אפליקציית Next.js",
+        "details": "## פסאודו-קוד:\n```\n1. גיבוי הגדרות Flask מ-Coolify לפני מחיקה\n2. ב-Coolify dashboard:\n   - מצא את הקונטיינר legal-ai-flask (או שם דומה)\n   - עצור את הקונטיינר\n   - צור snapshot או ארכיון של ההגדרות\n   - מחק את הקונטיינר והסרוויס\n3. ב-DNS (Cloudflare/Coolify proxy):\n   - שנה את legal-ai.nautilus.marcusgroup.org\n   - הפנה ל-IP/service של legal-ai-next (Next.js app)\n4. ב-Next.js app (Coolify):\n   - הוסף domain alias: legal-ai.nautilus.marcusgroup.org\n   - עדכן SSL certificate\n```\n\n## קבצים מושפעים:\n- Coolify dashboard settings\n- DNS records (Cloudflare או ספק אחר)\n- Coolify proxy/Traefik configuration\n\n## הערות:\n- **אין שינויים בקוד** - רק הגדרות תשתית\n- ודא שה-Next.js app עובד עם שני הדומיינים במקביל לפני הסרת Flask\n- שמור לוגים מ-Flask לפני מחיקה למקרה של rollback",
+        "testStrategy": "## בדיקות:\n1. **לפני הסרה**: ודא ש-legal-ai-next.nautilus.marcusgroup.org עובד תקין\n2. **אחרי שינוי DNS**: \n   - `curl -I https://legal-ai.nautilus.marcusgroup.org` - צריך להחזיר 200\n   - בדוק SSL certificate תקין\n3. **בדיקת UI**: \n   - פתח את legal-ai.nautilus.marcusgroup.org בדפדפן\n   - ודא שזה אותו UI כמו legal-ai-next\n4. **בדיקת API**: \n   - `curl https://legal-ai.nautilus.marcusgroup.org/api/cases`\n   - ודא שמחזיר נתונים",
+        "priority": "high",
+        "dependencies": [],
+        "status": "pending",
+        "subtasks": []
+      },
+      {
+        "id": 93,
+        "title": "עדכון סטטוסים ב-WorkflowTimeline וב-status-badge",
+        "description": "עדכון רשימת הסטטוסים בממשק לפי ה-pipeline החדש: new → proofread → documents_ready → analyst_verified → research_complete → outcome_set → direction_approved → drafted → qa_passed → exported, כולל qa_failed ו-blocked",
+        "details": "## קבצים לעדכון:\n1. `web-ui/src/lib/api/cases.ts` - עדכון type CaseStatus\n2. `web-ui/src/components/cases/status-badge.tsx` - תוויות ועיצוב\n3. `web-ui/src/components/cases/workflow-timeline.tsx` - שלבי pipeline\n\n## פסאודו-קוד:\n\n### 1. cases.ts - עדכון הטיפוס:\n```typescript\nexport type CaseStatus =\n  | \"new\"\n  | \"proofread\"\n  | \"documents_ready\"\n  | \"analyst_verified\"\n  | \"research_complete\"\n  | \"outcome_set\"\n  | \"direction_approved\"\n  | \"drafted\"\n  | \"qa_passed\"\n  | \"exported\"\n  | \"qa_failed\"\n  | \"blocked\";\n```\n\n### 2. status-badge.tsx - תוויות עבריות וצבעים:\n```typescript\nconst STATUS_LABELS: Record<CaseStatus, string> = {\n  new: \"חדש\",\n  proofread: \"הוגה\",\n  documents_ready: \"מסמכים מוכנים\",\n  analyst_verified: \"אומת ע״י אנליסט\",\n  research_complete: \"מחקר הושלם\",\n  outcome_set: \"תוצאה נקבעה\",\n  direction_approved: \"כיוון אושר\",\n  drafted: \"טיוטה\",\n  qa_passed: \"עבר QA\",\n  exported: \"יוצא\",\n  qa_failed: \"נכשל QA\",\n  blocked: \"חסום\",\n};\n\nconst STATUS_TONE: Record<CaseStatus, string> = {\n  new: \"bg-rule-soft text-ink-muted border-rule\",\n  proofread: \"bg-info-bg text-info border-info/30\",\n  documents_ready: \"bg-info-bg text-info border-info/40\",\n  analyst_verified: \"bg-info-bg text-info border-info/50\",\n  research_complete: \"bg-gold-wash text-gold-deep border-gold/40\",\n  outcome_set: \"bg-gold-wash text-gold-deep border-gold/50\",\n  direction_approved: \"bg-gold-wash text-gold-deep border-gold/60\",\n  drafted: \"bg-warn-bg text-warn border-warn/40\",\n  qa_passed: \"bg-success-bg text-success border-success/40\",\n  exported: \"bg-success-bg text-success border-success/60\",\n  qa_failed: \"bg-danger-bg text-danger border-danger/40\",\n  blocked: \"bg-danger-bg text-danger border-danger/50\",\n};\n```\n\n### 3. workflow-timeline.tsx - קבוצות שלבים חדשות:\n```typescript\nconst PHASES: Phase[] = [\n  { key: \"intake\", label: \"קליטה ועיבוד\", statuses: [\"new\", \"proofread\", \"documents_ready\"] },\n  { key: \"analysis\", label: \"ניתוח\", statuses: [\"analyst_verified\", \"research_complete\"] },\n  { key: \"direction\", label: \"קביעת כיוון\", statuses: [\"outcome_set\", \"direction_approved\"] },\n  { key: \"writing\", label: \"כתיבה וביקורת\", statuses: [\"drafted\", \"qa_passed\"] },\n  { key: \"done\", label: \"סגירה\", statuses: [\"exported\"] },\n];\n\n// טיפול בסטטוסי שגיאה (qa_failed, blocked) - הצגה מיוחדת\nif (status === \"qa_failed\" || status === \"blocked\") {\n  // הצג באדום עם אייקון אזהרה\n}\n```",
+        "testStrategy": "## בדיקות:\n1. **Unit Tests** (אם קיימים):\n   - ודא שכל הסטטוסים מופו נכון\n   - בדוק שאין סטטוס חסר ב-STATUS_LABELS ו-STATUS_TONE\n\n2. **Visual Testing**:\n   - צור/ערוך תיק ידנית ב-DB לכל סטטוס\n   - ודא שהתווית מוצגת בעברית נכונה\n   - ודא שהצבע מתאים (כחול לעיבוד, זהב לניתוח, ירוק להצלחה, אדום לשגיאה)\n\n3. **WorkflowTimeline**:\n   - ודא שהשלב הנוכחי מודגש בצהוב\n   - ודא ששלבים שהושלמו מסומנים בירוק\n   - ודא שסטטוסי שגיאה (qa_failed, blocked) מוצגים עם אינדיקציה ויזואלית מיוחדת",
+        "priority": "high",
+        "dependencies": [],
+        "status": "pending",
+        "subtasks": []
+      },
+      {
+        "id": 94,
+        "title": "דף/קומפוננטה להצגת כל הסטטוסים עם הסברים",
+        "description": "יצירת דף /statuses או מודל עזרה שמסביר את כל הסטטוסים האפשריים - מה כל סטטוס אומר, איזה agent קובע אותו, ומה קורה אחר כך",
+        "details": "## אפשרויות מימוש:\n\n### אפשרות A: Popover tooltip בתוך WorkflowTimeline (מומלץ)\n```typescript\n// web-ui/src/components/cases/workflow-timeline.tsx\n// הוסף אייקון (?) ליד הכותרת שפותח popover\n\nconst STATUS_INFO: Record<CaseStatus, StatusInfo> = {\n  new: {\n    description: \"תיק נוצר, ממתין להעלאת מסמכים\",\n    agent: \"משתמש\",\n    nextStep: \"העלאת מסמכים → proofread\"\n  },\n  proofread: {\n    description: \"מסמכים הועלו, עוברים הגהה אוטומטית\",\n    agent: \"Proofread Agent\",\n    nextStep: \"הגהה הושלמה → documents_ready\"\n  },\n  documents_ready: {\n    description: \"מסמכים מוכנים לניתוח\",\n    agent: \"Document Processor\",\n    nextStep: \"בדיקת אנליסט → analyst_verified\"\n  },\n  analyst_verified: {\n    description: \"אנליסט אימת את חילוץ הטענות\",\n    agent: \"Analyst Agent\",\n    nextStep: \"מחקר → research_complete\"\n  },\n  research_complete: {\n    description: \"מחקר משפטי הושלם, פסיקה זוהתה\",\n    agent: \"Research Agent\",\n    nextStep: \"קביעת תוצאה → outcome_set\"\n  },\n  outcome_set: {\n    description: \"דפנה קבעה את התוצאה (דחייה/קבלה)\",\n    agent: \"משתמש (דפנה)\",\n    nextStep: \"אישור כיוון → direction_approved\"\n  },\n  direction_approved: {\n    description: \"כיוון ההחלטה אושר, מוכן לכתיבה\",\n    agent: \"משתמש\",\n    nextStep: \"כתיבה → drafted\"\n  },\n  drafted: {\n    description: \"טיוטת החלטה נכתבה\",\n    agent: \"Writing Agent\",\n    nextStep: \"בדיקת QA → qa_passed\"\n  },\n  qa_passed: {\n    description: \"טיוטה עברה בדיקת איכות\",\n    agent: \"QA Agent\",\n    nextStep: \"ייצוא → exported\"\n  },\n  exported: {\n    description: \"ההחלטה יוצאה כ-DOCX\",\n    agent: \"Export Service\",\n    nextStep: \"הושלם\"\n  },\n  qa_failed: {\n    description: \"טיוטה נכשלה בבדיקת QA\",\n    agent: \"QA Agent\",\n    nextStep: \"חזרה לכתיבה → drafted\"\n  },\n  blocked: {\n    description: \"תיק חסום - דורש התערבות ידנית\",\n    agent: \"מערכת\",\n    nextStep: \"טיפול ידני\"\n  },\n};\n```\n\n### אפשרות B: דף /statuses נפרד\n```typescript\n// web-ui/src/app/statuses/page.tsx\n// דף עצמאי עם טבלה של כל הסטטוסים\n```\n\n## המלצה: אפשרות A - פשוטה יותר ומשתלבת ב-UX הקיים",
+        "testStrategy": "## בדיקות:\n1. **UI Testing**:\n   - לחיצה על אייקון העזרה פותחת popover/tooltip\n   - כל סטטוס מציג: תיאור, agent, שלב הבא\n   - סגירת ה-popover עובדת (לחיצה מחוץ/Escape)\n\n2. **Accessibility**:\n   - ה-popover נגיש למקלדת (Tab, Enter, Escape)\n   - aria-label מתאים\n   - RTL מוצג נכון\n\n3. **Content Review**:\n   - כל ההסברים בעברית תקנית\n   - הזרימה בין סטטוסים מובנת",
+        "priority": "medium",
+        "dependencies": [
+          93
+        ],
+        "status": "pending",
+        "subtasks": []
+      },
+      {
+        "id": 95,
+        "title": "עריכה ידנית של סטטוס בדף התיק",
+        "description": "הוספת dropdown או מודל בדף התיק לשינוי סטטוס ידני, לטיפול במקרים שבהם ה-pipeline נתקע או צריך reset",
+        "details": "## מיקום: בתוך הכרטיס של WorkflowTimeline (בצד ימין של דף התיק)\n\n## פסאודו-קוד:\n\n### 1. קומפוננטת StatusEditor:\n```typescript\n// web-ui/src/components/cases/status-editor.tsx\n\nimport { Select } from \"@/components/ui/select\";\nimport { Button } from \"@/components/ui/button\";\nimport { useUpdateCase } from \"@/lib/api/cases\";\nimport { toast } from \"sonner\";\n\nexport function StatusEditor({ caseNumber, currentStatus }: Props) {\n  const [selectedStatus, setSelectedStatus] = useState(currentStatus);\n  const updateCase = useUpdateCase(caseNumber);\n\n  const handleSave = async () => {\n    if (selectedStatus === currentStatus) return;\n    \n    try {\n      await updateCase.mutateAsync({ status: selectedStatus });\n      toast.success(\"סטטוס עודכן בהצלחה\");\n    } catch (error) {\n      toast.error(\"שגיאה בעדכון הסטטוס\");\n    }\n  };\n\n  return (\n    <div className=\"flex items-center gap-2 mt-4\">\n      <Select value={selectedStatus} onValueChange={setSelectedStatus}>\n        {ALL_STATUSES.map(status => (\n          <SelectItem key={status} value={status}>\n            {STATUS_LABELS[status]}\n          </SelectItem>\n        ))}\n      </Select>\n      <Button \n        onClick={handleSave} \n        disabled={selectedStatus === currentStatus || updateCase.isPending}\n        size=\"sm\"\n      >\n        עדכן\n      </Button>\n    </div>\n  );\n}\n```\n\n### 2. שילוב בדף התיק:\n```typescript\n// web-ui/src/app/cases/[caseNumber]/page.tsx\n// בתוך הכרטיס של WorkflowTimeline\n\n<Card className=\"bg-surface border-rule shadow-sm h-fit\">\n  <CardContent className=\"px-6 py-5\">\n    <h2 className=\"text-navy text-base mb-4\">שלב בתהליך</h2>\n    <WorkflowTimeline status={data?.status} />\n    {data && <StatusEditor caseNumber={caseNumber} currentStatus={data.status} />}\n  </CardContent>\n</Card>\n```\n\n### 3. עדכון ה-API (אם נדרש):\nה-`useUpdateCase` כבר תומך ב-status field לפי `caseUpdateSchema`.",
+        "testStrategy": "## בדיקות:\n1. **Functionality**:\n   - בחירת סטטוס חדש מה-dropdown\n   - לחיצה על \"עדכן\" שולחת PUT request ל-API\n   - הסטטוס מתעדכן ב-UI אחרי הצלחה\n   - toast הודעה מוצגת\n\n2. **Edge Cases**:\n   - לחיצה על \"עדכן\" כשהסטטוס לא השתנה - כפתור disabled\n   - טיפול בשגיאת API - הודעת שגיאה\n   - כפתור disabled בזמן loading\n\n3. **Integration**:\n   - ה-WorkflowTimeline מתעדכן מיד אחרי שינוי סטטוס\n   - ה-StatusBadge בכותרת מתעדכן\n   - הנתונים מסונכרנים עם ה-DB",
+        "priority": "medium",
+        "dependencies": [
+          93
+        ],
+        "status": "pending",
+        "subtasks": []
+      },
+      {
+        "id": 96,
+        "title": "מיזוג כפתורי פעולות לכרטיס הסקירה הראשי",
+        "description": "העברת הכפתורים 'פתח בעורך ההחלטה' ו'עריכת פרטי תיק' מהלשונית 'פעולות' לכרטיס הכותרת העליון, והסרת הלשונית המיותרת",
+        "details": "## קבצים לעדכון:\n- `web-ui/src/app/cases/[caseNumber]/page.tsx`\n- `web-ui/src/components/cases/case-header.tsx`\n\n## פסאודו-קוד:\n\n### 1. עדכון CaseHeader להוספת כפתורי פעולה:\n```typescript\n// web-ui/src/components/cases/case-header.tsx\n\nimport Link from \"next/link\";\nimport { Button } from \"@/components/ui/button\";\nimport { CaseEditDialog } from \"@/components/cases/case-edit-dialog\";\n\nexport function CaseHeader({ data }: { data?: CaseDetail }) {\n  return (\n    <Card className=\"bg-surface border-rule shadow-sm\">\n      <CardContent className=\"px-6 py-5\">\n        {/* ... breadcrumb קיים ... */}\n        \n        <div className=\"flex items-start justify-between gap-6 flex-wrap\">\n          <div className=\"space-y-2\">\n            {/* ... כותרת וסטטוס קיימים ... */}\n          </div>\n\n          {/* כפתורי פעולה - חדש */}\n          <div className=\"flex items-center gap-3 flex-wrap\">\n            <Button asChild className=\"bg-navy hover:bg-navy-soft text-parchment\">\n              <Link href={`/cases/${data?.case_number}/compose`}>\n                פתח בעורך ההחלטה\n              </Link>\n            </Button>\n            {data && <CaseEditDialog data={data} />}\n          </div>\n        </div>\n\n        {/* ... תאריכים קיימים ... */}\n      </CardContent>\n    </Card>\n  );\n}\n```\n\n### 2. הסרת לשונית \"פעולות\" מדף התיק:\n```typescript\n// web-ui/src/app/cases/[caseNumber]/page.tsx\n\n// הסר את TabsTrigger value=\"actions\"\n<TabsList className=\"bg-rule-soft/60\">\n  <TabsTrigger value=\"overview\">סקירה</TabsTrigger>\n  <TabsTrigger value=\"documents\">מסמכים (...)</TabsTrigger>\n  {/* הוסר: <TabsTrigger value=\"actions\">פעולות</TabsTrigger> */}\n</TabsList>\n\n// הסר את TabsContent value=\"actions\"\n// הקוד הבא נמחק:\n// <TabsContent value=\"actions\" className=\"mt-5\">\n//   <div className=\"flex items-center gap-3 flex-wrap\">\n//     <Button asChild>...</Button>\n//     {data && <CaseEditDialog data={data} />}\n//   </div>\n// </TabsContent>\n```\n\n### 3. עדכון CaseHeader props:\n```typescript\n// צריך להעביר caseNumber ל-CaseHeader אם עדיין לא קיים\n<CaseHeader data={data} caseNumber={caseNumber} />\n```",
+        "testStrategy": "## בדיקות:\n1. **Visual**:\n   - כפתורי הפעולה מופיעים בכרטיס העליון\n   - הכפתורים מיושרים ימינה (RTL)\n   - responsive - נגלשים נכון במסכים קטנים\n\n2. **Functionality**:\n   - \"פתח בעורך ההחלטה\" מנווט ל-/cases/{caseNumber}/compose\n   - \"עריכת פרטי תיק\" פותח את ה-CaseEditDialog\n   - ה-dialog עובד כרגיל\n\n3. **Removal**:\n   - לשונית \"פעולות\" לא מופיעה יותר ב-Tabs\n   - אין שגיאות קונסול\n   - ניווט ל-#actions לא עובד (ולא אמור)\n\n4. **Regression**:\n   - לשוניות \"סקירה\" ו\"מסמכים\" עובדות כרגיל\n   - שאר הדף לא נפגע",
+        "priority": "low",
+        "dependencies": [],
+        "status": "pending",
+        "subtasks": []
       }
     ],
     "metadata": {
-      "version": "1.0.0",
-      "lastModified": "2026-04-11T15:55:49.330Z",
-      "taskCount": 58,
-      "completedCount": 51,
-      "tags": [
-        "master"
-      ]
+      "created": "2026-04-13T14:20:54.888Z",
+      "updated": "2026-04-13T14:20:54.888Z",
+      "description": "Tasks for master context"
     }
   }
 }

CLAUDE.md

@@ -42,6 +42,8 @@
 | [`docs/block-schema.md`](docs/block-schema.md) | הגדרת 12 בלוקים — content model, constraints, processing params | **לפני כל כתיבת החלטה** |
 | [`docs/migration-plan.md`](docs/migration-plan.md) | תוכנית מעבר vault → DB — טבלאות, עדיפויות, כמויות | לפני ייבוא נתונים |
 | [`docs/legal-decision-lessons.md`](docs/legal-decision-lessons.md) | לקחים מ-3 החלטות — מה עבד, מה השתנה, ביטויי מעבר חדשים | **לפני כל כתיבת החלטה** |
+| [`docs/decision-methodology.md`](docs/decision-methodology.md) | **מתודולוגיה אנליטית — איך לחשוב על החלטה מעין-שיפוטית** | **לפני כל כתיבת החלטה** |
+| [`docs/corpus-analysis.md`](docs/corpus-analysis.md) | ניתוח שיטתי של 24 החלטות — מפת תוכן, דפוסי דיון תכנוני, פערים | **לפני כל כתיבת החלטה** |
 | [`docs/memory.md`](docs/memory.md) | הקשר כללי — skills, פרויקטים שהושלמו, מבנה vault | להתמצאות כללית |
 | [`skills/decision/SKILL.md`](skills/decision/SKILL.md) | מדריך סגנון מלא של דפנה — טון, מבנה, ביטויים, מתודולוגיה | **לפני כל כתיבת החלטה** |
 
@@ -107,6 +109,16 @@
 3. **"ללא כפילות"** — בלוק י (דיון) מפנה לבלוקים קודמים, לא חוזר עליהם
 4. **"טענות מקוריות בלבד"** — בלוק ז = מכתבי טענות מקוריים בלבד. השלמות → בלוק ח
 5. **ארכיטקטורת 12 בלוקים** — ראה `docs/block-schema.md`
+6. **צ'קליסט תוכן** — בלוק י מקבל צ'קליסט תוכן אוטומטי לפי סוג הערר (ראה `lessons.py: CONTENT_CHECKLISTS`)
+
+## הערות יו"ר (Chair Feedback)
+
+מנגנון לתיעוד הערות דפנה על טיוטות:
+- **DB**: טבלת `chair_feedback` (case_id, block_id, feedback_text, category, lesson_extracted)
+- **API**: `GET/POST /api/feedback`, `PATCH /api/feedback/{id}/resolve`
+- **MCP tools**: `record_chair_feedback`, `list_chair_feedback`
+- **UI**: דף ניהול ב-`/feedback` (ב-Next.js)
+- **קטגוריות**: missing_content, wrong_tone, wrong_structure, factual_error, style, other
 
 ## יו"ר: עו"ד דפנה תמיר
 - מדריך סגנון מלא: `skills/decision/SKILL.md`

Dockerfile

@@ -1,21 +1,20 @@
 # ══════════════════════════════════════════════════════════════
-# Dockerfile — Next.js 16 web-ui (ui-rewrite branch only)
+# Dockerfile — Next.js frontend + FastAPI backend (single container)
 #
-# This file REPLACES the FastAPI Dockerfile on this branch so that
-# Coolify's default /Dockerfile lookup builds the new Next.js staging
-# UI. The FastAPI Dockerfile lives on `main` and is unaffected.
+# The container runs both:
+#   - FastAPI (uvicorn) on :8000  — the API backend
+#   - Next.js (node)    on :3000  — the frontend (proxies /api/* to :8000)
 #
-# When the rewrite is merged to main, decide between:
-#   (a) keeping both via separate Dockerfiles + dockerfile_location config, or
-#   (b) a multi-stage Dockerfile that serves both, or
-#   (c) fully replacing FastAPI's StaticFiles with this Next.js front end.
+# start.sh launches both processes.
 # ══════════════════════════════════════════════════════════════
 
+# ── Stage 1: Node deps ────────────────────────────────────────
 FROM node:20-alpine AS deps
 WORKDIR /app
 COPY web-ui/package.json web-ui/package-lock.json ./
 RUN npm ci --no-audit --no-fund
 
+# ── Stage 2: Build Next.js ────────────────────────────────────
 FROM node:20-alpine AS builder
 WORKDIR /app
 COPY --from=deps /app/node_modules ./node_modules
@@ -23,18 +22,49 @@ COPY web-ui/ ./
 ENV NEXT_TELEMETRY_DISABLED=1
 RUN npm run build
 
-FROM node:20-alpine AS runner
+# ── Stage 3: Install Python deps (use slim for pre-built wheels) ──
+FROM python:3.12-slim AS pydeps
+WORKDIR /opt/api
+COPY mcp-server/ ./mcp-server/
+RUN pip install --no-cache-dir ./mcp-server
+
+# ── Stage 4: Runner ───────────────────────────────────────────
+FROM python:3.12-slim AS runner
 WORKDIR /app
+
+# Install Node.js 20.x
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      curl ca-certificates \
+ && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
+ && apt-get install -y --no-install-recommends nodejs \
+ && apt-get purge -y curl \
+ && rm -rf /var/lib/apt/lists/*
+
 ENV NODE_ENV=production
 ENV NEXT_TELEMETRY_DISABLED=1
 ENV PORT=3000
 ENV HOSTNAME=0.0.0.0
 
-# next.config.ts uses output: 'standalone', so we copy only the minimal runtime
+# Copy Python packages from pydeps stage
+COPY --from=pydeps /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=pydeps /usr/local/bin/uvicorn /usr/local/bin/uvicorn
+
+# Copy Next.js standalone build
 COPY --from=builder /app/public ./public
 COPY --from=builder /app/.next/standalone ./
 COPY --from=builder /app/.next/static ./.next/static
 
+# Copy FastAPI backend code
+COPY web/ ./web/
+COPY mcp-server/src/ ./mcp-server/src/
+
+# Make mcp-server source available to web/app.py (it does sys.path.insert for legal_mcp)
+ENV PYTHONPATH=/app/mcp-server/src
+
+# Copy startup script
+COPY start.sh ./start.sh
+RUN chmod +x ./start.sh
+
 EXPOSE 3000
 
-CMD ["node", "server.js"]
+CMD ["./start.sh"]

docs/block-schema.md

@@ -371,6 +371,7 @@ Conclusion → Rule → Explanation → Application → Conclusion.
 - MUST: מסקנה בפתיחת הדיון (לא בסוף)
 - MUST: מענה לכל טענה שהוצגה בבלוק ז
 - MUST: ציטוט פסיקה בבלוקים ארוכים (200-600 מילים)
+- MUST: **צ'קליסט תוכן** — הפרומפט מזריק `{content_checklist}` אוטומטית לפי סוג הערר (מתוך `lessons.py: CONTENT_CHECKLISTS`). ראה `docs/corpus-analysis.md` לדפוסי תוכן לפי סוג.
 - ⚠️ **MUST NOT ("ללא כפילות"):** חזרה על עובדות/טענות מבלוקים קודמים. השתמש בהפניות: "כאמור בסעיף X לעיל", "כפי שפורט", "כפי שציינו"
 - MUST NOT: כותרות משנה (חריג: נושאים נפרדים לחלוטין)
 - Dependencies: **ALL** previous blocks (ה-ט)

docs/corpus-analysis.md

@@ -0,0 +1,238 @@
+# ניתוח שיטתי של קורפוס ההחלטות — מפת תוכן
+
+> נוצר: 2026-04-12
+> מקור: ניתוח 24 החלטות מתוך `/data/training/proofread/`
+> מטרה: לחלץ דפוסי תוכן בפרק הדיון וההכרעה לפי סוג תיק
+
+---
+
+## 1. סקירה כללית של הקורפוס
+
+### הרכב הקורפוס
+| סוג | כמות | החלטות |
+|-----|------|--------|
+| רישוי ובנייה (1xxx) | 22 | כל ההחלטות מלבד גבאי ובית הכרם |
+| תמ"א 38 | 1 | בית הכרם 1126+1141 |
+| סמכות/סף בלבד | 1 | גבאי 1105 |
+| **היטל השבחה (8xxx)** | **0** | **פער קריטי — אין אף החלטה בקורפוס** |
+
+### תוצאות
+| תוצאה | כמות | דוגמאות |
+|-------|------|---------|
+| דחייה | 12 | עמית, פרומר, זעיתר, בית שמש, אנשין (חניה), אהרן, שטרית, גבאי, ירושלים שקופה, לבנון, יפה |
+| קבלה | 5 | טלי-אביב, הראל 1043+1054, הראל 1071+1077, מינץ, לוי |
+| קבלה חלקית | 4 | אמיתי, בר-און, אנשין (1096), בית הכרם, אואקנין |
+
+### אורך פרק הדיון
+- טווח: 465 — 12,000 מילים
+- ממוצע: ~5,000 מילים
+- הקצר ביותר: גבאי (465, סמכות בלבד)
+- הארוך ביותר: תורן/1015 (~11,000, שימוש חורג), מינץ/1071 (~12,000, סבב שני)
+
+---
+
+## 2. נושאים שנמצאו בפרקי הדיון — מפת תוכן מלאה
+
+### 2.1 נושאים תכנוניים (Planning Content)
+
+| נושא | מופיע ב-X החלטות | עומק טיפוסי | דוגמאות בולטות |
+|------|-----------------|-------------|----------------|
+| **ניתוח הוראות תכנית** (ציטוט ישיר, פרשנות) | 18/24 | 3-15 סעיפים | פרומר (MI/200), לבנון (Hal/435), בית הכרם (10038, 16000) |
+| **חניה** (חישוב, נספח תנועה, חלופות) | 8/24 | 5-15 סעיפים | אנשין-1096 (הרחבה), בית הכרם (הרחבה), אנשין-1109, לוי |
+| **קווי בניין ומרווחים** | 7/24 | 3-10 סעיפים | אמיתי, אואקנין, שטרית, בר-און |
+| **גובה/קומות** | 4/24 | 3-6 סעיפים | לבנון (הרחבה), בר-און, לוי |
+| **סביבה ואופי שכונה** | 6/24 | 2-5 סעיפים | זעיתר (טיפולוגיה), פרומר (חקלאי), בית הכרם |
+| **שימושים מותרים/שימוש חורג** | 2/24 | 5-20 סעיפים | תורן (הרחבה חריגה), יפה |
+| **שימור** | 2/24 | 2-5 סעיפים | בית הכרם, בר-און (עצים) |
+| **טופוגרפיה/טיפולוגיה** | 2/24 | 3-8 סעיפים | זעיתר (הרחבה), לבנון |
+| **תכנית אב כמסגרת** | 2/24 | 2-3 סעיפים | בית הכרם (16000), תורן (צור הדסה) |
+| **אינטרס ציבורי (חיזוק/התחדשות)** | 2/24 | 3-8 סעיפים | בית הכרם (תמ"א 38), מינץ |
+| **היררכיית תכניות** (ארצית→מחוזית→מקומית) | 3/24 | 5-12 סעיפים | פרומר (הרחבה), לבנון, תורן |
+| **נספח בינוי** (ניתוח פרטני) | 5/24 | 3-8 סעיפים | לבנון, לוי, מינץ, בר-און, בית שמש |
+| **פגיעה בשכנים** (צל, פרטיות, רעש) | 5/24 | 2-5 סעיפים | אמיתי, שטרית, בית הכרם, אואקנין, זעיתר |
+| **עצים/נוף** | 3/24 | 1-3 סעיפים | בר-און, בית שמש, בית הכרם |
+
+### 2.2 נושאים משפטיים (Legal Content)
+
+| נושא | מופיע ב-X החלטות | עומק טיפוסי |
+|------|-----------------|-------------|
+| **סמכות/זכות ערר** (ס' 152, 12ב) | 10/24 | 3-12 סעיפים |
+| **הלכת שפר** (ערר על היתר תואם תכנית) | 8/24 | 2-5 סעיפים |
+| **תימוכין קנייניים** (property feasibility) | 6/24 | 5-15 סעיפים |
+| **סטייה ניכרת** (תקנה 2) | 5/24 | 3-8 סעיפים |
+| **שיהוי** (delay/laches) | 5/24 | 2-5 סעיפים |
+| **מידתיות** (proportionality) | 4/24 | 2-5 סעיפים |
+| **עבריינות בנייה** (building violations) | 6/24 | 2-5 סעיפים |
+| **שיקול דעת הוועדה המקומית** | 8/24 | 2-5 סעיפים |
+| **קניין vs. תכנון** (הפרדת סמכויות) | 7/24 | 3-10 סעיפים |
+| **הכשרת בנייה קיימת** (regularization) | 3/24 | 5-12 סעיפים |
+
+---
+
+## 3. דפוסי "דיון תכנוני" שזוהו
+
+### 3.1 מתי דפנה מקיימת דיון תכנוני מקיף?
+
+**תמיד** כאשר:
+- הערר עוסק בהתאמה לתכנית (ייעוד, שימוש, גובה, בנייה)
+- יש שאלה של סטייה מהוראות תכנית
+- הנושא הוא חניה/תשתיות
+- התיק מערב תמ"א 38 או התחדשות עירונית
+
+**לעולם לא** כאשר:
+- התיק הוא סף/סמכות בלבד (גבאי)
+- השאלה היא קניינית טהורה (טלי-אביב/1043+1054, בית שמש/1180+1181)
+
+**עומק משתנה** כאשר:
+- יש מספר נושאים שחלקם תכנוניים — הדיון התכנוני מוגבל לנושאים הרלוונטיים
+
+### 3.2 איך דפנה בונה דיון תכנוני — הדפוס
+
+**שלב 1: הקשר תכנוני רחב (2-8 סעיפים)**
+- תכניות חלות ברמה הרלוונטית (מקומית, מחוזית, ארצית)
+- ייעוד הקרקע, שימושים מותרים
+- אופי הסביבה, מרקם בנוי
+- *דוגמה*: פרומר — 12 סעיפים על MI/200, TAMA 35, TAMAM 30/1
+
+**שלב 2: ציטוט ישיר מהוראות תכנית (3-15 סעיפים)**
+- בלוקים ארוכים (200-600 מילים) של הוראות תכנית
+- הדגשות בולד על המילים הרלוונטיות
+- "הדגשת הח"מ" / "הדגשת הח.מ."
+- *דוגמה*: בית הכרם — 400+ מילים מהוראות חניה של תכנית 5166ב
+
+**שלב 3: יישום על המקרה הספציפי (3-8 סעיפים)**
+- הוראה → עובדה → מסקנה
+- "הנה מה שאומרת התכנית, הנה מה שקורה בפועל, הנה המסקנה"
+- *דוגמה*: לבנון — השוואת חתכים של נספח בינוי עם הבקשה
+
+**שלב 4: מסקנה תכנונית (1-3 סעיפים)**
+- האם הבקשה תואמת/סוטה
+- האם הסטייה מוצדקת
+- מה צריך לתקן
+
+### 3.3 הדפוס של "דיון תכנוני" לפי סוג נושא
+
+| נושא | סדר ניתוח טיפוסי | רמת עומק |
+|------|-----------------|----------|
+| **חניה** | הוראות תכנית → תקנות חניה → נספח תנועה → חישוב → חלופות (קרן חניה, חפיפה, תחבורה ציבורית) | עמוק מאוד (8-15 סעיפים) |
+| **קווי בניין** | הוראת תכנית → סטייה ניכרת? (תקנה 2(19)) → מידתיות → פגיעה בשכנים | בינוני-עמוק (5-10 סעיפים) |
+| **גובה** | הוראת תכנית → נספח בינוי → מטרת ההגבלה → סטייה ניכרת? | בינוני (4-8 סעיפים) |
+| **ייעוד/שימוש** | פרשנות תכנית → היררכיית תכניות → פרשנות מהותית → יישום | עמוק מאוד (10-20 סעיפים) |
+| **שכנות** | עובדות (סיור) → השפעה (צל, פרטיות, רעש) → מידתיות | בינוני (3-6 סעיפים) |
+| **סביבה** | תכנית אב → אופי שכונה → מרקם → השתלבות | בינוני (3-5 סעיפים) |
+
+---
+
+## 4. דפוסים חוצי-החלטות
+
+### 4.1 מבנה הדיון — סדר הנושאים
+1. **שאלות סף** (אם יש) — סמכות, זכות ערר, שיהוי
+2. **הקשר תכנוני רחב** — תכניות, ייעוד, סביבה
+3. **ניתוח ענייני** — נושא אחר נושא, כל אחד ב-CREAC
+4. **מענה לטענות ספציפיות** — עובר על כל טענה מבלוק ז
+5. **מסקנה** — תוצאה + הוראות אופרטיביות
+
+### 4.2 כמה תכנון יש בכל החלטה?
+
+| דרגה | תיאור | החלטות |
+|------|-------|--------|
+| **כבד** (>50% תכנון) | הדיון הוא בעיקר תכנוני | פרומר, זעיתר, בית הכרם, תורן, לבנון |
+| **מאוזן** (30-50%) | שילוב תכנון + משפט | עמית, אמיתי, בר-און, אנשין-1096, אואקנין, לוי, שטרית |
+| **קל** (<30%) | בעיקר משפטי, תכנון מינימלי | בית שמש, אנשין-1109, יפה |
+| **אין** (0%) | רק משפטי/סמכות | טלי-אביב, הראל 1043+1054, גבאי, ירושלים שקופה |
+
+### 4.3 פסיקה חוזרת (Recurring Case Law)
+| פסיקה | נושא | מופיעה ב-X החלטות |
+|-------|------|-------------------|
+| הלכת שפר (עע"מ 317/10) | ערר על היתר תואם תכנית | 8 |
+| הלכת עייזן (בג"ץ 1578/90) | תימוכין קנייניים | 6 |
+| הלכת בן-יקר-גת | סטייה ניכרת | 4 |
+| ערר אדלר 1181/22 | שיקול דעת תמ"א 38 | 2 |
+| עע"מ 3975/22 קרן נכסים | קניין vs. תכנון | 4 |
+
+### 4.4 טכניקות ניתוח ייחודיות
+1. **פרשנות הרמונית** — כשיש מספר תכניות, דפנה מפרשת אותן ביחד (תורן)
+2. **בדיקת תקדימים עובדתית** — הוועדה בדקה בעצמה 3 נכסים שנטענו כתקדים (לבנון)
+3. **ציטוט מהחלטה מרכזת** — במקום לצטט 7 פס"ד, מצטטת אחד שריכז את כולם
+4. **מבחן "המגרש הריק"** — להכשרת בנייה קיימת (אמיתי)
+5. **מיפוי מתחים** — רשימת 3-6 מתחים לפני הניתוח (בית הכרם)
+6. **"למעלה מן הצורך"** — דיון obiter אחרי הכרעה בסף (עמית, בית שמש)
+
+---
+
+## 5. פערים שזוהו
+
+### 5.1 פער קריטי: אין החלטות היטל השבחה בקורפוס
+למרות שהמערכת מגדירה 3 סוגי עררים (רישוי, היטל השבחה, פיצויים) — **כל 24 ההחלטות הן רישוי ובנייה**. אין לנו אף מודל לכתיבת החלטה בהיטל השבחה.
+
+### 5.2 פער: לא כל נושא תכנוני מכוסה
+נושאים שמופיעים רק בהחלטה אחת-שתיים:
+- שימור → רק בית הכרם
+- תמ"א 38 → רק בית הכרם
+- שימוש חורג → רק תורן
+- טיפולוגיה/טופוגרפיה → רק זעיתר
+- תכנית אב כמסגרת → רק בית הכרם + תורן
+
+### 5.3 ~~פער: הפרומפט הנוכחי לא מכיל "צ'קליסט תוכן"~~ — **נסגר (2026-04-12)**
+נוספו:
+- ✅ צ'קליסטים תוכניים לפי סוג ערר (`lessons.py: CONTENT_CHECKLISTS`) — מוזרקים לפרומפט
+- ✅ מתודולוגיה אנליטית (`docs/decision-methodology.md`) — מלמדת איך לחשוב, לא רק מה לכסות
+- ✅ טיפול גמיש בטענות (bundle/skip דרך chair_directions)
+- ✅ בדיקת QA חדשה (methodology compliance)
+
+### 5.4 פער: הבחנה לא מספיקה בין תת-סוגי רישוי
+תיקי רישוי שונים מאוד זה מזה:
+- **סמכות/סף** — דיון משפטי טהור, אין צורך בתכנון
+- **קנייני** — תימוכין קנייניים, אין צורך בתכנון
+- **תכנוני מובהק** — ייעוד, חניה, גובה — דיון תכנוני מקיף
+- **שימוש חורג** — פרשנות תכניות, דיון תכנוני עמוק
+- **הקלה** — מידתיות + תכנון
+- **תמ"א 38** — איזון אינטרסים + תכנון
+
+---
+
+## 6. המלצות לשלב הבא
+
+### 6.1 צ'קליסט תוכן מוצע לערר רישוי ובנייה
+```
+בהתאם לנושא הערר, הדיון צריך לכלול:
+
+□ הקשר תכנוני רחב (תמיד כשהערר מגיע למריט):
+  - תכניות חלות (מקומית, מחוזית, ארצית — לפי הצורך)
+  - ייעוד הקרקע
+  - אופי הסביבה
+
+□ ניתוח הוראות תכנית (כשיש שאלה של התאמה/סטייה):
+  - ציטוט ישיר מהוראות רלוונטיות
+  - פרשנות — תכלית ההוראה
+  - יישום על המקרה
+
+□ חניה (כשרלוונטי):
+  - הוראות תכנית + נספח תנועה
+  - חישוב מקומות נדרשים vs. מסופקים
+  - חלופות (קרן חניה, חפיפה, תח"צ)
+
+□ שכנות/פגיעה (כשרלוונטי):
+  - ממצאי סיור
+  - צל, פרטיות, רעש, נוף
+  - מידתיות
+
+□ קווי בניין (כשרלוונטי):
+  - הוראת תכנית
+  - סטייה ניכרת — תקנה 2(19)
+  - הצדקה/מידתיות
+
+□ גובה/קומות (כשרלוונטי):
+  - הוראת תכנית + נספח בינוי
+  - מטרת ההגבלה
+  - סטייה ניכרת — תקנה 2(10)
+```
+
+### 6.2 הבחנה בין תת-סוגים
+הפרומפט צריך לזהות את סוג הערר ולהתאים את הצ'קליסט:
+- **ערר סמכות/סף** → ללא דיון תכנוני
+- **ערר קנייני** → דיון משפטי, ללא תכנון
+- **ערר מהותי** → דיון תכנוני מקיף + משפטי
+
+### 6.3 צורך דחוף: החלטות היטל השבחה
+צריך להוסיף לקורפוס לפחות 5-10 החלטות של היטל השבחה לפני שהמערכת יכולה לכתוב החלטות בתחום הזה.

docs/decision-methodology.md

@@ -0,0 +1,409 @@
+# מתודולוגיית כתיבת החלטות — מדריך אנליטי לוועדת ערר לתכנון ובניה
+
+מסמך זה מלמד כיצד לחשוב, לנתח ולבנות החלטה מנומקת. הוא אינו עוסק בסגנון הכתיבה של דפנה (ראה SKILL.md) ולא בנושאים שיש לכסות (ראה צ'קליסטים תוכניים). הוא עוסק בשיטה — כיצד להפוך חומרי מקור להנמקה משכנעת שתעמוד בביקורת שיפוטית.
+
+---
+
+## א. שלב מקדים — הבנת התיק לפני שנכתבת מילה
+
+### א.1 קרא הכל, סכם, ואז חשוב
+
+לפני שנכתב משפט אחד — קרא את כל חומרי המקור: כתב הערר, תגובת הוועדה המקומית, תגובת מבקשי ההיתר (אם יש), פרוטוקול הדיון, חוות דעת מומחים, ומסמכי תכנון רלוונטיים (תכנית, נספחים, החלטות ועדה מקומית).
+
+**מה לעשות:**
+- סמן את הטענות המרכזיות של כל צד. אל תסמוך על סיכום הצד — קרא את הנוסח המלא.
+- זהה מהן העובדות שאינן שנויות במחלוקת ומהן העובדות השנויות במחלוקת.
+- זהה את המסמכים הנורמטיביים הרלוונטיים (תכניות, חוקים, תקנות) וקרא אותם במלואם — לא רק את הסעיף הנטען. מילה בסעיף אחד מתפרשת לאור סעיפים אחרים באותו מסמך.
+
+### א.2 סווג את הערר
+
+סוג הערר קובע את מסגרת הניתוח:
+- **ערר רישוי (1xxx)**: שאלת שיקול דעת תכנוני; הוועדה מפעילה שיקול דעת עצמאי.
+- **ערר היטל השבחה (8xxx)**: שאלת שמאות ומשפט; ביקורת על שומה.
+- **ערר פיצויים — סעיף 197 (9xxx)**: דומה להיטל השבחה.
+
+הסיווג משפיע על תקן הביקורת, על עומק הדיון התכנוני, ועל טון ההחלטה.
+
+### א.3 נסח את השאלות לדיון — במילותיך
+
+הוועדה אינה כבולה לניסוח של עורכי הדין. אם העוררים העלו שמונה טענות אבל באמת יש שתי שאלות מרכזיות — נסח שתי שאלות. ניסוח הסוגיות הוא אבן הפינה של ההחלטה: הוא קובע אילו עובדות מהותיות ואילו כללים חלים.
+
+**מה לעשות:**
+- נסח כל שאלה כסילוגיזם מכווץ: הנחה משפטית, עובדות תמציתיות, שאלה חדה. לדוגמה: "תכנית X קובעת קו בניין של 3 מטרים. הבקשה כוללת בניה במרחק 1.5 מטרים מגבול המגרש. האם הבקשה תואמת את הוראות התכנית?"
+- ניסוח הסוגיות נכתב בגרסה סופית רק אחרי שהדיון מגובש — כדי לוודא שהשאלות תואמות את התשובות.
+
+**מבוסס על:** FJC Judicial Writing Manual §§A5-A7; Garner, Making Your Case §36; Posner — ניסוח סוגיות כאבן פינה.
+
+---
+
+## ב. ניתוח סף — מתי לבדוק, מתי לדלג
+
+### ב.1 שאלות סף תמיד קודמות
+
+אם עולה שאלת סמכות, מועד הגשה, או עמידה בתנאי מוקדם — היא נדונה ראשונה. הלוגיקה פשוטה: אם אין סמכות לדון, כל שאר הדיון מיותר.
+
+**מה לעשות:**
+- אם שאלת הסף נדחית (כלומר, הוועדה מוסמכת / הערר הוגש בזמן) — ציין זאת בפסקה אחת ועבור לגוף הערר.
+- אם שאלת הסף מתקבלת — ההחלטה מסתיימת בה. אין צורך לדון בגוף.
+- אל תדון בשאלת סף שלא הועלתה על ידי אף צד ושאין לה בסיס בחומר.
+
+### ב.2 ציון תקן הביקורת
+
+בפתיחת חלק הדיון, ציין את תקן הביקורת של הוועדה: "הוועדה מפעילה שיקול דעת תכנוני עצמאי" (ברישוי) או "הוועדה בוחנת את תקינות השומה המכרעת" (בהיטל השבחה). בלי ציון תקן — הקורא לא יודע באיזה סטנדרט נבחנה ההחלטה, והנימוק נשאר עמום.
+
+**מבוסס על:** FJC §B6; Posner — legalism works when the rule is clear.
+
+---
+
+## ג. סדר הסוגיות — מה קודם ולמה
+
+### ג.1 עקרון הסדר
+
+1. **שאלות סף** — תמיד ראשונות.
+2. **הסוגיה המכריעה** — מיד אחריהן. הסוגיה שמכריעה את הערר באה לפני סוגיות משניות.
+3. **סוגיות נוספות** — לפי חוזק ההנמקה. פתח בנימוק החזק ביותר. רושם ראשוני אי אפשר לבטל, ותשומת הלב של הקורא בשיאה בהתחלה.
+4. **סוגיות שנויות אך לא נחוצות** — בסוף, או בכלל לא.
+
+### ג.2 מתי לא לדון בטענה
+
+ההחלטה צריכה לדון רק בסוגיות שיש לפתור כדי להכריע. אם העורר העלה שמונה טענות אבל שתיים מכריעות — הדיון מתמקד בשתיים. את השאר ניתן לטפל כך:
+- טענה שהועלתה ברצינות אך אינה נחוצה: "טענה זו נבחנה על ידי הוועדה. נוכח מסקנתנו לעיל, אין צורך להכריע בה."
+- טענות חלשות או חוזרות: ניתן לקבץ. "באשר לטענות הנוספות שהעלו העוררים — לא מצאנו בהן ממש."
+- אל תתעלם לחלוטין מטענה מרכזית. הצד המפסיד חייב לראות שהוועדה שקלה את יסודות עמדתו.
+
+### ג.3 פסקת מפה
+
+בפתיחת הדיון, ספק מפת דרכים: "שלוש שאלות עומדות להכרעה: (1) האם הבקשה תואמת את הוראות התכנית לעניין קו הבניין; (2) האם ההקלה המבוקשת עומדת בתנאי סעיף 147; (3) מהו הסעד המתאים." הקורא יודע מראש מה לצפות, וההנמקה נתפסת כמאורגנת.
+
+**מבוסס על:** FJC §§B2-B5; Garner, MYC §§7, 12; LWPE §27; Posner — narrow holdings, focus on what matters.
+
+---
+
+## ד. בניית הניתוח — הלב של ההחלטה
+
+### ד.1 מבנה סילוגיסטי לכל סוגיה
+
+כל סוגיה נבנית כסילוגיזם:
+
+1. **הנחה עליונה (הכלל)** — סעיף בתכנית, הוראת חוק, הלכה פסוקה, או עיקרון תכנוני.
+2. **הנחה תחתונה (העובדות)** — העובדות הספציפיות של הערר שנבחנות לאור הכלל.
+3. **מסקנה** — התוצאה שנובעת בהכרח מהחלת הכלל על העובדות.
+
+זהו השלד. כל הנמקה שאינה ניתנת לפירוק למבנה זה — חסרה חוליה. אם לא ניתן לזהות את הכלל — ההנמקה אינה מספקת. אם לא ניתן לזהות כיצד העובדות מקיימות את הכלל — ההנמקה קריפטית.
+
+### ד.2 התחל מלשון הטקסט
+
+כשהמקרה נשלט על ידי הוראת תכנית או סעיף חוק — פתח תמיד בציטוט ההוראה. לא בפסיקה, לא בעקרון כללי. המילים של הטקסט הן נקודת המוצא.
+
+**מה לעשות:**
+- הבא את לשון ההוראה הרלוונטית (ציטוט ישיר, קצר ככל האפשר).
+- פרש מילים במשמעותן הרגילה.
+- בדוק עקביות עם הוראות אחרות באותה תכנית.
+- תן תוקף לכל מילה — מילה "מיותרת" בטקסט נורמטיבי אינה מיותרת.
+- אם יש עמימות — השתמש בכלי פרשנות: הכלל הכללי מצטמצם לאור הפרט; מילה מתפרשת לאור הקשרה; הכללת דבר אחד מרמזת על הדרת אחרים.
+
+### ד.3 שלושה מקורות להנחה העליונה
+
+בעררי תכנון, הכלל נשאב משלושה מקורות:
+- **טקסט**: הוראות התכנית, חוק התכנון והבניה, תקנות.
+- **תקדים**: פסיקת בתי משפט, החלטות ועדת ערר ארצית, החלטות ועדות ערר מחוזיות.
+- **מדיניות**: שיקולים תכנוניים — צפיפות, אופי סביבה, אינטרס ציבורי, השפעות כלכליות.
+
+בחר את המקור החזק ביותר. אם יש הוראת תכנית ברורה — אין צורך בפסיקה כדי לתמוך בה. פסיקה נדרשת כשהטקסט עמום או כשצריך לקבוע כיצד ליישם עיקרון כללי.
+
+### ד.4 ההנחה התחתונה היא המפתח
+
+ברוב העררים, הכלל המשפטי אינו שנוי במחלוקת. השאלה היא כיצד העובדות משתלבות בכלל. זהו לב ההחלטה. ההנמקה חייבת להראות בפירוט — לא בהכרזה — כיצד העובדות הספציפיות מקיימות או אינן מקיימות את תנאי הכלל.
+
+**מה לעשות:**
+- השתמש בנתונים: מספרים, מידות, אחוזים, תאריכים (כשרלוונטיים). "הבקשה חורגת ב-1.5 מטרים מקו הבניין" — לא "הבקשה חורגת באופן משמעותי."
+- הפרד בין ממצא עובדתי למסקנה משפטית. "הבניה במרחק 1.5 מטרים מגבול המגרש" — ממצא עובדתי. "חריגה זו עולה כדי סטייה ניכרת" — מסקנה משפטית. אל תערבב.
+- כל מעבר מכלל לעובדה למסקנה צריך להיות מפורש. לא לכתוב "העובדות מלמדות כי הערר אינו מוצדק" בלי לפרט למה.
+
+### ד.5 מבנה CREAC בפועל
+
+לכל סוגיה, השתמש במבנה הבא:
+
+1. **מסקנה** (Conclusion) — פתח בתשובה לשאלה. "הבקשה אינה תואמת את הוראות התכנית לעניין קו הבניין."
+2. **כלל** (Rule) — הבא את הכלל. ציטוט הוראת התכנית או ההלכה.
+3. **הרחבה** (Explanation) — אם הכלל דורש הבהרה, הבא תקדים רלוונטי אחד שמסביר כיצד הכלל יושם במקרה דומה.
+4. **יישום** (Application) — החל את הכלל על עובדות המקרה. כאן נמצא לב ההנמקה.
+5. **מסקנה חוזרת** (Conclusion) — סגור בתמצית. "לפיכך, הבקשה אינה עולה בקנה אחד עם הוראות התכנית."
+
+הפתיחה במסקנה חיונית: הקורא יודע לאן הדיון מוביל, וכל עובדה שנקראת אחר כך מובנת בהקשרה. עובדות ללא מסגרת — נתפסות כאקראיות וחסרות משמעות.
+
+**מבוסס על:** Garner, MYC §§22-27; FJC §§B1, B8; Posner — facts drive decisions; data over words; distinguish findings from conclusions.
+
+---
+
+## ה. איזון ומידתיות — מתי ואיך
+
+### ה.1 מתי נדרש איזון
+
+איזון נדרש כשהדין לא נותן תשובה חד-משמעית. כשהכלל ברור והעובדות מתאימות לו — אין צורך באיזון. אל תאזן כשאפשר להכריע לפי כלל. איזון הוא כלי לשעה שהכללים אוזלים, לא תחליף לניתוח נורמטיבי.
+
+### ה.2 מבנה האיזון
+
+כשאיזון נדרש, בנה אותו כך:
+
+1. **זהה את האינטרסים** — מהם האינטרסים המתחרים. לא "אינטרס הציבור" מול "אינטרס העורר" באופן מעורפל, אלא אינטרסים קונקרטיים: "זכות הקניין של העורר לבנות על מגרשו" מול "שמירה על אופי מגורים צמודי קרקע בשכונה."
+2. **בחן השלכות לכל כיוון** — מה קורה אם מקבלים? מה קורה אם דוחים? לא "מהו האינטרס החשוב יותר" אלא "מהן ההשלכות של כל תוצאה על כל אינטרס."
+3. **שקול השלכות מערכתיות** — לא רק תוצאה לתיק זה, אלא גם האות שנשלח למערכת התכנון. קבלת הערר תיצור תקדים? תפתח פתח לבקשות דומות?
+4. **הגע למסקנה** — ציין מפורשות מה מכריע את הכף ולמה.
+
+### ה.3 מידתיות כמבחן
+
+כשהוועדה מטילה מגבלה או תנאי — בדוק: (1) האם המגבלה משרתת תכלית ראויה; (2) האם יש אמצעי פוגע פחות; (3) האם הפגיעה מידתית ביחס לתועלת. שלושת השלבים צריכים להיות מפורשים בטקסט.
+
+**מבוסס על:** Posner — balance as methodology; systemic vs. case-specific consequences; pragmatist approach within legal norms.
+
+---
+
+## ו. טיפול בטענות — כללים מעשיים
+
+### ו.1 אל תהפוך את הדיון לוויכוח
+
+ההחלטה מנתחת שאלה — לא מתווכחת עם עורכי דין. המבנה הנכון הוא: שאלה → כלל → עובדות → מסקנה. לא: "העורר טוען X — אין לקבל טענה זו — שכן Y."
+
+הדיון לא מתנהל כ"תשובה לכתב הערר" אלא כניתוח עצמאי שבוחן את השאלות שהתעוררו. הוועדה מגיעה למסקנותיה מכוח הנימוק — לא מכוח דחיית טענות.
+
+### ו.2 Steel-manning — הצג את הטענה הטובה ביותר של הצד המפסיד
+
+לפני שדוחים טענה — הצג אותה בגרסה החזקה ביותר שלה. לא קריקטורה של הטענה, אלא הטענה כפי שעורך דין מוכשר היה מנסח אותה. אז הסבר למה היא נדחית.
+
+**למה זה חשוב:** טענת קש קלה להפריך, אבל הקורא (ובמיוחד בית המשפט בביקורת שיפוטית) יזהה שלא התמודדת עם הטענה האמיתית. הצגה הוגנת של הטענה ודחייתה — משכנעת. הצגה מעוותת — מחשידה.
+
+**מה לעשות:**
+- כשנדרשת התמודדות עם טענת העורר, כתוב: "אמנם צודק העורר כי [נקודה שפועלת לטובתו], אולם [הנימוק לדחייה]."
+- אם יש נקודה שאי אפשר להגן עליה — הכר בה בגלוי. "נכון כי המבנה הסמוך חורג מקו הבניין. אולם עובדה זו אינה מקנה זכות לחריגה נוספת, שכן..."
+- טענה חלשה שאין בה ממש — מספיק משפט אחד. אל תפזר זמן על טענות שאינן ראויות לדיון.
+
+### ו.3 מיקום ההתמודדות עם טענות נגדיות
+
+באמצע הדיון — לא בהתחלה ולא בסוף. המבנה המומלץ לכל סוגיה:
+1. הנחה משפטית (הכלל)
+2. יישום על העובדות
+3. מסקנה ראשונית
+4. **טענה נגדית + תשובה**
+5. **טענה נגדית נוספת + תשובה** (אם יש)
+6. נקודה תומכת נוספת
+7. משפט סיכום
+
+פתיחה בטענות הצד השני מציבה את ההחלטה בעמדת הגנה. סיום בהן משאיר את המוקד על הצד המפסיד. האמצע הוא המקום הנכון.
+
+### ו.4 קיבוץ טענות
+
+כשיש טענות רבות שמכוונות לאותה נקודה — קבץ אותן. "העוררים העלו מספר טענות הנוגעות לאופן חישוב השטחים. לאחר בחינתן, לא מצאנו בהן ממש, ונפרט." זה עדיף על טיפול נקודתי בכל טענה, שמייצר תחושה של רשימת מכולת ולא של ניתוח.
+
+**מבוסס על:** FJC §§B3-B4, E1-E2; Garner, MYC §§4, 8, 10-12; LWPE §30; Posner — honest engagement with counterarguments, avoid empty formulas.
+
+---
+
+## ז. ציטוטים ואזכורי פסיקה — פחות זה יותר
+
+### ז.1 טכניקת הסנדוויץ'
+
+כל ציטוט חייב להיות עטוף: משפט הקדמה → ציטוט → ניתוח.
+
+**הקדמה גרועה:** "בית המשפט קבע כדלקמן:" (ריקה מתוכן).
+**הקדמה טובה:** "בית המשפט קבע כי אין לקבל בקשות שהוגשו באיחור ללא טעם מיוחד:" (מודיעה על התוכן).
+
+אל תניח שהקורא יקרא ציטוט ארוך. סכם את עיקרו לפניו, ולאחריו הוסף ניתוח שמסביר כיצד הציטוט רלוונטי למקרה הנדון.
+
+### ז.2 כמה לצטט
+
+- **הוראת תכנית/חוק**: ציטוט ישיר — המילים המדויקות חשובות כי ההנמקה נבנית עליהן.
+- **הלכה פסוקה**: פרפרזה עדיפה. צטט ישירות רק כשהניסוח המקורי עושה נקודה שלא ניתן לבטא בפרפרזה. 1-2 משפטים לכל היותר.
+- **כלל מוסדר**: מקור אחד מספיק. לא מחרוזות של "ראו: X; Y; Z; A; B." מחרוזת אזכורים אינה מוסיפה כוח — היא מעידה על חוסר ביטחון.
+- **כלל חדש או שנוי במחלוקת**: כאן כן יש מקום לסקירת ההתפתחות בפסיקה, אבל ממוקדת ותכליתית.
+
+### ז.3 היררכיית תקדימים
+
+בעררי תכנון, סדר המשקל הוא:
+1. פסיקת בית המשפט העליון
+2. פסיקת בית משפט לעניינים מנהליים
+3. החלטות ועדת ערר ארצית
+4. החלטות ועדות ערר מחוזיות אחרות
+5. ספרות משפטית/תכנונית
+
+העדף תקדים עדכני. כשמאזכרים תקדים — ציין בדיוק מה נפסק ואם מדובר בהלכה מחייבת או אמרת אגב. אם התקדים שונה מהמקרה הנדון — אמור זאת במפורש.
+
+### ז.4 הפניות ביבליוגרפיות
+
+שלב את שם בית המשפט ושם התיק בגוף הטקסט ("כפי שקבע בית המשפט העליון בפרשת אליאב") והעבר את ההפניה המספרית להערת שוליים. הפניות בגוף הטקסט שוברות את מהלך המחשבה.
+
+**מבוסס על:** FJC §§D1-D5; Garner, MYC §§26-27, 48, 50; LWPE §§28-29.
+
+---
+
+## ח. כתיבת חלק העובדות — ניטרלי, ממוקד, מדויק
+
+### ח.1 רק עובדות הנחוצות להסברת ההחלטה
+
+כל עובדה שמופיעה — הקורא יניח שהיא רלוונטית. אם היא לא רלוונטית — היא מסיחה דעת. אם היא רלוונטית ולא מופיעה — ההנמקה חסרה בסיס.
+
+**מה לעשות:**
+- כלול רק עובדות שמשמשות בדיון. מבחן: לכל עובדה בחלק הרקע, שאל — "האם אני מפנה לעובדה זו בחלק הדיון?" אם לא — שקול להסיר.
+- תאריכים מדויקים רק כשהם מהותיים (מועד הגשה, תוקף תכנית, שאלת שיהוי). אחרת — "כחודש לאחר מכן", "בתחילת 2023."
+- פרטים "מעניינים" שאינם רלוונטיים — השמט. היסטוריה של השכונה, נוף, תיאורים ציוריים — רק אם רלוונטיים להחלטה.
+
+### ח.2 ניטרליות מוחלטת
+
+חלק העובדות אינו טוען. אין בו מילות שיפוט ("למרבה הפליאה", "באופן מפתיע"). אין בו ציטוטים מצדדים (ציטוטים שייכים לחלק הטענות). הוא מציג עובדות — לא מפרש אותן.
+
+אבל ניטרליות אינה הסתרה. אם יש עובדה שתומכת בצד המפסיד — היא חייבת להופיע. רקע ניטרלי כולל את כל העובדות המהותיות, לא רק את אלה שתומכות בתוצאה.
+
+### ח.3 מבנה: סדר כרונולוגי, עובדות כלליות ואז ספציפיות
+
+עקוב אחר ציר הזמן: הנכס, הבקשה, ההחלטה, הערר. אל תפתח בהחלטת הוועדה המקומית ואז תחזור לתיאור הנכס.
+
+בתיקים רב-סוגייתיים — הגבל את חלק הרקע לעובדות כלליות ושלב עובדות ספציפיות בדיון בכל סוגיה. זה מונע כפילות ושומר על רלוונטיות.
+
+### ח.4 דיוק מוחלט
+
+אל תסמוך על עובדות כפי שמוצגות בכתבי הטענות. בדוק מול חומרי המקור (פרוטוקולים, תכניות, תצהירים). שגיאה עובדתית היא הדבר המזיק ביותר שיכול לקרות להחלטה — היא מערערת את סמכותה ופוגעת באמינותה.
+
+**מבוסס על:** FJC §§C1-C6; Garner, LWPE §§3, 17, 23; MYC §36; Posner — data over words, facts drive decisions.
+
+---
+
+## ט. כתיבת חלק ההכרעה — ברור ואופרטיבי
+
+### ט.1 התוצאה חייבת להיות חד-משמעית
+
+"הערר נדחה." "הערר מתקבל." "הערר מתקבל בחלקו." לא "לאור כל האמור לעיל, הערר נדחה" — אלא סיכום קצר (2-3 משפטים) שמסביר את עיקר ההנמקה, ואז התוצאה.
+
+### ט.2 הוראות אופרטיביות מפורטות
+
+כשהערר מוחזר לוועדה המקומית — אל תדבר בחידות. "הערר מוחזר לוועדה המקומית לצורך דיון מחדש" — אינו מספיק. פרט: מה צריכה הוועדה המקומית לבחון? לפי איזו תכנית? האם לתת שימוע? מהם השיקולים שיש לשקול?
+
+כשנקבעים תנאים — פרט כל תנאי באופן שהגוף המבצע יוכל ליישם בלי לפרש את ההחלטה.
+
+### ט.3 שמירה על סמכות הערכאה הנמוכה
+
+גם כשנמצא פגם בשיקול הדעת — ההחלטה מחזירה את העניין לוועדה המקומית כדי שתפעיל שיקול דעת מחדש. אל תכפה תוצאה ספציפית אלא אם הדין מחייב תוצאה אחת בלבד.
+
+### ט.4 התייחסות לוועדה המקומית — ללא ביקורת מיותרת
+
+כשהערר מתקבל — הוועדה המקומית טעתה. אבל ההנמקה מתמקדת ב"מה צריך להיות" — לא ב"כמה טעתה הוועדה המקומית." אין "באופן מפתיע", "למרבה הפליאה", "שגתה שגיאה חמורה". נמק את הפגם — אל תבקר את השופט.
+
+**מבוסס על:** FJC §§E4, F1-F3; Garner, MYC §21; Posner — narrow holdings, constrained pragmatism.
+
+---
+
+## י. טכניקות כתיבה — ברמת הפסקה והמשפט
+
+### י.1 משפט נושא בפתיחת כל פסקה
+
+כל פסקה נפתחת במשפט שמודיע על הנקודה המרכזית שלה. לא באזכור פסק דין, לא בהפניה, לא בתיאור רקע. הנקודה — ואז התמיכה.
+
+**לא:** "בעע"מ 1234/05 נקבע כי..." → הקורא לא יודע למה הוא קורא על פסק הדין הזה.
+**כן:** "ועדת ערר אינה מוסמכת להתערב בשיקול דעת מקצועי של מהנדס העיר. כך נפסק ב..." → הקורא יודע את הנקודה, ופסק הדין תומך בה.
+
+### י.2 גשרים בין פסקאות
+
+כל פסקה חייבה להיות מחוברת לקודמתה. שלושה כלים:
+- **מילות קישור מפורשות**: לפיכך, אולם, בנוסף, מנגד, אכן, עם זאת.
+- **מילות הצבעה**: "בעניין זה", "נוכח קביעה זו", "מעבר לכך".
+- **הדי הפסקה הקודמת**: חזרה על מונח מפתח מהפסקה הקודמת בפתיחת הפסקה הנוכחית.
+
+### י.3 פסקה אחת — נקודה אחת
+
+אם פסקה עוסקת גם בכלל המשפטי, גם ביישומו, וגם בטענה נגדית — חלק אותה. הפסקה היא יחידת החשיבה הבסיסית, ויחידה שמכילה שני רעיונות שונים — מבלבלת.
+
+### י.4 כותרות אינפורמטיביות (כשמתאים)
+
+כשיש כותרות משנה בדיון (בתיקים מורכבים עם סוגיות נפרדות) — כתוב כותרת שמודיעה על המסקנה, לא רק על הנושא.
+- **לא:** "סוגיית קו הבניין"
+- **כן:** "הבנייה בקו אפס אינה עולה בקנה אחד עם הוראות התכנית"
+
+### י.5 בניין פעיל
+
+"הוועדה המקומית דחתה את הבקשה" — לא "הבקשה נדחתה על ידי הוועדה המקומית." בניין פעיל קצר יותר, ברור יותר, ומזהה את הפועל. חריג: כשהפעולה חשובה יותר מהפועל ("ההיתר בוטל" — כשלא חשוב מי ביטל).
+
+### י.6 דיוק ומשמעת לשונית
+
+- **עקביות מינוחית**: אם כתבת "היתר בנייה" — אל תעבור ל"רישיון בנייה." עקביות חשובה מגיוון.
+- **לא להגזים**: "הפסיקה חד-משמעית" — רק אם היא באמת חד-משמעית. "אין כל ספק" — רק אם באמת אין. הגזמה מערערת אמינות.
+- **לא לנפח**: "במידה ו-" → "אם". "לאור העובדה ש-" → "מכיוון ש-". "על מנת ש-" → "כדי ש-". כל מילה שאינה עוזרת — מפריעה.
+- **לא לכפול**: "לבטל ולהפקיע" → "לבטל". אם מילה אחת מספיקה — מילה שנייה מחייבת את הקורא לחפש הבדל שאינו קיים.
+- **סיום חזק**: אל תסיים משפט בתאריך או בהפניה אלא אם הם חשובים. המילה האחרונה במשפט היא זו שנשארת.
+
+### י.7 כנות לגבי קושי
+
+כשהמקרה קשה — אמור זאת. "הדבר אינו נקי מספקות, אולם..." עדיף על פני הצגת מקרה קשה כקל. כנות לגבי הקושי מחזקת את אמינות ההחלטה — הקורא מבין שהוועדה התלבטה ובכל זאת הגיעה למסקנה מנומקת.
+
+אבל — ההחלטה משקפת רק את התוצאה הסופית. לא לתעד כל צעד ומעד בדרך, לא להציג שני מסלולי חשיבה חלופיים. אם ההחלטה קשה — ניתן לומר זאת, ואז להציג את ההנמקה הסופית בביטחון.
+
+### י.8 הימנעות מנוסחאות ריקות
+
+כל משפט חייב לעשות עבודה. "לאחר ששקלנו את כלל השיקולים הרלוונטיים" — ריק. מה שקלתם? "בעניין זה יש לומר" — ריק. אמור מה יש לומר בלי ההקדמה. "הננו סבורים" — ריק. כתוב את מה שאתה סבור, בלי להכריז שאתה סבור.
+
+מבחן: אם מוחקים את המשפט וההחלטה לא מאבדת מידע — המשפט מיותר.
+
+**מבוסס על:** FJC §§G1-G6; Garner, LWPE §§5-17, 24-26; MYC §§6, 35, 39, 43; Posner — avoid empty formulas, candor about uncertainty.
+
+---
+
+## יא. אנלוגיה ותקדים — מתי ואיך
+
+### יא.1 אנלוגיה דורשת הסבר מדיניות
+
+"מקרה זה דומה לפרשת X" — ריק, אלא אם מסביר למה הדמיון רלוונטי. מה המדיניות שעמדה בבסיס ההחלטה ב-X? האם אותה מדיניות חלה כאן?
+
+**מה לעשות:**
+- כשמפנים לתקדים, ציין: (1) מה נפסק שם; (2) מה הנסיבות הדומות; (3) למה הרציונל חל גם כאן.
+- כשמבחינים מתקדים: (1) מה שונה; (2) למה ההבדל משמעותי.
+
+### יא.2 החזקות חלופיות — "אף בהנחה"
+
+הימנע מ"אף בהנחה שצודקים העוררים בטענתם..." ו"גם אם היינו מקבלים..." — הם מחלישים את ההחזקה העיקרית. אם יש שני נימוקים — דון בנימוק המשני קודם ואז הצג את הנימוק העיקרי. כך שני הנימוקים עומדים בזכות עצמם, בלי שאחד מערער את השני.
+
+**מבוסס על:** FJC §B7; Garner, MYC §§26, 48; Posner — analogy requires policy analysis, narrow holdings.
+
+---
+
+## יב. עריכה — רשימת ביקורת
+
+לפני סיום ההחלטה, בצע את הבדיקות הבאות:
+
+### ביקורת מבנית
+- [ ] המבוא מכסה את כל הסוגיות שנדונו בהחלטה
+- [ ] כל עובדה בחלק הרקע מופיעה בדיון (אין עובדות "יתומות")
+- [ ] כל קביעה בדיון מבוססת על עובדה מחלק הרקע (אין עובדות חדשות בדיון)
+- [ ] סדר הסוגיות לוגי: סף → מכריע → משני
+- [ ] המסקנה נובעת מהדיון — לא מכריזה תוצאה שלא נומקה
+
+### ביקורת אנליטית
+- [ ] לכל סוגיה — ניתן לזהות כלל + עובדות + מסקנה (מבנה סילוגיסטי)
+- [ ] הממצאים העובדתיים מופרדים מהמסקנות המשפטיות
+- [ ] הטענה המרכזית של הצד המפסיד קיבלה מענה מנומק
+- [ ] אין "נוסחאות ריקות" — כל משפט עושה עבודה
+- [ ] אין הגזמה — "חד-משמעי", "ברי", "ללא ספק" רק כשמוצדקים
+
+### ביקורת עקביות
+- [ ] התוצאה בבלוק יא/יב תואמת את הסיכום בבלוק א/ב
+- [ ] מינוח עקבי לאורך כל ההחלטה (אותם מונחים לאותם מושגים)
+- [ ] הציטוטים מדויקים ובהקשרם
+- [ ] אזכורי פסיקה נכונים (לא מייחסים לפסק דין יותר ממה שאמר)
+
+**מבוסס על:** FJC §§G8-G10; Garner, MYC §6; Posner — precision, intellectual honesty.
+
+---
+
+## סיכום — עשרת העקרונות המנחים
+
+1. **סילוגיזם תמיד**: כלל → עובדות → מסקנה. אין קיצורי דרך.
+2. **התחל מהטקסט**: הוראת תכנית או חוק — לפני פסיקה, לפני עקרונות כלליים.
+3. **עובדות מכריעות**: רוב המקרים מוכרעים על ידי העובדות, לא על ידי הדין.
+4. **נתונים, לא תיאורים**: מספרים ומידות — לא "משמעותי", "ניכר", "מהותי."
+5. **Steel-man**: הצג את הטענה הטובה ביותר של הצד המפסיד — ואז הסבר למה היא נדחית.
+6. **כנות**: מקרה קשה — אמור שהוא קשה. אל תעמיד פנים שקל.
+7. **כל מילה עובדת**: נוסחה ריקה, מילה מנופחת, כפילות — מחק.
+8. **מסקנה קודם**: הקורא יודע לאן הדיון מוביל — העובדות מובנות בהקשרן.
+9. **מקור אחד מספיק**: לנקודה מוסדרת — אזכור אחד. מחרוזות אזכורים = חולשה.
+10. **הוראות ברורות**: הצד שמקבל את ההחלטה חייב לדעת בדיוק מה נדרש ממנו.
+
+---
+
+*מסמך זה מבוסס על שלושה מקורות מרכזיים: (1) Federal Judicial Center, Judicial Writing Manual (1991, 2020); (2) Garner, Legal Writing in Plain English (2001) ו-Scalia & Garner, Making Your Case (2008); (3) Posner, How Judges Think (2008). העקרונות סונתזו והותאמו להקשר של ועדת ערר לתכנון ובניה בישראל.*

docs/fjc-principles-extraction.md

@@ -0,0 +1,610 @@
+# עקרונות כתיבת החלטות מעין-שיפוטיות — מיצוי מתוך Judicial Writing Manual (FJC)
+
+מקורות:
+- **מהדורה ראשונה (1991)** — Judicial Writing Manual, Federal Judicial Center
+- **מהדורה שנייה (2020)** — Judicial Writing Manual: A Pocket Guide for Judges, Second Edition
+
+---
+
+## A. מבנה כולל של ההחלטה — מה קודם, מה אחרון, רצף
+
+### A1. חמישה מרכיבים חובה בהחלטה מלאה
+
+**העיקרון:** החלטה מלאה חייבת לכלול חמישה אלמנטים בסדר הבא: (1) מבוא — טבע התיק ומצבו הפרוצדורלי; (2) ניסוח הסוגיות; (3) תיאור העובדות המהותיות; (4) דיון בעקרונות המשפטיים וביישומם; (5) התוצאה האופרטיבית וההוראות.
+
+> "A full-dress opinion should contain five elements: (1) an introductory statement of the nature and procedural posture of the case; (2) a statement of the issues to be decided; (3) a description of the material facts; (4) a discussion of the governing legal principles and the resolution of the issues; and (5) the disposition and necessary instructions."
+> — 1991, עמ' 13; 2020, עמ' 13
+
+**יישום לוועדת ערר:** מתאים ישירות לארכיטקטורת 12 הבלוקים — בלוקים א-ג (מבוא/פרוצדורה), ד-ה (סוגיות), ו (עובדות), ז-י (דיון), יא-יב (תוצאה).
+
+---
+
+### A2. כותרות וכותרות-משנה — חובה
+
+**העיקרון:** יש להשתמש בכותרות, כותרות-משנה, ומספור כדי לחשוף את ארגון ההחלטה לקורא. זה חיוני במיוחד כשההחלטה ארוכה והנושא מורכב.
+
+> "The use of headings and subheadings, Roman numerals, or other means of disclosing the organization to the reader is always helpful, particularly where the opinion is long and the subject matter complex. These not only provide road signs for the reader, they also help to organize the writer's thoughts and test the logic of the opinion."
+> — 1991, עמ' 13; 2020, עמ' 13
+
+**יישום לוועדת ערר:** כל בלוק מקבל כותרת ברורה. בתוך בלוק הדיון (י) — כותרות-משנה לכל סוגיה. מאפשר לצדדים ולבית המשפט לנווט בהחלטה.
+
+---
+
+### A3. מבוא — מכוון את הקורא
+
+**העיקרון:** מטרת המבוא היא לכוון (orient) את הקורא. הוא צריך לציין בקצרה: מהו התיק, מה הנושא המשפטי, ומה התוצאה. בנוסף, יש לזהות את הצדדים (רצוי בשם ולא בתואר פרוצדורלי), לתאר את המצב הפרוצדורלי, ולציין את הסוגיות.
+
+> "The purpose of the introduction is to orient the reader to the case. It should state briefly what the case is about, the legal subject matter, and the result."
+> — 1991, עמ' 13; 2020, עמ' 13
+
+> "The parties should be identified, if not in the introduction then early in the opinion, preferably by name, and that identification should be used consistently throughout. The use of legal descriptions, such as 'appellant' and 'appellee,' tends to confuse, especially in multi-party cases."
+> — 1991, עמ' 13; 2020, עמ' 13-14
+
+**יישום לוועדת ערר:** בבלוק א — זיהוי הצדדים בשם (לא "העורר" ו"המשיבה" בלבד). ציון סוג הערר, נושאו, ותוצאתו כבר בפתיחה. שימוש עקבי באותו זיהוי לאורך כל ההחלטה.
+
+---
+
+### A4. סיכום ההחזקה בתחילת ההחלטה
+
+**העיקרון:** סיכום התוצאה כבר בפתיחה חוסך זמן לקוראים, ומאלץ את הכותב לנסח את ההחזקה בדיוק ובתמציתיות. הגרסה הסופית של המבוא כדאי שתיכתב אחרי השלמת ההחלטה כולה.
+
+> "Summarizing the holding at the outset can save time for readers, particularly researchers who will be able to determine immediately whether to read the rest of the opinion. Providing a terse summary of the holding at the start of the opinion also helps the writer to state it precisely and succinctly. The final version of the introduction may be best written after the opinion is completed."
+> — 1991, עמ' 13; 2020, עמ' 14
+
+**יישום לוועדת ערר:** בבלוק א לכתוב: "הערר נדחה/מתקבל" + משפט אחד על הנימוק המרכזי. המבוא נכתב אחרון (אחרי שהדיון מגובש).
+
+---
+
+### A5. ניסוח הסוגיות — אבן הפינה
+
+**העיקרון:** ניסוח הסוגיות הוא אבן הפינה של ההחלטה. הוא קובע אילו עובדות הן מהותיות ואילו עקרונות משפטיים חלים. השופט לא כבול לניסוח של עורכי הדין — עליו לנסח את הסוגיות כפי שהוא רואה אותן.
+
+> "The statement of issues is the cornerstone of the opinion; how the issues are formulated determines which facts are material and what legal principles govern. Judges should not be prisoners of the attorneys' analysis; they should frame the issues as they see them."
+> — 1991, עמ' 14; 2020, עמ' 14
+
+**יישום לוועדת ערר:** בלוקים ד-ה — הוועדה מנסחת את השאלות לדיון במילותיה, לא בניסוח העוררים. אם העוררים הגדירו שלוש שאלות אבל באמת יש שאלה מרכזית אחת — הוועדה מנסחת שאלה אחת.
+
+---
+
+### A6. סוגיות לפני/אחרי עובדות — גמישות
+
+**העיקרון:** ניסוח הסוגיות יכול לבוא לפני או אחרי תיאור העובדות. הצבת הסוגיות קודם הופכת את תיאור העובדות למשמעותי יותר ומסייעת להתמקד בעובדות המהותיות. אך לפעמים לא ניתן לנסח את הסוגיה ללא שהקורא מכיר את העובדות.
+
+> "Stating the issues first will make the fact statement more meaningful to the reader and help focus on material facts."
+> — 1991, עמ' 14; 2020, עמ' 14
+
+**יישום לוועדת ערר:** בארכיטקטורת 12 הבלוקים — בלוק ה (סוגיות) בא לפני בלוק ו (רקע עובדתי). זה מתאים לעיקרון.
+
+---
+
+### A7. ניסוח סוגיות ≠ פירוט טענות הצדדים
+
+**העיקרון:** יש להפריד בין ניסוח הסוגיות לבין פירוט טענות הצדדים. פירוטים ארוכים של טענות אינם תחליף לניתוח ולנימוק, ויש להימנע מהם.
+
+> "The statement of issues should not be confused with recitals of the parties' contentions. Lengthy statements of the parties' contentions, occasionally found in opinions, are not a substitute for analysis and reasoning and should be avoided."
+> — 1991, עמ' 14-15; 2020, עמ' 14
+
+**יישום לוועדת ערר:** בלוקים ז-ח (טענות הצדדים) הם נפרדים מבלוק ה (סוגיות). בלוק ה קצר וממוקד; בלוקים ז-ח מפרטים את הטענות; בלוק י מנתח — ולא חוזר על הטענות.
+
+---
+
+### A8. ההחלטה משקפת רק את התוצאה הסופית
+
+**העיקרון:** הכתיבה צריכה לשקף רק את ההחלטה הסופית ואת הנימוקים שלה. כשההחלטה קשה — יש לומר זאת, אבל לא לתעד כל צעד ומעד בדרך.
+
+> "The writing should reflect only the final decision and the reasons for it. Where the decision is a close one, the opinion should say so, but it should not record every step and misstep the writer took along the way."
+> — 1991, עמ' 10; 2020, עמ' 9
+
+**יישום לוועדת ערר:** הדיון בבלוק י לא מתעד את התלבטויות הוועדה. אם ההחלטה קשה — ניתן לכתוב "הדבר אינו נקי מספקות, אולם..." ולהמשיך בנימוק ברור לתוצאה.
+
+---
+
+## B. כתיבת חלק הדיון/ניתוח — לב ההחלטה
+
+### B1. הדיון חייב להיות מבוסס על היגיון ולוגיקה, לא על טיעון
+
+**העיקרון:** חלק הדיון הוא לב ההחלטה. הוא חייב להדגים שמסקנת בית המשפט מבוססת על שכל ישר ולוגיקה. הוא צריך לשכנע את הקורא בכוח הנימוק — לא באמצעות סנגוריה או טיעון.
+
+> "The discussion of legal principles is the heart of the opinion. It must demonstrate that the court's conclusion is based on reason and logic. It should persuade the reader of the correctness of the result by the power of its reasoning, not by advocacy or argument."
+> — 1991, עמ' 16; 2020, עמ' 16
+
+**יישום לוועדת ערר:** בלוק י — הדיון לא "טוען" בעד התוצאה אלא בונה שרשרת נימוקים: כלל → עובדות → מסקנה. הטון ניטרלי-אנליטי, לא אדברסרי.
+
+---
+
+### B2. סוגיות מכריעות קודם
+
+**העיקרון:** ככלל, סוגיות מכריעות (dispositive) צריכות להידון ראשונות. הסדר ייקבע על-ידי הלוגיקה של הנימוק. סוגיות שאינן מכריעות — אם בכלל נדונות — באות בסוף.
+
+> "Generally, dispositive issues should be discussed first. The order in which those issues are taken up will be governed by the opinion's reasoning. If non-dispositive issues are addressed at all — for educational reasons or to guide further proceedings — discuss them near the end of the opinion."
+> — 1991, עמ' 16-17; 2020, עמ' 16-17
+
+**יישום לוועדת ערר:** אם יש טענת סף (אי-עמידה בתנאי, איחור) — נדונה קודם. אם נדחית, ממשיכים לגוף הערר. בתוך הדיון — הסוגיה שמכריעה את הערר קודמת.
+
+---
+
+### B3. לא לדון בכל מה שהצדדים העלו
+
+**העיקרון:** ככלל, ההחלטה צריכה לדון רק בסוגיות שיש לפתור כדי להכריע בתיק. מה שהוועדה אינה צריכה להכריע — לא צריך לדון בו. אם הערכאה מגלה שסוגיה שהצדדים לא העלו היא מכריעה — עליה להודיע לצדדים ולאפשר להם לטעון.
+
+> "An opinion should not range beyond the issues presented; it should address only the issues that need to be resolved to decide the case."
+> — 1991, עמ' 17; 2020, עמ' 17
+
+**יישום לוועדת ערר:** אם העורר העלה 8 טענות אבל 2 מכריעות — הדיון מתמקד ב-2. את השאר ניתן לציין בקצרה ("אין צורך להכריע בשאר הטענות" או "טענה זו נבחנה ונמצא כי אין בה ממש").
+
+---
+
+### B4. סוגיות שאינן נחוצות — מספיק להראות שנשקלו
+
+**העיקרון:** סוגיות שאינן נחוצות להכרעה אך הצד המפסיד הציגן ברצינות — יש לדון בהן רק במידה הנדרשת כדי להראות שנשקלו. הקו בין מה שנחוץ למה שלא — לא תמיד ברור.
+
+> "Issues not necessary to the decision but seriously urged by the losing party should be discussed only to the extent necessary to show that they have been considered."
+> — 1991, עמ' 17; 2020, עמ' 17
+
+**יישום לוועדת ערר:** טענה שהועלתה בכובד ראש אך אינה מכריעה — משפט עד פסקה. "טענה זו נבחנה על ידי הוועדה. נוכח מסקנתנו לעיל, אין צורך להכריע בה." או דיון קצר שמראה שהטענה נשקלה.
+
+---
+
+### B5. שיקולי יעילות — מתי לדון במה שלא חייבים
+
+**העיקרון:** לפעמים שיקולי יעילות מצדיקים דיון בסוגיות שאינן נחוצות להכרעה — למשל, לתת הנחיות לערכאה הנמוכה בהחזרה. אך יש להיזהר מלהכריע בסוגיות שלא בפני הערכאה ומלתת חוות דעת מייעצות.
+
+> "Considerations of economy and efficiency may argue in favor of addressing issues not necessary to the decision if the court can thereby provide useful guidance for the lower court on remand. In doing so, however, judges must be careful not to prejudge issues that are not before them and to avoid advisory opinions."
+> — 1991, עמ' 17; 2020, עמ' 17
+
+**יישום לוועדת ערר:** כשהערר מוחזר לוועדה המקומית — כדאי לתת הנחיות ברורות ("על הוועדה המקומית לבחון..." / "יש לשקול..."). אך לא להכריע בשאלות שלא נטענו.
+
+---
+
+### B6. הקדמת תקן הביקורת
+
+**העיקרון:** ההחלטה צריכה לציין את תקן הביקורת (standard of review) בתחילת חלק הדיון. בלי זה — משמעות ההחלטה עלולה להיות עמומה. ציון התקן גם ממשמע את הניתוח.
+
+> "The opinion should specify the controlling standard of review at the outset of the discussion of legal principles. Unless the reader is told whether review is under the de novo, the clearly erroneous, or the abuse of discretion standard, the meaning of the decision may be obscure."
+> — 1991, עמ' 16; 2020, עמ' 16
+
+**יישום לוועדת ערר:** בבלוק ט או תחילת בלוק י — ציון סמכות הוועדה ותקן הביקורת: "הוועדה רשאית להפעיל שיקול דעת עצמאי / הוועדה בוחנת את שיקול הדעת של הוועדה המקומית / ביקורת שיפוטית על שומה מכרעת" וכו'.
+
+---
+
+### B7. החזקות חלופיות — "גם אם" / "אף בהנחה"
+
+**העיקרון:** ציון עילות נפרדות ועצמאיות להחלטה מחזק את ההחלטה אך מחליש את ערכה כתקדים. יש להימנע מ"גם אם" ו"בהנחת ארגומנדו" כי הם מערערים את סמכות ההחזקה. אלטרנטיבה: לטפל בעילה החלופית קודם ולציין את העילה העיקרית אחרונה.
+
+> "Stating separate and independent grounds for a decision adds strength to the decision but diminishes its value as a precedent. Statements such as 'even if the facts were otherwise' or 'assuming arguendo that we had not concluded thus and so' undermine the authority of the holding."
+> — 1991, עמ' 17; 2020, עמ' 17
+
+> "Witkin suggests either limiting the 'even if' approach to situations where it is necessary to achieve a majority decision, or avoiding it completely by phrasing the opinion in such a manner that the alternative assumption is disposed of first and the substantial ground of the opinion stated last."
+> — 1991, עמ' 17; 2020, עמ' 17
+
+**יישום לוועדת ערר:** במקום לכתוב "גם אם היינו מקבלים את טענת העורר..." — עדיף לסדר את הדיון כך שהעילה המשנית נדונה קודם ונדחית, ואז העילה העיקרית מובאת כבסיס מוצק. אם בכל זאת משתמשים ב"אף בהנחה" — רק כשזה מחזק את ההחלטה משמעותית.
+
+---
+
+### B8. הניתוח לא יהיה קריפטי
+
+**העיקרון:** אמנם תמציתיות רצויה, אבל השופט חייב לפרט את הנימוקים במידה מספקת כדי שהקורא יוכל לעקוב. החלטה שמדלגת על צעדים בנימוק — לא משיגה את מטרותיה.
+
+> "While brevity is desirable, judges must elaborate their reasoning sufficiently so that the reader can follow. An opinion that omits steps in the reasoning essential to understanding will fail to serve its purposes."
+> — 1991, עמ' 22; 2020, עמ' 22
+
+**יישום לוועדת ערר:** בלוק י — כל מעבר מכלל לעובדה למסקנה צריך להיות מפורש. לא לכתוב "העובדות מלמדות כי הערר אינו מוצדק" בלי לפרט למה.
+
+---
+
+## C. טיפול בעובדות
+
+### C1. רק עובדות הנחוצות להסברת ההחלטה
+
+**העיקרון:** יש לכלול רק את העובדות הנחוצות להסברת ההחלטה. עם זאת, מה שנחוץ אינו תמיד מובן מאליו ותלוי בקהל היעד.
+
+> "Only the facts that are necessary to explain the decision should be included, but what is necessary to explain the decision is not always obvious and may also vary depending on the audience."
+> — 1991, עמ' 15; 2020, עמ' 15
+
+**יישום לוועדת ערר:** בלוק ו — עובדות רלוונטיות בלבד. לא לפרט את כל תולדות המקרקעין אם רק עניין אחד רלוונטי. אבל "מבחן השופט" — לשופט שלא מכיר את התיק צריך לתת מספיק רקע.
+
+---
+
+### C2. פרטי עובדות מיותרים מסיחים דעת
+
+**העיקרון:** פרטים עובדתיים מיותרים מסיחים דעת. תאריכים, למשל, נוטים לבלבל ואין לכלול אותם אלא אם הם מהותיים להחלטה.
+
+> "Excessive factual detail can be distracting. Dates, for example, tend to confuse and should not be included unless material to the decision or helpful to its understanding."
+> — 1991, עמ' 15; 2020, עמ' 15
+
+**יישום לוועדת ערר:** בבלוק ו — לא לכתוב "ביום 15.3.2024 הגיש העורר בקשה, וביום 22.4.2024 הוועדה המקומית דנה, וביום 3.5.2024 ניתנה החלטה..." אלא אם הזמנים מהותיים (למשל, שאלת איחור).
+
+---
+
+### C3. עובדות הצד המפסיד — אסור להתעלם
+
+**העיקרון:** תמציתיות ופשטות רצויים, אך הם משניים לצורך בהצגה מלאה והוגנת. אין להתעלם מעובדות משמעותיות שתומכות בצד המפסיד.
+
+> "While brevity and simplicity are always desirable, they are secondary to the need for a full and fair statement. Facts significant to the losing side should not be ignored."
+> — 1991, עמ' 15; 2020, עמ' 15
+
+**יישום לוועדת ערר:** בבלוק ו — אם יש עובדה שתומכת בטענת העורר שנדחה, היא חייבת להופיע. רקע ניטרלי = כולל את הכול, לא רק את מה שתומך בתוצאה.
+
+---
+
+### C4. עובדות "צבעוניות" — סיכון
+
+**העיקרון:** יש שופטים שאוהבים לכלול עובדות שאינן מהותיות אך מוסיפות צבע. הסכנה: הקורא עלול לחשוב שההחלטה מבוססת על עובדות אלה. גם הצדדים עלולים לראות בכך זלזול בתיק.
+
+> "There is an obvious danger, however, that the reader may think the decision is based on these facts even though they are not material to the reasoning. Moreover, this style of writing — though appealing to the author — may be seen by the parties as trivializing the case."
+> — 1991, עמ' 15; 2020, עמ' 15
+
+**יישום לוועדת ערר:** בבלוק ו — לא לכלול פרטים "מעניינים" שאינם רלוונטיים. לא לתאר את נוף השכונה או היסטוריה שאינה נחוצה. כל עובדה שמופיעה — הקורא יניח שהיא רלוונטית להחלטה.
+
+---
+
+### C5. דיוק עובדתי — אין תחליף לבדיקת הרשומה
+
+**העיקרון:** הצגת העובדות חייבת להיות מדויקת. אין להניח שעובדות כפי שמוצגות בכתבי הטענות נכונות. אין תחליף לבדיקה מול הרשומה.
+
+> "Above all, the statement of facts must be accurate. The writer should not assume that the facts recited in the parties' briefs are stated correctly. There is no substitute for checking fact references against the record."
+> — 1991, עמ' 15; 2020, עמ' 16
+
+> "Misstating significant facts or authorities is a mark of carelessness and undermines the opinion's authority and integrity."
+> — 1991, עמ' 1; 2020, עמ' 1
+
+**יישום לוועדת ערר:** המערכת חייבת לוודא שעובדות בבלוק ו נלקחות מחומרי המקור (פרוטוקולים, תכניות, תצהירים) — לא מכתבי הטענות. שגיאה עובדתית = פגיעה בסמכות ההחלטה.
+
+---
+
+### C6. בתיקים רב-סוגייתיים — עובדות כלליות בהתחלה, ספציפיות בדיון
+
+**העיקרון:** כשיש סדרת סוגיות ולא כל העובדות רלוונטיות לכולן, ניתן להגביל את תיאור העובדות ההתחלתי לרקע היסטורי נחוץ ולשלב עובדות ספציפיות בניתוח של כל סוגיה.
+
+> "In such a case, the initial statement of facts may be limited to necessary historical background, leaving the specific decisional facts to be incorporated in the analysis of the issues on which they bear."
+> — 1991, עמ' 15; 2020, עמ' 15
+
+**יישום לוועדת ערר:** בלוק ו — רקע כללי (מיקום, תכנית רלוונטית, ההליך). בבלוק י — עובדות ספציפיות לכל סוגיה, עם הפניה לבלוק ו אם צריך. נמנעים מכפילות.
+
+---
+
+## D. ציטוטים ואזכורי פסיקה
+
+### D1. אזכור מקרה אחד מספיק — לא מחרוזות
+
+**העיקרון:** רוב הנקודות המשפטיות נתמכות היטב באזכור הפסק האחרון בעניין, או פסק-הדין הפורץ דרך. מחרוזות אזכורים ודיסרטציות על תולדות הכלל אינן מוסיפות כשהעניין מוסדר. יש להתנגד לפיתוי להרשים בלמדנות.
+
+> "Most points of law are adequately supported by citation of the latest decision on point in the court's circuit or the watershed case, if there is one. String citations and dissertations on the history of the rule add nothing when the matter is settled."
+> — 1991, עמ' 17; 2020, עמ' 18
+
+> "Judges should resist the temptation of trying to impress people with their (or their law clerks') erudition."
+> — 1991, עמ' 17; 2020, עמ' 18
+
+**יישום לוועדת ערר:** לא לכתוב "ראו: עע"מ X; עע"מ Y; עע"מ Z; עת"מ A; עת"מ B" כשמספיק פסק אחד מנחה. מחרוזת אזכורים → מיותרת ומעמיסה. אזכור אחד + ציטוט רלוונטי = מספיק.
+
+---
+
+### D2. פריצת דרך — כן לסקור את המקורות
+
+**העיקרון:** כאשר ההחלטה פורצת דרך חדשה, יש למרשל את המקורות הקיימים ולנתח את התפתחות הדין כדי לתמוך בכלל החדש.
+
+> "If an opinion breaks new ground, however, the court should marshal existing authority and analyze the evolution of the law sufficiently to support the new rule."
+> — 1991, עמ' 17; 2020, עמ' 18
+
+**יישום לוועדת ערר:** כשהוועדה קובעת עמדה חדשה (למשל, פרשנות חדשה של סעיף בחוק) — יש לסקור את ההתפתחות בפסיקה ולהראות איך העמדה החדשה נגזרת מהדין הקיים.
+
+---
+
+### D3. מקורות משניים — במשורה ולמטרה
+
+**העיקרון:** מקורות משניים (מאמרים, ספרים, מקורות לא-משפטיים) אינם סמכות ראשית ויש לאזכר אותם במשורה ורק לתכלית ברורה: הפניה לניתוח תומך, סמכות מוכרת בתחום, או שפיכת אור על שיקולי מדיניות.
+
+> "Because law review articles, treatises, texts, and non-legal sources are not primary authority, they should be cited sparingly and only to serve a purpose."
+> — 1991, עמ' 18; 2020, עמ' 18
+
+**יישום לוועדת ערר:** ספרות תכנון, חוות דעת מומחים, מסמכי מדיניות — ניתן לאזכר אך רק כשתורמים ממשית לנימוק, לא כעיטור.
+
+---
+
+### D4. ציטוטים — קצרים, הוגנים, רק כשהם חשובים
+
+**העיקרון:** אם משהו חשוב נאמר היטב לפני כן — ציטוט רלוונטי יכול להיות משכנע יותר מפרפרזה. אך ההשפעה של ציטוט יחס הפוך לאורכו. יש לצטט בקצרה, ורק כשהניסוח עושה נקודה חשובה. הציטוט חייב להיות הוגן — בהקשר ומשקף נאמנה את המקור.
+
+> "If something important to the opinion has been said well before, quoting relevant language from a case on point can be more persuasive and informative than merely citing or paraphrasing it. The impact of a quote, however, is inversely proportional to its length. Quote briefly, and only when the language makes an important point."
+> — 1991, עמ' 18; 2020, עמ' 18
+
+> "While quotes should be short, they must also be fair. They must be in context and accurately reflect the tenor of their source."
+> — 1991, עמ' 18; 2020, עמ' 18
+
+**יישום לוועדת ערר:** לא להביא פסקאות שלמות מפסקי דין. ציטוט = 1-2 משפטים לכל היותר, ורק כשהניסוח המקורי חשוב (כלל מנחה, אמירה מכוננת). תמיד לוודא שהציטוט בהקשרו.
+
+---
+
+### D5. הערות שוליים — רק למידע שמפריע לזרימה
+
+**העיקרון:** מטרת הערת שוליים היא להעביר מידע שיפריע לזרימת ההחלטה אם יכלל בטקסט. השאלה הראשונה: האם התוכן מוצדק בכלל. אם הוא לא חשוב מספיק לטקסט — צריכה להיות סיבה טובה לכלול אותו בהערה. הערות שוליים לא צריכות להיות מאגר של מידע שהכותב לא יודע מה לעשות איתו.
+
+> "The first question to ask about a prospective footnote is whether its content is appropriate for inclusion in the opinion. If it is not important enough to go into the text, the writer must have some justification for including it in the opinion at all."
+> — 1991, עמ' 24; 2020, עמ' 24
+
+> "Footnotes should not be inserted for the writer's gratification or as a repository for information that the writer does not know what to do with."
+> — 1991, עמ' 24
+
+**יישום לוועדת ערר:** הערות שוליים רק לטקסט חקיקה, פרטי רקע נחוצים אך לא-מרכזיים, או דחיית טענה צדדית בקצרה. לא מאגר לחומר "מעניין".
+
+---
+
+## E. טיפול בצד המפסיד
+
+### E1. דיון מספיק כדי להראות שהטענות נשקלו
+
+**העיקרון:** השופט חייב להתמודד עם סמכות נוגדת לכאורה ועם טענות נגדיות. עליו להתעמת עם הסוגיות ישירות ובכנות. ההחלטה לא צריכה להתייחס לכל תיק וטענה, אך הדיון חייב להספיק כדי להדגים לצד המפסיד שהיסודות של עמדתו נשקלו במלואם.
+
+> "The judge must deal with arguably contrary authority and opposing argument, and must confront the issues squarely and deal with them forthrightly. Although the opinion need not address every case and contention, the discussion must be sufficient to demonstrate to the losing party that the essentials of its position have been fully considered."
+> — 1991, עמ' 16; 2020, עמ' 16
+
+**יישום לוועדת ערר:** זהו עיקרון מפתח. כשהערר נדחה — הדיון חייב להראות שהוועדה הבינה את הטענה המרכזית וענתה עליה. לא צריך לענות על כל נקודה, אבל הטענה העיקרית של הצד המפסיד חייבת לקבל מענה מנומק.
+
+---
+
+### E2. לא להפוך לוויכוח עם עורכי הדין
+
+**העיקרון:** בהתייחסות לטענות הצד המפסיד, ההחלטה לא צריכה להפוך לוויכוח בין השופט לעורכי הדין. אם הוצגו טענות מהותיות — יש להסביר למה נדחו. אבל אין צורך להפריך את טענות הצד המפסיד נקודה בנקודה או לאמץ טון עוין.
+
+> "An opinion should not become an argument between the judge and the lawyers, or other judges on the court, or the court below. If the losing side has raised substantial contentions, the opinion should explain why they were rejected. But it need not refute the losing party's arguments point by point or adopt a contentious or adversarial tone."
+> — 1991, עמ' 18; 2020, עמ' 18-19
+
+**יישום לוועדת ערר:** הדיון לא מתנהל כ"תשובה לכתב הערר". הוועדה מנתחת את השאלה — לא מתווכחת עם הטוען. במקום "טענת העורר כי X — שגויה מיסודה" → "לאחר בחינת הסוגיה נמצא כי Y, ועל כן אין לקבל את הטענה".
+
+---
+
+### E3. הרשעה בלי להיות טרקט
+
+**העיקרון:** החלטה יכולה — וצריכה — לשדר שכנוע בלי להפוך לחוברת. יש להניח בצד רגשות ותחושות אישיות, ולהימנע משימוש בשמות תואר ותארי פועל אלא אם הם מעבירים מידע מהותי.
+
+> "An opinion can — and properly should — carry conviction without becoming a tract. Put aside emotion and personal feelings, and avoid using adjectives and adverbs unless they convey information material to the decision."
+> — 1991, עמ' 18-19; 2020, עמ' 19
+
+**יישום לוועדת ערר:** לא "בבירור" / "ללא ספק" / "ברי כי" אלא אם מדובר בעניין שבאמת ברור. הטון של דפנה — מקצועי, מרוסן, בטוח אך לא פומפוזי.
+
+---
+
+### E4. התייחסות לערכאה הנמוכה — ללא ביקורת מיותרת
+
+**העיקרון:** ניתן ונדרש לתקן שגיאות של הערכאה הנמוכה, אך ללא ביקורת מיותרת, ללא תקיפת שיקול דעתה או גישתה, וללא ייחוס מניעים לא ראויים.
+
+> "Appellate opinions can and should correct trial court errors and provide guidance on remand without embroidering on the circumstances or criticizing the court below. An appellate opinion need not attack a trial court's wisdom, judgment, or even its attitude in order to reverse its decision."
+> — 1991, עמ' 19; 2020, עמ' 19
+
+**יישום לוועדת ערר:** כשהערר מתקבל = הוועדה המקומית טעתה. אבל הנימוק צריך להתמקד ב"מה צריך להיות" — לא ב"כמה טעתה הוועדה המקומית". ללא ביטויים כמו "באופן מפתיע" / "למרבה הפליאה".
+
+---
+
+## F. ניסוח התוצאה / המסקנה
+
+### F1. התוצאה היא החלק הכי חשוב
+
+**העיקרון:** התוצאה האופרטיבית — וההוראות לערכאה הנמוכה או לגורם המנהלי — היא החלק הכי חשוב בפסקת הסיום.
+
+> "Disposition of a case — and the mandate to the lower court or agency, when that is a part of the disposition — is the most important part of the conclusion."
+> — 1991, עמ' 19; 2020, עמ' 19
+
+**יישום לוועדת ערר:** בלוקים יא-יב — חייבים להיות ברורים ואופרטיביים. "הערר נדחה" / "הערר מתקבל" / "הערר מתקבל בחלקו". בהחזרה — הוראות מפורטות.
+
+---
+
+### F2. לא לדבר בחידות
+
+**העיקרון:** אין לדבר בחידות. להחזיר תיק "להליכים נוספים בהתאם להחלטה זו" עלול להותיר את הערכאה הנמוכה בים. ההחלטה חייבת לפרט בבירור מה צפוי מהם — מבלי לפלוש לשיקול הדעת שנותר בידיהם.
+
+> "Appellate courts should not speak in riddles. Simply to remand a case 'for further proceedings consistent with the opinion' may leave the court below at sea. Opinions must spell out clearly what the lower courts or agencies are expected to do without, however, trespassing on what remains entrusted to their discretion."
+> — 1991, עמ' 19; 2020, עמ' 19
+
+**יישום לוועדת ערר:** במקום "הערר מוחזר לדיון מחדש" → "הערר מוחזר לוועדה המקומית לצורך בחינה מחדש של [X] בהתאם לתכנית [Y], תוך מתן הזדמנות שימוע לעורר ובהתחשב ב[Z]." הוראות ספציפיות ואופרטיביות.
+
+---
+
+### F3. גם כשנמצא שימוש לרעה בשיקול דעת — הסמכות נשארת
+
+**העיקרון:** גם כשנמצא שימוש לרעה בשיקול דעת, החלטת ערכאת הערעור היא בשאלת הדין. הערכאה הנמוכה או הגוף המנהלי בהחזרה שומרים על סמכותם להפעיל שיקול דעת כראוי.
+
+> "Even where an abuse of discretion is found, the appellate court's decision is on the law, and the lower court or agency on remand retains the authority to exercise its discretion properly."
+> — 1991, עמ' 19; 2020, עמ' 19
+
+**יישום לוועדת ערר:** כשהוועדה המקומית לא שקלה שיקול רלוונטי — הערר מוחזר כדי שתשקול אותו. אין לכפות תוצאה ספציפית (אלא אם הדין מחייב).
+
+---
+
+## G. שפה, סגנון, עריכה עצמית
+
+### G1. שלוש בעיות עיקריות — יתירות, חוסר דיוק, ארגון גרוע
+
+**העיקרון:** הבעיות העיקריות בכתיבה שיפוטית: (א) יתירות — לא רק שימוש בשתי מילים כשמספיקה אחת, אלא ניסיון להעביר יותר מדי מידע, לכסות יותר מדי סוגיות, ופשוט לכתוב יותר מדי; (ב) חוסר דיוק ובהירות; (ג) ארגון גרוע.
+
+> "Wordiness means not just verbosity — using two words when one will do — but trying to convey too much information, covering too many issues, and simply writing too much."
+> — 1991, עמ' 21; 2020, עמ' 21
+
+> "Often wordiness reflects the writer's failure (or inability) to separate the material from the immaterial and do the grubby work of editing."
+> — 1991, עמ' 21; 2020, עמ' 21
+
+**יישום לוועדת ערר:** עריכה קפדנית של כל בלוק. אם משפט לא מקדם את הנימוק — למחוק. אם סוגיה לא נחוצה — לקצר או להסיר.
+
+---
+
+### G2. דיוק — המטרה המרכזית
+
+**העיקרון:** דיוק הוא המטרה המרכזית של כתיבה טובה. כדי לכתוב בבהירות ודיוק — הכותב חייב לדעת בדיוק מה הוא רוצה לומר, ולומר את זה ותו לא. שופטים כותבים לנצח — ברגע שהחלטה מוגשת, עורכי דין יקראו אותה עם עין למה שישרת את מטרתם.
+
+> "To write with clarity and precision, the writer must know precisely what he or she wants to say and must say that and nothing else."
+> — 1991, עמ' 21; 2020, עמ' 21
+
+> "Precision in judicial writing is important not simply as a matter of style but also because judges write for posterity. Once an opinion is filed, lawyers and others will read it with an eye to how they can use it to serve their particular purpose."
+> — 1991, עמ' 21; 2020, עמ' 21
+
+**יישום לוועדת ערר:** כל משפט — "האם אמרתי בדיוק מה שרציתי? האם ניתן לקרוא את זה אחרת ממה שהתכוונתי?" מיוחד חשוב בהחלטות שקובעות תקדים.
+
+---
+
+### G3. השמטת מילים מיותרות — עיקרון סטרנק
+
+**העיקרון:** כתיבה עזה היא תמציתית. כל מילה צריכה לעבוד.
+
+> "Vigorous writing is concise. A sentence should contain no unnecessary words, a paragraph no unnecessary sentences, for the same reason that a drawing should have no unnecessary lines and a machine no unnecessary parts. This requires not that the writer make all his sentences short, or that he avoid all detail and treat his subjects only in outline, but that every word tell."
+> — Strunk & White, מצוטט ב-1991, עמ' 22-23; 2020, עמ' 22-23
+
+**יישום לוועדת ערר:** בעריכה — לסמן כל מילה ולשאול: "האם היא נחוצה?" לא "קצר" — אלא "כל מילה עובדת". זהו הכלל המרכזי לסגנון דפנה.
+
+---
+
+### G4. תמציתיות ועמידה בנקודה
+
+**העיקרון:** תמציתיות מקדמת בהירות. כתיבה שמגיעה לנקודה בקצרה — מובנת יותר. יש להשתמש במשפטים פשוטים ודקלרטיביים ובפסקאות קצרות, אך לגוון את אורך המשפט ומבנהו לצורכי הדגשה וניגוד. יש להעדיף לשון פעילה ולהימנע מבניות כמו "נטען כי", "הוטען כי".
+
+> "Use simple, declarative sentences and short paragraphs most of the time, but vary sentence length and structure where necessary for emphasis, contrast, and reader interest. Prefer the active voice and avoid constructions such as 'it is said,' 'it is argued,' and 'it is well founded.'"
+> — 1991, עמ' 23; 2020, עמ' 23
+
+> "Weed out adjectives and eliminate adverbs such as 'clearly,' 'plainly,' and 'merely.'"
+> — 1991, עמ' 23; 2020, עמ' 23
+
+**יישום לוועדת ערר:** לא "נטען על-ידי העורר כי הוועדה המקומית טעתה" → "העורר טוען כי הוועדה המקומית טעתה". לא "ברי כי" / "מובן מאליו כי" — אם זה ברור, לא צריך לומר שזה ברור.
+
+---
+
+### G5. שפה פשוטה — אנגלית/עברית רגילה
+
+**העיקרון:** אפילו רעיונות מורכבים ניתנים לביטוי בשפה פשוטה. יש להימנע מ"לשון משפטית", קלישאות, ביטויים שחוקים, ביטויים לטיניים, וז'רגון. כשמשתמשים במונחי מקצוע — לבדוק אם הם מובנים לקהל או דורשים הגדרה.
+
+> "Even complex ideas can be expressed in simple language understandable by the general reader. To write in simple language requires that the writer understand the idea fully, enabling him or her to break it down into its essential components."
+> — 1991, עמ' 23; 2020, עמ' 23
+
+> "Avoid 'legalese,' clichés, hackneyed phrases ('as hereinabove set forth,' for example), Latin expressions ('vel non,' for example), and jargon."
+> — 1991, עמ' 23; 2020, עמ' 23
+
+**יישום לוועדת ערר:** לא "כדרישת הדין ולפיו" / "לאמור לעיל" / "כאמור" (מיותר). עברית פשוטה ובהירה. מונח תכנוני — להגדיר אם לא ברור ("תכנית בניין עיר" לא "תב"ע" ללא הגדרה ראשונית).
+
+---
+
+### G6. פומפוזיות — להימנע
+
+**העיקרון:** כתיבה שיפוטית עלולה להיות פומפוזית. השופט חייב להיזהר: ביטויים ארכאיים או מליציים, שימוש ב"אנו" הקיסרי על-ידי שופט יחיד, סטיות ללמדנות שאינה רלוונטית.
+
+> "The judge must be vigilant for evidence of pomposity, such as arcane or florid expressions, use of the imperial 'we' by a single district judge, or excursions into irrelevant erudition."
+> — 1991, עמ' 22; 2020, עמ' 22
+
+**יישום לוועדת ערר:** הוועדה = "הוועדה", לא "אנו סבורים" (אם יו"ר יחיד כותב). לא "למותר לציין כי" / "מן המפורסמות הוא כי". טון סמכותי אך פשוט.
+
+---
+
+### G7. הומור — סיכון שלא כדאי לקחת
+
+**העיקרון:** הומור עובד טוב יותר בנאום מאשר בהחלטה. בעלי הדין — שלא סביר שיראו משהו מצחיק בהתדיינות — עלולים לראות בו סימן ליהירות וחוסר רגישות.
+
+> "Although humor is sometimes rationalized as an antidote to pomposity, it works better in after-dinner speeches than in judicial opinions. In the latter it may strike the litigants — who are not likely to see anything funny in the litigation — as a sign of judicial arrogance and lack of sensitivity."
+> — 1991, עמ' 22; 2020, עמ' 22
+
+**יישום לוועדת ערר:** לא הומור, לא אירוניה, לא ציניות בהחלטות. גם אם הטענה נראית מגוחכת — להתייחס בכבוד.
+
+---
+
+### G8. עריכה — לא רק שפה, גם תוכן ומבנה
+
+**העיקרון:** בעריכה, השופט צריך לבדוק: (א) עקביות פנימית; (ב) האם המבוא מכסה את כל הסוגיות; (ג) האם העובדות מכסות את כל מה שנחוץ להחלטה ולא יותר; (ד) האם הדיון מתייחס בסדר לוגי לכל הסוגיות; (ה) האם המסקנה נובעת מהדיון.
+
+> "Judges must check for internal consistency. Go back to the introduction to see whether the opinion has addressed all of the issues and answered the questions as they were initially formulated. Reread the statement of facts to see whether it covers all the facts significant to the decision and no more. Review the legal discussion to see whether the opinion has addressed in logical order the issues that need to be addressed. Consider whether the conclusion follows from the discussion."
+> — 1991, עמ' 25; 2020, עמ' 25-26
+
+**יישום לוועדת ערר:** צ'קליסט עריכה אוטומטי: (1) עקביות בלוק א ↔ בלוק יב; (2) כל עובדה בבלוק ו מופיעה בדיון?; (3) סדר הסוגיות לוגי?; (4) המסקנה נובעת מהניתוח?
+
+---
+
+### G9. הנחת הטיוטה בצד ושיבה אליה
+
+**העיקרון:** שיפור העריכה — על-ידי הנחת הטיוטה בצד ושיבה אליה מאוחר יותר. גם עיכוב של ימים ספורים מאפשר מבט אובייקטיבי יותר, תובנות חדשות, ורעיונות חדשים.
+
+> "Although time constraints and mounting caseloads may make it difficult, delaying editing the opinion for even a few days may help the judge review things more objectively, gain new insights, and think of new ideas."
+> — 1991, עמ' 25; 2020, עמ' 26
+
+**יישום לוועדת ערר:** בתהליך העבודה עם המערכת — שלב "צינון" לפני עריכה סופית. הטיוטה נשמרת, יו"ר הוועדה חוזרת אליה לאחר זמן.
+
+---
+
+### G10. עריכה משפט-משפט
+
+**העיקרון:** עריכה מדוקדקת ומהורהרת חיונית לכתיבה מדויקת. זה אומר לעבור על ההחלטה משפט אחרי משפט ולשאול: מה התכוונתי לומר כאן, והאם אמרתי את זה ולא יותר?
+
+> "Painstaking and thoughtful editing is essential for precise writing. This means going over the opinion, sentence by sentence, and asking: What do I mean to say here, and have I said it and no more?"
+> — 1991, עמ' 21-22; 2020, עמ' 21
+
+**יישום לוועדת ערר:** כל בלוק — עריכה ברמת המשפט. כל משפט עומד בפני עצמו ומוסיף מידע חדש או נקודה חדשה.
+
+---
+
+## H. חידושים ייחודיים למהדורה השנייה (2020)
+
+### H1. התייחסות לעידן הדיגיטלי
+
+**העיקרון:** המהדורה השנייה מציינת שהחלטות שיפוטיות נקראות יותר ויותר בפורמט דיגיטלי, ולכן הבהירות חשובה אף יותר.
+
+> "With so much of today's writing embedded in the truncated protocols of social media and other 'real time' forms of expression, the clarity and persuasive quality the authors of the first edition sought to teach are particularly important for judges' writing."
+> — 2020, Foreword, עמ' ix
+
+**יישום לוועדת ערר:** ההחלטות מתפרסמות באתר הוועדה ובמאגרי מידע — מותאמות לקריאה דיגיטלית. כותרות, מבנה, פסקאות קצרות.
+
+---
+
+### H2. ציטוט מ-Bryan Garner על שפה משפטית
+
+**העיקרון:** המהדורה השנייה מוסיפה ציטוט מ-Garner על הימנעות מביטויים משפטיים מסורתיים:
+
+> "[N]ever assume that traditional legal expressions are legally necessary. As often as not they are scars left by the law's verbal elephantiasis, which only lately has started into remission. Use words and phrases that you know to be both precise and as widely understood as possible."
+> — Bryan Garner, מצוטט ב-2020, עמ' 23-24
+
+**יישום לוועדת ערר:** ביטויים כמו "בכבוד רב", "מן הראוי", "למיטב הבנתנו" — לא "נחוצים משפטית". להחליף בשפה פשוטה ומדויקת.
+
+---
+
+### H3. מודעות לפרסום בלתי נשלט
+
+**העיקרון:** המהדורה השנייה מוסיפה אזהרה שמפרסמים משפטיים (כמו Westlaw) מפרסמים לפעמים החלטות שסומנו כ"לא לפרסום" — על סמך שיקול דעתם שלהם.
+
+> "Some legal publishers, including Westlaw, put certain district court orders and opinions on line whether or not the judge designates them for publication and even sometimes when a judge states that the order or opinion is 'not for publication.'"
+> — 2020, עמ' 7
+
+**יישום לוועדת ערר:** כל החלטה של ועדת הערר עלולה להתפרסם ולשמש תקדים — גם אם לא תוכננה לכך. יש לכתוב כל החלטה כאילו תפורסם.
+
+---
+
+### H4. הדגשת ניתוח קריפטי כבעיה נפרדת
+
+**העיקרון:** המהדורה השנייה מבנה את "ניתוח קריפטי" כבעיה נפרדת (לא רק תת-סעיף) — מה שמדגיש את חשיבות פירוט הנימוקים.
+
+**יישום לוועדת ערר:** בלוק י — כל צעד בנימוק חייב להיות מפורש. אסור "לדלג" מכלל למסקנה בלי ליישם על העובדות.
+
+---
+
+### H5. מבנה מעודכן — "Editing the Opinion" כפרק נפרד
+
+**העיקרון:** במהדורה הראשונה, שפה/סגנון/עריכה היו פרק אחד. במהדורה השנייה, "Editing" הוא פרק נפרד (V), מה שמדגיש את חשיבות העריכה כתהליך עצמאי ולא כחלק מהכתיבה.
+
+**יישום לוועדת ערר:** בתהליך העבודה — שלב עריכה מוגדר, נפרד מהכתיבה. המערכת מפעילה צ'קליסט עריכה אוטומטי אחרי יצירת הטיוטה.
+
+---
+
+### H6. הפניה ל-Aldisert על חשיבה לוגית לפני כתיבה
+
+**העיקרון:** המהדורה השנייה מוסיפה ציטוט של שופט Aldisert:
+
+> "If a judge wants to write clearly and cogently, with words parading before the reader in logical order, the judge must first think clearly and cogently, with thoughts laid out in neat rows."
+> — Aldisert, Opinion Writing (2d ed. 2009), מצוטט ב-2020, עמ' 9
+
+**יישום לוועדת ערר:** לפני שהמערכת כותבת — שלב "תכנון" חובה: מה התוצאה? מה הנימוקים? באיזה סדר? רק אחר-כך — כתיבה.
+
+---
+
+## סיכום כללי — עקרונות-על
+
+1. **ההחלטה קיימת כדי להסביר ולשכנע** — לא רק להכריע, אלא להראות שההכרעה מבוססת, הוגנת, ומנומקת.
+2. **כל מילה צריכה לעבוד** — תמציתיות היא לא קיצור אלא הסרת המיותר.
+3. **הצד המפסיד צריך לראות שהוא נשמע** — הדיון חייב להדגים שהטענות המרכזיות נשקלו.
+4. **דיוק הוא הדבר החשוב ביותר** — כל משפט נקרא לנצח וייקרא בדרכים שלא ציפית.
+5. **מבנה ברור = חשיבה ברורה** — כותרות, סדר לוגי, וחמישה אלמנטים.
+6. **לא סנגוריה** — ההחלטה משכנעת בכוח הנימוק, לא בטון.
+7. **עובדות מדויקות והוגנות** — כולל עובדות שתומכות בצד המפסיד.
+8. **ציטוטים קצרים, אזכורים מועטים** — אחד טוב > עשרה מיותרים.
+9. **הוראות אופרטיביות ברורות** — לא חידות, לא עמימות.
+10. **כתוב אחרון — ערוך ראשון** — המבוא נכתב אחרי הדיון; העריכה חשובה כמו הכתיבה.

docs/garner-methodology-extraction.md

@@ -0,0 +1,625 @@
+# עקרונות כתיבת החלטות מעין-שיפוטיות — מיצוי מספרי גארנר
+
+מסמך מתודולוגי המבוסס על שני ספרים:
+1. **Making Your Case: The Art of Persuading Judges** (Scalia & Garner, 2008)
+2. **Legal Writing in Plain English** (Garner, 2001)
+
+> **הערה חשובה**: "Making Your Case" נכתב עבור עורכי דין טוענים, לא שופטים. העקרונות כאן מותאמים לכתיבת החלטות — לא לטיעון תיק.
+
+---
+
+## א. חשיבה משפטית והנמקה (Making Your Case, פרקים 22–27)
+
+### א.1 חשיבה סילוגיסטית — מבנה כל טיעון משפטי
+
+**עיקרון**: כל הנמקה משפטית חייבת להיבנות כסילוגיזם: הנחה עליונה (כלל משפטי) → הנחה תחתונה (עובדות המקרה) → מסקנה.
+
+> "Leaving aside emotional appeals, persuasion is possible only because all human beings are born with a capacity for logical thought... The most rigorous form of logic, and hence the most persuasive, is the syllogism." (MYC §22)
+
+> "If the major premise (the controlling rule) and the minor premise (the facts invoking that rule) are true... the conclusion follows inevitably." (MYC §22)
+
+**יישום להחלטות ועדת ערר**: כל סוגיה בבלוק י (דיון) חייבת להיבנות כך:
+- הנחה עליונה: הכלל התכנוני/המשפטי (סעיף בתוכנית, פסיקה, עקרון תכנוני)
+- הנחה תחתונה: העובדות הספציפיות של הערר
+- מסקנה: התוצאה לגבי סוגיה זו
+
+**עיקרון משנה — שלושה מקורות להנחה עליונה**:
+
+> "Legal argument generally has three sources of major premises: a text (constitution, statute, regulation, ordinance, or contract), precedent (caselaw, etc.), and policy (i.e., consequences of the decision)." (MYC §22)
+
+**יישום**: בעררי תכנון, המקורות הם:
+- טקסט: הוראות התוכנית, חוק התכנון והבניה, תקנות
+- תקדים: החלטות ועדות ערר קודמות, פסיקת בתי משפט
+- מדיניות: שיקולים תכנוניים (צפיפות, אופי הסביבה, אינטרס ציבורי)
+
+**עיקרון משנה — ההנחה התחתונה היא המפתח**:
+
+> "There is much to be said for the proposition that 'legal reasoning revolves mainly around the establishment of the minor premise.'" (MYC §22)
+
+**יישום**: ברוב העררים, הכלל המשפטי אינו שנוי במחלוקת — השאלה היא כיצד העובדות משתלבות בכלל. ההחלטה חייבת להראות בפירוט כיצד העובדות הספציפיות מקיימות או אינן מקיימות את תנאי הכלל.
+
+### א.2 פרשנות טקסטואלית — ניתוח הוראות תוכנית
+
+**עיקרון ראשי**: לפני כל מסקנה לגבי משמעות טקסט — קרא את המסמך כולו.
+
+> "Paramount rule: Before coming to any conclusion about the meaning of a text, read the entire document, not just the particular provision at issue. The court will be seeking to give an ambiguous word or phrase meaning in the context of the document in which it appears." (MYC §23)
+
+**כללי פרשנות שיש לאמץ**:
+
+> "Words are presumed to bear their ordinary meanings." (MYC §23)
+
+> "Without some contrary indication, a word or phrase is presumed to have the same meaning throughout a document." (MYC §23)
+
+> "The provisions of a document should be interpreted in a way that renders them harmonious, not contradictory." (MYC §23)
+
+> "If possible, every word should be given effect; no word should be read as surplusage." (MYC §23)
+
+**יישום**: כשההחלטה מפרשת הוראת תוכנית:
+1. הצג את לשון ההוראה המלאה
+2. פרש מילים במשמעותן הרגילה
+3. בדוק עקביות עם הוראות אחרות באותה תוכנית
+4. תן תוקף לכל מילה — אל תתעלם ממילים "מיותרות"
+5. אם יש עמימות — השתמש בכלים הקאנוניים (הכלל הכללי מצטמצם לאור הפרט; מילה מתפרשת על פי הקשרה)
+
+**כלים קאנוניים לפרשנות** (MYC §23):
+- **Inclusio unius**: הכללת דבר אחד מרמזת על הדרת אחרים
+- **Noscitur a sociis**: מילה מתפרשת לאור המילים הסמוכות לה
+- **Ejusdem generis**: קטגוריה כללית שבאה אחרי רשימה מתייחסת לפריטים מאותו סוג
+
+### א.3 התחל תמיד מלשון הטקסט
+
+**עיקרון**: כשהמקרה נשלט על ידי טקסט משפטי — התחל תמיד מהמילים.
+
+> "In cases controlled by governing legal texts, always begin with the words of the text to establish the major premise." (MYC §24)
+
+**יישום**: בלוק י חייב לפתוח כל דיון בסוגיה בציטוט ישיר של ההוראה הרלוונטית מהתוכנית/חוק, ורק אז לעבור לניתוח ויישום על העובדות.
+
+### א.4 משקל תקדימים — היררכיה ברורה
+
+**עיקרון**: לסמכויות משפטיות שונות יש משקל שונה, וחובה להכיר בהיררכיה.
+
+> "From a juridical point of view, case authorities are of two sorts: those that are governing (either directly or by implication) and those that are persuasive." (MYC §26)
+
+> "Governing authorities are more significant and should occupy more of your attention." (MYC §26)
+
+**היררכיה בעררי תכנון** (לפי סדר יורד של משקל):
+1. פסיקת בית המשפט העליון
+2. פסיקת בית משפט לעניינים מנהליים (שנותן ביקורת שיפוטית ישירה)
+3. החלטות ועדת ערר ארצית
+4. החלטות ועדות ערר מחוזיות אחרות
+5. ספרות משפטית/תכנונית
+
+**עיקרון משנה — עדיפות לתקדים עדכני**:
+
+> "At least where opinions of governing courts are concerned, the more recent the citation the better. The judge wants to know whether the judgment you seek will be affirmed by the current court, not whether it would have been affirmed 30 years ago." (MYC §26)
+
+### א.5 מצא ניסוח מפורש להנחה העליונה
+
+**עיקרון**: אם אפשר, ציין בדיוק מהי ההנחה העליונה תוך ציטוט ישיר מסמכות מחייבת.
+
+> "It is often quite easy to find a governing case with a passage that says precisely what you want your major premise to be." (MYC §27)
+
+> "When direct quotation is not possible, set forth the major premise in your own words, supported by citation of a case from a governing court." (MYC §27)
+
+**יישום**: בפתיחת דיון בכל סוגיה, ההנחה העליונה צריכה להופיע בצורה ברורה — אם אפשר כציטוט ישיר מפסק דין או מהוראת חוק/תוכנית.
+
+---
+
+## ב. מבנה וארגון (משני הספרים)
+
+### ב.1 הצגת המסקנה מראש (Front-loading)
+
+**עיקרון**: התחל תמיד בהצגת הסוגיה המרכזית לפני שמפרט עובדות.
+
+> "Always start with a statement of the main issue before fully stating the facts." (MYC §14)
+
+> "The facts one reads seem random and meaningless until one knows what they pertain to." (MYC §14)
+
+> "The greatest mistake a lawyer can make either in briefing or oral argument is to keep the court in the dark as to what the case is about until after a lengthy discussion of dates, testimony of witnesses, legal authorities, and the like." (MYC §14, ציטוט השופט McAmis)
+
+**עיקרון משלים מ-Legal Writing in Plain English**:
+
+> "Virtually all analytical or persuasive writing should have a summary on page one—a true summary that capsulizes the upshot of the message. This upshot inevitably consists of three parts: the question, the answer, and the reasons." (LWPE §22)
+
+**יישום**: בלוק א (כותרת) ובלוק ב (סיכום מנהלי) חייבים לגלות מיד את מהות הערר ואת התוצאה. הקורא לא צריך לקרוא 10 עמודים כדי להבין במה מדובר.
+
+### ב.2 טכניקת ה-"Deep Issue" — סילוגיזם בשאלה
+
+**עיקרון**: נסח את הסוגיה בצורת סילוגיזם מכווץ — עד 75 מילים, במספר משפטים.
+
+> "The most persuasive form of an issue statement—the so-called deep issue—contains within it the syllogism that produces your desired conclusion." (MYC §36)
+
+> "The better strategy is to break up the question into separate sentences totaling no more than 75 words. The first sentences follow a chronological order, telling a story in miniature. Then, emerging inevitably from the story, the pointed question comes at the end." (MYC §36)
+
+**דוגמה מהספר**: במקום "האם דו"ח חקירת האירוע הפר כללי OSHA?" — כתוב:
+> "כללי OSHA דורשים שכל דו"ח חקירת אירוע יכלול רשימת גורמים תורמים. הדו"ח על הפיצוץ במפעל פירט את הגורמים התורמים לא בגוף הדו"ח אלא בנספח נפרד. האם הדו"ח הפר את כללי OSHA?"
+
+**יישום**: בלוק ב (סיכום מנהלי) צריך לנסח כל סוגיה בדרך זו — הנחה משפטית, עובדות תמציתיות, שאלה חדה.
+
+### ב.3 שלושה חלקים: פתיחה, גוף, סיכום
+
+**עיקרון**: כל כתיבה אנליטית חייבת שלושה חלקים — ורוב הכתיבה המשפטית מזניחה את הפתיחה והסיכום.
+
+> "Virtually all expository writing should have three parts: an introduction, a main body, and a conclusion. You'd think everyone knows this. Not so: the orthodox method of brief-writing, and the way of many research memos, is to give only one part—a middle." (LWPE §21)
+
+> "The conclusion should briefly sum up the argument. If you're writing as an advocate, you'll need to show clearly what the decision-maker should do and why." (LWPE §21)
+
+**יישום**: ההחלטה חייבת פתיחה (בלוקים א–ב), גוף (בלוקים ג–י), וסיכום (בלוקים יא–יב). הסיכום אינו "לאור כל האמור לעיל" אלא חזרה תמציתית ורעננה על עיקרי ההנמקה.
+
+### ב.4 סדר הסוגיות — החזק מתחיל
+
+**עיקרון**: אם ההיגיון מאפשר — פתח בטיעון החזק ביותר.
+
+> "If possible, lead with your strongest argument." (MYC §7)
+
+> "Why? Because first impressions are indelible. Because when the first taste is bad, one is not eager to drink further. Because judicial attention will be highest at the outset." (MYC §7)
+
+**חריג חשוב**: כשההיגיון דורש סדר אחר (למשל, שאלת סמכות לפני דיון בגוף)
+
+> "Sometimes, of course, the imperatives of logical exposition demand that you first discuss a point that is not your strongest." (MYC §7)
+
+**יישום**: בבלוק י, סדר הסוגיות צריך להיקבע לפי:
+1. שאלות סף (סמכות, מועד) — תמיד ראשונות
+2. הסוגיה המרכזית — מיד אחריהן
+3. סוגיות משניות — לפי חוזק ההנמקה
+
+### ב.5 כותרות אינפורמטיביות
+
+**עיקרון**: השתמש בכותרות שהן משפטים מלאים המודיעים לא רק על הנושא אלא גם על העמדה.
+
+> "Headings are most effective if they're full sentences announcing not just the topic but your position on the topic: Not 'I. Statute of Limitations' but 'I. The statute of limitations was tolled while the plaintiff suffered from amnesia.'" (MYC §40)
+
+> "State and federal judges routinely emphasize this point at judicial-writing seminars. They say that headings and subheadings help them keep their bearings, let them actually see the organization, and afford them mental rest stops." (LWPE §4)
+
+**יישום**: כל כותרת סעיף בהחלטה צריכה להודיע על המסקנה, לא רק על הנושא:
+- לא: "סוגיית הבנייה בקו אפס"
+- כן: "הבנייה בקו אפס אינה עולה בקנה אחד עם תוכנית המתאר"
+
+### ב.6 פסקת מפה (Roadmap Paragraph)
+
+**עיקרון**: ספק שלטי דרך ברורים — אמור מראש כמה נקודות יש ומה הן.
+
+> "If there are three issues you're going to discuss, state them explicitly on page one. If there are four advantages to your recommended course of action, say so when introducing the list. And be specific: don't say that there are 'several' advantages. If there are four, say so." (LWPE §27)
+
+**יישום**: בפתיחת בלוק י, כתוב: "הסוגיות שיש לדון בהן הן שלוש: (1) ...; (2) ...; (3) ...". זה מכין את הקורא ומאפשר לו לעקוב.
+
+### ב.7 חלק וכבוש — חלוקה לסעיפים
+
+**עיקרון**: חלק את המסמך לסעיפים ותתי-סעיפים עם כותרות.
+
+> "Once you've determined the necessary order of your document, you should divide it into discrete, recognizable parts... The more complex your project, the simpler and more overt its structure should be." (LWPE §4)
+
+**יישום**: ארכיטקטורת 12 הבלוקים כבר מספקת חלוקה מאקרו. בתוך בלוק י, יש לחלק לפי סוגיות עם כותרות וכותרות משנה.
+
+---
+
+## ג. טכניקות ברמת הפסקה (Legal Writing in Plain English)
+
+### ג.1 משפט נושא בפתיחת כל פסקה
+
+**עיקרון**: פתח כל פסקה במשפט שמודיע על הנושא המרכזי שלה.
+
+> "By stating the controlling idea, a topic sentence will lend unity to a paragraph... readers who are in a hurry will get your point efficiently." (LWPE §24)
+
+> "Good writers think of the paragraph—not the sentence—as the basic unit of thought." (LWPE §24)
+
+**כלל מעשי**: אל תפתח פסקה באזכור תיק ללא הקשר:
+
+> "Delaying the citation typically enables you to write a stronger topic sentence." (LWPE §24)
+
+**יישום**: במקום "בעע"מ 1234/05 נקבע ש..." — כתוב "ועדת ערר אינה מוסמכת להתערב בשיקול דעת מקצועי של מהנדס העיר. כך נפסק ב..."
+
+### ג.2 גשרים בין פסקאות (Echo Links)
+
+**עיקרון**: כל פתיחת פסקה חייבת לכלול מילת קישור או הד לפסקה הקודמת.
+
+> "Every paragraph opener should contain a transitional word or phrase to ease the reader's way from one paragraph to the next." (LWPE §25)
+
+**שלושה כלים**:
+
+> "Pointing words—that is, words like this, that, these, those, and the. Echo links—that is, words or phrases in which a previously mentioned idea reverberates. Explicit connectives—that is, words whose chief purpose is to supply transitions." (LWPE §25)
+
+**רשימת מילות קישור** (LWPE §25):
+- הוספה: גם, בנוסף, כמו כן, באופן דומה, יתרה מכך
+- דוגמה: למשל, כדוגמה, לענייננו
+- ניסוח מחדש: כלומר, במילים אחרות, בקצרה
+- סיבה: מכיוון ש-, שכן, בשל
+- תוצאה: לפיכך, אי לכך, כתוצאה מכך, משכך
+- ניגוד: אולם, ואולם, לעומת זאת, מנגד, עם זאת
+- ויתור: אמנם, נכון ש-, גם אם, אף ש-
+- חיזוק: אכן, למעשה, ללא ספק
+
+### ג.3 פסקה אחת — סוגיה אחת
+
+**עיקרון**: כל פסקה צריכה לעסוק בנקודה אחת בלבד.
+
+> "The topic sentence ensures that each paragraph has its own cohesive content. A good topic sentence centers the paragraph. It announces what the paragraph is about, while the other sentences play supporting roles." (LWPE §24)
+
+**יישום**: אם פסקה עוסקת גם בכלל המשפטי וגם ביישומו על המקרה וגם בהתמודדות עם טענה נגדית — חלק אותה.
+
+### ג.4 אורך פסקאות — קצר עדיף
+
+**עיקרון**: פסקאות קצרות מגבירות קריאות.
+
+> "Strive for an average paragraph of no more than 150 words—preferably far fewer—in three to eight sentences." (LWPE §26)
+
+> "As with sentence length, you need variety in paragraph length: some slender paragraphs and some fairly ample ones." (LWPE §26)
+
+**יישום**: בהחלטה, ממוצע של 100–150 מילים לפסקה. פסקה של משפט אחד מותרת ואפילו רצויה לעתים — למשל, כמשפט סיכום חד.
+
+---
+
+## ד. בהירות ברמת המשפט (Legal Writing in Plain English)
+
+### ד.1 בניין פעיל
+
+**עיקרון**: העדף בניין פעיל על פני סביל.
+
+> "In an active-voice construction, the subject does something (The court dismissed the appeal). In a passive-voice construction, something is done to the subject (The appeal was dismissed by the court)." (LWPE §8)
+
+**ארבעה יתרונות**:
+
+> "It usually requires fewer words. It better reflects a chronologically ordered sequence. It makes the reader's job easier because its syntax meets the English-speaker's expectation. It makes the writing more vigorous and lively." (LWPE §8)
+
+**יישום**: במקום "הבקשה נדחתה על ידי הוועדה המקומית" — "הוועדה המקומית דחתה את הבקשה". חריג: כשהפועל חשוב מהפועל ("ההיתר בוטל" — כשלא חשוב מי ביטל).
+
+### ד.2 קרבת נושא-נשוא-מושא
+
+**עיקרון**: שמור את הנושא, הפועל והמושא קרובים זה לזה — ובתחילת המשפט.
+
+> "Keep the subject, the verb, and the object together—toward the beginning of the sentence." (LWPE §7)
+
+> "The reason you should put the subject and verb at or near the beginning is that readers approach each sentence by looking for the action." (LWPE §7)
+
+**יישום**: במקום: "העורר, אשר רכש את הנכס בשנת 2018 ופנה לוועדה המקומית בבקשה להיתר בניה במרץ 2020, טוען כי..." — כתוב: "העורר טוען כי... [ההקשר העובדתי יובא בהמשך או בפסקה נפרדת]"
+
+### ד.3 אורך משפטים — ממוצע 20 מילים
+
+**עיקרון**: שמור על ממוצע של כ-20 מילים למשפט, עם גיוון.
+
+> "Keep your average sentence length to about 20 words." (LWPE §6)
+
+> "Not only do you want a short average; you also need variety. That is, you should have some 35-word sentences and some 3-word sentences, as well as many in between." (LWPE §6)
+
+**יישום**: הימנע ממשפטים של 60+ מילים שנפוצים בכתיבה משפטית ישראלית. שבור משפטים ארוכים. משפט קצר ומפתיע ("הערר נדחה") יכול להעניק אפקט חזק.
+
+### ד.4 הפוך שמות פעולה לפעלים
+
+**עיקרון**: הימנע משמות פעולה (-tion words / שמות פעולה בעברית) כשאפשר להשתמש בפועל.
+
+> "Turn -ion words into verbs when you can." (LWPE §14)
+
+> "Write that someone has violated the law, not that someone was in violation of the law; that something illustrates something else, not that it provides an illustration of it." (LWPE §14)
+
+**יישום**: במקום "ביצוע בחינה של" — "לבחון". במקום "קבלת החלטה" — "להחליט". במקום "מתן אישור" — "לאשר".
+
+### ד.5 השמט מילים מיותרות
+
+**עיקרון**: לחם נגד מילוי מילים. כל מילה שאינה עוזרת — מפריעה.
+
+> "Three good things happen when you combat verbosity: your readers read faster, your own clarity is enhanced, and your writing has greater impact." (LWPE §5)
+
+> "Every word that is not a help is a hindrance because it distracts. A judge who realizes that a brief is wordy will skim it; one who finds a brief terse and concise will read every word." (MYC §35)
+
+**ביטויים מנופחים ותחליפיהם** (LWPE §15):
+| מנופח | פשוט |
+|---|---|
+| במידה ו- | אם |
+| בנסיבות אלה | לכן |
+| לאור העובדה ש- | מכיוון ש- |
+| בשלב הנוכחי | עתה |
+| על מנת ש- | כדי ש- |
+| בסמוך לאחר | אחרי |
+| לא יאוחר מ- | עד |
+
+### ד.6 סיים משפטים בחוזקה
+
+**עיקרון**: המילה האחרונה במשפט היא החשובה ביותר.
+
+> "Professional writers know that a sentence's final word, whatever it may be, should have a special kick." (LWPE §11)
+
+**יישום**: אל תסיים משפט בתאריך או בהפניה אלא אם הם חשובים. במקום "הבקשה נדחתה ביום 15.3.2024" — "ביום 15.3.2024 נדחתה הבקשה". או אם התאריך לא חשוב — "הוועדה המקומית דחתה את הבקשה".
+
+### ד.7 הימנע מז'רגון מיותר
+
+**עיקרון**: אם יש מילה רגילה שאומרת אותו דבר — השתמש בה.
+
+> "Learn to detest simplifiable jargon." (LWPE §12)
+
+> "Legalisms should become part of your reading vocabulary, not part of your writing vocabulary." (LWPE §12)
+
+**יישום**: במקום "הננו להורות" — "אנו מורים". במקום "דנא" — "כאן". במקום "המבקש דנן" — "העורר". במקום "כמפורט לעיל" — "כפי שצוין".
+
+### ד.8 הימנע מכפילויות ושלישיות
+
+**עיקרון**: אם מילה אחת מספיקה, אל תשתמש בשתיים או שלוש.
+
+> "The idea isn't to say something in as many ways as you can, but to say it as well as you can." (LWPE §16)
+
+**יישום**: במקום "לבטל ולהפקיע" — "לבטל". במקום "לפרש ולהבהיר" — "לפרש". כל מילה נוספת מחייבת את הקורא לחפש הבדל.
+
+### ד.9 הקפד על הקבלה דקדוקית
+
+**עיקרון**: רעיונות מקבילים דורשים מבנה דקדוקי מקביל.
+
+> "Just as you should put related words together in ways that match the reader's natural expectations, you should also state related ideas in similar grammatical form." (LWPE §9)
+
+**יישום**: ברשימות תנאים או נימוקים, שמור על מבנה אחיד. אם התנאי הראשון מתחיל בשם עצם — כולם יתחילו בשם עצם. אם הראשון פועל — כולם פועל.
+
+### ד.10 הימנע מכפל שלילות
+
+**עיקרון**: אם אפשר לנסח חיובית — עשה כן.
+
+> "When you can recast a negative statement as a positive one without changing the meaning, do it. You'll save readers from needless mental exertion." (LWPE §10)
+
+**יישום**: במקום "לא ניתן שלא להתעלם מ-" — ניסוח חיובי ברור. במקום "אין יסוד לטענה כי אין סמכות" — "לוועדה יש סמכות".
+
+---
+
+## ה. התמודדות עם טיעוני צד שכנגד (Making Your Case)
+
+### ה.1 הכר את הצד השני — "Steel-manning"
+
+**עיקרון**: אל תחליף את טענת היריב בטענת קש שקל להפריך.
+
+> "Don't delude yourself. Try to discern the real argument that an intelligent opponent would make, and don't replace it with a straw man that you can easily dispatch." (MYC §4)
+
+**יישום**: בבלוק י, כשמתמודדים עם טענות הצד שהפסיד — הצג את טענותיו בצורה הוגנת וחזקה לפני שדוחה אותן. זה מחזק את אמינות ההחלטה.
+
+### ה.2 ויתור מפגין על שטח בלתי-ניתן להגנה
+
+**עיקרון**: הודה בנקודות שנגדך — בגלוי ובנדיבות.
+
+> "Don't try to defend the indefensible." (MYC §11)
+
+> "Openly acknowledge the ones that are against you. In fact... raise them candidly and explain why they aren't dispositive." (MYC §11)
+
+> "A weak argument does more than merely dilute your brief. It speaks poorly of your judgment and thus reduces confidence in your other points. As the saying goes, it is like the 13th stroke of a clock: not only wrong in itself, but casting doubt on all that preceded it." (MYC §11)
+
+**יישום**: כשיש נקודה שפועלת לטובת העורר שהערר שלו נדחה — הכר בה מפורשות: "אמנם צודק העורר כי המבנה הסמוך חורג מקו הבניין, אולם עובדה זו אינה מקנה לו זכות לחרוג אף הוא, שכן..."
+
+### ה.3 הפרכה מקדימה — באמצע, לא בהתחלה ולא בסוף
+
+**עיקרון**: טפל בטענות נגדיות באמצע הדיון — לא בפתיחה (שמציבה אותך בעמדת הגנה) ולא בסיום (שמשאירה את המוקד על טענות הצד השני).
+
+> "For the first to argue, refutation belongs in the middle. Aristotle observed that 'in court one must begin by giving one's own proofs, and then meet those of the opposition by dissolving them and tearing them up before they are made.'" (MYC §8)
+
+**יישום בכתיבת החלטה**: מבנה מומלץ לכל סוגיה (מבוסס על LWPE §30):
+1. הנחה משפטית (הכלל)
+2. הנחה עובדתית (העובדות)
+3. מסקנה ראשונית
+4. **טענה נגדית אפשרית + תשובה**
+5. **טענה נגדית נוספת + תשובה**
+6. נקודה תומכת נוספת
+7. משפט סיכום חד
+
+> "An argument using this structure makes for convincing reading. And it's hard to rebut." (LWPE §30)
+
+### ה.4 תפוס קרקע ניתנת להגנה
+
+**עיקרון**: בחר את העמדה הקלה ביותר להגנה.
+
+> "Select the most easily defensible position that favors your client. Don't assume more of a burden than you must." (MYC §10)
+
+**יישום**: כשיש מספר נימוקים אפשריים לתוצאה, בחר את החזק ביותר ופתח בו. אל תנסה להגן על כל נימוק אפשרי.
+
+### ה.5 היה ישר — גם כשזה לא נוח
+
+**עיקרון**: הכר בנקודות חולשה. שכנע באמצעות הגינות, לא באמצעות הסתרה.
+
+> "In dealing with counterarguments, be sure that you don't set out the opponent's points at great length before supplying an answer. Your undercut needs to be swift and immediate." (LWPE §30)
+
+> "If you want to write convincingly, you should habitually ask yourself why the reader might arrive at a different conclusion from the one you're urging. Think of the reader's best objections to your point of view, and then answer those objections directly." (LWPE §30)
+
+**יישום**: ההחלטה חייבת לעבור את "מבחן בית המשפט" — שופט בביקורת שיפוטית צריך לראות שכל טענה רצינית קיבלה מענה.
+
+---
+
+## ו. ציטוטים והפניות (משני הספרים)
+
+### ו.1 צטט במשורה
+
+**עיקרון**: ציטוטים ישירים צריכים להיות נדירים ומדויקים.
+
+> "Quote authorities more sparingly still." (MYC §50)
+
+> "A remarkably large number of lawyers seem to believe that their briefs are improved if each thought is expressed in the words of a governing case. The contrary is true." (MYC §50)
+
+> "After you have established your major premise, it will be your reasoning that interests the court, and this is almost always more clearly and forcefully expressed in your own words." (MYC §50)
+
+**יישום**: צטט ישירות רק כשהמילים המדויקות חשובות — הוראת תוכנית, קביעה מפתח בפסק דין. את השאר — פרפרז.
+
+### ו.2 הימנע מציטוטים ארוכים בלוקים
+
+**עיקרון**: ציטוט ארוך מוכנס (block quote) מזמין דילוג.
+
+> "Be especially loath to use a lengthy, indented quotation. It invites skipping. In fact, many block quotes have probably never been read by anyone." (MYC §50)
+
+> "Never let your point be made only in the indented quotation. State the point, and then support it with the quotation." (MYC §50)
+
+**יישום**: אם חייבים ציטוט ארוך (למשל, הוראת תוכנית) — הקדם לו משפט שמסכם את עיקרו, ולאחריו הוסף ניתוח. אל תניח שהקורא יקרא את הציטוט.
+
+### ו.3 טכניקת הסנדוויץ' — הקדמה → ציטוט → ניתוח
+
+**עיקרון**: שלב ציטוטים בנרטיב — עם הקדמה ייעודית ומסקנה.
+
+> "Weave quotations deftly into your narrative." (LWPE §29)
+
+> "Say something specific. Assert something. Then let the quotation support what you've said." (LWPE §29)
+
+**הקדמות גרועות** (LWPE §29):
+- "בית המשפט קבע כדלקמן:"
+- "החוק קובע בזו הלשון:"
+
+**הקדמות טובות**:
+- "בית המשפט פסק כי אין לקבל בקשות שהוגשו באיחור ללא טעם מיוחד:"
+- "התוכנית מגבילה במפורש את השימוש למגורים בלבד:"
+
+### ו.4 הפניות — תמציתיות, לא רשימות
+
+**עיקרון**: הימנע מ-"string citations" — רשימות ארוכות של תקדימים.
+
+> "Brevity means abandoning string cites with more than three cases." (MYC §36, חלק הArgument)
+
+> "Obvious points can be made by citing a single governing case, a statute, or even a well-known treatise." (MYC §36)
+
+**יישום**: לנקודה שאינה שנויה במחלוקת — מספיק מקור אחד. לנקודה מרכזית — דון בתקדים מוביל אחד לעומק, ואחריו "ראו גם" עם 1–2 מקורות נוספים.
+
+### ו.5 תאר סמכויות בדיוק קפדני
+
+**עיקרון**: אל תעוות תקדימים. אל תטען שפסק דין אומר יותר ממה שהוא באמת אומר.
+
+> "Persuasive briefing induces the court to draw favorable conclusions from accurate descriptions of your authorities. It never distorts cases to fit the facts." (MYC §48)
+
+> "When even one of your citations fails to live up to your introductory signal... all the rest of your citations inevitably become suspect." (MYC §48)
+
+**יישום**: כשמצטטים פסק דין — ציין אם מדובר בהלכה מחייבת, אמרת אגב, או פסיקת ערכאה שאינה מחייבת. אם התקדים שונה מהמקרה הנדון — אמור זאת.
+
+### ו.6 הזז הפניות ביבליוגרפיות להערות שוליים
+
+**עיקרון**: הפניות (מספרי כרכים ועמודים) צריכות להיות בהערות שוליים, לא בגוף הטקסט.
+
+> "Put citations—and generally only citations—in footnotes. And write in such a way that no reader would ever have to look at your footnotes to know what important authorities you're relying on." (LWPE §28)
+
+> "Citations belong in a footnote: even one full citation... breaks the thought; two, three, or more in one massive paragraph are an abomination." (LWPE §28, ציטוט השופט Wisdom)
+
+**יישום**: שלב את שם בית המשפט ושם התיק בגוף הטקסט ("כפי שקבע בית המשפט העליון בפרשת אליאב"), והעבר את ההפניה הביבליוגרפית להערת שוליים.
+
+---
+
+## ז. טכניקות שכנוע (Making Your Case)
+
+### ז.1 פנה לצדק ולהיגיון בריא
+
+**עיקרון**: הראה שהתוצאה לא רק נכונה משפטית אלא גם צודקת.
+
+> "Appeal not just to rules but to justice and common sense." (MYC §15)
+
+> "You need to give the court a reason you should win that the judge could explain in a sentence or two to a nonlawyer friend." (MYC §15)
+
+**יישום**: בסיום הדיון בכל סוגיה, הוסף משפט שמסביר מדוע התוצאה הגיונית ומידתית — לא רק מדוע היא נכונה טכנית.
+
+### ז.2 שלוט בשדה הסמנטי
+
+**עיקרון**: המילים שבהן אתה משתמש מעצבות את תפיסת הקורא.
+
+> "Labels are important... you should think through the terminology of your case. Use names and words that favor your side of the argument." (MYC §20)
+
+**יישום**: בחר מונחים בקפידה. "סטייה מתוכנית" נשמע אחרת מ"גמישות תכנונית". "מבנה ותיק" נשמע אחרת מ"מבנה ללא היתר". המונחים צריכים לשקף את המסקנה.
+
+### ז.3 סיים בחוזקה — אמור מפורשות מה התוצאה
+
+**עיקרון**: הסיום חייב להיות ברור, חד, ולא פורמלי.
+
+> "Persuasive argument neither comes to an abrupt halt nor trails off in a grab-bag of minor points." (MYC §21)
+
+> "The trite phrase 'for all the foregoing reasons' is hopelessly feeble. Say something forceful and vivid to sum up your points." (MYC §21)
+
+**יישום**: בלוק יא (הכרעה) צריך לחזור בתמציתיות על עיקר ההנמקה ואז לקבוע את התוצאה בצורה חד-משמעית. לא "לאור כל האמור לעיל, הערר נדחה" — אלא סיכום של 2–3 משפטים שמסבירים למה, ואז "הערר נדחה".
+
+### ז.4 לעולם אל תגזים
+
+**עיקרון**: דיוק קפדני חשוב יותר מהגזמה.
+
+> "Never overstate your case. Be scrupulously accurate." (MYC §6)
+
+> "Scrupulous accuracy consists not merely in never making a statement you know to be incorrect (that is mere honesty), but also in never making a statement you are not certain is correct." (MYC §6)
+
+**יישום להחלטות**: אל תכתוב "הפסיקה חד-משמעית" אלא אם היא באמת חד-משמעית. אל תכתוב "אין כל ספק" אלא אם באמת אין. שפה מדויקת מחזקת אמינות; הגזמה מערערת אותה.
+
+### ז.5 מרכז את האש — בחר את הטיעונים הטובים ביותר
+
+**עיקרון**: בחר 2–3 נימוקים מרכזיים ופתח אותם לעומק. אל תפזר.
+
+> "Pick your best independent reasons why you should prevail—preferably no more than three—and develop them fully." (MYC §12)
+
+> "Scattershot argument is ineffective. It gives the impression of weakness and desperation, and it insults the intelligence of the court." (MYC §12)
+
+> "We must not always burden the judge with all the arguments we have discovered, since by doing so we shall at once bore him and render him less inclined to believe us." (MYC §12, ציטוט קווינטיליאן)
+
+**יישום**: בהחלטה, מרכז את ההנמקה ב-2–3 נימוקים חזקים. אם יש 7 טענות של העורר — אין צורך להתייחס לכל אחת באריכות. קבץ טענות חלשות, ותן מענה עמוק לעיקריות.
+
+### ז.6 הבהר מושגים מופשטים באמצעות דוגמאות
+
+**עיקרון**: דוגמה מבהירה יותר מכל הסבר תיאורטי.
+
+> "Nothing clarifies [abstract concepts'] meaning as well as examples." (MYC §42)
+
+**יישום**: כשהדיון נוגע לעקרונות תכנוניים מופשטים (כמו "אופי הסביבה" או "שיקולים מהותיים"), תן דוגמה קונקרטית מהמקרה הנדון.
+
+### ז.7 בהירות מעל לכל
+
+**עיקרון**: בהירות היא הערך העליון. כל ערך סגנוני אחר כפוף לה.
+
+> "In brief-writing, one feature of a good style trumps all others. Literary elegance, erudition, sophistication of expression—these and all other qualities must be sacrificed if they detract from clarity." (MYC §39)
+
+> "This means, for example, that the same word should be used to refer to a particular key concept, even if elegance of style would avoid such repetition in favor of various synonyms." (MYC §39)
+
+**יישום**: אם השתמשת ב"היתר בנייה" — אל תעבור ל"רישיון בנייה" בפסקה הבאה כדי להימנע מחזרה. עקביות מינוחית חשובה יותר מגיוון לשוני.
+
+### ז.8 עשה את הכתיבה מעניינת
+
+**עיקרון**: כתיבה ברורה ותמציתית לא חייבת להיות משעממת.
+
+> "To say that your writing must be clear and brief is not to say that it must be dull." (MYC §43)
+
+> "Three simple ways to add interest to your writing are to enliven your word choices, to mix up your sentence structures, and to vary your sentence lengths." (MYC §43)
+
+> "An occasional arrestingly short sentence can deliver real punch." (MYC §43)
+
+**יישום**: גיוון אורך משפטים (משפטים קצרים וחדים בין משפטים ארוכים יותר); שימוש במטאפורה מדי פעם; סיפור עובדתי שזורם כרונולוגית.
+
+### ז.9 השתמש בשמות, לא בתוויות
+
+**עיקרון**: קרא לצדדים בשמם, לא בתוויות משפטיות.
+
+> "Legal writers have traditionally spoiled their stories by calling people 'Plaintiff' and 'Defendant,' 'Appellant' and 'Appellee'... call people McInerny or Walker or Zook." (LWPE §17)
+
+> "Refer to the bank or the company or the university... Then make sure your story line works." (LWPE §17)
+
+**יישום**: בהחלטה, כתוב "משפחת כהן" או "העוררים" (ולא "המערער" או "העורר 1 והעורר 2"). כשאפשר — שם המשפחה או שם הפרויקט.
+
+### ז.10 סדר כרונולוגי לעובדות
+
+**עיקרון**: ספר את העובדות בסדר כרונולוגי. הימנע מקפיצות בזמן.
+
+> "Order your material in a logical sequence. Use chronology when presenting facts." (LWPE §3)
+
+> "Disruptions in the story line frequently result from opening the narrative with a statement of the immediately preceding steps in litigation." (LWPE §3)
+
+**יישום**: בלוק ו (רקע עובדתי) חייב לעקוב אחר ציר הזמן. אל תפתח בהחלטת הוועדה המקומית ואז תחזור אחורה לתיאור הנכס. התחל מהנכס, המשך לבקשה, דרך ההחלטה, עד הגשת הערר.
+
+### ז.11 הימנע מתאריכים מדויקים מיותרים
+
+**עיקרון**: רוב התאריכים המדויקים מסיחים את דעת הקורא.
+
+> "Never begin statement after statement with dates. A few dates will be important, but for the others simply say 'The next morning...,' 'That afternoon...,' etc." (MYC §36)
+
+**דוגמה מ-LWPE §23**: במקום "ביום 12.2.1995 בשעה 15:00 בערך, במהלך מקלחת, התובעת נפלה..." — "בפברואר 1995, במהלך מקלחת, גב' ווקר נפלה..."
+
+**יישום**: בבלוק ו, ציין תאריכים מדויקים רק כשהם משמעותיים (מועד הגשה, תוקף תוכנית). אחרת — "כחודש לאחר מכן", "בתחילת 2023".
+
+### ז.12 הכל צריך להישמע טבעי
+
+**עיקרון**: אם לא היית אומר את זה בעל פה — אל תכתוב את זה.
+
+> "Here's a good test of naturalness: if you wouldn't say it, then don't write it." (LWPE §20)
+
+> "Generally, the best approach in writing is to be relaxed and natural. That bespeaks confidence." (LWPE §20)
+
+**יישום**: קרא את הטיוטה בקול רם. אם מילה או ביטוי גורמים לך להיתקע — החלף אותם.
+
+---
+
+## סיכום: 10 עקרונות העל
+
+1. **חשוב סילוגיסטית**: כל נימוק = כלל + עובדות + מסקנה
+2. **פתח בתמצית**: הקורא צריך לדעת מה התוצאה מהעמוד הראשון
+3. **נסח בבהירות**: ממוצע 20 מילים למשפט, בניין פעיל, נושא-נשוא קרובים
+4. **ארגן בהיגיון**: כותרות אינפורמטיביות, פסקת מפה, סדר מהחזק לחלש
+5. **התמודד עם טענות נגדיות**: הכר בהן, הצג אותן בהגינות, הפרך באמצע
+6. **צטט במשורה**: פרפרז עדיף; ציטוט רק כשהמילים המדויקות חשובות
+7. **מרכז את ההנמקה**: 2–3 נימוקים חזקים, לא 7 חלשים
+8. **ספר סיפור**: עובדות בסדר כרונולוגי, בשמות אמיתיים, ללא תאריכים מיותרים
+9. **סיים בחוזקה**: סיכום רענן של ההנמקה, ואז תוצאה חד-משמעית
+10. **לעולם אל תגזים**: דיוק קפדני בונה אמינות; הגזמה הורסת אותה

docs/legal-decision-lessons.md

@@ -161,3 +161,94 @@ Our skill was "over-indexed" on one case type (הכט = rejected appeal). The co
 - Created `create-decision-structure.cjs` script for generating structure DOCX
 - Key innovation from Arieli: "ההליכים בפני ועדת הערר" as separate section (Block ח)
 - "Judge Test": every block written as if administrative court judge reads cold
+
+---
+
+## Lessons from Systematic Corpus Analysis (24 decisions, April 2026)
+
+### Source
+- All 24 proofread decisions in `/data/training/proofread/`
+- Full analysis: [`docs/corpus-analysis.md`](corpus-analysis.md)
+- Date: April 2026
+
+### 12. System Learned Style but Not Substantive Content
+- **Problem:** Dafna reviewed Kiryat Yearim draft and noted missing planning discussion in block-yod
+- **Root cause:** The block-yod prompt taught CREAC methodology and "answer all claims" but never said "in licensing cases, include comprehensive planning discussion"
+- **Fix:** Content checklists added to `lessons.py` (`CONTENT_CHECKLISTS`), injected into block-yod prompt via `{content_checklist}`
+- **Applied to:** `lessons.py`, `block_writer.py`
+
+### 13. Corpus Composition — All Licensing, No Betterment Levy
+- All 24 training decisions are licensing/construction (1xxx)
+- Zero betterment levy (8xxx) decisions in corpus
+- Not a current priority gap — focusing on licensing first
+
+### 14. Planning Discussion Patterns in Licensing Decisions
+- **Always present** when the appeal reaches substantive planning questions
+- **Never present** when the appeal is purely jurisdictional or property-based
+- **Structure**: broad planning context → direct plan provision citations (200-600 words) → application to specific case → planning conclusion
+- **Deepest planning**: פרומר (pure plan interpretation), לבנון (height/building appendix), בית הכרם (multi-plan TAMA 38)
+- **No planning**: טלי-אביב (property only), גבאי (jurisdiction only)
+
+### 15. Five Appeal Subtypes Identified (Not Just Three)
+Licensing appeals are not homogeneous — the discussion structure varies significantly:
+1. **Substantive licensing** — full planning discussion + legal analysis (majority of cases)
+2. **Threshold/jurisdiction** — legal analysis only, no planning
+3. **Property-focused** — תימוכין קנייניים, minimal planning
+4. **TAMA 38** — balancing public interest + planning + neighbor impact
+5. **Deviant use (שימוש חורג)** — deep plan interpretation across multiple plans
+
+### 16. Chair Feedback System Established
+- DB table `chair_feedback` records Dafna's comments on drafts
+- Categories: missing_content, wrong_tone, wrong_structure, factual_error, style, other
+- MCP tools + UI page for recording and reviewing feedback
+- First entry: Kiryat Yearim — missing planning discussion (2026-04-12)
+
+---
+
+## Lessons from External Expertise Research (April 2026)
+
+### Source
+- Federal Judicial Center, *Judicial Writing Manual* (1991, 2nd ed. 2020)
+- Bryan Garner, *Legal Writing in Plain English* (2001)
+- Scalia & Garner, *Making Your Case: The Art of Persuading Judges* (2008)
+- Richard Posner, *How Judges Think* (2008)
+- Full texts stored in: `docs/sources/`
+
+### 17. Methodology Document Created — Separating "How to Think" from "How to Write"
+
+**Problem:** The system knew Dafna's STYLE (SKILL.md) and WHAT TOPICS to cover (content checklists), but had no formal methodology for HOW TO REASON through a decision — the analytical stages, when to balance, how to structure arguments, how to handle counterarguments.
+
+**Fix:** Created `docs/decision-methodology.md` — a standalone analytical methodology document based on synthesis of all four external sources. 3,400 words, 12 sections, 10 guiding principles. Covers: pre-analysis, threshold questions, issue ordering, syllogistic structure (CREAC), balancing/proportionality, claims handling (steel-man, bundling), quotation technique (sandwich), factual findings vs. legal conclusions, disposition, writing techniques, analogy/precedent, editing checklist.
+
+**Key principle:** Methodology is UNIVERSAL — it teaches how to think about any quasi-judicial decision. It does not contain case-specific content (parking, building lines, etc.). Case-specific content stays in the content checklists.
+
+**Applied to:**
+- `docs/decision-methodology.md` — new document
+- `lessons.py` — new function `get_methodology_summary()` injected into block-yod prompt
+- `block_writer.py` — new `{methodology_guidance}` placeholder in block-yod prompt
+- `.claude/agents/legal-writer.md` — restructured block-yod workflow to follow methodology stages
+- `.claude/agents/legal-qa.md` — new check #7 (methodology compliance)
+
+### 18. "Answer All Claims" Made Flexible
+
+**Problem:** The block-yod prompt hardcoded "answer every claim individually" and the QA check enforced it. But Dafna sometimes bundles weak claims, skips irrelevant ones, and focuses on what matters.
+
+**Fix:**
+- Block-yod prompt changed from "חובה לענות על כל אחת" to flexible handling: address substantive claims; bundle [bundle]; skip [skip]
+- Chair can mark claims in `chair_directions` as bundle or skip
+- QA check #3 updated to respect these markings
+- Methodology teaches WHEN to address individually vs. bundle vs. skip (methodology §ו)
+
+### 19. Source Library Established
+
+Downloaded and converted to text 5 authoritative sources for the methodology:
+- `docs/sources/fjc-judicial-writing-manual-1991.txt` (13,567 words)
+- `docs/sources/fjc-judicial-writing-manual-2nd-ed-2020.txt` (15,912 words)
+- `docs/sources/garner-legal-writing-plain-english.txt` (97,475 words)
+- `docs/sources/posner-how-judges-think.txt` (156,789 words)
+- `docs/sources/scalia-garner-making-your-case.txt` (54,683 words)
+Total: ~340,000 words of source material.
+
+Intermediate extraction documents also saved:
+- `docs/fjc-principles-extraction.md` — 38 principles from FJC
+- `docs/garner-methodology-extraction.md` — ~50 principles from Garner/Scalia

docs/sources/garner-legal-writing-plain-english-2nd.pdf

@@ -0,0 +1,535 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+	<META HTTP-EQUIV="CACHE-CONTROL" CONTENT="max-age=604800, must-revalidate">
+	<meta name="rating" content="general">
+	<!--<link href="/rss/index.php" rel="alternate" type="application/rss+xml" title="News" />-->
+	<link rel="shortcut icon" href="/img/favicon.ico" type="image/x-icon">
+	<title>Library Genesis</title>
+		
+	<!--[if IE 6]>
+	<style>
+		body {behavior: url("/csshover3.htc");}
+		#menu li .drop {background:url("img/drop.gif") no-repeat right 8px; 
+	</style>
+	<![endif]-->
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/css/bootstrap.min.css">	
+	
+<link href="/css/font.min.css" rel="stylesheet">	
+<style>
+nav.navbar .dropdown:hover > .dropdown-menu {
+ display: block; 
+}
+.bd-placeholder-img {
+	font-size: 1.125rem;
+	text-anchor: middle;
+	-webkit-user-select: none;
+	-moz-user-select: none;
+	-ms-user-select: none;
+	user-select: none;
+}
+@media (min-width: 768px) {
+			.bd-placeholder-img-lg {
+			font-size: 3.5rem;
+		}
+	}
+
+.panel-heading .accordion-toggle:after {
+    font-family: "Glyphicons Halflings";  
+    content: "\e114";    
+    float: right;       
+    color: grey;         
+}
+.panel-heading .accordion-toggle.collapsed:after {
+    content: "\e080";   
+}
+.tooltip-inner {
+    max-width: 350px;
+    width: 350px; 
+}
+h1 {
+	display: block; 
+	font-size: 1.8rem; 
+	font-weight: bold; 
+	font-family: Georgia, "Times New Roman", Times, serif;  color: #A00000; 
+}
+#tablelibgen td { 
+	font-family: "Pt Sans", Tahoma, Helvetica, sans-serif; 
+	margin: 0; 
+	padding: 0em 3px; 
+	font-size: 1rem;
+}
+
+#tablelibgen1 td { 
+	font-family: "Pt Sans", Tahoma, Helvetica, sans-serif; 
+	margin: 0; 
+	padding: 0em 3px; 
+	font-size: 1rem;
+}
+
+.taghide {
+    display: none; 
+}
+.taghide + label ~ div {
+    display: none;
+}
+/* оформляем текст label */
+.taghide + label {
+    display: inline-block; 
+}
+/* вид текста label при активном переключателе */
+
+/* когда чекбокс активен показываем блоки с содержанием  */
+.taghide:checked + label + div {
+    display: block; 
+}
+
+
+
+/*.navbar {
+	background-color: #BBBBBB;
+}*/
+	</style>
+
+	<link rel="stylesheet" href="/css/dark-mode.css">
+	<script src="https://code.jquery.com/jquery-3.6.0.min.js" integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" crossorigin="anonymous"></script>
+<style>p {margin: 0;}</style>
+
+
+
+
+</head>
+<body><script>
+(function () {
+    var script = document.createElement('script');
+var COOKIE_NAME = 'test_variant';
+    var valueFromCookie = getCookie(COOKIE_NAME);
+    var variant;
+
+    function getCookie(name) {
+    var cookiesList = document.cookie.split(';');
+
+for (var i = 0, length = cookiesList.length; i < length; i += 1) {
+    var cookie = cookiesList[i].split('=');
+
+    if (cookie[0].trim() === name) {
+    return Number(cookie[1].trim());
+}
+}
+
+    return null;
+}
+
+    function setCookie(name, value) {
+    document.cookie = [
+    name + '=' + value,
+    'SameSite=Lax',
+    'path=/',
+    'Expires=' +
+    new Date(new Date().getTime() + 14 * 24 * 60 * 60 * 1000).toUTCString(),
+    ].join(';');
+}
+
+    if (valueFromCookie === null) {
+    variant = Math.random();
+    setCookie(COOKIE_NAME, variant);
+} else {
+    variant = valueFromCookie;
+}
+    if (variant < 0.5) {
+    script.setAttribute('data-domain', 'features-2562_0');
+    script.setAttribute('src', '//inopportunefable.com/7d/78/3d/7d783dc7f86db4429028d485a085a9b7.js');
+
+    window.addEventListener('DOMContentLoaded', function () {
+    if (
+    document.body.querySelector('script[data-domain="features-2562_0"]') ===
+    null
+    ) {
+    document.body.appendChild(script);
+}
+});
+} else {
+    script.setAttribute('data-domain', 'features-2562_1');
+    /* dynamic */ script.setAttribute('src', '//inopportunefable.com/imw/zIaHmB/0nCsRHnp/SCgHBcfS8hOrJa4/854J8Er1gxI1LoK32BBg/zk6iz1O4Lg/JiGAhxO4-ENw6/hJq3/4gzKxMG_mlKcbOl/08XbF_y6D5em/sH0oBrSV1A0hSBB/GxBx');
+
+    window.addEventListener('DOMContentLoaded', function () {
+    if (
+    document.body.querySelector('script[data-domain="features-2562_1"]') ===
+    null
+    ) {
+    document.body.appendChild(script);
+}
+});
+}
+})();
+</script>    
+<nav class="navbar navbar-expand-md navbar-dark bg-secondary  mb-1">
+  
+   <a class="navbar-brand" href="/index.php">
+    <img src="/img/logo.png"  height="30" alt="">
+  </a>
+  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarCollapse" aria-controls="navbarCollapse" aria-expanded="false" aria-label="Toggle navigation">
+    <span class="navbar-toggler-icon"></span>
+  </button>
+  <div class="collapse navbar-collapse" id="navbarCollapse">
+    <ul class="navbar-nav mr-auto">
+      <li class="nav-item active">
+        <a class="nav-link" href="/community/app.php/article/news">NEWS <span class="sr-only">(current)</span></a>
+      </li>
+      <li class="nav-item active">
+        <a class="nav-link" href="/community/">FORUM <span class="sr-only">(current)</span></a>
+      </li>
+	
+      <li class="nav-item dropdown">
+<a class="btn btn-secondary dropdown-toggle" href="/community/ucp.php?mode=login" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          LOGIN
+        </a>
+        <div class="dropdown-menu" aria-labelledby="dropdown01">    
+          <a class="dropdown-item" href="/community/ucp.php?mode=register">Register</a>
+        </div>
+      </li>
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          DOWNLOAD
+        </a>
+        <div class="dropdown-menu" aria-labelledby="dropdown01">      
+
+          <a class="dropdown-item" href="/mirrors.php">Mirrors</a>
+          <a class="dropdown-item" href="http://libgenfrialc7tguyjywa36vtrdcplwpxaw43h6o63dmmwhvavo5rqqd.onion/">TOR</a>
+
+	<div class="dropdown-divider"></div>
+         <h6 class="dropdown-header">P2P</h6>
+          <a class="dropdown-item" href="/torrents/">Torrents</a>
+          <a class="dropdown-item" href="https://ipdl.cat/data/torrents.html">Torrents status</a>
+          <a class="dropdown-item" href="/nzb/">Usenet (*.nzb)</a>
+          <a class="dropdown-item" href="/soft/">Soft</a>
+	<!--https://phillm.net/libgen-stats-table.php-->
+
+
+
+
+	<div class="dropdown-divider"></div>
+         <h6 class="dropdown-header">DB Dumps</h6>
+          <a class="dropdown-item" href="/dirlist.php?dir=dbdumps">Libgen</a>
+          <a class="dropdown-item" href="http://libgen.rs/dbdumps/">libgen.rs (gen.lib.rus.ec)</a>
+
+	<!--<div class="dropdown-divider"></div>
+ 	 <a class="dropdown-item" href="/magz0/">Unsorted magz</a>
+ 	 <a class="dropdown-item" href="/fict0/">Unsorted fiction</a>
+
+	 <a class="dropdown-item" href="/comics4/">Unsorted comics</a>
+        </div>-->
+
+      </li>
+
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="librarian.php" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          UPLOAD
+        </a>
+        <div class="dropdown-menu" aria-labelledby="dropdown01">  
+          <a class="dropdown-item" href="ftp://ftp.libgen.bz/upload/">FTP</a> 
+        </div>
+      </li>
+
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="/index.php?req=fmode:last&topics1=all" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          LAST
+        </a>
+
+        <div class="dropdown-menu" aria-labelledby="dropdown01">
+	<a class="dropdown-item" href="/index.php?req=fmode:last&topics1=all"><b>Files</b></a>
+
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=l">Libgen</a>
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=a">Scientific Articles</a> 
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=f">Fiction</a> 
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=c">Comics</a> 
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=m">Magazines</a> 
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=s">Standards</a> 
+          <a class="dropdown-item" href="/index.php?req=fmode:last&topics%5B%5D=r">Fiction RUS</a>
+	<div class="dropdown-divider"></div>
+          <a class="dropdown-item" href="/index.php?req=mode:last&curtab=e">Editions</a> 
+          <a class="dropdown-item" href="/index.php?req=mode:last&curtab=s">Series</a>
+          <a class="dropdown-item" href="/index.php?req=mode:last&curtab=p">Publishers</a> 
+        <!--  <a class="dropdown-item" href="/index.php?req=mode:last&curtab=f">Files</a> -->
+          <a class="dropdown-item" href="/index.php?req=mode:last&curtab=a">Authors</a> 
+          <a class="dropdown-item" href="/index.php?req=mode:last&curtab=w">Works</a>
+
+
+  
+        </div>
+
+
+      </li>
+
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          OTHERS
+        </a>
+
+        <div class="dropdown-menu" aria-labelledby="dropdown01">  
+          <a class="dropdown-item" href="json.php">API</a> 
+          <a class="dropdown-item" href="rss.php">RSS</a> 
+          <a class="dropdown-item" href="top.php">Top 100 users</a> 
+          <a class="dropdown-item" href="stat.php">Stats</a>
+
+	<a class="dropdown-item" href="topics.php">Topics</a>
+
+          <a class="dropdown-item" href="batchsearchindex.php">Batch search</a>  
+          <a class="dropdown-item" href="biblioservice.php">Bibliographic services</a>
+          <a class="dropdown-item" href="https://wiki.mhut.org/software:libgen_desktop">Libgen librarian for desktop</a>
+
+
+          <a class="dropdown-item" href="/code/">Source (PHP)</a>
+          <a class="dropdown-item" href="/soft/">LG soft</a>
+          <!--<a class="dropdown-item" href="/import/">Import local files in LG format</a>-->
+          <a class="dropdown-item" href="https://z-library.se/fulltext/">Full text search</a>
+
+
+
+        </div>
+      </li>
+
+
+
+     <!-- <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="topics.php" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          Topics
+        </a>
+      </li>
+-->
+
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          LINKS
+        </a>
+
+        <div class="dropdown-menu" aria-labelledby="dropdown01">  
+
+
+          
+          <a class="dropdown-item" href="http://sci-hub.ru">Sci-hub</a> 
+          <a class="dropdown-item" href="http://magzdb.org">Magzdb.org</a>
+
+          <a class="dropdown-item" href="http://nlr.ru/rlin/Periodika_rus.php">РНБ</a>
+          <a class="dropdown-item" href="http://rsl.ru/">РГБ</a>
+          <a class="dropdown-item" href="http://loc.gov/">LOC</a>
+          <a class="dropdown-item" href="https://comicvine.gamespot.com/">ComicVine</a>
+          <a class="dropdown-item" href="http://cyberleninka.ru/">Cyberleninka</a>
+          <a class="dropdown-item" href="http://lib.rus.ec/">Lib.rus.ec</a>
+          <a class="dropdown-item" href="http://flibusta.net/">Flibusta.net</a>
+          <a class="dropdown-item" href="http://goodreads.com/">Goodreads.com</a>
+          <a class="dropdown-item" href="http://worldcat.org/">Worldcat.org</a>
+          <a class="dropdown-item" href="https://wiki.archiveteam.org/">Archive team</a>
+          <a class="dropdown-item" href="https://www.reddit.com/r/libgen/">Reddit</a>
+          <a class="dropdown-item" href="http://annas-archive.org/">Anna's Archive</a>
+          <a class="dropdown-item" href="https://welib.org/">Welib</a>
+          <a class="dropdown-item" href="https://open-slum.org/">The Shadow Library Uptime Monitor</a>
+
+        </div>
+
+      </li>
+
+
+      <li class="nav-item dropdown">
+        <a class="btn btn-secondary" href="index.php?req=mode:req&curtab=e" role="button" id="dropdownMenuLink"  aria-haspopup="true" aria-expanded="false">
+          WANTED
+        </a>
+      </li>
+
+    </ul>
+  </div>
+
+  <div class="nav-link">
+
+    <div class="custom-control custom-switch">
+      <input type="checkbox" class="custom-control-input" id="darkSwitch">
+      <label class="custom-control-label" for="darkSwitch">🌓</label>
+    </div>
+    <script src="/js/dark-mode-switch.js"></script>
+  </div>
+   <a class="navbar-brand" href="setlang.php?md5=1b1ba2439cfa9fa6f44bab813e9b7bab&lang=ru">RU</a>
+</nav>
+<span></span><table id=main  align="center" border=1>
+
+
+
+
+		<tr>
+	
+		<td align="left" valign="top" bgcolor="#F5F6CE" width=1 nowrap></td>
+		<td align="center" valign="top" bgcolor="#A9F5BC"><a href="get.php?md5=1b1ba2439cfa9fa6f44bab813e9b7bab&key=5TQ3IXLH0VDDKN79"><h2>GET</h2></a></td>
+		<td align="left" valign="top" bgcolor="#F5F6CE" width=1></td>
+		</tr>
+		<tr>
+	
+		<td bgcolor="#F5F6CE" valign=top></td>
+		<td>
+<table width=700 border=0>
+<tr><td  colspan=3 bgcolor="#F5F6CE" align="center"><nobr><script type="text/javascript">
+	atOptions = {
+		'key' : '8653b0dc857008353ad71d83dad80b6d',
+		'format' : 'iframe',
+		'height' : 90,
+		'width' : 728,
+		'params' : {}
+	};
+	document.write('<scr' + 'ipt type="text/javascript" src="http' + (location.protocol === 'https:' ? 's' : '') + '://inopportunefable.com/8653b0dc857008353ad71d83dad80b6d/invoke.js"></scr' + 'ipt>');
+</script></nobr></td></tr>
+<tr><td  rowspan=2><a href="/covers/1586000/1b1ba2439cfa9fa6f44bab813e9b7bab.jpg"><img src="/covers/1586000/1b1ba2439cfa9fa6f44bab813e9b7bab.jpg" width=300></a></td><td>Title: Legal Writing in Plain English: A Text with Exercises<br>
+Series: Chicago Guides to Writing, Editing, and Publishing<br>
+Author(s): Bryan A. Garner<br>
+Publisher: University Of Chicago Press<br>
+Year: 2013<br>
+ISBN: 0226283933; 9780226283937<br></td>
+
+<tr><td><textarea rows='9' name='bibtext' id='bibtext' readonly cols='60'>@book{book:{92607912},
+   title =     {Legal Writing in Plain English: A Text with Exercises},
+   author =    {Bryan A. Garner},
+   publisher = {University Of Chicago Press},
+   isbn =      {0226283933; 9780226283937},
+   year =      {2013},
+   series =    {Chicago Guides to Writing, Editing, and Publishing},
+   edition =   {2},
+   url =       {libgen.li/file.php?md5=1b1ba2439cfa9fa6f44bab813e9b7bab}}</textarea></td></tr>
+<tr><td colspan=3><p style='text-align:center'>
+<a href='https://www.worldcat.org/search?qt=worldcat_org_bks&q=Legal%20Writing%20in%20Plain%20English%3A%20A%20Text%20with%20Exercises&fq=dt%3Abks'>Search in WorldCat</a> 
+<a href='https://www.goodreads.com/search?utf8=✓&query=Legal%20Writing%20in%20Plain%20English%3A%20A%20Text%20with%20Exercises'>Search in Goodreads</a><br>
+<a href='https://www.abebooks.com/servlet/SearchResults?tn=Legal%20Writing%20in%20Plain%20English%3A%20A%20Text%20with%20Exercises&pt=book&cm_sp=pan-_-srp-_-ptbook'>Search in AbeBooks</a></td></tr>
+</table>
+</td>
+		<td bgcolor="#F5F6CE" valign=top></td>
+		</tr>
+
+		<tr><td></td><td colspan=2></td></tr>
+		<tr><td colspan=3 bgcolor="#F5F6CE" align="center"><script type="text/javascript">
+	atOptions = {
+		'key' : '8653b0dc857008353ad71d83dad80b6d',
+		'format' : 'iframe',
+		'height' : 90,
+		'width' : 728,
+		'params' : {}
+	};
+	document.write('<scr' + 'ipt type="text/javascript" src="http' + (location.protocol === 'https:' ? 's' : '') + '://inopportunefable.com/8653b0dc857008353ad71d83dad80b6d/invoke.js"></scr' + 'ipt>');
+</script><br><script type="text/javascript">
+	atOptions = {
+		'key' : '8653b0dc857008353ad71d83dad80b6d',
+		'format' : 'iframe',
+		'height' : 90,
+		'width' : 728,
+		'params' : {}
+	};
+	document.write('<scr' + 'ipt type="text/javascript" src="http' + (location.protocol === 'https:' ? 's' : '') + '://inopportunefable.com/8653b0dc857008353ad71d83dad80b6d/invoke.js"></scr' + 'ipt>');
+</script></td></tr>
+		</table><nav class="navbar sticky-bottom navbar-expand-sm navbar-dark bg-secondary">
+  <div class="collapse navbar-collapse" id="navbarCollapse">
+    <ul class="navbar-nav mr-auto">
+      <li class="nav-item">
+	    <a class="nav-link" href="#" data-toggle="modal" data-target="#dmcamodal">DMCA</a>
+      </li>
+      <li class="nav-item">
+	    <a class="nav-link" href="#" data-toggle="modal" data-target="#aboutmodal">ABOUT</a>
+      </li>
+      <li class="nav-item">
+	    <a class="nav-link" href="#" data-toggle="modal" data-target="#donatemodal" >DONATE</a>
+      </li>
+	
+    </ul>
+	<span class="navbar-text">Users online 5949</span>
+  </div>
+</nav>
+
+<!-- Modal Donate -->
+<div class="modal fade text-dark" id="donatemodal" tabindex="-1" aria-labelledby="donatemodalLabel" aria-hidden="true">
+  <div class="modal-dialog">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="donatemodalLabel">Donate</h5>
+        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+          <span aria-hidden="true">&times;</span>
+        </button>
+      </div>
+      <div class="modal-body">
+        <a href="bitcoin://bc1qlv9lwa5vncm2jjrxyhddfcvu0z3u5vn0s9672r">Bitcoin</a>
+	<br>
+        <a href="monero:48WhyKv4D9x53SyDFNYuMsHsDzuHXEcht4mWoFtXtE3k4KZ3A7goi3CQWBQQZ3A8PSK7CpwnAFKLnfGiZTAbEpcaCQCghvN">Monero</a>
+      </div>
+    </div>
+  </div>
+</div>
+
+<!-- Modal About -->
+<div class="modal fade text-dark" id="aboutmodal" tabindex="-1" aria-labelledby="aboutmodalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-lg">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="aboutmodalLabel">About</h5>
+        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+          <span aria-hidden="true">&times;</span>
+        </button>
+      </div>
+      <div class="modal-body">
+
+
+<div id="about">
+The Library Genesis aggregator is a community aiming at collecting and cataloging items descriptions for the most part of scientific, 
+scientific and technical directions, as well as file metadata. In addition to the descriptions, 
+the aggregator contains only links to third-party resources hosted by users. 
+All information posted on the website is collected from publicly available public Internet resources and is intended solely for informational purposes.  
+</div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<!-- Modal DMCA -->
+<div class="modal fade text-dark" id="dmcamodal" tabindex="-1" aria-labelledby="dmcamodalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-lg">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="dmcamodalLabel">About</h5>
+        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+          <span aria-hidden="true">&times;</span>
+        </button>
+      </div>
+      <div class="modal-body">
+
+<div id="dmca">
+Library Genesis - aggregator items is a website that collects and organizes online items from users. 
+Item aggregation is done for fact-finding purposes, and website Library Genesis respects the rights of copyright holders and respect dcma.
+
+     Removing Content From Library Genesis / DMCA Policy
+     Library Genesis respects the intellectual property of others.
+</div>
+
+    <div class="dmca">
+     If you believe that your copyrighted work has been copied in a way that constitutes copyright infringement and is accessible on this site, you may notify our copyright agent, as set forth in the Digital Millennium Copyright Act of 1998 (DMCA). For your complaint to be valid under the DMCA, you must provide the following information when providing notice of the claimed copyright infringement:
+</div>
+    <div class="dmca">
+     * A physical or electronic signature of a person authorized to act on behalf of the copyright owner Identification of the copyrighted work claimed to have been infringed <br />
+     * Identification of the material that is claimed to be infringing or to be the subject of the infringing activity and that is to be removed <br />
+     * Information reasonably sufficient to permit the service provider to contact the complaining party, such as an address, telephone number, and, if available, an electronic mail address <br />
+     * A statement that the complaining party "in good faith believes that use of the material in the manner complained of is not authorized by the copyright owner, its agent, or law" <br />
+     * A statement that the "information in the notification is accurate", and "under penalty of perjury, the complaining party is authorized to act on behalf of the owner of an exclusive right that is allegedly infringed" <br />
+     The above information must be submitted as a written, faxed or emailed notification to the following Designated Agent: ianzlib@protonmail.com. Appeals will be reviewed within 72 hours.</div>
+
+
+      </div>
+    </div>
+  </div>
+</div>
+
+
+	<script src="https://cdn.jsdelivr.net/npm/popper.js@1.12.5/dist/popper.min.js"></script>
+	<script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/js/bootstrap.min.js" integrity="sha384-w1Q4orYjBQndcko6MimVbzY0tgp4pWB4lZ7lr30WKz0vr/aWKhXdBNmNb5D92v7s" crossorigin="anonymous"></script>
+	<script src="https://cdn.jsdelivr.net/npm/bootstrap@4.5.3/dist/js/bootstrap.bundle.min.js" integrity="sha384-ho+j7jyWK8fNQe+A12Hb8AhRq26LrZ/JpcUGGOn+Y7RsweNrtN/tE3MoK7ZeZDyx" crossorigin="anonymous"></script>
+	<script src="/js/form-validation.js"></script>
+	<script>
+$('[data-toggle="tooltip"]').tooltip();
+$('.btn-tooltip-bottom').tooltip({
+    placement: 'bottom'
+});
+</script>
+
+</body>
+</html>

docs/sources/instructions-chairman-appeals-2024.txt

@@ -0,0 +1,261 @@
+‫הנחיות יו"ר ועדת המשנה לעררים על החלטות הוועדה‬
+‫המחוזית והולחוף‬
+
+‫יחידה‬
+
+‫ועדת המשנה לעררים‬
+‫המועצה הארצית לתכנון‬
+‫ולבניה‬
+
+‫מס' נוהל‬
+
+‫תאריך פרסום מקורי‬
+
+‫תאריך פרסום עדכני‬
+
+‫‪2019/1‬‬
+
+‫‪11.03.2019‬‬
+
+‫‪26.03.2024‬‬
+
+‫הנחיות יו"ר ועדת המשנה לעררים על‬
+‫החלטות הוועדה המחוזית והולחוף‬
+‫על מנת לייעל את ההליכים לפני ועדת המשנה לעררים ולעמוד בלוחות הזמנים הקצובים‬
+‫בתקנות התכנון והבניה (ערר בפני המועצה הארצית)‪ ,‬התשל"ב‪ ,1972 -‬ובתקנות התכנון‬
+‫והבניה ( סדרי דין בפני ועדת הערר למימי חופין)‪ ,‬תש"ל‪( 1969-‬להלן ביחד‪ :‬תקנות העררים) ‪,‬‬
+‫הוחלט לגבש את ההנחיות הבאות ולהביאן לידיעת הציבור‪.‬‬
+‫ההנחיות יחולו על הליכי הערר החל ממועד פרסומן‪.‬‬
+‫חשוב‪ :‬כל תגובה‪ ,‬בקשה או פניה בנוגע לערר‪ ,‬לרבות בקשה להתווסף לרשימת התפוצה‬
+‫בדוא"ל או הסרה ממנה‪ ,‬יש להפנות למזכירות ועדת המשנה לעררים בכתובת הדוא"ל ‪:‬‬
+‫‪ Arr@iplan.gov.il‬להלן‪ ( :‬המזכירות) ‪ .‬הגשת פניה לגורם אחר או באמצעי אחר כמוה אי‪-‬‬
+‫הגשה‪.‬‬
+‫‪ . 1‬הגשת בקשות‬
+‫א‪.‬‬
+
+‫כל בקשה המוגשת לוועדה ( לרבות‪ :‬בקשות להארכת מועד‪ ,‬בקשות לשינוי מועד דיון ‪,‬‬
+
+‫בקשות לצירוף מסמכים‪ ,‬בקשות להצטרפות כמשיבים לערר וכדו') תוגש למזכירות‬
+‫בליווי התייחסות יתר הצדדים להליך הערר כפי שקבעו תקנות העררים‪ .‬בקשות שיוגשו‬
+‫ללא עמדת יתר הצדדים כאמור‪ ,‬או הסבר בנושא‪ ,‬יושבו למבקש על‪-‬ידי המזכירות‬
+‫לצורך השלמה‪.‬‬
+‫ב‪.‬‬
+
+‫בקשה להארכת מועד להגשת ערר‬
+‫על פי סעיף ‪(110‬ד) לחוק התכנון והבניה‪ ,‬התשכ"ה‪( 1965-‬להלן‪ " :‬החוק")‪ ,‬ערר יוגש‬
+‫בתוך שלושים ימים מהיום שבו הומצאה לעורר החלטת הוועדה המחוזית‪ ,‬או הרשות‬
+‫לערור‪ ,‬לפי העניין‪ .‬עררים שיוגשו באיחור וללא ארכה שאושרה על ידי יו"ר הוועדה‪,‬‬
+‫יידחו על הסף‪.‬‬
+‫(‪ )1‬במקרה שבו נבצר מהעורר להגיש את הערר במועד‪ ,‬יש להגיש בקשה להארכת‬
+‫מועד ‪ .‬בבקשה יש לציין את המועד שבו התקבלה החלטת הוועדה המחוזית או הרשות‬
+‫לערור ‪,‬לפי העניין‪.‬‬
+‫(‪ )2‬בקשה להארכת מועד להגשת ערר ת היה מנומקת‪ ,‬ויצורפו לה תגובות הצדדים‬
+‫לבקשה‪.‬‬
+‫(‪ )3‬במקרה שבו הבקשה מתבססת על טענות עובדתיות )כגון – לעניין המועד שבו‬
+‫הומצאה לעורר החלטת הוועדה המחוזית או הרשות לערור(‪ ,‬יש לתמוך את הבקשה‬
+‫בראיות מתאימות‪.‬‬
+
+‫|‪1‬‬
+
+‫הנחיות יו"ר ועדת המשנה לעררים על החלטות הוועדה‬
+‫המחוזית והולחוף‬
+
+‫ג‪.‬‬
+
+‫יחידה‬
+
+‫ועדת המשנה לעררים‬
+‫המועצה הארצית לתכנון‬
+‫ולבניה‬
+
+‫מס' נוהל‬
+
+‫תאריך פרסום מקורי‬
+
+‫תאריך פרסום עדכני‬
+
+‫‪2019/1‬‬
+
+‫‪11.03.2019‬‬
+
+‫‪26.03.2024‬‬
+
+‫בקשות לשינוי מועד הדיון‬
+‫(‪ ) 1‬ככלל‪ ,‬דיוני ועדת המשנה לעררים מתקיימים בימי חמישי‪.‬‬
+‫(‪ ) 2‬הכלל הוא כי הדיונים יתקיימו במועד שנקבע להם‪ .‬שיקולי נוחות‪ ,‬הסכמת‬
+‫הצדדים ‪ ,‬קיום משא ומתן לפשרה‪ ,‬נסיבות אישיות או עומס עבודה אינם מהווים‪,‬‬
+‫ככלל‪ ,‬הצדקה לדחיית הדיון‪ .‬במקרים של נסיבות אישיות חריגות ובלתי‪-‬צפויות‬
+‫תישקל דחיית הדיון‪ ,‬תוך התחשב ות במאפייני התוכנית ובעיכוב שייגרם כתוצאה‬
+‫מאישור הדחייה‪.‬‬
+‫(‪ ) 3‬בקשה לדחיית דיון בשל קיומו של דיון מקביל תוגש מיד עם קבלת הידיעה על‬
+‫מועד הדיון‪ ,‬ותישקל בהתאם לנסיבות‪.‬‬
+‫(‪ ) 4‬כל בקשה לשינוי מועד הדיון בערר תכלול לפחות שלושה מועדים חלופיים לקיום‬
+‫הדיון‪ ,‬שתואמו מבעוד מועד מול מזכירות הוועדה ומוסכמים על יתר הצדדים‬
+‫לערר ‪ ,‬אין מניעה להגיש בקשה להקדמת הדיון בערר‪ ,‬הכול בכפוף ללוח הזמנים‬
+‫של הוועדה ‪ .‬אין באמור לעיל כדי לגרוע מסמכות הוועדה לקבוע דיון במועד אחר‬
+‫המתאים ליומנה‪.‬‬
+
+‫‪ .2‬המשיבים בערר‬
+‫בכתב הערר יש לפרט את המשיבים בערר לפי תקנות הע ררים‪ ,‬ואותם בלבד‪ ,‬כאמור להלן‪:‬‬
+‫א‪ .‬על פי תקנה ‪ 4‬לתקנות התכנון והבניה (ערר בפני המועצה הארצית)‪ ,‬התשל"ב‪,1972 -‬‬
+‫המשיבים בערר הם‪:‬‬
+‫(‪ ) 1‬בערר לפי סעיפים ‪(78‬ב)(‪ )1‬או ‪(98‬ג) לחוק – הוועדה המחוזית‪ ,‬הוועדה המקומית‬
+‫הנוגעת בדבר ומגיש התוכנית;‬
+‫(‪ ) 2‬בערר לפי סעיף ‪(110‬א) לחוק – הוועדה המחוזית‪ ,‬הוועדה המקומית הנוגעת‬
+‫בדבר ומגיש התוכנית; וכן‪ ,‬לפי העניין‪ ,‬מי שהתנגדותו לתוכנית נתקבלה ובעקבות‬
+‫זאת הוגש הערר או מי שהשמיע טענות לפי סעיף ‪(106‬ב) וטענותיו התקבלו‬
+‫ובעקבות זאת הוגש הערר‪.‬‬
+‫ב‪.‬‬
+
+‫על פי תקנה ‪ 4‬לתקנות התכנון והבניה ( סדרי דין בפני ועדת הערר למימי חופין)‪,‬‬
+‫התש"ל‪ 1969-‬המשיבים בערר על החלטת הוועדה לשמירת הסביבה החופית הם‬
+‫הוועדה לשמירת הסביבה החופית‪ ,‬וכן מי שהגיש תכנית שאושרה על ידיה לפי סעיף‬
+‫‪ 4‬לתוספת השנייה לחוק‪ ,‬או מי שהגיש בקשה להיתר שאושרה על ידיה לפי סעיף ‪5‬‬
+‫לתוספת השנייה לחוק‪.‬‬
+
+‫ג‪.‬‬
+
+‫ערר שיוגש שלא בהתאם ל רשימת המשיבים כאמור בתקנות הנ"ל יידרש בתיקון‬
+‫רשימת המשיבים בהתאם להנחיות המזכירות‪ .‬המשיבים להליך יובהרו גם במסגרת‬
+‫הזימון שיישלח לדיון‪ ,‬וראו סעיף ‪(4‬ג) להלן‪.‬‬
+
+‫|‪2‬‬
+
+‫הנחיות יו"ר ועדת המשנה לעררים על החלטות הוועדה‬
+‫המחוזית והולחוף‬
+
+‫ד‪.‬‬
+
+‫יחידה‬
+
+‫ועדת המשנה לעררים‬
+‫המועצה הארצית לתכנון‬
+‫ולבניה‬
+
+‫מס' נוהל‬
+
+‫תאריך פרסום מקורי‬
+
+‫תאריך פרסום עדכני‬
+
+‫‪2019/1‬‬
+
+‫‪11.03.2019‬‬
+
+‫‪26.03.2024‬‬
+
+‫משיבים נוספים – הרואה עצמו משיב לערר שהוגש בשל קבלת התנגדותו‪ ,‬ולא צוין‬
+‫ברשימת המשיבים לערר בזימון ל דיון‪ ,‬יגיש בקשת הצטרפות תוך ציון הסוגייה‬
+‫בהתנגדות שהובילה להגשת הערר‪ .‬גורם שלא מופיע ברשימת המשיבים שנשלחה‬
+‫במסגרת הזימון לדיון‪ ,‬ומבקש להיות משיב בערר‪ ,‬יגיש בקשה מנומקת בהתאם‬
+‫להנחיות בסעיף ‪ 1‬לעיל‪.‬‬
+
+‫‪ . 3‬הגשת ערר על ידי רשות מקומית או ועדה מקומית הנוגעת בדבר לפי סעיף ‪(110‬א)(‪()1‬ב)‬
+‫לחוק‬
+‫א‪.‬‬
+
+‫בהתאם לחוק וההלכה הפסוקה‪ ,‬ערר לפי סעיף ‪(110‬א)(‪()1‬ב) לחוק יוגש בליווי החלטת‬
+‫מליאת הרשות‪/‬הוועדה המאשרת את הגשת הערר (להלן‪ :‬החלטת מליאה)‪.‬‬
+
+‫ב‪.‬‬
+
+‫כאשר לוח הזמנים אינו מאפשר את כינוס מליאת הרשות‪/‬הוועדה קודם להגשת‬
+‫הערר‪ ,‬יש לעדכן את מזכירות הוועדה מתי עתידה המליאה להתכנס בנדון‪ ,‬ובכל‬
+‫מקרה החלטת מליאה תומצא למזכירות עד ‪ 30‬ימים לאחר הגשת הערר‪.‬‬
+
+‫ג‪.‬‬
+
+‫לא הומצאה החלטת המליאה לוועדה בתוך ‪ 30‬ימים מהגשת הערר‪ ,‬תישקל דחיית‬
+‫הערר על הסף ללא התראה נוספת‪.‬‬
+
+‫‪ . 4‬איחוד עררים‪ ,‬הזימון לדיון והגשת תשובות לערר‬
+‫א‪.‬‬
+
+‫מזכירות הוועדה תוודא טרם שיבוץ ערר לדיון כי לא הוגשו עררים נוספים‪ ,‬בזכות או‬
+‫בהתאם לרשות שניתנה על‪ -‬ידי יו"ר הוועדה המחוזית לפי סעיף ‪(110‬א)(‪ )2‬לחוק‪.‬‬
+
+‫ב‪.‬‬
+
+‫בהתאם לתקנות העררים‪ ,‬ככל שהוגשו כמה עררים בגין החלטה באותה התוכנית‪,‬‬
+‫ככלל יאוחדו העררים לדיון אחד שייערך בעררים על תוכנית‪.‬‬
+
+‫ג‪.‬‬
+
+‫ז ימון לדיון בערר יישלח בדואר אלקטרוני לכלל הצדדים בערר וכן לבעלי עניין נוספים‬
+‫לידיעה שייכתבו ברשימה בזימון לדיון‪ ,‬במצורף לכתב הערר‪.‬‬
+
+‫ד‪.‬‬
+
+‫הגשת תשובות לערר‪:‬‬
+‫(‪ ) 1‬בהתאם לתקנות העררים‪ ,‬על המשיבים להגיש תשובתם לערר בתוך ‪ 30‬ימים‪.‬‬
+‫המועד להגשת התשובות ייכתב בזימון לדיון‪.‬‬
+‫(‪ ) 2‬ה גשת חומרים תיעשה באמצעות הדוא"ל כמופיע מטה לידי המזכירות‪ .‬עם זאת ‪,‬‬
+
+‫המזכירות עשויה לפנות ולבקש הגשת חומרים גם באופן פיזי‪ ,‬בהתאם לשיקול‬
+‫דעתה‪.‬‬
+‫ה ‪ .‬הנגשת המידע מתיק הערר‪ :‬כתבי הערר‪ ,‬התשובות וחומרים נוספים שהוגשו מטעם‬
+‫הצדדים יועלו לאתר מנהל התכנון‪ ,‬בדף הערר שקישור א ליו יישלח גם על‪-‬ידי‬
+‫המזכירות ‪ .‬מצגות שהוצגו בדיון יועלו לאתר הערר לאחר הדיון‪ .‬המזכירות מעדכנת‬
+‫את החומרים מעת לעת באתר הערר‪ ,‬ומומלץ לעקוב אחר מידע חדש שמתפרסם‪.‬‬
+‫יתכן שהמזכירות תפיץ חלק מהחומרים הנ"ל גם באמצעות רשימת התפוצה בדוא"ל‪.‬‬
+
+‫|‪3‬‬
+
+‫הנחיות יו"ר ועדת המשנה לעררים על החלטות הוועדה‬
+‫המחוזית והולחוף‬
+
+‫יחידה‬
+
+‫ועדת המשנה לעררים‬
+‫המועצה הארצית לתכנון‬
+‫ולבניה‬
+
+‫מס' נוהל‬
+
+‫תאריך פרסום מקורי‬
+
+‫תאריך פרסום עדכני‬
+
+‫‪2019/1‬‬
+
+‫‪11.03.2019‬‬
+
+‫‪26.03.2024‬‬
+
+‫‪ .5‬הדיון בערר‬
+‫א‪.‬‬
+
+‫הצדדים יתייצבו לדיון בערר בהתאם למועד בזימון לדיון‪.‬‬
+
+‫ב‪.‬‬
+
+‫הרכב ועדת המשנה לעררים ( בעררים על החלטות הוועדות המחוזיות והוולחו"ף )‬
+‫נקבע בהחלטת מליאת המועצה הארצית מיום ‪ 10.06.2014:‬נציג שר המשפטים יהיה‬
+‫היו"ר; נציג מנכ"ל מינהל התכנון; נציג השר הגנת הסביבה או נציג מנהל רשות הטבע‬
+‫והגנים; נציג שר הבינוי והשיכון או נציג בעל הכשרה בשיכון ובניה; שני נציגי השלטון‬
+‫המקומי‪ .‬בהחלטת המועצה הארצית הוגדרו גם ממלאי מקום לחברים ‪ .‬משכך‪ ,‬בהתאם‬
+‫לסעיף ‪(42‬א) לחוק‪ ,‬המניין החוקי בישיבות ועדת המשנה לעררים הוא ‪.3‬‬
+
+‫ג‪.‬‬
+
+‫ככלל‪ ,‬הדיון בערר יתקיים באופן חזיתי ( פרונטלי) במשרדי מי נהל התכנון בירושלים‬
+‫ועל הצדדים (בעלי דין‪ ,‬באי‪ -‬כוח ויועצים מקצועיים) להיערך להצגת הטענות באולם‬
+‫הוועדה‪.‬‬
+
+‫ד ‪ .‬מספר ימים טרם הדיון בערר תישלח המזכירות הודעת תזכורת לצדדים עם מיקום‬
+‫הדיון במדויק (להלן בסעיף זה‪ :‬ההודעה) ‪ .‬ההודעה עשויה לכלול הנחיה לפיה הדיון‬
+‫יתקיים גם בהיוועדות חזותית‪ .‬במקרה זה תכלול ההודעה מידע והנחיות נוספות‬
+‫בהקשר זה‪.‬‬
+‫ה ‪ .‬צד לדיון בערר שמבקש להציג מצגת יעביר למען הסדר הטוב את העתקה למזכירות‬
+‫הוועדה לכל המאוחר ערב הדיון הקבוע בערר‪.‬‬
+‫ו‪.‬‬
+
+‫צד לדיון בערר אשר הגיש במהלך הדיון חומר נוסף שיו"ר הוועדה אישר הגשתו‪ ,‬יעביר‬
+‫למזכירות הוועדה העתק במועד הדיון בערר לצורך הפצתו ליתר הצדדים‪.‬‬
+
+‫מורן בראון‪,‬‬
+‫עו"ד יו"ר ועדת המשנה לעררים‬
+
+‫|‪4‬‬
+
+

docs/sources/instructions-planning-appeals.txt

@@ -0,0 +1,220 @@
+‫אגף תקצוב ורכש‬
+
+‫הנחיות עזר להגשת עררים בועדת ערר מחוזיות לתכנון ובניה‬
+
+‫הנחיות עזר להגשת ערר בנושא היתרי בניה‪:‬‬
+‫כתב הערר יוגש תוך ‪ 30‬ימים מיום קבלת החלטת הועדה המקומית‬
+‫‪ .1‬הערר יוגש למזכירות ועדת הערר בכתב‪ ,‬בשישה עותקים‪ ,‬בצירוף עותקים נוספים לפי מספר‬
+‫המשיבים‪.‬‬
+‫‪.2‬‬
+
+‫על הערר לכלול את כל אלה‪:‬‬
+‫‪ .2.1‬שם העורר‪ ,‬מספר ת‪.‬ז‪ ,‬מען‪ ,‬מספר טלפון וטלפון נייד‪ ,‬מספר פקס וכתובת מייל (במידה‬
+‫ויש)‪.‬‬
+‫‪ .2.2‬פרטי המשיבים‪ :‬שמותיהם ‪ ,‬מענם‪ ,‬מספר טלפון‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‬
+‫‪ .2.2‬במידה והעורר מיוצג על ידי עורך דין‪ -‬שם ב"כ העורר‪ ,‬מען למסירת מסמכים‪ ,‬מספר‬
+‫טלפון‪ ,‬מספר פקס‪ ,‬כתובת מייל וייפוי כוח‪.‬‬
+‫‪ .2.2‬פרטי הבקשה שלגביה ניתנה ההחלטה נושא הערר (פרטי המקרקעין‪/‬הנכס‪ -‬כתובת‪ ,‬מס'‬
+‫גוש ומס' חלקה)‬
+‫‪ .2.2‬פרטי ההחלטה שעליה מוגש הערר והעתק מהודעת הועדה או הרשות על ההחלטה‪.‬‬
+‫‪ .2.2‬נימוקי הערר‬
+‫‪ .2.2‬עיקר הראיות שהעורר מבקש להביא בפני ועדת הערר‪.‬‬
+‫‪ .2.2‬כאשר הערר מוגש על ידי מבקש ההיתר‪ -‬עליו לצרף לכתב הערר עותק מהגרמושקה‬
+‫נשוא ההחלטה‪.‬‬
+‫‪ .2.2‬כאשר העורר הוא מי שהגיש התנגדות לבקשה להיתר או מבקש ההיתר‪ ,‬על הועדת‬
+‫המקומית לצרף לתגובתה עותק מודפס מהגרמושקה נשוא ההחלטה‪.‬‬
+
+‫לתשומת ליבכם‪:‬‬
+‫‪‬‬
+
+‫הגשת הערר אינה כרוכה בתשלום אגרה‪.‬‬
+
+‫‪‬‬
+
+‫את הערר יש להגיש לועדת הערר במסירה ידנית או בדואר רשום ובלבד שעמד בכל דרישות‬
+‫הדין להגשת הערר והגיע לועדת הערר במועד הקבוע בחוק להגשת ערר‪.‬‬
+‫המועד בו נתקבל הערר בדואר רשום במזכירות הועדה ירשם כמועד בו נתקבל הערר‪.‬‬
+‫ערר לא ניתן להעביר באמצעות פקס‪/‬מייל‪.‬‬
+
+‫‪‬‬
+
+‫ערר שהגיע לועדה שלא במועד‪ ,‬לא יתקבל אלא אם ניתנה החלטה המאשרת ארכה להגשתו‪.‬‬
+
+‫‪‬‬
+
+‫לבקשת עורר‪ ,‬תמציא לו הועדה המקומית את פרטי הצדדים להליך נושא הערר‪ ,‬שמותיהם‬
+‫ומעניהם תוך שלושה ימים מיום הגשת הבקשה‪.‬‬
+
+‫‪‬‬
+
+‫שימו לב ❤ הערר צריך להיות חתום על ידי העורר‪.‬‬
+
+‫הנחיות אלו כלליות ומשמשות כעזר לשירות הציבור‪ ,‬בכפוף לקבוע בדין ובתקנות‪ ,‬הגובר על האמור בהנחיות‬
+‫אלה‪ ,‬ההנחיות אינן ממצות ואינן כוללות את כל הוראות הדין הרלוונטיות לעניין‪ .‬כמו כן ייתכן וקיימות דרישות‬
+‫נוספות בוועדות הערר השונות והן ימסרו על ידי הועדה‪.‬‬
+‫הנחיות אלו אינן מהוות תחליף לייעוץ משפטי‪.‬‬
+‫עמוד ‪1‬‬
+
+‫אגף תקצוב ורכש‬
+
+‫הנחיות עזר להגשת ערר בעניין תכנית‪:‬‬
+‫כתב הערר יוגש תוך ‪ 15‬ימים מיום קבלת ההחלטה‬
+‫‪ .1‬הערר יוגש למזכירות ועדת הערר בכתב‪ ,‬בשישה עותקים‪ ,‬בצירוף עותקים נוספים לפי מספר‬
+‫המשיבים‪.‬‬
+‫‪ .2‬על הערר לכלול את כל אלה‪:‬‬
+‫‪ .2.1‬שם העורר‪ ,‬מענו‪ ,‬מספר טלפון וטלפון נייד‪ ,,‬מספר פקס וכתובת מייל (במידה ויש)‪.‬‬
+‫‪ .2.2‬פרטי המשיבים‪ :‬שמותיהם ‪ ,‬מענם‪ ,‬מספר טלפון‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‬
+‫‪ .2.2‬במידה והעורר מיוצג על ידי עורך דין‪ -‬שם ב"כ העורר‪ ,‬מען למסירת מסמכים‪ ,‬מספר‬
+‫טלפון‪ ,‬מספר פקס‪ ,‬כתובת מייל וייפוי כוח‪.‬‬
+‫‪ .2.2‬פרטי התכנית שלגביה ניתנה ההחלטה נושא הערר (פרטי המקרקעין‪ /‬הנכס‪ -‬כתובת‪ ,‬מס'‬
+‫גוש ומס' חלקה)‬
+‫‪ .2.2‬נימוקי הערר‬
+‫‪ .2.2‬עיקר הראיות שהעורר מבקש להביא בפני ועדת הערר (נספחים וכל מסמך הנוגע לערר)‬
+‫‪ .2.2‬החלטת הועדה המקומית לאשר‪/‬לדחות התכנית‪.‬‬
+‫‪ .2.2‬כאשר הערר מוגש על ידי מגיש התכנית‪ -‬עליו לצרף לכתב הערר עותק מתקנון ומתשריט‬
+‫התכנית‪.‬‬
+‫‪ .2.2‬כאשר הערר מוגש על ידי מי שהגיש התנגדות לתכנית או מגיש התכנית ‪ -‬על הועדה‬
+‫המקומית לצרף לתגובתה עותק מודפס מתקנון ומתשריט התכנית‪.‬‬
+‫לתשומת ליבכם‪:‬‬
+‫‪‬‬
+
+‫הגשת הערר אינה כרוכה בתשלום אגרה‪.‬‬
+
+‫‪‬‬
+
+‫את הערר יש להגיש לועדת הערר במסירה ידנית או בדואר רשום ובלבד שעמד בכל דרישות‬
+‫הדין להגשת הערר והגיע לועדת הערר במועד הקבוע בחוק להגשת ערר‪.‬‬
+‫המועד בו נתקבל הערר בדואר רשום במזכירות הועדה ירשם כמועד בו נתקבל הערר‪.‬‬
+‫ערר לא ניתן להעביר באמצעות פקס‪/‬מייל‪.‬‬
+
+‫‪‬‬
+
+‫ערר שהגיע לועדה שלא במועד‪ ,‬לא יתקבל אלא אם ניתנה החלטה המאשרת ארכה להגשתו‪.‬‬
+
+‫‪‬‬
+
+‫לבקשת עורר‪ ,‬תמציא לו הועדה המקומית את פרטי הצדדים להליך נושא הערר‪ ,‬שמותיהם‬
+‫ומעניהם תוך שלושה ימים מיום הגשת הבקשה‪.‬‬
+
+‫‪‬‬
+
+‫שימו לב❤ הערר צריך להיות חתום על ידי העורר‪.‬‬
+
+‫הנחיות אלו כלליות ומשמשות כעזר לשירות הציבור‪ ,‬בכפוף לקבוע בדין ובתקנות‪ ,‬הגובר על האמור בהנחיות‬
+‫אלה‪ ,‬ההנחיות אינן ממצות ואינן כוללות את כל הוראות הדין הרלוונטיות לעניין‪ .‬כמו כן ייתכן וקיימות דרישות‬
+‫נוספות בוועדות הערר השונות והן ימסרו על ידי הועדה‪.‬‬
+‫הנחיות אלו אינן מהוות תחליף לייעוץ משפטי‪.‬‬
+‫עמוד ‪2‬‬
+
+‫אגף תקצוב ורכש‬
+
+‫הנחיות עזר להגשת ערר בעניין תשריט חלוקה‬
+‫כתב הערר יוגש תוך ‪ 30‬ימים מיום קבלת החלטת הועדה המקומית‬
+‫‪ .1‬הערר יוגש למזכירות ועדת הערר בכתב‪ ,‬בשישה עותקים‪ ,‬בצירוף עותקים נוספים לפי מספר‬
+‫המשיבים‪.‬‬
+‫‪ .2‬על הערר לכלול את כל אלה‪:‬‬
+‫‪ .2.1‬שם העורר‪ ,‬מענו‪ ,‬מספר טלפון וטלפון נייד‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‪.‬‬
+‫‪ .2.2‬פרטי המשיבים‪ :‬שמותיהם ‪ ,‬מענם‪ ,‬מספר טלפון‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‬
+‫כאשר יש לציין בפרטי הועדה המקומית את תאריך הגשת הבקשה‪.‬‬
+‫‪ .2.2‬במידה והעורר מיוצג על ידי עורך דין‪ -‬שם ב"כ העורר‪ ,‬מספר רישיון‪ ,‬מען למסירת‬
+‫מסמכים‪ ,‬מספר טלפון‪ ,‬מספר פקס‪ ,‬כתובת מייל וייפוי כוח‪.‬‬
+‫‪ .2.2‬פרטי הבקשה שלגביה ניתנה ההחלטה נושא הערר (פרטי המקרקעין‪ /‬הנכס‪ -‬כתובת‪ ,‬מס'‬
+‫גוש ומס' חלקה)‬
+‫‪ .2.2‬פרטי ההחלטה שעליה מוגש הערר והעתק מהודעת הועדה או הרשות על ההחלטה‪.‬‬
+‫‪ .2.2‬נימוקי הערר‬
+‫‪ .2.2‬עיקר הראיות שהעורר מבקש להביא בפני ועדת הערר‪.‬‬
+‫לתשומת ליבכם‪:‬‬
+‫‪‬‬
+
+‫הגשת הערר אינה כרוכה בתשלום אגרה‪.‬‬
+
+‫‪‬‬
+
+‫את הערר יש להגיש לועדת הערר במסירה ידנית או בדואר רשום ובלבד שעמד בכל דרישות‬
+‫הדין להגשת הערר והגיע לועדת הערר במועד הקבוע בחוק להגשת ערר‪.‬‬
+‫המועד בו נתקבל הערר בדואר רשום במזכירות הועדה ירשם כמועד בו נתקבל הערר‪.‬‬
+‫ערר לא ניתן להעביר באמצעות פקס‪/‬מייל‪.‬‬
+
+‫‪‬‬
+
+‫ערר שהגיע לועדה שלא במועד‪ ,‬לא יתקבל אלא אם ניתנה החלטה המאשרת ארכה להגשתו‪.‬‬
+
+‫‪‬‬
+
+‫לבקשת עורר‪ ,‬תמציא לו הועדה המקומית את פרטי הצדדים להליך נושא הערר‪ ,‬שמותיהם‬
+‫ומעניהם תוך שלושה ימים מיום הגשת הבקשה‪.‬‬
+
+‫‪‬‬
+
+‫שימו לב ❤ הערר צריך להיות חתום על ידי העורר‪.‬‬
+
+‫הנחיות אלו כלליות ומשמשות כעזר לשירות הציבור‪ ,‬בכפוף לקבוע בדין ובתקנות‪ ,‬הגובר על האמור בהנחיות‬
+‫אלה‪ ,‬ההנחיות אינן ממצות ואינן כוללות את כל הוראות הדין הרלוונטיות לעניין‪ .‬כמו כן ייתכן וקיימות דרישות‬
+‫נוספות בוועדות הערר השונות והן ימסרו על ידי הועדה‪.‬‬
+‫הנחיות אלו אינן מהוות תחליף לייעוץ משפטי‪.‬‬
+‫עמוד ‪3‬‬
+
+‫אגף תקצוב ורכש‬
+
+‫הנחיות עזר להגשת ערר על הנחיות מרחביות‬
+‫הערר יוגש תוך ‪ 30‬ימים מיום פרסום ההנחיות המרחביות‬
+‫‪ .1‬הערר יוגש למזכירות ועדת הערר בכתב‪ ,‬בשישה עותקים‪ ,‬בצירוף עותקים נוספים לפי מספר‬
+‫המשיבים‪.‬‬
+‫‪ .2‬על הערר לכלול את כל אלה‪:‬‬
+‫‪ .2.1‬שם העורר‪ ,‬מענו‪ ,‬מספר טלפון וטלפון נייד‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‪.‬‬
+‫‪ .2.2‬פרטי המשיבים‪ :‬שמותיהם ‪ ,‬מענם‪ ,‬מספר טלפון‪ ,‬מספר פקס וכתובת מייל (במידה ויש)‬
+‫‪ .2.2‬במידה והעורר מיוצג על ידי עורך דין‪ -‬שם ב"כ העורר‪ ,‬מען למסירת מסמכים‪ ,‬מספר‬
+‫טלפון‪ ,‬מספר פקס‪ ,‬כתובת מייל וייפוי כוח‪.‬‬
+‫‪ .2.2‬פרטי הבקשה שלגביה ניתנה ההחלטה נושא הערר (פרטי המקרקעין‪ /‬הנכס‪ -‬כתובת‪ ,‬מס'‬
+‫גוש ומס' חלקה)‬
+‫‪ .2‬פרטי ההחלטה שעליה מוגש הערר‪ ,‬והעתק מהודעת הועדה או הרשות על ההחלטה‪.‬‬
+‫‪ .2.1‬נימוקי הערר;‬
+‫‪ .2.2‬עיקר הראיות שהעורר מבקש להביא בפני ועדת הערר‪.‬‬
+‫לתשומת ליבכם‪:‬‬
+‫‪‬‬
+
+‫הגשת הערר אינה כרוכה בתשלום אגרה‪.‬‬
+
+‫‪‬‬
+
+‫את הערר יש להגיש לועדת הערר במסירה ידנית או בדואר רשום ובלבד שעמד בכל דרישות‬
+‫הדין להגשת הערר והגיע לועדת הערר במועד הקבוע בחוק להגשת ערר‪.‬‬
+‫המועד בו נתקבל הערר בדואר רשום במזכירות הועדה ירשם כמועד בו נתקבל הערר‪.‬‬
+‫ערר לא ניתן להעביר באמצעות פקס‪/‬מייל‪.‬‬
+
+‫‪‬‬
+
+‫לבקשת עורר‪ ,‬תמציא לו הועדה המקומית את פרטי הצדדים להליך נושא הערר‪ ,‬שמותיהם‬
+‫ומעניהם תוך שלושה ימים מיום הגשת הבקשה‪.‬‬
+
+‫‪‬‬
+
+‫ערר שהגיע לועדה שלא במועד‪ ,‬לא יתקבל אלא אם ניתנה החלטה המאשרת ארכה להגשתו‪.‬‬
+
+‫‪‬‬
+
+‫יש לציין תאריך המצאת ההחלטה לידי העורר‪.‬‬
+
+‫‪‬‬
+
+‫יש לציין באם הערר המוגש קשור לערר קודם שהוגש בעבר‪.‬‬
+
+‫‪‬‬
+
+‫שימו לב ❤ הערר צריך להיות חתום על ידי העורר‪.‬‬
+
+‫הנחיות אלו כלליות ומשמשות כעזר לשירות הציבור‪ ,‬בכפוף לקבוע בדין ובתקנות‪ ,‬הגובר על האמור בהנחיות‬
+‫אלה‪ ,‬ההנחיות אינן ממצות ואינן כוללות את כל הוראות הדין הרלוונטיות לעניין‪ .‬כמו כן ייתכן וקיימות דרישות‬
+‫נוספות בוועדות הערר השונות והן ימסרו על ידי הועדה‪.‬‬
+‫הנחיות אלו אינן מהוות תחליף לייעוץ משפטי‪.‬‬
+‫עמוד ‪4‬‬
+
+‫אגף תקצוב ורכש‬
+
+‫הנחיות אלו כלליות ומשמשות כעזר לשירות הציבור‪ ,‬בכפוף לקבוע בדין ובתקנות‪ ,‬הגובר על האמור בהנחיות‬
+‫אלה‪ ,‬ההנחיות אינן ממצות ואינן כוללות את כל הוראות הדין הרלוונטיות לעניין‪ .‬כמו כן ייתכן וקיימות דרישות‬
+‫נוספות בוועדות הערר השונות והן ימסרו על ידי הועדה‪.‬‬
+‫הנחיות אלו אינן מהוות תחליף לייעוץ משפטי‪.‬‬
+‫עמוד ‪5‬‬
+
+

mcp-server/pyproject.toml

@@ -17,6 +17,8 @@ dependencies = [
     "rq>=1.16.0",
     "pillow>=10.0.0",
     "google-cloud-vision>=3.7.0",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.30.0",
 ]
 
 [build-system]

mcp-server/src/legal_mcp/server.py

@@ -45,7 +45,9 @@ mcp = FastMCP(
 
 # ── Import and register tools ───────────────────────────────────────
 
-from legal_mcp.tools import cases, documents, search, drafting, workflow  # noqa: E402
+from legal_mcp.tools import (  # noqa: E402
+    cases, documents, search, drafting, workflow, precedents,
+)
 
 
 # Case management
@@ -102,6 +104,48 @@ async def case_update(
     )
 
 
+@mcp.tool()
+async def case_delete(case_number: str, remove_files: bool = False) -> str:
+    """מחיקת תיק ערר. קבצים בדיסק נשארים אלא אם remove_files=true."""
+    return await cases.case_delete(case_number, remove_files)
+
+
+# Precedent attachments (user-supplied legal support for the compose phase)
+@mcp.tool()
+async def precedent_attach(
+    case_number: str,
+    quote: str,
+    citation: str,
+    section_id: str = "",
+    chair_note: str = "",
+    pdf_document_id: str = "",
+) -> str:
+    """צירוף פסיקה תומכת לתיק. section_id ריק = כללי לתיק; אחרת threshold_1/issue_3."""
+    return await precedents.precedent_attach(
+        case_number, quote, citation, section_id, chair_note, pdf_document_id,
+    )
+
+
+@mcp.tool()
+async def precedent_list(case_number: str) -> str:
+    """רשימת כל הפסיקות שצורפו לתיק."""
+    return await precedents.precedent_list(case_number)
+
+
+@mcp.tool()
+async def precedent_remove(precedent_id: str) -> str:
+    """הסרת פסיקה מצורפת."""
+    return await precedents.precedent_remove(precedent_id)
+
+
+@mcp.tool()
+async def precedent_search_library(
+    query: str, practice_area: str = "", limit: int = 10,
+) -> str:
+    """חיפוש בספרייה הרוחבית של ציטוטים שנצברו בין תיקים."""
+    return await precedents.precedent_search_library(query, practice_area, limit)
+
+
 # Documents
 @mcp.tool()
 async def document_upload(
@@ -346,6 +390,29 @@ async def ingest_final_version(
     return await workflow.ingest_final_version(case_number, file_path, final_text)
 
 
+@mcp.tool()
+async def record_chair_feedback(
+    case_number: str,
+    feedback_text: str,
+    block_id: str = "block-yod",
+    category: str = "missing_content",
+    lesson_extracted: str = "",
+) -> str:
+    """תיעוד הערת יו"ר (דפנה) על טיוטת החלטה — חסר, שגיאה, סגנון."""
+    return await workflow.record_chair_feedback(
+        case_number, feedback_text, block_id, category, lesson_extracted,
+    )
+
+
+@mcp.tool()
+async def list_chair_feedback(
+    case_number: str = "",
+    category: str = "",
+    unresolved_only: bool = True,
+) -> str:
+    """הצגת הערות יו"ר שתועדו — אפשר לסנן לפי תיק, קטגוריה, מטופלות."""
+    return await workflow.list_chair_feedback(case_number, category, unresolved_only)
+
 
 def main():
     mcp.run(transport="stdio")

mcp-server/src/legal_mcp/services/block_writer.py

@@ -20,6 +20,7 @@ from uuid import UUID
 
 from legal_mcp import config
 from legal_mcp.services import db, embeddings, claude_session
+from legal_mcp.services.lessons import get_content_checklist, get_methodology_summary
 
 logger = logging.getLogger(__name__)
 
@@ -200,20 +201,14 @@ BLOCK_PROMPTS = {
 ## זהו הבלוק הקריטי ביותר — ליבת ההחלטה (ratio decidendi).
 ## אורך נדרש: **2,000-4,000 מילים לפחות**. זהו הבלוק הארוך ביותר בהחלטה (35-50%).
 
-## מתודולוגיה — CREAC:
-1. **C** (Conclusion) — פתח במסקנה: "לאחר שעיינו... מצאנו כי הערר [נדחה/מתקבל]"
-2. **R** (Rule) — הצג את הכלל המשפטי הרלוונטי עם ציטוט פסיקה
-3. **E** (Explanation) — צטט פסיקה שמסבירה את הכלל (200-600 מילים לכל ציטוט)
-4. **A** (Application) — יישם על העובדות הספציפיות של התיק
-5. **C** (Conclusion) — מסקנת ביניים
+{methodology_guidance}
 
-## כללים קריטיים:
-- **מסקנה בפתיחה** — לא בסוף
-- **מענה פרטני לכל טענה** שהוצגה בבלוק ז — עבור על כל טענה ברשימה והתייחס אליה בנפרד. אל תדלג על שום טענה.
-- **ציטוטי פסיקה** — צטט לפחות 3-5 פסקי דין רלוונטיים. כל ציטוט עם שם התיק המלא.
+{content_checklist}
+
+## כללים נוספים:
 - **ללא כפילות** — הפנה לבלוקים קודמים: "כאמור בסעיף X לעיל"
-- **ללא כותרות משנה** (חריג: נושאים נפרדים לחלוטין)
-- מספור רציף
+- **מספור רציף** — המשך מספור מהבלוק הקודם
+- מותרות כותרות-משנה כשיש נושאים נפרדים לחלוטין
 
 ## כיוון מאושר (חובה):
 {direction_context}
@@ -221,7 +216,7 @@ BLOCK_PROMPTS = {
 ## מבנה לפי תוצאה:
 {structure_guidance}
 
-## טענות שצריך לענות עליהן (חובה — כל טענה חייבת מענה):
+## טענות:
 {claims_context}
 
 ## חומרי מקור:
@@ -310,6 +305,18 @@ async def write_block(
     outcome = (decision or {}).get("outcome", "rejected")
     structure_guidance = STRUCTURE_GUIDANCE.get(outcome, "")
 
+    # Content checklist — tells block-yod WHAT topics to cover
+    content_checklist = ""
+    methodology_guidance = ""
+    if block_id == "block-yod":
+        content_checklist = get_content_checklist(
+            appeal_type=case.get("appeal_type", ""),
+            subject=case.get("subject", ""),
+            subject_categories=case.get("subject_categories", []),
+        )
+        # Methodology guidance — tells block-yod HOW to reason (universal, not case-specific)
+        methodology_guidance = get_methodology_summary()
+
     # Format prompt — per Anthropic long-context best practices:
     # Place source documents FIRST (top of prompt), instructions LAST.
     # "Queries at the end can improve response quality by up to 30%"
@@ -323,6 +330,8 @@ async def write_block(
         style_context=style_context,
         discussion_context=discussion_context,
         structure_guidance=structure_guidance,
+        content_checklist=content_checklist,
+        methodology_guidance=methodology_guidance,
     )
 
     # Restructure: sources first, then instructions
@@ -418,7 +427,7 @@ async def _build_claims_context(case_id: UUID) -> str:
             lines.append(f"\n### {role_heb.get(current_role, current_role)}")
         claim_num += 1
         lines.append(f"טענה #{claim_num}: {c['claim_text'][:400]}")
-    lines.append(f"\n**סה\"כ {claim_num} טענות — חובה לענות על כל אחת.**")
+    lines.append(f"\n**סה\"כ {claim_num} טענות. ענה על כל טענה מהותית; טענות [bundle] — אגד; טענות [skip] — ציון קצר בלבד.**")
     return "\n".join(lines)
 
 
@@ -649,6 +658,17 @@ async def get_block_context(case_id: UUID, block_id: str, instructions: str = ""
     outcome = (decision or {}).get("outcome", "rejected")
     structure_guidance = STRUCTURE_GUIDANCE.get(outcome, "")
 
+    # Content checklist + methodology for block-yod
+    content_checklist = ""
+    methodology_guidance = ""
+    if block_id == "block-yod":
+        content_checklist = get_content_checklist(
+            appeal_type=case.get("appeal_type", ""),
+            subject=case.get("subject", ""),
+            subject_categories=case.get("subject_categories", []),
+        )
+        methodology_guidance = get_methodology_summary()
+
     formatted_prompt = prompt_template.format(
         case_context=case_context,
         source_context=source_context,
@@ -659,6 +679,8 @@ async def get_block_context(case_id: UUID, block_id: str, instructions: str = ""
         style_context=style_context,
         discussion_context=discussion_context,
         structure_guidance=structure_guidance,
+        content_checklist=content_checklist,
+        methodology_guidance=methodology_guidance,
     )
 
     if instructions:

mcp-server/src/legal_mcp/services/db.py

@@ -358,6 +358,22 @@ CREATE TABLE IF NOT EXISTS case_law_embeddings (
     created_at TIMESTAMPTZ DEFAULT now()
 );
 
+-- ═══════════════════════════════════════════════════════════════════
+-- Chair Feedback (הערות דפנה על טיוטות)
+-- ═══════════════════════════════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS chair_feedback (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    case_id UUID REFERENCES cases(id) ON DELETE SET NULL,
+    block_id TEXT DEFAULT '',                    -- block-yod, block-vav, etc.
+    feedback_text TEXT NOT NULL,                 -- ההערה של דפנה
+    category TEXT DEFAULT 'other',              -- missing_content/wrong_tone/wrong_structure/factual_error/style/other
+    lesson_extracted TEXT DEFAULT '',            -- הלקח שהופק
+    applied_to TEXT[] DEFAULT '{}',             -- לאילו קבצים/כללים הלקח יושם
+    resolved BOOLEAN DEFAULT FALSE,             -- האם הלקח יושם
+    created_at TIMESTAMPTZ DEFAULT now()
+);
+
 -- ═══════════════════════════════════════════════════════════════════
 -- Indexes
 -- ═══════════════════════════════════════════════════════════════════
@@ -381,6 +397,51 @@ CREATE INDEX IF NOT EXISTS idx_case_law_embeddings_vec
 """
 
 
+# ── Phase 4: Methodology alignment ──────────────────────────────
+
+SCHEMA_V4_SQL = """
+
+-- ═══════════════════════════════════════════════════════════════════
+-- V4: Methodology alignment (decision-methodology.md)
+-- ═══════════════════════════════════════════════════════════════════
+
+-- claims: טיפול בטענות (bundle/skip) + סוג טענה
+ALTER TABLE claims ADD COLUMN IF NOT EXISTS claim_type TEXT DEFAULT 'claim';
+    -- claim / response / reply
+ALTER TABLE claims ADD COLUMN IF NOT EXISTS claim_handling TEXT DEFAULT 'address';
+    -- address (דיון מלא) / bundle (קיבוץ) / skip (דילוג)
+ALTER TABLE claims ADD COLUMN IF NOT EXISTS bundle_group TEXT DEFAULT '';
+    -- שם הקבוצה לקיבוץ (למשל "פגמים פרוצדורליים")
+ALTER TABLE claims ADD COLUMN IF NOT EXISTS handling_reason TEXT DEFAULT '';
+    -- נימוק לדילוג/קיבוץ (למשל "נבחנה ולא מצאנו ממש")
+
+-- cases: תקן ביקורת + קטגוריות נושא
+ALTER TABLE cases ADD COLUMN IF NOT EXISTS standard_of_review TEXT DEFAULT '';
+    -- "שיקול דעת תכנוני עצמאי" / "בחינת שומה מכרעת" / ...
+ALTER TABLE cases ADD COLUMN IF NOT EXISTS subject_categories JSONB DEFAULT '[]';
+    -- ["חניה", "קווי בניין", "גובה", "שימוש חורג", ...]
+
+-- case_law: רמת תקדים + מעמד
+ALTER TABLE case_law ADD COLUMN IF NOT EXISTS precedent_level TEXT DEFAULT '';
+    -- עליון / מנהלי / ועדת ערר ארצית / ועדת ערר מחוזית
+ALTER TABLE case_law ADD COLUMN IF NOT EXISTS is_binding BOOLEAN DEFAULT TRUE;
+    -- הלכה מחייבת (true) / אמרת אגב (false)
+ALTER TABLE case_law ADD COLUMN IF NOT EXISTS creac_role TEXT DEFAULT '';
+    -- rule (הנחה עליונה) / explanation (הרחבה) / analogy (אנלוגיה)
+
+-- decisions: סדר סוגיות + תקן ביקורת
+ALTER TABLE decisions ADD COLUMN IF NOT EXISTS issue_order JSONB DEFAULT '[]';
+    -- סדר הסוגיות שנקבע ע"י המנצח: [{"title": "...", "type": "threshold/dispositive/secondary"}]
+ALTER TABLE decisions ADD COLUMN IF NOT EXISTS claim_handling JSONB DEFAULT '{}';
+    -- {"overrides": [{"claim_id": "...", "handling": "bundle", "group": "..."}]}
+
+-- indexes
+CREATE INDEX IF NOT EXISTS idx_claims_handling ON claims(claim_handling);
+CREATE INDEX IF NOT EXISTS idx_claims_type ON claims(claim_type);
+CREATE INDEX IF NOT EXISTS idx_case_law_level ON case_law(precedent_level);
+"""
+
+
 async def init_schema() -> None:
     pool = await get_pool()
     async with pool.acquire() as conn:
@@ -388,7 +449,8 @@ async def init_schema() -> None:
         await conn.execute(MIGRATIONS_SQL)
         await conn.execute(SCHEMA_V2_SQL)
         await conn.execute(SCHEMA_V3_SQL)
-    logger.info("Database schema initialized (v1 + v2 + v3)")
+        await conn.execute(SCHEMA_V4_SQL)
+    logger.info("Database schema initialized (v1 + v2 + v3 + v4)")
 
 
 # ── Case CRUD ───────────────────────────────────────────────────────
@@ -685,6 +747,22 @@ async def update_decision(decision_id: UUID, **fields) -> None:
         await conn.execute(sql, decision_id, *values)
 
 
+# ── Document deletion ──────────────────────────────────────────────
+
+async def delete_document(doc_id: UUID) -> bool:
+    """Delete a document and all its chunks. Returns True if deleted."""
+    pool = await get_pool()
+    async with pool.acquire() as conn:
+        async with conn.transaction():
+            await conn.execute(
+                "DELETE FROM document_chunks WHERE document_id = $1", doc_id
+            )
+            result = await conn.execute(
+                "DELETE FROM documents WHERE id = $1", doc_id
+            )
+            return int(result.split()[-1]) > 0
+
+
 # ── Chunks & Vectors ───────────────────────────────────────────────
 
 async def delete_document_chunks(document_id: UUID) -> int:
@@ -986,3 +1064,157 @@ async def search_precedents(
 
     results.sort(key=lambda x: x["score"], reverse=True)
     return results[:limit]
+
+
+# ── Case precedents (CRUD) ────────────────────────────────────────
+
+
+async def create_case_precedent(
+    case_id: UUID,
+    quote: str,
+    citation: str,
+    section_id: str | None = None,
+    chair_note: str = "",
+    pdf_document_id: UUID | None = None,
+    practice_area: str | None = None,
+) -> dict:
+    """Insert a new precedent attached to a case."""
+    pool = await get_pool()
+    row = await pool.fetchrow(
+        """
+        INSERT INTO case_precedents
+            (case_id, section_id, quote, citation, chair_note, pdf_document_id, practice_area)
+        VALUES ($1, $2, $3, $4, $5, $6, $7)
+        RETURNING *
+        """,
+        case_id, section_id, quote, citation, chair_note, pdf_document_id, practice_area,
+    )
+    return dict(row)
+
+
+async def list_case_precedents(case_id: UUID) -> list[dict]:
+    """List all precedents attached to a case, ordered by section then creation time."""
+    pool = await get_pool()
+    rows = await pool.fetch(
+        """
+        SELECT id, case_id, section_id, quote, citation, chair_note,
+               pdf_document_id, practice_area, created_at, updated_at
+        FROM case_precedents
+        WHERE case_id = $1
+        ORDER BY section_id NULLS LAST, created_at
+        """,
+        case_id,
+    )
+    return [dict(r) for r in rows]
+
+
+async def delete_case_precedent(precedent_id: UUID) -> bool:
+    """Delete a precedent attachment by ID. Returns True if deleted."""
+    pool = await get_pool()
+    result = await pool.execute(
+        "DELETE FROM case_precedents WHERE id = $1", precedent_id
+    )
+    return result == "DELETE 1"
+
+
+async def search_precedent_library(
+    query: str, practice_area: str = "", limit: int = 10,
+) -> list[dict]:
+    """Search all precedents across cases by citation or quote text."""
+    pool = await get_pool()
+    pattern = f"%{query}%"
+    if practice_area:
+        rows = await pool.fetch(
+            """
+            SELECT id, case_id, section_id, quote, citation, chair_note,
+                   practice_area, created_at
+            FROM case_precedents
+            WHERE (citation ILIKE $1 OR quote ILIKE $1)
+              AND practice_area = $2
+            ORDER BY created_at DESC
+            LIMIT $3
+            """,
+            pattern, practice_area, limit,
+        )
+    else:
+        rows = await pool.fetch(
+            """
+            SELECT id, case_id, section_id, quote, citation, chair_note,
+                   practice_area, created_at
+            FROM case_precedents
+            WHERE citation ILIKE $1 OR quote ILIKE $1
+            ORDER BY created_at DESC
+            LIMIT $2
+            """,
+            pattern, limit,
+        )
+    return [dict(r) for r in rows]
+
+
+# ── Chair feedback ────────────────────────────────────────────────
+
+async def record_chair_feedback(
+    case_id: UUID | None,
+    block_id: str,
+    feedback_text: str,
+    category: str = "other",
+    lesson_extracted: str = "",
+) -> UUID:
+    """Record feedback from the chair (Dafna) on a draft block."""
+    pool = await get_pool()
+    feedback_id = uuid4()
+    async with pool.acquire() as conn:
+        await conn.execute(
+            """INSERT INTO chair_feedback
+               (id, case_id, block_id, feedback_text, category, lesson_extracted)
+               VALUES ($1, $2, $3, $4, $5, $6)""",
+            feedback_id, case_id, block_id, feedback_text, category,
+            lesson_extracted,
+        )
+    return feedback_id
+
+
+async def list_chair_feedback(
+    case_id: UUID | None = None,
+    category: str | None = None,
+    unresolved_only: bool = False,
+) -> list[dict]:
+    """List chair feedback, optionally filtered."""
+    pool = await get_pool()
+    conditions = []
+    params: list = []
+    idx = 1
+
+    if case_id:
+        conditions.append(f"case_id = ${idx}")
+        params.append(case_id)
+        idx += 1
+    if category:
+        conditions.append(f"category = ${idx}")
+        params.append(category)
+        idx += 1
+    if unresolved_only:
+        conditions.append("resolved = FALSE")
+
+    where = f"WHERE {' AND '.join(conditions)}" if conditions else ""
+    async with pool.acquire() as conn:
+        rows = await conn.fetch(
+            f"SELECT * FROM chair_feedback {where} ORDER BY created_at DESC",
+            *params,
+        )
+    return [dict(r) for r in rows]
+
+
+async def resolve_chair_feedback(
+    feedback_id: UUID,
+    applied_to: list[str],
+) -> None:
+    """Mark feedback as resolved and record where it was applied."""
+    pool = await get_pool()
+    async with pool.acquire() as conn:
+        await conn.execute(
+            """UPDATE chair_feedback
+               SET resolved = TRUE, applied_to = $2
+               WHERE id = $1""",
+            feedback_id, applied_to,
+        )

mcp-server/src/legal_mcp/services/lessons.py

@@ -329,3 +329,255 @@ def format_ratios_comment(outcome: str, section: str) -> str:
         lo, hi = ratios[section]
         return f"יעד: {lo}-{hi}% מסך ההחלטה"
     return ""
+
+
+# ── Content checklists by appeal subtype ──────────────────────────
+# Based on systematic analysis of 24 decisions from Dafna's corpus.
+# See: docs/corpus-analysis.md
+
+CONTENT_CHECKLISTS: dict[str, str] = {
+    "licensing_substantive": """## צ'קליסט תוכן — ערר רישוי מהותי (חובה)
+הדיון חייב לכלול את הנושאים הרלוונטיים מהרשימה הבאה.
+**אל תדלג על נושא שרלוונטי לתיק — בדוק כל סעיף.**
+
+### א. הקשר תכנוני רחב (חובה בכל ערר מהותי)
+- תכניות חלות — ציין את התכניות הרלוונטיות ברמה מקומית, מחוזית וארצית (לפי הצורך)
+- ייעוד הקרקע — מה הייעוד בתכנית? מה השימושים המותרים?
+- אופי הסביבה — מרקם בנוי, צפיפות, אופי שכונה/ישוב
+- *דוגמה*: בערר פרומר — 12 סעיפים על MI/200, תמ"א 35, תמ"מ 30/1
+
+### ב. ניתוח הוראות תכנית (כשיש שאלה של התאמה/סטייה)
+- ציטוט ישיר מהוראות התכנית הרלוונטיות (200-600 מילים לכל ציטוט)
+- פרשנות — מה תכלית ההוראה?
+- יישום — האם הבקשה תואמת או סוטה?
+- *דוגמה*: בערר לבנון — ניתוח חתכים של נספח בינוי מול הבקשה
+
+### ג. חניה (כשרלוונטי — מופיע ב-8 מתוך 24 החלטות)
+- הוראות תכנית + נספח תנועה (ציטוט ישיר)
+- חישוב מקומות חניה נדרשים vs. מסופקים
+- חלופות: קרן חניה, חפיפת שימושים, קרבה לתח"צ
+- *דוגמה*: בערר בית הכרם — 8 סעיפים, 400+ מילים מהוראות תכנית 5166ב
+
+### ד. קווי בניין ומרווחים (כשרלוונטי)
+- הוראת תכנית על מרווחים
+- סטייה ניכרת? — תקנה 2(19) / הלכת בן-יקר-גת
+- הצדקה + מידתיות — פגיעה בשכנים?
+
+### ה. גובה וקומות (כשרלוונטי)
+- הוראת תכנית + נספח בינוי (חתכים)
+- מטרת ההגבלה — למה יש הגבלת גובה כאן?
+- סטייה ניכרת — תקנה 2(10) / 2(8)
+
+### ו. פגיעה בשכנים (כשרלוונטי)
+- ממצאי סיור באתר
+- השפעה: צל, פרטיות, רעש, נוף
+- מידתיות — האם הפגיעה סבירה?
+
+### ז. שימוש חורג (כשרלוונטי)
+- מה השימוש המותר בתכנית? מה השימוש המבוקש?
+- "מבחן ההתאמה" — האם השימוש מתאים למיקום?
+- תנאים ומגבלות
+""",
+
+    "licensing_threshold": """## צ'קליסט תוכן — ערר רישוי סף/סמכות
+הערר עוסק בשאלות סף — אין צורך בדיון תכנוני מקיף.
+
+### א. שאלת הסמכות
+- סעיפי חוק רלוונטיים (ס' 12ב, 152, וכו')
+- פסיקה על גבולות הסמכות
+
+### ב. זכות ערר
+- מי רשאי לערור? באיזה מסלול?
+- הלכת שפר (עע"מ 317/10) — כשרלוונטית
+
+### ג. שיהוי (אם רלוונטי)
+""",
+
+    "licensing_property": """## צ'קליסט תוכן — ערר רישוי קנייני
+הערר עוסק בעיקר בשאלת תימוכין קנייניים — דיון משפטי.
+
+### א. מסגרת נורמטיבית
+- הלכת עייזן, בני אליעזר, רוזן — "היתכנות קניינית"
+- ס' 71ב לחוק המקרקעין
+
+### ב. בחינת הראיות
+- הסכמות, רישום, היסטוריית בנייה
+- חלוקה דה-פקטו ארוכת שנים
+
+### ג. הפרדה בין קניין לתכנון
+- גוף תכנוני אינו מכריע בסכסוכי קניין
+- "היתכנות קניינית" ≠ הוכחת בעלות
+
+### ד. שאלות תכנוניות (אם רלוונטיות)
+- אם הערר עולה גם שאלות תכנוניות — דון בהן בנפרד
+""",
+
+    "tama38": """## צ'קליסט תוכן — ערר תמ"א 38
+הדיון חייב לאזן בין אינטרס ציבורי לפגיעה בשכנים.
+
+### א. אינטרס ציבורי — חיזוק/התחדשות
+- עוצמת האינטרס — בניין גדול vs. בית בודד
+- "בית בודד" מחליש את אינטרס החיזוק
+- תרומה לרקמה העירונית
+
+### ב. תכנית אב / מדיניות אזורית
+- האם יש תכנית אב? מדיניות 16000?
+- התאמה לראיה כללית vs. אד-הוק
+
+### ג. ניתוח השוואתי
+- זכויות לפי תכנית קיימת vs. מבוקש לפי תמ"א 38
+- שטחים, קומות, קווי בניין — טבלת השוואה
+
+### ד. שימור (כשרלוונטי)
+- חוות דעת אגף שימור
+- השפעה על מיקום/צורת הבניין
+
+### ה. חניה (כמעט תמיד רלוונטי)
+- הוראות תכנית + ס' 17 לתמ"א 38
+- פטורים — קרבה לתח"צ, קרן חניה, תכנית אב
+- ניתוח מפורט של חלופות
+
+### ו. פגיעה בשכנים
+- ממצאי סיור
+- צל, פרטיות, קרבה
+- מידתיות — מה הפגיעה ביחס לתועלת?
+
+### ז. מטרדי בנייה
+- "מטרד בנייה אינו עילה לסירוב" — אך תנאים נדרשים
+- תכנית ארגון אתר
+""",
+
+    "betterment_levy": """## צ'קליסט תוכן — ערר היטל השבחה
+⚠️ שים לב: אין עדיין החלטות היטל השבחה בקורפוס האימון.
+הצ'קליסט הזה מבוסס על ידע כללי — לא על ניתוח ספציפי של סגנון דפנה.
+
+### א. המסגרת הנורמטיבית
+- התוספת השלישית לחוק התכנון והבנייה
+- אירוע מס — מה יצר את ההשבחה?
+
+### ב. שומה
+- שיטת השומה (שומה מכרעת / שמאי מייעץ)
+- מועד הקובע
+- זכויות בנייה — לפני ואחרי
+
+### ג. שאלות משפטיות
+- פטורים (ס' 19)
+- מועדי תשלום
+- שיערוך
+
+### ד. ניתוח שמאי
+- האם השומה תקינה?
+- פערים בין השומות
+""",
+}
+
+
+def get_content_checklist(
+    appeal_type: str = "",
+    subject: str = "",
+    subject_categories: list[str] | None = None,
+) -> str:
+    """Return the appropriate content checklist based on case characteristics.
+
+    Determines the subtype from case metadata:
+    - TAMA 38 cases → tama38 checklist
+    - Betterment levy (8xxx) → betterment_levy checklist
+    - Property-only cases → licensing_property checklist
+    - Threshold/jurisdiction cases → licensing_threshold checklist
+    - All other licensing → licensing_substantive checklist
+    """
+    cats = subject_categories or []
+    subject_lower = subject.lower() if subject else ""
+    appeal_lower = appeal_type.lower() if appeal_type else ""
+
+    # TAMA 38
+    if any(
+        kw in subject_lower
+        for kw in ["תמ\"א 38", "תמא 38", "תמ\"א38", "חיזוק", "tama"]
+    ) or "תמ\"א 38" in cats:
+        return CONTENT_CHECKLISTS["tama38"]
+
+    # Betterment levy
+    if "היטל השבחה" in appeal_lower or "betterment" in appeal_lower or any(
+        "היטל" in c for c in cats
+    ):
+        return CONTENT_CHECKLISTS["betterment_levy"]
+
+    # Property-focused (תימוכין קנייניים)
+    if any(
+        kw in subject_lower
+        for kw in ["תימוכין", "קנייני", "בעלות", "הסכמת דיירים"]
+    ):
+        return CONTENT_CHECKLISTS["licensing_property"]
+
+    # Threshold/jurisdiction
+    if any(
+        kw in subject_lower
+        for kw in ["סמכות", "סף", "סילוק על הסף", "זכות ערר"]
+    ):
+        return CONTENT_CHECKLISTS["licensing_threshold"]
+
+    # Default: substantive licensing
+    return CONTENT_CHECKLISTS["licensing_substantive"]
+
+
+# ── Methodology guidance (condensed from decision-methodology.md) ──
+
+_METHODOLOGY_CORE = """## מתודולוגיה אנליטית — עקרונות מנחים לכתיבת הדיון
+
+### מבנה סילוגיסטי לכל סוגיה
+כל סוגיה נבנית כסילוגיזם: (1) הנחה עליונה = הכלל (הוראת תכנית, חוק, הלכה); (2) הנחה תחתונה = העובדות הספציפיות; (3) מסקנה. אם לא ניתן לזהות את הכלל — ההנמקה אינה מספקת. אם לא ניתן לזהות כיצד העובדות מקיימות את הכלל — ההנמקה קריפטית.
+
+### התחל מלשון הטקסט
+כשהמקרה נשלט על ידי הוראת תכנית או סעיף חוק — פתח בציטוט ההוראה. פרש מילים במשמעותן הרגילה. תן תוקף לכל מילה. אם יש עמימות — השתמש בכלי פרשנות.
+
+### הפרד ממצא עובדתי ממסקנה משפטית
+"הבניה במרחק 1.5 מטרים מגבול המגרש" = ממצא עובדתי. "חריגה זו עולה כדי סטייה ניכרת" = מסקנה משפטית. אל תערבב.
+
+### CREAC לכל סוגיה
+1. מסקנה — פתח בתשובה ("הבקשה אינה תואמת...")
+2. כלל — ציטוט ההוראה
+3. הרחבה — תקדים רלוונטי אחד (אם נדרש)
+4. יישום — החלת הכלל על העובדות (לב ההנמקה)
+5. מסקנה חוזרת — סגירה תמציתית
+
+### Steel-Man — הצג טענה בחוזקתה לפני דחייה
+לפני שדוחים טענה — הצג אותה בגרסה החזקה ביותר: "אמנם צודק העורר כי [נקודה לטובתו], אולם [הנימוק לדחייה]." טענת קש קלה להפריך אך לא משכנעת.
+
+### טכניקת סנדוויץ' לציטוטים
+כל ציטוט עטוף: משפט הקדמה (מודיע על התוכן) → ציטוט → ניתוח (מסביר כיצד רלוונטי למקרה). אל תניח שהקורא יקרא ציטוט ארוך ויפיק ממנו מסקנות בעצמו.
+
+### נתונים, לא תיאורים
+"הבקשה חורגת ב-1.5 מטרים מקו הבניין" — לא "הבקשה חורגת באופן משמעותי." מספרים, מידות, אחוזים.
+
+### כנות לגבי קושי
+כשהמקרה קשה — אמור זאת: "הדבר אינו נקי מספקות, אולם..." אל תעמיד פנים שמקרה קשה הוא קל.
+
+### כל מילה עובדת
+"לאחר ששקלנו את כלל השיקולים" — ריק, מחק. מבחן: אם מוחקים את המשפט וההחלטה לא מאבדת מידע — המשפט מיותר.
+
+### איזון ומידתיות (כשהכלל לא נותן תשובה חד-משמעית)
+כשנדרש איזון:
+1. זהה אינטרסים קונקרטיים (לא "אינטרס הציבור" אלא "שמירה על אופי מגורים צמודי קרקע")
+2. בחן השלכות לכל כיוון: מה קורה אם מקבלים? אם דוחים?
+3. שקול השלכות מערכתיות: מה הסיגנל שנשלח למערכת?
+4. ציין מה מכריע את הכף ולמה
+כשמטילים מגבלה/תנאי — מבחן מידתיות: (1) תכלית ראויה?; (2) אמצעי פוגע פחות?; (3) פגיעה מידתית ביחס לתועלת?
+
+### טיפול בטענות
+- ההחלטה מנתחת שאלות — לא מתווכחת עם עו"ד. מבנה: שאלה→כלל→עובדות→מסקנה
+- טענות שסומנו [bundle] ב-chair_directions: קבץ ודון יחד
+- טענות שסומנו [skip] ב-chair_directions: ציון קצר בלבד
+- טענות ללא סימון: ענה בנפרד עם מענה מנומק
+- טענה מרכזית של הצד המפסיד חייבת מענה Steel-Man
+- מיקום ההתמודדות עם טענות נגדיות: באמצע הדיון בסוגיה (לא בהתחלה ולא בסוף)
+"""
+
+def get_methodology_summary() -> str:
+    """Return the condensed methodology guidance — always the same, always complete.
+
+    The methodology is universal: it teaches HOW to think, not WHAT to discuss.
+    Case-specific content (parking, building lines, significant deviation) belongs
+    in the content checklists, not here.
+    """
+    return _METHODOLOGY_CORE

mcp-server/src/legal_mcp/services/practice_area.py

@@ -0,0 +1,96 @@
+"""Practice area + appeal subtype: derivation, validation, constants.
+
+Two orthogonal axes used to separate legal domains across the system:
+
+  practice_area  — top-level domain (multi-tenant axis). Examples:
+                   appeals_committee, national_insurance, labor_law.
+  appeal_subtype — refines within a domain. For appeals_committee:
+                   building_permit (1xxx), betterment_levy (8xxx),
+                   compensation_197 (9xxx), unknown.
+
+Both columns are denormalized into documents/chunks/decisions/style_corpus
+so vector searches can filter cheaply.
+"""
+
+from __future__ import annotations
+
+import re
+
+# ── Enums ──────────────────────────────────────────────────────────
+
+PRACTICE_AREAS: set[str] = {
+    "appeals_committee",
+    "national_insurance",
+    "labor_law",
+}
+
+APPEALS_COMMITTEE_SUBTYPES: set[str] = {
+    "building_permit",
+    "betterment_levy",
+    "compensation_197",
+    "unknown",
+}
+
+DEFAULT_PRACTICE_AREA = "appeals_committee"
+
+# Subtypes per practice_area (extend when adding domains)
+SUBTYPES_BY_AREA: dict[str, set[str]] = {
+    "appeals_committee": APPEALS_COMMITTEE_SUBTYPES,
+    "national_insurance": {"unknown"},
+    "labor_law": {"unknown"},
+}
+
+
+# ── Derivation ─────────────────────────────────────────────────────
+
+_FIRST_DIGIT = re.compile(r"^\s*(\d)")
+
+_APPEALS_COMMITTEE_DIGIT_TO_SUBTYPE = {
+    "1": "building_permit",
+    "8": "betterment_levy",
+    "9": "compensation_197",
+}
+
+
+def derive_subtype(case_number: str, practice_area: str = DEFAULT_PRACTICE_AREA) -> str:
+    """Infer the appeal_subtype from case_number.
+
+    For appeals_committee, the convention is:
+      1xxx → building_permit, 8xxx → betterment_levy, 9xxx → compensation_197.
+
+    For other practice areas there is no public numbering convention yet,
+    so we return 'unknown' until a real rule is defined.
+    """
+    if practice_area != "appeals_committee":
+        return "unknown"
+    m = _FIRST_DIGIT.match(case_number or "")
+    if not m:
+        return "unknown"
+    return _APPEALS_COMMITTEE_DIGIT_TO_SUBTYPE.get(m.group(1), "unknown")
+
+
+# ── Validation ─────────────────────────────────────────────────────
+
+
+def validate(practice_area: str, appeal_subtype: str | None) -> None:
+    """Raise ValueError on unknown values. appeal_subtype=None is allowed."""
+    if practice_area not in PRACTICE_AREAS:
+        raise ValueError(
+            f"unknown practice_area: {practice_area!r}. "
+            f"expected one of {sorted(PRACTICE_AREAS)}"
+        )
+    if appeal_subtype is None:
+        return
+    allowed = SUBTYPES_BY_AREA.get(practice_area, {"unknown"})
+    if appeal_subtype not in allowed:
+        raise ValueError(
+            f"unknown appeal_subtype {appeal_subtype!r} for practice_area "
+            f"{practice_area!r}. expected one of {sorted(allowed)}"
+        )
+
+
+def is_override(case_number: str, practice_area: str, appeal_subtype: str) -> bool:
+    """True iff the user-supplied subtype disagrees with what derive_subtype
+    would have produced (and the derived value is not 'unknown')."""
+    derived = derive_subtype(case_number, practice_area)
+    return derived != "unknown" and derived != appeal_subtype

mcp-server/src/legal_mcp/tools/cases.py

@@ -3,12 +3,13 @@
 from __future__ import annotations
 
 import json
+import shutil
 import subprocess
 from pathlib import Path
 from uuid import UUID
 
 from legal_mcp import config
-from legal_mcp.services import db
+from legal_mcp.services import audit, db, practice_area as pa
 
 
 async def case_create(
@@ -23,6 +24,8 @@ async def case_create(
     hearing_date: str = "",
     notes: str = "",
     expected_outcome: str = "",
+    practice_area: str = "appeals_committee",
+    appeal_subtype: str = "",
 ) -> str:
     """יצירת תיק ערר חדש.
 
@@ -38,6 +41,9 @@ async def case_create(
         hearing_date: תאריך דיון (YYYY-MM-DD)
         notes: הערות
         expected_outcome: תוצאה צפויה (rejection/partial_acceptance/full_acceptance/betterment_levy)
+        practice_area: תחום משפטי (appeals_committee / national_insurance / labor_law)
+        appeal_subtype: סוג ערר (building_permit / betterment_levy / compensation_197).
+                        ריק = יוסק אוטומטית ממספר התיק
     """
     from datetime import date as date_type
 
@@ -45,6 +51,12 @@ async def case_create(
     if hearing_date:
         h_date = date_type.fromisoformat(hearing_date)
 
+    # Resolve appeal_subtype: explicit override > auto-derive > 'unknown'
+    derived_subtype = pa.derive_subtype(case_number, practice_area)
+    if not appeal_subtype:
+        appeal_subtype = derived_subtype
+    pa.validate(practice_area, appeal_subtype)
+
     case = await db.create_case(
         case_number=case_number,
         title=title,
@@ -57,8 +69,24 @@ async def case_create(
         hearing_date=h_date,
         notes=notes,
         expected_outcome=expected_outcome,
+        practice_area=practice_area,
+        appeal_subtype=appeal_subtype,
     )
 
+    # If the user overrode the case-number convention (e.g. case 8500 marked
+    # as building_permit), record it so we can audit later.
+    if pa.is_override(case_number, practice_area, appeal_subtype):
+        await audit.log_action(
+            action="case_subtype_override",
+            case_id=UUID(case["id"]),
+            details={
+                "case_number": case_number,
+                "derived_subtype": derived_subtype,
+                "chosen_subtype": appeal_subtype,
+                "practice_area": practice_area,
+            },
+        )
+
     # Initialize git repo for the case
     case_dir = config.find_case_dir(case_number)
     case_dir.mkdir(parents=True, exist_ok=True)
@@ -187,3 +215,37 @@ async def case_update(
         )
 
     return json.dumps(updated, default=str, ensure_ascii=False, indent=2)
+
+
+async def case_delete(case_number: str, remove_files: bool = False) -> str:
+    """מחיקת תיק ערר. מסיר את התיק מ-DB עם cascade לכל המסמכים והטענות.
+
+    Args:
+        case_number: מספר תיק הערר
+        remove_files: האם למחוק גם את תיקיית הדיסק (drafts, git repo).
+                      ברירת מחדל False — ה-DB נמחק אבל הקבצים נשמרים לגיבוי.
+    """
+    case = await db.get_case_by_number(case_number)
+    if not case:
+        return json.dumps(
+            {"deleted": False, "reason": f"תיק {case_number} לא נמצא."},
+            ensure_ascii=False,
+        )
+
+    case_id = UUID(case["id"])
+    ok = await db.delete_case(case_id)
+
+    result = {
+        "deleted": ok,
+        "case_number": case_number,
+        "case_id": str(case_id),
+        "removed_files": False,
+    }
+
+    if ok and remove_files:
+        case_dir = config.find_case_dir(case_number)
+        if case_dir.exists():
+            shutil.rmtree(case_dir, ignore_errors=True)
+            result["removed_files"] = True
+
+    return json.dumps(result, ensure_ascii=False, indent=2)

mcp-server/src/legal_mcp/tools/documents.py

@@ -105,6 +105,8 @@ async def document_upload_training(
     decision_date: str = "",
     subject_categories: list[str] | None = None,
     title: str = "",
+    practice_area: str = "appeals_committee",
+    appeal_subtype: str = "",
 ) -> str:
     """העלאת החלטה קודמת של דפנה לקורפוס הסגנון (training).
 
@@ -114,10 +116,13 @@ async def document_upload_training(
         decision_date: תאריך ההחלטה (YYYY-MM-DD)
         subject_categories: קטגוריות - אפשר לבחור כמה (בנייה, שימוש חורג, תכנית, היתר, הקלה, חלוקה, תמ"א 38, היטל השבחה, פיצויים 197)
         title: שם המסמך
+        practice_area: תחום משפטי (appeals_committee / national_insurance / labor_law)
+        appeal_subtype: סוג ערר (building_permit / betterment_levy / compensation_197).
+                        ריק = יוסק אוטומטית ממספר ההחלטה
     """
     from datetime import date as date_type
 
-    from legal_mcp.services import extractor, embeddings, chunker
+    from legal_mcp.services import chunker, embeddings, extractor, practice_area as pa
 
     source = Path(file_path)
     if not source.exists():
@@ -126,6 +131,11 @@ async def document_upload_training(
     if not title:
         title = source.stem
 
+    # Resolve subtype: explicit > derived from decision_number > 'unknown'
+    if not appeal_subtype:
+        appeal_subtype = pa.derive_subtype(decision_number, practice_area)
+    pa.validate(practice_area, appeal_subtype)
+
     # Copy to training directory (skip if already there)
     config.TRAINING_DIR.mkdir(parents=True, exist_ok=True)
     dest = config.TRAINING_DIR / source.name
@@ -140,25 +150,29 @@ async def document_upload_training(
     if decision_date:
         d_date = date_type.fromisoformat(decision_date)
 
-    # Add to style corpus
+    # Add to style corpus (tagged by domain so block-writer can filter)
     corpus_id = await db.add_to_style_corpus(
         document_id=None,
         decision_number=decision_number,
         decision_date=d_date,
         subject_categories=subject_categories or [],
         full_text=text,
+        practice_area=practice_area,
+        appeal_subtype=appeal_subtype,
     )
 
     # Chunk and embed for RAG search over training corpus
     chunks = chunker.chunk_document(text)
     if chunks:
-        # Create a document record (no case association)
+        # Create a document record (no case association — tag explicitly)
         doc = await db.create_document(
             case_id=None,
             doc_type="decision",
             title=f"[קורפוס] {title}",
             file_path=str(dest),
             page_count=page_count,
+            practice_area=practice_area,
+            appeal_subtype=appeal_subtype,
         )
         doc_id = UUID(doc["id"])
         await db.update_document(doc_id, extracted_text=text, extraction_status="completed")
@@ -176,7 +190,10 @@ async def document_upload_training(
             }
             for c, emb in zip(chunks, embs)
         ]
-        await db.store_chunks(doc_id, None, chunk_dicts)
+        await db.store_chunks(
+            doc_id, None, chunk_dicts,
+            practice_area=practice_area, appeal_subtype=appeal_subtype,
+        )
 
     return json.dumps({
         "corpus_id": str(corpus_id),

mcp-server/src/legal_mcp/tools/precedents.py

@@ -0,0 +1,95 @@
+"""MCP tools for attached legal precedents (user-supplied case-law quotes).
+
+These complement the existing `case_law` table (which is populated from
+structured sources and is what the block-writer RAG searches) by storing
+free-text citations the chair attaches during the compose phase.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from uuid import UUID
+
+from legal_mcp.services import db
+
+
+async def precedent_attach(
+    case_number: str,
+    quote: str,
+    citation: str,
+    section_id: str = "",
+    chair_note: str = "",
+    pdf_document_id: str = "",
+) -> str:
+    """צירוף פסיקה תומכת לתיק ערר.
+
+    Args:
+        case_number: מספר תיק הערר
+        quote: הציטוט המדויק שיוכנס להחלטה
+        citation: מראה המקום (ערר 1126-08-25 ... נ' ... (נבו 9.3.2026))
+        section_id: מזהה הטענה/סוגיה (threshold_1, issue_3); ריק = כללי לתיק
+        chair_note: הערה אופציונלית — למה הציטוט תומך בעמדה
+        pdf_document_id: מזהה קובץ PDF מצורף (אופציונלי)
+    """
+    case = await db.get_case_by_number(case_number)
+    if not case:
+        return json.dumps({"error": f"תיק {case_number} לא נמצא."}, ensure_ascii=False)
+
+    pdf_uuid: UUID | None = None
+    if pdf_document_id:
+        try:
+            pdf_uuid = UUID(pdf_document_id)
+        except ValueError:
+            return json.dumps({"error": "pdf_document_id לא תקין"}, ensure_ascii=False)
+
+    row = await db.create_case_precedent(
+        case_id=UUID(case["id"]),
+        quote=quote,
+        citation=citation,
+        section_id=section_id or None,
+        chair_note=chair_note,
+        pdf_document_id=pdf_uuid,
+        practice_area=case.get("practice_area"),
+    )
+    return json.dumps(row, ensure_ascii=False, indent=2)
+
+
+async def precedent_list(case_number: str) -> str:
+    """רשימת כל הפסיקות שצורפו לתיק, ממוינות לפי סעיף ואז לפי זמן יצירה."""
+    case = await db.get_case_by_number(case_number)
+    if not case:
+        return json.dumps({"error": f"תיק {case_number} לא נמצא."}, ensure_ascii=False)
+
+    rows = await db.list_case_precedents(UUID(case["id"]))
+    return json.dumps(rows, ensure_ascii=False, indent=2)
+
+
+async def precedent_remove(precedent_id: str) -> str:
+    """הסרת פסיקה מצורפת. קובץ ה-PDF (אם צורף) נשאר ב-documents לצורך audit."""
+    try:
+        pid = UUID(precedent_id)
+    except ValueError:
+        return json.dumps({"error": "precedent_id לא תקין"}, ensure_ascii=False)
+
+    ok = await db.delete_case_precedent(pid)
+    return json.dumps(
+        {"deleted": ok, "precedent_id": precedent_id}, ensure_ascii=False,
+    )
+
+
+async def precedent_search_library(
+    query: str, practice_area: str = "", limit: int = 10,
+) -> str:
+    """חיפוש בספרייה הרוחבית — כל הפסיקות שצורפו אי-פעם בכל התיקים.
+
+    Args:
+        query: מחרוזת חיפוש (מתחרה מול citation ומול quote)
+        practice_area: אופציונלי — סינון לתחום משפטי מסוים
+        limit: מספר תוצאות מקסימלי
+    """
+    if not query or len(query.strip()) < 2:
+        return json.dumps([], ensure_ascii=False)
+
+    rows = await db.search_precedent_library(query.strip(), practice_area, limit)
+    return json.dumps(rows, ensure_ascii=False, indent=2)

mcp-server/src/legal_mcp/tools/search.py

@@ -3,28 +3,52 @@
 from __future__ import annotations
 
 import json
+import logging
 from uuid import UUID
 
 from legal_mcp.services import db, embeddings
 
+logger = logging.getLogger(__name__)
+
 
 async def search_decisions(
     query: str,
     limit: int = 10,
     section_type: str = "",
+    practice_area: str = "",
+    appeal_subtype: str = "",
+    case_number: str = "",
 ) -> str:
-    """חיפוש סמנטי בהחלטות קודמות ובמסמכים.
+    """חיפוש סמנטי בהחלטות קודמות ובמסמכים — מסונן לפי תחום משפטי.
 
     Args:
-        query: שאילתת חיפוש בעברית (לדוגמה: "שימוש חורג למסחר באזור מגורים")
+        query: שאילתת חיפוש בעברית
         limit: מספר תוצאות מקסימלי
-        section_type: סינון לפי סוג סעיף (facts, legal_analysis, conclusion, ruling, וכו'). ריק = הכל
+        section_type: סינון לפי סוג סעיף (facts, legal_analysis, ...)
+        practice_area: תחום משפטי לסינון (appeals_committee/national_insurance/...)
+        appeal_subtype: סוג ערר לסינון (building_permit/betterment_levy/compensation_197)
+        case_number: אם סופק, ה-practice_area/subtype יוסקו אוטומטית מהתיק
     """
+    # Auto-resolve practice_area from case_number if available
+    if case_number and not practice_area:
+        case = await db.get_case_by_number(case_number)
+        if case:
+            practice_area = case.get("practice_area") or ""
+            appeal_subtype = appeal_subtype or (case.get("appeal_subtype") or "")
+
+    if not practice_area:
+        logger.warning(
+            "search_decisions called without practice_area filter — "
+            "results may mix legal domains"
+        )
+
     query_emb = await embeddings.embed_query(query)
     results = await db.search_similar(
         query_embedding=query_emb,
         limit=limit,
         section_type=section_type or None,
+        practice_area=practice_area or None,
+        appeal_subtype=appeal_subtype or None,
     )
 
     if not results:
@@ -61,6 +85,7 @@ async def search_case_documents(
         return f"תיק {case_number} לא נמצא."
 
     query_emb = await embeddings.embed_query(query)
+    # Restricted to case_id — practice_area filter would be redundant.
     results = await db.search_similar(
         query_embedding=query_emb,
         limit=limit,
@@ -86,17 +111,37 @@ async def search_case_documents(
 async def find_similar_cases(
     description: str,
     limit: int = 5,
+    practice_area: str = "",
+    appeal_subtype: str = "",
+    case_number: str = "",
 ) -> str:
-    """מציאת תיקים דומים על בסיס תיאור.
+    """מציאת תיקים דומים על בסיס תיאור — מסונן לפי תחום משפטי.
 
     Args:
-        description: תיאור התיק או הנושא (לדוגמה: "ערר על סירוב להיתר בנייה לתוספת קומה")
+        description: תיאור התיק או הנושא
         limit: מספר תוצאות מקסימלי
+        practice_area: תחום משפטי לסינון
+        appeal_subtype: סוג ערר לסינון
+        case_number: אם סופק, ה-practice_area/subtype יוסקו אוטומטית מהתיק
     """
+    if case_number and not practice_area:
+        case = await db.get_case_by_number(case_number)
+        if case:
+            practice_area = case.get("practice_area") or ""
+            appeal_subtype = appeal_subtype or (case.get("appeal_subtype") or "")
+
+    if not practice_area:
+        logger.warning(
+            "find_similar_cases called without practice_area filter — "
+            "results may mix legal domains"
+        )
+
     query_emb = await embeddings.embed_query(description)
     results = await db.search_similar(
         query_embedding=query_emb,
         limit=limit * 3,  # Get more to deduplicate by case
+        practice_area=practice_area or None,
+        appeal_subtype=appeal_subtype or None,
     )
 
     if not results:

mcp-server/src/legal_mcp/tools/workflow.py

@@ -318,3 +318,97 @@ async def ingest_final_version(
         return json.dumps(result, default=str, ensure_ascii=False, indent=2)
     except ValueError as e:
         return json.dumps({"status": "error", "message": str(e)}, ensure_ascii=False, indent=2)
+
+
+# ── Chair feedback tools ──────────────────────────────────────────
+
+
+async def record_chair_feedback(
+    case_number: str,
+    feedback_text: str,
+    block_id: str = "block-yod",
+    category: str = "missing_content",
+    lesson_extracted: str = "",
+) -> str:
+    """תיעוד הערת יו"ר (דפנה) על טיוטת החלטה.
+
+    Args:
+        case_number: מספר תיק הערר
+        feedback_text: ההערה של דפנה (מה חסר, מה לא נכון, מה צריך לשנות)
+        block_id: הבלוק שההערה מתייחסת אליו (ברירת מחדל: block-yod)
+        category: קטגוריה — missing_content/wrong_tone/wrong_structure/factual_error/style/other
+        lesson_extracted: הלקח שהופק מההערה (אם ברור כבר)
+    """
+    case = await db.get_case_by_number(case_number)
+    case_id = UUID(case["id"]) if case else None
+
+    valid_categories = [
+        "missing_content", "wrong_tone", "wrong_structure",
+        "factual_error", "style", "other",
+    ]
+    if category not in valid_categories:
+        return f"קטגוריה לא חוקית. אפשרויות: {', '.join(valid_categories)}"
+
+    feedback_id = await db.record_chair_feedback(
+        case_id=case_id,
+        block_id=block_id,
+        feedback_text=feedback_text,
+        category=category,
+        lesson_extracted=lesson_extracted,
+    )
+
+    return json.dumps({
+        "status": "ok",
+        "feedback_id": str(feedback_id),
+        "message": f"הערה נרשמה בהצלחה. קטגוריה: {category}.",
+        "next_steps": [
+            "כדי להפיק לקח מההערה, הפעל: analyze_chair_feedback",
+            "כדי לסמן כמטופל: resolve_chair_feedback",
+        ],
+    }, ensure_ascii=False, indent=2)
+
+
+async def list_chair_feedback(
+    case_number: str = "",
+    category: str = "",
+    unresolved_only: bool = True,
+) -> str:
+    """הצגת הערות יו"ר שתועדו, עם אפשרות סינון.
+
+    Args:
+        case_number: סינון לפי תיק (אם ריק — כל ההערות)
+        category: סינון לפי קטגוריה
+        unresolved_only: האם להציג רק הערות שלא טופלו (ברירת מחדל: כן)
+    """
+    case_id = None
+    if case_number:
+        case = await db.get_case_by_number(case_number)
+        if case:
+            case_id = UUID(case["id"])
+
+    feedbacks = await db.list_chair_feedback(
+        case_id=case_id,
+        category=category or None,
+        unresolved_only=unresolved_only,
+    )
+
+    if not feedbacks:
+        return "אין הערות שמתאימות לסינון."
+
+    items = []
+    for fb in feedbacks:
+        items.append({
+            "id": str(fb["id"]),
+            "case_id": str(fb["case_id"]) if fb["case_id"] else None,
+            "block_id": fb["block_id"],
+            "category": fb["category"],
+            "feedback": fb["feedback_text"],
+            "lesson": fb["lesson_extracted"],
+            "resolved": fb["resolved"],
+            "date": fb["created_at"].isoformat() if fb.get("created_at") else None,
+        })
+
+    return json.dumps({
+        "total": len(items),
+        "feedbacks": items,
+    }, ensure_ascii=False, indent=2, default=str)

skills/decision/SKILL.md

@@ -203,6 +203,9 @@ description: This skill should be used when writing legal decisions (החלטו
 
 ## 6. השיטה האנליטית - "איך לחשוב" לפני "איך לכתוב"
 
+> **מסמך המתודולוגיה המלא:** [`docs/decision-methodology.md`](../../docs/decision-methodology.md)
+> מסמך זה עוסק בטכניקות הכתיבה של דפנה. לתאוריית ההחלטה הכללית — מבנה סילוגיסטי, איזון, steel-man, טכניקת סנדוויץ', הפרדת ממצאים ממסקנות — ראה את מסמך המתודולוגיה.
+
 ### 6.1 שומר הסף - שאלת הסף
 
 לפני שנוגעים בטענה לגופה, השאלה הראשונה היא: "יש לעוררים בכלל זכות ערר?" זו לא רק שאלה פרוצדורלית - זו מסגרת הניתוח כולה. **סייג חשוב:** שאלת הסף היא כלי אסטרטגי, לא חובה. בתיקים עם שאלות מהותיות חזקות (חניה, שימור, קווי בניין), דפנה עשויה לדלג על שאלת הסף ולדון ישירות בגוף העניין — במיוחד בקבלה חלקית. ראה: בית הכרם 1126/25 — דילגה על ס' 152 לחלוטין.
@@ -499,3 +502,39 @@ description: This skill should be used when writing legal decisions (החלטו
 | תיבות תמונה | מסגרת עם shading אפור בהיר (fill: "F0F0F0"), טקסט "📷 תמונה: [תיאור]" | ShadingType.CLEAR |
 | חתימות | טבלה ללא גבולות (`visuallyRightToLeft: true`), 2 טורים | כמו בתבנית ב-create-legal-doc.js |
 | כותרת מוסדית | טבלה ללא גבולות, 2 טורים: ימין=מוסד, שמאל=מספרי תיק | `visuallyRightToLeft: true` |
+
+
+## 12. צ'קליסט תוכן לפי סוג ערר
+
+> נוסף אפריל 2026 בעקבות ניתוח שיטתי של 24 החלטות. ראה: `docs/corpus-analysis.md`
+
+הפרומפט של בלוק י מקבל **צ'קליסט תוכן** אוטומטי לפי סוג הערר (`lessons.py: CONTENT_CHECKLISTS`). זה מבטיח שהדיון יכסה את הנושאים הנדרשים — לא רק סגנון ומתודולוגיה, אלא תוכן ענייני.
+
+### 12.1 חמישה תת-סוגי רישוי (לא שלושה)
+ניתוח הקורפוס חשף שלתיקי רישוי יש 5 תת-סוגים שונים מבחינת מבנה הדיון:
+
+| תת-סוג | מה בדיון | דוגמאות |
+|---------|---------|---------|
+| **רישוי מהותי** | דיון תכנוני מקיף + משפטי | רוב ההחלטות |
+| **סף/סמכות** | משפטי בלבד, ללא תכנון | גבאי, ירושלים שקופה |
+| **קנייני** | תימוכין קנייניים, מינימום תכנון | טלי-אביב, הראל 1043 |
+| **תמ"א 38** | איזון אינטרסים + תכנון + שכנות | בית הכרם |
+| **שימוש חורג** | פרשנות תכניות מרובות | תורן |
+
+### 12.2 דיון תכנוני — מתי ואיך
+**מתי חובה:** כשהערר מגיע לדיון מהותי (לא סף/סמכות, לא קנייני טהור).
+
+**מבנה טיפוסי (מהקורפוס):**
+1. הקשר תכנוני רחב — תכניות חלות, ייעוד, סביבה (2-8 סעיפים)
+2. ציטוט ישיר מהוראות תכנית — בלוקים של 200-600 מילים עם "הדגשת הח"מ"
+3. יישום על המקרה — הוראה → עובדה → מסקנה
+4. מסקנה תכנונית — תואם/סוטה, מוצדק/לא
+
+**נושאים שמופיעים בתדירות גבוהה:**
+- חניה (8/24 החלטות) — הנושא התכנוני הנפוץ ביותר, עומק של 5-15 סעיפים
+- קווי בניין (7/24) — כולל ניתוח סטייה ניכרת
+- ניתוח הוראות תכנית (18/24) — כמעט תמיד
+- פגיעה בשכנים (5/24) — צל, פרטיות, רעש
+
+### 12.3 הערות יו"ר
+הערות דפנה על טיוטות מתועדות במערכת `chair_feedback` (DB + API + UI ב-`/feedback`). כל הערה מסווגת לקטגוריה ומפיקה לקח שמשפר את ההחלטות הבאות.

start.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+# Start FastAPI backend + Next.js frontend in the same container.
+# Both processes log to stdout/stderr so Docker captures everything.
+
+set -e
+
+echo "[start.sh] Starting FastAPI backend on :8000 ..."
+uvicorn web.app:app --host 127.0.0.1 --port 8000 --workers 1 2>&1 &
+UVICORN_PID=$!
+
+# Give uvicorn a moment to start (or crash)
+sleep 2
+
+if ! kill -0 $UVICORN_PID 2>/dev/null; then
+  echo "[start.sh] ERROR: uvicorn failed to start!"
+  # Don't exit — let Node.js run so the UI is accessible for debugging
+fi
+
+echo "[start.sh] Starting Next.js frontend on :3000 ..."
+node server.js

web-ui/README.md

@@ -1,36 +1,175 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# עוזר משפטי — Web UI (Next.js rewrite)
 
-## Getting Started
+The Next.js 16 rewrite of `legal-ai.nautilus.marcusgroup.org`, currently hosted side-by-side with the legacy vanilla `index.html` at:
 
-First, run the development server:
+- **Staging:** https://legal-ai-next.nautilus.marcusgroup.org (auto-deployed from `ui-rewrite` branch via Coolify)
+- **Production FastAPI:** https://legal-ai.nautilus.marcusgroup.org (same backend, old UI still default)
+
+The rewrite talks to the existing FastAPI via proxy rewrites in `next.config.ts` — no CORS setup, no duplicated backend.
+
+## Stack
+
+- Next.js 16.2.3 (App Router, Turbopack, `output: "standalone"`)
+- React 19.2 · TypeScript · Tailwind v4 · shadcn/ui (radix-nova preset)
+- TanStack Query v5 + TanStack Table v8
+- react-hook-form + zod for mutations
+- react-dropzone for uploads; EventSource for SSE progress
+- Heebo via `next/font/google`; design tokens in `src/app/globals.css`
+
+## Local development
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
+npm install
+npm run dev        # http://localhost:3000
+npm run build      # full type check + production build
+npm run lint
+npm run api:types  # regenerate src/lib/api/types.ts from FastAPI's OpenAPI
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+### API connection
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+By default the dev server proxies to production FastAPI (`https://legal-ai.nautilus.marcusgroup.org`). To point at a different backend, set:
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+```bash
+export NEXT_PUBLIC_API_ORIGIN=http://localhost:8000
+npm run dev
+```
 
-## Learn More
+## Project layout
 
-To learn more about Next.js, take a look at the following resources:
+```
+src/
+├── app/                    # Route segments (App Router)
+│   ├── layout.tsx          # Root: Providers + RTL html + fonts
+│   ├── page.tsx            # Home: KPIs + status donut + cases table
+│   ├── error.tsx           # Route-segment error boundary
+│   ├── global-error.tsx    # Root crash fallback
+│   ├── not-found.tsx       # 404
+│   ├── cases/
+│   │   ├── new/            # 3-step create wizard
+│   │   └── [caseNumber]/
+│   │       ├── page.tsx    # Case detail (tabs + workflow timeline)
+│   │       └── compose/    # Research analysis + chair-position editor
+│   ├── training/           # Style portrait + corpus + compare (3 tabs)
+│   ├── skills/             # Paperclip skills inventory
+│   └── diagnostics/        # DB health + failed/stuck docs
+├── components/
+│   ├── app-shell.tsx       # Header + nav with aria-current
+│   ├── cases/              # Home + detail screens
+│   ├── compose/            # Research analysis editor
+│   ├── documents/          # UploadSheet
+│   ├── training/           # Style report / corpus / compare panels
+│   ├── wizard/             # Case create wizard + parties-field
+│   └── ui/                 # shadcn primitives
+├── lib/
+│   ├── api/                # Typed hooks per domain (cases, documents, research,
+│   │                       #   system, skills, training)
+│   ├── schemas/            # zod schemas (case create / update)
+│   ├── practice-area.ts    # Multi-tenant axis enum + deriveSubtype()
+│   ├── sse.ts              # EventSource wrapper
+│   ├── providers.tsx       # QueryClient + Toaster
+│   └── utils.ts            # cn()
+```
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+## Smoke test (run after every deploy)
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+Use any browser at the staging URL. Every step should be doable **without console errors** and each mutation should produce a visible toast.
 
-## Deploy on Vercel
+### 1. Home · `/`
+- [ ] Header nav shows 5 items; the current page is underlined in gold
+- [ ] 4 KPI cards render real numbers (סה״כ · בהכנה · בכתיבה · מוכנים)
+- [ ] Cases table lists existing cases; search filters by case number or title
+- [ ] "פיזור סטטוסים" donut renders with a legend
+- [ ] "+ תיק חדש" button in the top-left navigates to `/cases/new`
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+### 2. Create case · `/cases/new`
+- [ ] 3-step wizard: פרטי יסוד → צדדים → השלמות
+- [ ] Type `1500-25` → appeal_subtype auto-fills to "רישוי ובנייה"
+- [ ] Type `8500-25` → subtype auto-fills to "היטל השבחה"
+- [ ] Manually pick a different subtype → auto-fill stops
+- [ ] Submitting with invalid case number shows a zod field error (no crash)
+- [ ] Successful create → toast "תיק חדש נוצר" → router pushes to `/cases/{number}`
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+### 3. Case detail · `/cases/[caseNumber]`
+- [ ] Header shows status badge + gold "ועדת ערר · X" practice-area badge
+- [ ] Tabs switch cleanly: סקירה / מסמכים / פעולות
+- [ ] Workflow timeline on the right shows the current phase highlighted in gold
+- [ ] פעולות tab → "עריכת פרטי תיק" dialog opens; submitting updates the header without full reload (optimistic cache patch)
+- [ ] "העלאת מסמכים" sheet opens from the tab row; drag-drop fires a POST and a live progress bar appears via SSE
+
+### 4. Compose · `/cases/[caseNumber]/compose`
+- [ ] If analysis-and-research.md exists: threshold claims + issues render as collapsible cards
+- [ ] Chair-position textarea auto-saves on blur with "✓ נשמר {time}" indicator
+- [ ] If 404 (no analysis yet): empty state card renders, no error toast
+
+### 5. Training · `/training`
+- [ ] **Report tab:** headline card, 4 KPIs, subject donut, anatomy bars, top-12 signature phrases
+- [ ] **Corpus tab:** table of corpus decisions with a trash icon per row (aria-label present)
+- [ ] Deleting a decision refreshes both the corpus table and the report KPIs
+- [ ] **Compare tab:** two Selects, pick 2 different decisions, side-by-side panels + shared/only-A/only-B pattern lists
+
+### 6. Skills · `/skills`
+- [ ] Card grid of Paperclip skills with sync-status badges (מסונכרן / DB בלבד / לא סונכרן)
+- [ ] Chars + file counts render; "לא ידוע" doesn't appear for installed skills
+
+### 7. Diagnostics · `/diagnostics`
+- [ ] DB status card shows "מחובר" in green
+- [ ] Table counts populate for cases / documents / chunks / corpus / patterns
+- [ ] Failed + stuck document lists render (empty states OK)
+- [ ] Page self-refreshes every 10s — check the network tab for recurring calls
+
+### 8. Error boundary
+- [ ] Visit `/cases/NOT-REAL-999-99` → case detail shows an error card with the FastAPI message and "חזרה לרשימת התיקים" button (no white screen)
+- [ ] Visit `/anything-broken-xyz` → custom 404 page with "חזרה לבית" button
+
+### 9. Keyboard + RTL
+- [ ] Tab through the home page — focus rings are gold, visible
+- [ ] Wizard progresses via Enter on the "הבא" button
+- [ ] Screen reader announces nav items with "עמוד נוכחי" on the active one
+
+## Deploy
+
+```
+git push  # → Coolify auto-build on branch ui-rewrite (~90 s)
+```
+
+> **Known issue:** the Gitea → Coolify webhook is not firing at the time of writing. Trigger a manual deploy via the Coolify MCP (`mcp__coolify__deploy` with app UUID `l146g36mtlp0k03vrwkyrgkk`) or the Coolify UI until the webhook is fixed.
+
+## Phase tracking
+
+See `~/.claude/plans/joyful-marinating-sutton.md` for the 7-phase rewrite plan and `~/legal-ai-ui-rewrite/.taskmaster/tasks/tasks.json` for the task board.
+
+| Phase | Scope | Status |
+|---|---|---|
+| 1 | Scaffold + Coolify staging | ✅ |
+| 2 | API client + typed hooks + probe | ✅ |
+| 3 | Read views (home, case detail, compose) | ✅ |
+| 4 | Mutations (wizard, edit, upload+SSE) | ✅ |
+| 4.5 | Practice-area integration | ✅ |
+| 5 | Secondary screens (training, skills, diagnostics) | ✅ |
+| 6 | Polish, a11y, error boundaries, smoke test | ✅ |
+| 7 | DNS cutover to production | pending |
+
+## Backend contract
+
+The new UI consumes the existing FastAPI at `legal-ai/web/app.py`. Key endpoints currently relied on:
+
+| Endpoint | Hook | Used by |
+|---|---|---|
+| `GET /api/cases?detail=true` | `useCases` | home table, KPIs |
+| `GET /api/cases/{n}/details` | `useCase` | case detail |
+| `POST /api/cases/create` | `useCreateCase` | wizard |
+| `PUT /api/cases/{n}` | `useUpdateCase` | inline edit |
+| `DELETE /api/cases?case_number=...` | (MCP only so far) | admin cleanup |
+| `POST /api/cases/{n}/documents/upload-tagged` | `useUploadDocument` | upload sheet |
+| `GET /api/progress/{task_id}` (SSE) | `useProgress` | upload progress |
+| `GET /api/cases/{n}/research/analysis` | `useResearchAnalysis` | compose |
+| `PATCH .../chair-position` | `useSaveChairPosition` | chair editor |
+| `GET /api/training/style-report` | `useStyleReport` | training/report tab |
+| `GET /api/training/corpus` | `useCorpus` | training/corpus tab |
+| `GET /api/training/compare` | `useCompare` | training/compare tab |
+| `DELETE /api/training/corpus/{id}` | `useDeleteCorpusEntry` | corpus tab |
+| `GET /api/system/diagnostics` | `useDiagnostics` | diagnostics page |
+| `GET /api/admin/skills` | `useSkills` | skills page |
+
+Any new endpoint should get a typed hook in `src/lib/api/` — do not reach into `fetch` from component code.

web-ui/next.config.ts

@@ -1,17 +1,14 @@
 import type { NextConfig } from "next";
 
 /**
- * Staging config — proxies /api/* and /openapi.json to the production FastAPI
- * at legal-ai.nautilus.marcusgroup.org. This lets the new Next.js UI call the
- * existing backend without CORS and without running a second FastAPI instance.
- *
- * When the rewrite branch is cut over to production, set NEXT_PUBLIC_API_BASE_URL
- * and/or move the FastAPI in front of this app via traefik routing.
+ * Proxies /api/* and /openapi.json to the FastAPI backend.
+ * In Docker both processes run in the same container, so the default
+ * target is http://127.0.0.1:8000.  Override with NEXT_PUBLIC_API_ORIGIN
+ * if the backend lives elsewhere (e.g. during local dev).
  */
 
 const API_ORIGIN =
-  process.env.NEXT_PUBLIC_API_ORIGIN ??
-  "https://legal-ai.nautilus.marcusgroup.org";
+  process.env.NEXT_PUBLIC_API_ORIGIN ?? "http://127.0.0.1:8000";
 
 const nextConfig: NextConfig = {
   output: "standalone",

web-ui/package.json

@@ -17,12 +17,16 @@
     "clsx": "^2.1.1",
     "lucide-react": "^1.8.0",
     "next": "16.2.3",
+    "next-themes": "^0.4.6",
     "radix-ui": "^1.4.3",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "react-dropzone": "^15.0.0",
     "react-hook-form": "^7.72.1",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
     "shadcn": "^4.2.0",
+    "sonner": "^2.0.7",
     "tailwind-merge": "^3.5.0",
     "tw-animate-css": "^1.4.0",
     "zod": "^4.3.6"

web-ui/src/app/cases/[caseNumber]/compose/page.tsx

@@ -7,8 +7,11 @@ import { Card, CardContent } from "@/components/ui/card";
 import { Button } from "@/components/ui/button";
 import { Skeleton } from "@/components/ui/skeleton";
 import { SubsectionCard } from "@/components/compose/subsection-card";
+import { PrecedentsSection } from "@/components/compose/precedents-section";
+import { Markdown } from "@/components/ui/markdown";
 import { useCase } from "@/lib/api/cases";
 import { useResearchAnalysis } from "@/lib/api/research";
+import { useCasePrecedents } from "@/lib/api/precedents";
 
 function ProseSection({ title, content }: { title: string; content?: string }) {
   if (!content?.trim()) return null;
@@ -17,9 +20,7 @@ function ProseSection({ title, content }: { title: string; content?: string }) {
       <h3 className="text-[0.78rem] uppercase tracking-[0.08em] text-gold-deep font-semibold">
         {title}
       </h3>
-      <p className="text-sm text-ink-soft leading-relaxed whitespace-pre-line prose">
-        {content.trim()}
-      </p>
+      <Markdown content={content.trim()} />
     </section>
   );
 }
@@ -32,6 +33,21 @@ export default function ComposePage({
   const { caseNumber } = use(params);
   const caseQuery = useCase(caseNumber);
   const analysis = useResearchAnalysis(caseNumber);
+  const precedentsQuery = useCasePrecedents(caseNumber);
+
+  /* Partition the flat list into scopes so each child renders its own slice
+   * without re-fetching. Done once at the page level. */
+  const allPrecedents = precedentsQuery.data ?? [];
+  const caseLevelPrecedents = allPrecedents.filter((p) => p.section_id === null);
+  const precedentsBySection = new Map<string, typeof allPrecedents>();
+  for (const p of allPrecedents) {
+    if (p.section_id) {
+      const existing = precedentsBySection.get(p.section_id) ?? [];
+      existing.push(p);
+      precedentsBySection.set(p.section_id, existing);
+    }
+  }
+  const practiceArea = caseQuery.data?.practice_area ?? null;
 
   const isNotFound =
     analysis.error instanceof Error &&
@@ -62,9 +78,24 @@ export default function ComposePage({
               </p>
             )}
           </div>
-          <Button asChild variant="outline">
-            <Link href={`/cases/${caseNumber}`}>חזרה לתיק</Link>
-          </Button>
+          <div className="flex items-center gap-2">
+            {analysis.data && (
+              <Button
+                variant="outline"
+                onClick={() => {
+                  const a = document.createElement("a");
+                  a.href = `/api/cases/${caseNumber}/research/analysis/download`;
+                  a.download = `analysis-${caseNumber}.md`;
+                  a.click();
+                }}
+              >
+                הורד ניתוח
+              </Button>
+            )}
+            <Button asChild variant="outline">
+              <Link href={`/cases/${caseNumber}`}>חזרה לתיק</Link>
+            </Button>
+          </div>
         </div>
 
         <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />
@@ -98,9 +129,24 @@ export default function ComposePage({
             </CardContent>
           </Card>
         ) : analysis.data ? (
-          <div className="grid gap-6 lg:grid-cols-[1fr_320px]">
-            {/* Main editable column */}
-            <div className="space-y-6">
+          <div className="space-y-6">
+              {/* Case-level general precedents */}
+              <Card className="bg-surface border-rule shadow-sm">
+                <CardContent className="px-6 py-5">
+                  <h2 className="text-navy text-xl mb-1">פסיקה כללית לדיון</h2>
+                  <p className="text-[0.78rem] text-ink-muted mb-4">
+                    ציטוטים התומכים בעמדה באופן רוחבי — ישולבו בפתיחת בלוק י (דיון).
+                  </p>
+                  <PrecedentsSection
+                    caseNumber={caseNumber}
+                    sectionId={null}
+                    precedents={caseLevelPrecedents}
+                    practiceArea={practiceArea}
+                    emptyHelperText="עדיין לא צורפה פסיקה כללית לתיק"
+                  />
+                </CardContent>
+              </Card>
+
               {/* Threshold claims */}
               {analysis.data.threshold_claims &&
                 analysis.data.threshold_claims.length > 0 && (
@@ -112,12 +158,13 @@ export default function ComposePage({
                       </span>
                     </div>
                     <div className="space-y-3">
-                      {analysis.data.threshold_claims.map((tc, i) => (
+                      {analysis.data.threshold_claims.map((tc) => (
                         <SubsectionCard
                           key={tc.id}
                           caseNumber={caseNumber}
                           item={tc}
-                          defaultOpen={i === 0}
+                          precedents={precedentsBySection.get(tc.id) ?? []}
+                          practiceArea={practiceArea}
                         />
                       ))}
                     </div>
@@ -139,6 +186,8 @@ export default function ComposePage({
                         key={iss.id}
                         caseNumber={caseNumber}
                         item={iss}
+                        precedents={precedentsBySection.get(iss.id) ?? []}
+                        practiceArea={practiceArea}
                       />
                     ))}
                   </div>
@@ -153,13 +202,13 @@ export default function ComposePage({
                   </CardContent>
                 </Card>
               )}
-            </div>
 
-            {/* Side column: background prose + conclusions */}
-            <aside className="space-y-5">
+              {/* Background prose — moved below the issues so it reads as
+                  supporting context after the chair has seen the main
+                  decision points, not as a wall of text beside them. */}
               <Card className="bg-surface border-rule shadow-sm">
-                <CardContent className="px-5 py-4 space-y-5">
-                  <h2 className="text-navy text-base mb-0">רקע לניתוח</h2>
+                <CardContent className="px-6 py-5 space-y-5">
+                  <h2 className="text-navy text-xl mb-0">רקע לניתוח</h2>
                   <ProseSection
                     title="צד מיוצג"
                     content={analysis.data.represented_party}
@@ -181,15 +230,12 @@ export default function ComposePage({
 
               {analysis.data.conclusions?.trim() && (
                 <Card className="bg-gold-wash border-gold/40 shadow-sm">
-                  <CardContent className="px-5 py-4 space-y-2">
-                    <h2 className="text-gold-deep text-base mb-0">מסקנות</h2>
-                    <p className="text-sm text-ink leading-relaxed whitespace-pre-line prose">
-                      {analysis.data.conclusions.trim()}
-                    </p>
+                  <CardContent className="px-6 py-5 space-y-3">
+                    <h2 className="text-gold-deep text-xl mb-0">מסקנות</h2>
+                    <Markdown content={analysis.data.conclusions.trim()} />
                   </CardContent>
                 </Card>
               )}
-            </aside>
           </div>
         ) : null}
       </section>

web-ui/src/app/cases/[caseNumber]/page.tsx

@@ -8,10 +8,19 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { Button } from "@/components/ui/button";
 import { Skeleton } from "@/components/ui/skeleton";
 import { CaseHeader } from "@/components/cases/case-header";
+import { CaseEditDialog } from "@/components/cases/case-edit-dialog";
 import { WorkflowTimeline } from "@/components/cases/workflow-timeline";
+import { StatusGuide } from "@/components/cases/status-guide";
+import { StatusChanger } from "@/components/cases/status-changer";
 import { DocumentsPanel } from "@/components/cases/documents-panel";
+import { UploadSheet } from "@/components/documents/upload-sheet";
+import { expectedOutcomes } from "@/lib/schemas/case";
 import { useCase } from "@/lib/api/cases";
 
+const EXPECTED_OUTCOME_LABELS: Record<string, string> = Object.fromEntries(
+  expectedOutcomes.map((o) => [o.value, o.label]),
+);
+
 /*
  * Next 16 breaking change: route params are now a Promise.
  * The `use()` hook unwraps them inside a client component.
@@ -23,6 +32,9 @@ export default function CaseDetailPage({
 }) {
   const { caseNumber } = use(params);
   const { data, isPending, error } = useCase(caseNumber);
+  const expectedOutcomeLabel = data?.expected_outcome
+    ? EXPECTED_OUTCOME_LABELS[data.expected_outcome] ?? data.expected_outcome
+    : null;
 
   return (
     <AppShell>
@@ -55,24 +67,26 @@ export default function CaseDetailPage({
               <Card className="bg-surface border-rule shadow-sm">
                 <CardContent className="px-6 py-5">
                   <Tabs defaultValue="overview" dir="rtl">
-                    <TabsList className="bg-rule-soft/60">
-                      <TabsTrigger value="overview">סקירה</TabsTrigger>
-                      <TabsTrigger value="documents">
-                        מסמכים
-                        {data?.documents && (
-                          <span className="ms-1.5 text-[0.7rem] text-ink-muted tabular-nums">
-                            ({data.documents.length})
-                          </span>
-                        )}
-                      </TabsTrigger>
-                      <TabsTrigger value="actions">פעולות</TabsTrigger>
-                    </TabsList>
+                    <div className="flex items-center justify-between gap-3 mb-1">
+                      <TabsList className="bg-rule-soft/60">
+                        <TabsTrigger value="overview">סקירה</TabsTrigger>
+                        <TabsTrigger value="documents">
+                          מסמכים
+                          {data?.documents && (
+                            <span className="ms-1.5 text-[0.7rem] text-ink-muted tabular-nums">
+                              ({data.documents.length})
+                            </span>
+                          )}
+                        </TabsTrigger>
+                      </TabsList>
+                      <UploadSheet caseNumber={caseNumber} />
+                    </div>
 
                     <TabsContent value="overview" className="mt-5 space-y-4">
                       <div>
                         <h3 className="text-navy text-base mb-2">תוצאה צפויה</h3>
                         <p className="text-ink-soft text-sm leading-relaxed">
-                          {data?.expected_outcome ?? "לא נקבעה תוצאה צפויה."}
+                          {expectedOutcomeLabel ?? "לא נקבעה תוצאה צפויה."}
                         </p>
                       </div>
                       <div>
@@ -88,24 +102,19 @@ export default function CaseDetailPage({
                           </dd>
                         </dl>
                       </div>
-                    </TabsContent>
-
-                    <TabsContent value="documents" className="mt-5">
-                      <DocumentsPanel data={data} />
-                    </TabsContent>
-
-                    <TabsContent value="actions" className="mt-5">
-                      <div className="space-y-3">
+                      <div className="flex items-center gap-3 flex-wrap pt-2 border-t border-rule">
                         <Button asChild className="bg-navy hover:bg-navy-soft text-parchment">
                           <Link href={`/cases/${caseNumber}/compose`}>
                             פתח בעורך ההחלטה
                           </Link>
                         </Button>
-                        <p className="text-xs text-ink-muted">
-                          מעבר לעורך 12 הבלוקים לכתיבת טיוטה.
-                        </p>
+                        {data && <CaseEditDialog data={data} />}
                       </div>
                     </TabsContent>
+
+                    <TabsContent value="documents" className="mt-5">
+                      <DocumentsPanel data={data} />
+                    </TabsContent>
                   </Tabs>
                 </CardContent>
               </Card>
@@ -114,6 +123,8 @@ export default function CaseDetailPage({
                 <CardContent className="px-6 py-5">
                   <h2 className="text-navy text-base mb-4">שלב בתהליך</h2>
                   <WorkflowTimeline status={data?.status} />
+                  <StatusChanger caseNumber={caseNumber} currentStatus={data?.status} />
+                  <StatusGuide />
                 </CardContent>
               </Card>
             </div>

web-ui/src/app/cases/new/page.tsx

@@ -0,0 +1,26 @@
+import Link from "next/link";
+import { AppShell } from "@/components/app-shell";
+import { CaseWizard } from "@/components/wizard/case-wizard";
+
+export default function NewCasePage() {
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <header>
+          <nav className="text-[0.78rem] text-ink-muted flex items-center gap-2 mb-1">
+            <Link href="/" className="hover:text-gold-deep">בית</Link>
+            <span aria-hidden>·</span>
+            <span className="text-navy">תיק חדש</span>
+          </nav>
+          <h1 className="text-navy mb-0">יצירת תיק ערר</h1>
+          <p className="text-ink-muted text-sm mt-1 max-w-2xl">
+            שלושה שלבים קצרים — פרטי יסוד, צדדים, והשלמות. התיק ייווצר ב-DB
+            וב-Gitea מיד בשמירה.
+          </p>
+        </header>
+
+        <CaseWizard />
+      </section>
+    </AppShell>
+  );
+}

web-ui/src/app/diagnostics/page.tsx

@@ -0,0 +1,219 @@
+"use client";
+
+import Link from "next/link";
+import { AlertTriangle, CheckCircle2, Clock, Database } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { Card, CardContent } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import { Skeleton } from "@/components/ui/skeleton";
+import { useDiagnostics, type DiagDoc } from "@/lib/api/system";
+
+const TABLE_LABELS: Record<string, string> = {
+  cases: "תיקים",
+  documents: "מסמכים",
+  document_chunks: "chunks",
+  style_corpus: "קורפוס סגנון",
+  style_patterns: "דפוסי סגנון",
+};
+
+function formatRelativeTime(iso: string | null) {
+  if (!iso) return "—";
+  const then = new Date(iso);
+  const diffMs = Date.now() - then.getTime();
+  const min = Math.floor(diffMs / 60000);
+  if (min < 1) return "עכשיו";
+  if (min < 60) return `לפני ${min} דקות`;
+  const hr = Math.floor(min / 60);
+  if (hr < 24) return `לפני ${hr} שעות`;
+  const days = Math.floor(hr / 24);
+  if (days < 30) return `לפני ${days} ימים`;
+  return then.toLocaleDateString("he-IL");
+}
+
+function DocRow({ doc, tone }: { doc: DiagDoc; tone: "danger" | "warn" }) {
+  const cls =
+    tone === "danger" ? "bg-danger-bg/60 border-danger/30" : "bg-warn-bg/60 border-warn/30";
+  return (
+    <li
+      className={`rounded border px-3 py-2 flex items-center gap-3 text-sm ${cls}`}
+    >
+      <div className="flex-1 min-w-0">
+        <div className="text-ink font-medium truncate" title={doc.title}>
+          {doc.title || "(ללא כותרת)"}
+        </div>
+        <div className="text-[0.72rem] text-ink-muted flex gap-3 mt-0.5">
+          {doc.case_number && (
+            <Link href={`/cases/${doc.case_number}`} className="hover:text-gold-deep">
+              ערר {doc.case_number}
+            </Link>
+          )}
+          <span>{formatRelativeTime(doc.created_at)}</span>
+        </div>
+      </div>
+      <Badge variant="outline" className="text-[0.7rem]">{doc.status}</Badge>
+    </li>
+  );
+}
+
+export default function DiagnosticsPage() {
+  const { data, isPending, error } = useDiagnostics();
+
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <header>
+          <nav className="text-[0.78rem] text-ink-muted mb-1">
+            <Link href="/" className="hover:text-gold-deep">בית</Link>
+            <span aria-hidden> · </span>
+            <span className="text-navy">אבחון מערכת</span>
+          </nav>
+          <h1 className="text-navy mb-0">אבחון מערכת</h1>
+          <p className="text-ink-muted text-sm mt-1 max-w-2xl">
+            מצב ה-DB, מסמכים שנכשלו או תקועים, ומשימות רקע פעילות. מתעדכן כל 10
+            שניות.
+          </p>
+        </header>
+
+        <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />
+
+        {error ? (
+          <Card className="bg-danger-bg border-danger/40">
+            <CardContent className="px-6 py-6 text-center text-danger">
+              {error.message}
+            </CardContent>
+          </Card>
+        ) : (
+          <>
+            {/* DB status + table counts */}
+            <div className="grid gap-4 md:grid-cols-[240px_1fr]">
+              <Card className="bg-surface border-rule shadow-sm">
+                <CardContent className="px-5 py-4 flex flex-col items-start gap-2">
+                  <div className="flex items-center gap-2 text-ink-muted text-[0.72rem] uppercase tracking-wider">
+                    <Database className="w-3.5 h-3.5" />
+                    מצב DB
+                  </div>
+                  {isPending ? (
+                    <Skeleton className="h-6 w-24" />
+                  ) : data?.db_ok ? (
+                    <div className="flex items-center gap-2 text-success font-semibold">
+                      <CheckCircle2 className="w-5 h-5" />
+                      <span>מחובר</span>
+                    </div>
+                  ) : (
+                    <div className="flex items-center gap-2 text-danger font-semibold">
+                      <AlertTriangle className="w-5 h-5" />
+                      <span>מנותק</span>
+                    </div>
+                  )}
+                </CardContent>
+              </Card>
+
+              <Card className="bg-surface border-rule shadow-sm">
+                <CardContent className="px-5 py-4">
+                  <div className="text-ink-muted text-[0.72rem] uppercase tracking-wider mb-3">
+                    ספירת טבלאות
+                  </div>
+                  <dl className="grid grid-cols-2 md:grid-cols-5 gap-y-2 gap-x-4">
+                    {Object.keys(TABLE_LABELS).map((key) => (
+                      <div key={key} className="space-y-0.5">
+                        <dt className="text-[0.72rem] text-ink-muted">
+                          {TABLE_LABELS[key]}
+                        </dt>
+                        <dd className="font-display font-bold text-navy text-xl tabular-nums">
+                          {isPending ? "—" : (data?.tables[key] ?? "—")}
+                        </dd>
+                      </div>
+                    ))}
+                  </dl>
+                </CardContent>
+              </Card>
+            </div>
+
+            {/* Active tasks */}
+            <Card className="bg-surface border-rule shadow-sm">
+              <CardContent className="px-6 py-5">
+                <h2 className="text-navy text-lg mb-3 flex items-center gap-2">
+                  <Clock className="w-4 h-4" />
+                  משימות רקע פעילות
+                  <Badge variant="outline" className="text-[0.7rem] tabular-nums">
+                    {data?.active_tasks.length ?? 0}
+                  </Badge>
+                </h2>
+                {isPending ? (
+                  <Skeleton className="h-16 w-full" />
+                ) : data?.active_tasks.length === 0 ? (
+                  <p className="text-ink-muted text-sm">אין משימות פעילות</p>
+                ) : (
+                  <ul className="space-y-2">
+                    {data?.active_tasks.map((t) => (
+                      <li
+                        key={t.task_id}
+                        className="flex items-center gap-3 text-sm rounded bg-rule-soft/60 border border-rule px-3 py-2"
+                      >
+                        <span className="flex-1 text-ink truncate">
+                          {t.filename || t.task_id}
+                        </span>
+                        <Badge variant="outline" className="text-[0.7rem]">
+                          {t.step || t.status}
+                        </Badge>
+                      </li>
+                    ))}
+                  </ul>
+                )}
+              </CardContent>
+            </Card>
+
+            {/* Failed + stuck docs */}
+            <div className="grid gap-4 md:grid-cols-2">
+              <Card className="bg-surface border-rule shadow-sm">
+                <CardContent className="px-6 py-5">
+                  <h2 className="text-danger text-lg mb-3 flex items-center gap-2">
+                    <AlertTriangle className="w-4 h-4" />
+                    מסמכים שנכשלו
+                    <Badge variant="outline" className="text-[0.7rem] tabular-nums">
+                      {data?.failed_documents.length ?? 0}
+                    </Badge>
+                  </h2>
+                  {isPending ? (
+                    <Skeleton className="h-20 w-full" />
+                  ) : data?.failed_documents.length === 0 ? (
+                    <p className="text-ink-muted text-sm">אין כשלונות</p>
+                  ) : (
+                    <ul className="space-y-2">
+                      {data?.failed_documents.map((d) => (
+                        <DocRow key={d.id} doc={d} tone="danger" />
+                      ))}
+                    </ul>
+                  )}
+                </CardContent>
+              </Card>
+
+              <Card className="bg-surface border-rule shadow-sm">
+                <CardContent className="px-6 py-5">
+                  <h2 className="text-warn text-lg mb-3 flex items-center gap-2">
+                    <Clock className="w-4 h-4" />
+                    תקועים (&gt; 10 דק׳)
+                    <Badge variant="outline" className="text-[0.7rem] tabular-nums">
+                      {data?.stuck_documents.length ?? 0}
+                    </Badge>
+                  </h2>
+                  {isPending ? (
+                    <Skeleton className="h-20 w-full" />
+                  ) : data?.stuck_documents.length === 0 ? (
+                    <p className="text-ink-muted text-sm">אין מסמכים תקועים</p>
+                  ) : (
+                    <ul className="space-y-2">
+                      {data?.stuck_documents.map((d) => (
+                        <DocRow key={d.id} doc={d} tone="warn" />
+                      ))}
+                    </ul>
+                  )}
+                </CardContent>
+              </Card>
+            </div>
+          </>
+        )}
+      </section>
+    </AppShell>
+  );
+}

web-ui/src/app/error.tsx

@@ -0,0 +1,57 @@
+"use client";
+
+import { useEffect } from "react";
+import Link from "next/link";
+import { AlertTriangle } from "lucide-react";
+import { Button } from "@/components/ui/button";
+
+/*
+ * Route-segment error boundary. Next 16 App Router convention: this file
+ * catches render-time errors thrown below the root layout. `reset` clears
+ * the error and re-renders the segment; we keep the user's nav in place
+ * (no AppShell here — the shell re-renders from the layout above us).
+ */
+export default function ErrorPage({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  useEffect(() => {
+    console.error("Route error:", error);
+  }, [error]);
+
+  return (
+    <main className="flex-1 w-full max-w-[1400px] mx-auto px-10 py-10">
+      <div className="max-w-xl mx-auto text-center space-y-5 py-16">
+        <AlertTriangle className="w-12 h-12 text-danger mx-auto" aria-hidden="true" />
+        <div className="space-y-2">
+          <h1 className="text-navy">משהו השתבש</h1>
+          <p className="text-ink-muted leading-relaxed">
+            נכשלה טעינת המסך. זה עשוי להיות כשל זמני ברשת או באחד מה-endpoints
+            של FastAPI.
+          </p>
+          {error.digest && (
+            <p className="text-[0.72rem] text-ink-light tabular-nums">
+              error id: {error.digest}
+            </p>
+          )}
+          {error.message && (
+            <code className="text-[0.78rem] text-ink-soft bg-rule-soft/60 rounded px-3 py-1 inline-block mt-2">
+              {error.message}
+            </code>
+          )}
+        </div>
+        <div className="flex items-center justify-center gap-3">
+          <Button onClick={reset} className="bg-navy hover:bg-navy-soft text-parchment">
+            נסה שוב
+          </Button>
+          <Button variant="outline" asChild>
+            <Link href="/">חזרה לבית</Link>
+          </Button>
+        </div>
+      </div>
+    </main>
+  );
+}

web-ui/src/app/feedback/page.tsx

@@ -0,0 +1,329 @@
+"use client";
+
+import { useState } from "react";
+import Link from "next/link";
+import { AppShell } from "@/components/app-shell";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@/components/ui/dialog";
+import {
+  useFeedbackList,
+  useCreateFeedback,
+  useResolveFeedback,
+  CATEGORY_LABELS,
+  BLOCK_LABELS,
+  type FeedbackCategory,
+} from "@/lib/api/feedback";
+import { toast } from "sonner";
+
+const CATEGORY_COLORS: Record<FeedbackCategory, string> = {
+  missing_content: "bg-amber-100 text-amber-800 border-amber-200",
+  wrong_tone: "bg-purple-100 text-purple-800 border-purple-200",
+  wrong_structure: "bg-blue-100 text-blue-800 border-blue-200",
+  factual_error: "bg-red-100 text-red-800 border-red-200",
+  style: "bg-emerald-100 text-emerald-800 border-emerald-200",
+  other: "bg-gray-100 text-gray-800 border-gray-200",
+};
+
+export default function FeedbackPage() {
+  const [showResolved, setShowResolved] = useState(false);
+  const [filterCategory, setFilterCategory] = useState<string>("");
+
+  const { data: feedbacks, isLoading } = useFeedbackList({
+    category: filterCategory || undefined,
+    unresolved_only: !showResolved,
+  });
+
+  const resolveMutation = useResolveFeedback();
+
+  function handleResolve(id: string) {
+    resolveMutation.mutate(
+      { feedbackId: id, applied_to: [] },
+      {
+        onSuccess: () => toast.success("ההערה סומנה כמטופלת"),
+        onError: () => toast.error("שגיאה בעדכון"),
+      },
+    );
+  }
+
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <header>
+          <nav className="text-[0.78rem] text-ink-muted mb-1">
+            <Link href="/" className="hover:text-gold-deep">
+              בית
+            </Link>
+            <span aria-hidden> &middot; </span>
+            <span className="text-navy">הערות יו״ר</span>
+          </nav>
+          <h1 className="text-navy mb-0">הערות יו״ר על טיוטות</h1>
+          <p className="text-ink-muted text-sm mt-1 max-w-2xl">
+            תיעוד הערות דפנה על טיוטות החלטות. כל הערה מנותחת ומשפיעה על שיפור
+            כתיבת ההחלטות העתידיות.
+          </p>
+        </header>
+
+        <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />
+
+        {/* Toolbar */}
+        <div className="flex items-center gap-3 flex-wrap">
+          <NewFeedbackDialog />
+
+          <select
+            value={filterCategory}
+            onChange={(e) => setFilterCategory(e.target.value)}
+            className="rounded-md border border-rule bg-surface px-3 py-1.5 text-sm"
+          >
+            <option value="">כל הקטגוריות</option>
+            {Object.entries(CATEGORY_LABELS).map(([key, label]) => (
+              <option key={key} value={key}>
+                {label}
+              </option>
+            ))}
+          </select>
+
+          <label className="flex items-center gap-2 text-sm text-ink-muted cursor-pointer">
+            <input
+              type="checkbox"
+              checked={showResolved}
+              onChange={(e) => setShowResolved(e.target.checked)}
+              className="rounded border-rule"
+            />
+            הצג גם מטופלות
+          </label>
+
+          {feedbacks && (
+            <span className="text-sm text-ink-muted me-auto">
+              {feedbacks.length} הערות
+            </span>
+          )}
+        </div>
+
+        {/* Feedback list */}
+        {isLoading ? (
+          <Card className="bg-surface border-rule shadow-sm">
+            <CardContent className="px-6 py-8 text-center text-ink-muted">
+              טוען...
+            </CardContent>
+          </Card>
+        ) : !feedbacks?.length ? (
+          <Card className="bg-surface border-rule shadow-sm">
+            <CardContent className="px-6 py-8 text-center text-ink-muted">
+              אין הערות{!showResolved ? " פתוחות" : ""}
+              {filterCategory ? ` בקטגוריה ${CATEGORY_LABELS[filterCategory as FeedbackCategory]}` : ""}
+            </CardContent>
+          </Card>
+        ) : (
+          <div className="space-y-3">
+            {feedbacks.map((fb) => (
+              <Card
+                key={fb.id}
+                className={`bg-surface border-rule shadow-sm ${fb.resolved ? "opacity-60" : ""}`}
+              >
+                <CardHeader className="border-b pb-3">
+                  <div className="flex items-center gap-2 flex-wrap">
+                    <Badge
+                      className={`text-[0.7rem] border ${CATEGORY_COLORS[fb.category]}`}
+                    >
+                      {CATEGORY_LABELS[fb.category]}
+                    </Badge>
+                    <Badge variant="outline" className="text-[0.7rem]">
+                      {BLOCK_LABELS[fb.block_id] ?? fb.block_id}
+                    </Badge>
+                    {fb.case_number && (
+                      <Link
+                        href={`/cases/${fb.case_number}`}
+                        className="text-[0.7rem] text-gold-deep hover:underline"
+                      >
+                        תיק {fb.case_number}
+                      </Link>
+                    )}
+                    {fb.resolved && (
+                      <Badge className="bg-emerald-100 text-emerald-700 text-[0.7rem] border border-emerald-200">
+                        טופל
+                      </Badge>
+                    )}
+                    <span className="text-[0.7rem] text-ink-muted me-auto">
+                      {fb.created_at
+                        ? new Date(fb.created_at).toLocaleDateString("he-IL")
+                        : ""}
+                    </span>
+                  </div>
+                </CardHeader>
+                <CardContent className="px-6 py-4 space-y-3">
+                  <p className="text-sm leading-relaxed">{fb.feedback_text}</p>
+
+                  {fb.lesson_extracted && (
+                    <div className="bg-gold/5 border border-gold/20 rounded-md px-4 py-3">
+                      <p className="text-[0.7rem] font-semibold text-gold-deep mb-1">
+                        לקח שהופק:
+                      </p>
+                      <p className="text-sm text-ink-muted leading-relaxed">
+                        {fb.lesson_extracted}
+                      </p>
+                    </div>
+                  )}
+
+                  {!fb.resolved && (
+                    <div className="flex justify-end">
+                      <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => handleResolve(fb.id)}
+                        disabled={resolveMutation.isPending}
+                      >
+                        סמן כמטופל
+                      </Button>
+                    </div>
+                  )}
+                </CardContent>
+              </Card>
+            ))}
+          </div>
+        )}
+      </section>
+    </AppShell>
+  );
+}
+
+/* ── New feedback dialog ─────────────────────────────────── */
+
+function NewFeedbackDialog() {
+  const [open, setOpen] = useState(false);
+  const createMutation = useCreateFeedback();
+
+  const [caseNumber, setCaseNumber] = useState("");
+  const [blockId, setBlockId] = useState("block-yod");
+  const [category, setCategory] = useState<FeedbackCategory>("missing_content");
+  const [feedbackText, setFeedbackText] = useState("");
+  const [lesson, setLesson] = useState("");
+
+  function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    if (!feedbackText.trim()) return;
+
+    createMutation.mutate(
+      {
+        case_number: caseNumber || undefined,
+        block_id: blockId,
+        feedback_text: feedbackText,
+        category,
+        lesson_extracted: lesson || undefined,
+      },
+      {
+        onSuccess: () => {
+          toast.success("ההערה נרשמה בהצלחה");
+          setOpen(false);
+          setCaseNumber("");
+          setFeedbackText("");
+          setLesson("");
+        },
+        onError: () => toast.error("שגיאה ברישום ההערה"),
+      },
+    );
+  }
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        <Button>+ הערה חדשה</Button>
+      </DialogTrigger>
+      <DialogContent className="sm:max-w-lg" dir="rtl">
+        <DialogHeader>
+          <DialogTitle>רישום הערת יו״ר</DialogTitle>
+        </DialogHeader>
+        <form onSubmit={handleSubmit} className="space-y-4 mt-2">
+          <div className="grid grid-cols-2 gap-3">
+            <div>
+              <Label htmlFor="fb-case">מספר תיק (אופציונלי)</Label>
+              <Input
+                id="fb-case"
+                value={caseNumber}
+                onChange={(e) => setCaseNumber(e.target.value)}
+                placeholder="1130-25"
+              />
+            </div>
+            <div>
+              <Label htmlFor="fb-block">בלוק</Label>
+              <select
+                id="fb-block"
+                value={blockId}
+                onChange={(e) => setBlockId(e.target.value)}
+                className="w-full rounded-md border border-rule bg-surface px-3 py-2 text-sm"
+              >
+                {Object.entries(BLOCK_LABELS).map(([key, label]) => (
+                  <option key={key} value={key}>
+                    {label}
+                  </option>
+                ))}
+              </select>
+            </div>
+          </div>
+
+          <div>
+            <Label htmlFor="fb-category">קטגוריה</Label>
+            <select
+              id="fb-category"
+              value={category}
+              onChange={(e) => setCategory(e.target.value as FeedbackCategory)}
+              className="w-full rounded-md border border-rule bg-surface px-3 py-2 text-sm"
+            >
+              {Object.entries(CATEGORY_LABELS).map(([key, label]) => (
+                <option key={key} value={key}>
+                  {label}
+                </option>
+              ))}
+            </select>
+          </div>
+
+          <div>
+            <Label htmlFor="fb-text">ההערה</Label>
+            <Textarea
+              id="fb-text"
+              value={feedbackText}
+              onChange={(e) => setFeedbackText(e.target.value)}
+              placeholder="מה דפנה אמרה? מה חסר, מה לא נכון, מה צריך לשנות..."
+              rows={4}
+              required
+            />
+          </div>
+
+          <div>
+            <Label htmlFor="fb-lesson">לקח שהופק (אופציונלי)</Label>
+            <Textarea
+              id="fb-lesson"
+              value={lesson}
+              onChange={(e) => setLesson(e.target.value)}
+              placeholder="מה למדנו מההערה? מה צריך לשנות במערכת?"
+              rows={2}
+            />
+          </div>
+
+          <div className="flex justify-end gap-2 pt-2">
+            <Button
+              type="button"
+              variant="outline"
+              onClick={() => setOpen(false)}
+            >
+              ביטול
+            </Button>
+            <Button type="submit" disabled={createMutation.isPending}>
+              {createMutation.isPending ? "שומר..." : "שמור הערה"}
+            </Button>
+          </div>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

web-ui/src/app/global-error.tsx

@@ -0,0 +1,60 @@
+"use client";
+
+/*
+ * Root-level error boundary. Renders only when the root layout itself
+ * crashes, so it must include its own <html> / <body>. No AppShell here —
+ * the Providers that wrap AppShell are also above the crash boundary and
+ * may themselves be the thing that failed.
+ */
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <html lang="he" dir="rtl">
+      <body
+        style={{
+          fontFamily: "system-ui, sans-serif",
+          background: "#f5f1e8",
+          color: "#1a1a2e",
+          minHeight: "100vh",
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "center",
+          padding: "2rem",
+        }}
+      >
+        <div style={{ maxWidth: 520, textAlign: "center" }}>
+          <h1 style={{ color: "#0f172a", fontSize: "2rem", marginBottom: 8 }}>
+            שגיאה חמורה
+          </h1>
+          <p style={{ color: "#6b7280", lineHeight: 1.6, marginBottom: 16 }}>
+            האפליקציה נכשלה לטעון. נסה לרענן את הדף.
+          </p>
+          {error.digest && (
+            <p style={{ fontSize: 12, color: "#9ca3af", marginBottom: 16 }}>
+              error id: {error.digest}
+            </p>
+          )}
+          <button
+            onClick={reset}
+            style={{
+              background: "#0f172a",
+              color: "#fbf8f0",
+              border: 0,
+              padding: "0.6rem 1.25rem",
+              borderRadius: 6,
+              cursor: "pointer",
+              fontSize: "0.95rem",
+            }}
+          >
+            נסה שוב
+          </button>
+        </div>
+      </body>
+    </html>
+  );
+}

web-ui/src/app/layout.tsx

@@ -14,8 +14,11 @@ const heebo = Heebo({
 });
 
 export const metadata: Metadata = {
-  title: "עוזר משפטי — ניהול תיקים",
-  description: "מערכת סיוע בניסוח החלטות לוועדת ערר לתכנון ובנייה",
+  title: {
+    default: "עוזר משפטי — ניהול תיקים",
+    template: "%s · עוזר משפטי",
+  },
+  description: "מערכת סיוע בניסוח החלטות לוועדת ערר לתכנון ובנייה, ירושלים",
 };
 
 export default function RootLayout({

web-ui/src/app/not-found.tsx

@@ -0,0 +1,24 @@
+import Link from "next/link";
+import { AppShell } from "@/components/app-shell";
+import { Button } from "@/components/ui/button";
+
+export default function NotFound() {
+  return (
+    <AppShell>
+      <section className="max-w-xl mx-auto text-center py-16 space-y-5">
+        <div className="font-display text-gold text-6xl leading-none" aria-hidden="true">
+          404
+        </div>
+        <div className="space-y-2">
+          <h1 className="text-navy">הדף לא נמצא</h1>
+          <p className="text-ink-muted leading-relaxed">
+            הכתובת שביקשת אינה קיימת או שהוזזה לדף אחר.
+          </p>
+        </div>
+        <Button asChild className="bg-navy hover:bg-navy-soft text-parchment">
+          <Link href="/">חזרה לבית</Link>
+        </Button>
+      </section>
+    </AppShell>
+  );
+}

web-ui/src/app/page.tsx

@@ -1,10 +1,12 @@
 "use client";
 
+import Link from "next/link";
 import { AppShell } from "@/components/app-shell";
 import { KPICards } from "@/components/cases/kpi-cards";
 import { StatusDonut } from "@/components/cases/status-donut";
 import { CasesTable } from "@/components/cases/cases-table";
 import { Card, CardContent } from "@/components/ui/card";
+import { Button } from "@/components/ui/button";
 import { useCases } from "@/lib/api/cases";
 
 export default function HomePage() {
@@ -24,6 +26,9 @@ export default function HomePage() {
               12 הבלוקים.
             </p>
           </div>
+          <Button asChild className="bg-navy hover:bg-navy-soft text-parchment">
+            <Link href="/cases/new">+ תיק חדש</Link>
+          </Button>
         </header>
 
         <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />

web-ui/src/app/skills/page.tsx

@@ -0,0 +1,128 @@
+"use client";
+
+import Link from "next/link";
+import { Plug, HardDrive, Database, FileText } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { Card, CardContent } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import { Skeleton } from "@/components/ui/skeleton";
+import { useSkills, type Skill } from "@/lib/api/skills";
+
+function formatSize(bytes: number | null) {
+  if (bytes == null) return "—";
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+function statusBadge(s: Skill) {
+  if (s.not_in_db) {
+    return <Badge variant="outline" className="bg-warn-bg text-warn border-warn/40">לא סונכרן</Badge>;
+  }
+  if (s.db_markdown_chars > 0 && s.disk_exists) {
+    return <Badge variant="outline" className="bg-success-bg text-success border-success/40">מסונכרן</Badge>;
+  }
+  if (s.db_markdown_chars > 0) {
+    return <Badge variant="outline" className="bg-info-bg text-info border-info/40">DB בלבד</Badge>;
+  }
+  return <Badge variant="outline">לא ידוע</Badge>;
+}
+
+function SkillCard({ skill }: { skill: Skill }) {
+  const fileCount = skill.file_inventory?.length ?? 0;
+  return (
+    <Card className="bg-surface border-rule shadow-sm hover:shadow-md transition-shadow">
+      <CardContent className="px-5 py-4">
+        <div className="flex items-start justify-between gap-3 mb-2">
+          <div className="flex items-center gap-2 min-w-0">
+            <Plug className="w-4 h-4 text-gold-deep shrink-0" />
+            <div className="min-w-0">
+              <h3 className="text-navy font-semibold text-base mb-0 truncate">
+                {skill.name || skill.slug}
+              </h3>
+              <code className="text-[0.72rem] text-ink-muted tabular-nums">
+                {skill.slug}
+              </code>
+            </div>
+          </div>
+          {statusBadge(skill)}
+        </div>
+        <dl className="grid grid-cols-3 gap-2 text-[0.72rem] text-ink-muted mt-3">
+          <div className="flex items-center gap-1">
+            <FileText className="w-3 h-3" />
+            <span className="tabular-nums">{fileCount}</span>
+            <span>קבצים</span>
+          </div>
+          <div className="flex items-center gap-1">
+            <Database className="w-3 h-3" />
+            <span className="tabular-nums">
+              {(skill.db_markdown_chars / 1000).toFixed(1)}K
+            </span>
+            <span>תווים</span>
+          </div>
+          <div className="flex items-center gap-1">
+            <HardDrive className="w-3 h-3" />
+            <span className="tabular-nums">
+              {formatSize(skill.disk_skill_md_bytes)}
+            </span>
+          </div>
+        </dl>
+        {skill.updated_at && (
+          <p className="text-[0.7rem] text-ink-light mt-2">
+            עודכן: {new Date(skill.updated_at).toLocaleDateString("he-IL")}
+          </p>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
+export default function SkillsPage() {
+  const { data, isPending, error } = useSkills();
+
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <header>
+          <nav className="text-[0.78rem] text-ink-muted mb-1">
+            <Link href="/" className="hover:text-gold-deep">בית</Link>
+            <span aria-hidden> · </span>
+            <span className="text-navy">מיומנויות</span>
+          </nav>
+          <h1 className="text-navy mb-0">מיומנויות Paperclip</h1>
+          <p className="text-ink-muted text-sm mt-1 max-w-2xl">
+            רשימת ה-skills המותקנים במערכת Paperclip ומצב הסנכרון שלהם בין ה-DB
+            לדיסק.
+          </p>
+        </header>
+
+        <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />
+
+        {error ? (
+          <Card className="bg-danger-bg border-danger/40">
+            <CardContent className="px-6 py-6 text-center text-danger">
+              {error.message}
+            </CardContent>
+          </Card>
+        ) : isPending ? (
+          <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
+            {[...Array(6)].map((_, i) => (
+              <Skeleton key={i} className="h-32 w-full rounded-lg" />
+            ))}
+          </div>
+        ) : data?.length === 0 ? (
+          <Card className="bg-surface border-rule">
+            <CardContent className="px-6 py-12 text-center text-ink-muted">
+              <div className="text-gold text-3xl mb-2" aria-hidden>❦</div>
+              אין skills מותקנים
+            </CardContent>
+          </Card>
+        ) : (
+          <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-3">
+            {data?.map((s) => <SkillCard key={s.slug} skill={s} />)}
+          </div>
+        )}
+      </section>
+    </AppShell>
+  );
+}

web-ui/src/app/training/page.tsx

@@ -0,0 +1,56 @@
+"use client";
+
+import Link from "next/link";
+import { AppShell } from "@/components/app-shell";
+import { Card, CardContent } from "@/components/ui/card";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { StyleReportPanel } from "@/components/training/style-report-panel";
+import { CorpusPanel } from "@/components/training/corpus-panel";
+import { ComparePanel } from "@/components/training/compare-panel";
+
+export default function TrainingPage() {
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <header>
+          <nav className="text-[0.78rem] text-ink-muted mb-1">
+            <Link href="/" className="hover:text-gold-deep">בית</Link>
+            <span aria-hidden> · </span>
+            <span className="text-navy">אימון סגנון</span>
+          </nav>
+          <h1 className="text-navy mb-0">הפורטרט הסגנוני של דפנה</h1>
+          <p className="text-ink-muted text-sm mt-1 max-w-2xl">
+            לוח בקרה של קורפוס האימון — סטטיסטיקות, אנטומיית החלטה ממוצעת,
+            ביטויי חתימה, וכלי השוואה בין שתי החלטות.
+          </p>
+        </header>
+
+        <div className="h-[2px] bg-gradient-to-l from-transparent via-gold to-transparent" />
+
+        <Card className="bg-surface border-rule shadow-sm">
+          <CardContent className="px-6 py-5">
+            <Tabs defaultValue="report" dir="rtl">
+              <TabsList className="bg-rule-soft/60">
+                <TabsTrigger value="report">פורטרט סגנון</TabsTrigger>
+                <TabsTrigger value="corpus">קורפוס</TabsTrigger>
+                <TabsTrigger value="compare">השוואה</TabsTrigger>
+              </TabsList>
+
+              <TabsContent value="report" className="mt-5">
+                <StyleReportPanel />
+              </TabsContent>
+
+              <TabsContent value="corpus" className="mt-5">
+                <CorpusPanel />
+              </TabsContent>
+
+              <TabsContent value="compare" className="mt-5">
+                <ComparePanel />
+              </TabsContent>
+            </Tabs>
+          </CardContent>
+        </Card>
+      </section>
+    </AppShell>
+  );
+}

web-ui/src/components/app-shell.tsx

@@ -1,5 +1,8 @@
+"use client";
+
 import type { ReactNode } from "react";
 import Link from "next/link";
+import { usePathname } from "next/navigation";
 
 /**
  * Ezer Mishpati navigation shell.
@@ -9,8 +12,9 @@ import Link from "next/link";
  * - Parchment/cream body background (set on <body> via globals.css)
  * - Hebrew RTL throughout (set on <html> in layout.tsx)
  *
- * Structure mirrors the current vanilla index.html header so that visual
- * continuity is preserved while we migrate screen-by-screen.
+ * Nav items pick up an `aria-current="page"` and a gold underline when
+ * the current route matches, so screen readers announce the active
+ * section and sighted users can see where they are.
  */
 
 type NavItem = {
@@ -19,14 +23,22 @@ type NavItem = {
 };
 
 const NAV_ITEMS: NavItem[] = [
-  { href: "/", label: "בית" },
-  { href: "/upload", label: "העלאת מסמכים" },
-  { href: "/training", label: "אימון סגנון" },
-  { href: "/skills", label: "מיומנויות" },
-  { href: "/diagnostics", label: "אבחון" },
+  { href: "/",            label: "בית"         },
+  { href: "/cases/new",   label: "תיק חדש"     },
+  { href: "/training",    label: "אימון סגנון" },
+  { href: "/feedback",    label: "הערות יו״ר"  },
+  { href: "/skills",      label: "מיומנויות"  },
+  { href: "/diagnostics", label: "אבחון"       },
 ];
 
+function isActive(pathname: string, href: string): boolean {
+  if (href === "/") return pathname === "/";
+  return pathname === href || pathname.startsWith(`${href}/`);
+}
+
 export function AppShell({ children }: { children: ReactNode }) {
+  const pathname = usePathname();
+
   return (
     <>
       <header
@@ -45,25 +57,43 @@ export function AppShell({ children }: { children: ReactNode }) {
           <span className="text-gold-soft text-sm font-medium">ניהול תיקים</span>
         </Link>
 
-        <nav className="me-auto flex items-center gap-1">
-          {NAV_ITEMS.map((item) => (
-            <Link
-              key={item.href}
-              href={item.href}
-              className="
-                px-3 py-1.5 rounded
-                text-sm text-parchment/80
-                transition-colors
-                hover:text-parchment hover:bg-navy-soft/60
-              "
-            >
-              {item.label}
-            </Link>
-          ))}
+        <nav
+          className="me-auto flex items-center gap-1"
+          aria-label="ניווט ראשי"
+        >
+          {NAV_ITEMS.map((item) => {
+            const active = isActive(pathname, item.href);
+            return (
+              <Link
+                key={item.href}
+                href={item.href}
+                aria-current={active ? "page" : undefined}
+                className={`
+                  relative px-3 py-1.5 rounded text-sm transition-colors
+                  ${
+                    active
+                      ? "text-parchment font-semibold bg-navy-soft/80"
+                      : "text-parchment/80 hover:text-parchment hover:bg-navy-soft/60"
+                  }
+                `}
+              >
+                {item.label}
+                {active && (
+                  <span
+                    className="absolute -bottom-[19px] inset-x-2 h-[2px] bg-gold"
+                    aria-hidden="true"
+                  />
+                )}
+              </Link>
+            );
+          })}
         </nav>
       </header>
 
-      <main className="flex-1 w-full max-w-[1400px] mx-auto px-10 py-10">
+      <main
+        id="main"
+        className="flex-1 w-full max-w-[1400px] mx-auto px-10 py-10"
+      >
         {children}
       </main>
     </>

web-ui/src/components/cases/case-edit-dialog.tsx

@@ -0,0 +1,160 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { toast } from "sonner";
+import {
+  Dialog, DialogContent, DialogDescription, DialogFooter,
+  DialogHeader, DialogTitle, DialogTrigger,
+} from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
+import { Label } from "@/components/ui/label";
+import {
+  Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
+} from "@/components/ui/select";
+import { useUpdateCase } from "@/lib/api/cases";
+import { caseUpdateSchema, expectedOutcomes, type CaseUpdateInput } from "@/lib/schemas/case";
+import type { CaseDetail } from "@/lib/api/cases";
+
+/*
+ * Inline edit dialog for core case fields. Uses react-hook-form + zod
+ * directly (shadcn's <Form> registry entry wasn't available at init
+ * time, so the styling is reproduced by hand in a lean form layout).
+ */
+
+function FieldError({ message }: { message?: string }) {
+  if (!message) return null;
+  return <p className="text-[0.72rem] text-danger mt-1">{message}</p>;
+}
+
+export function CaseEditDialog({ data }: { data: CaseDetail }) {
+  const [open, setOpen] = useState(false);
+  const mutate = useUpdateCase(data.case_number);
+
+  const form = useForm<CaseUpdateInput>({
+    resolver: zodResolver(caseUpdateSchema),
+    defaultValues: {
+      title: data.title ?? "",
+      subject: data.subject ?? "",
+      hearing_date: data.hearing_date ?? "",
+      notes: "",
+      expected_outcome: data.expected_outcome ?? "",
+    },
+  });
+
+  /* Re-sync the form when the underlying case refetches after save */
+  useEffect(() => {
+    if (!open) return;
+    form.reset({
+      title: data.title ?? "",
+      subject: data.subject ?? "",
+      hearing_date: data.hearing_date ?? "",
+      notes: "",
+      expected_outcome: data.expected_outcome ?? "",
+    });
+  }, [open, data, form]);
+
+  const onSubmit = form.handleSubmit(async (values) => {
+    try {
+      await mutate.mutateAsync(values);
+      toast.success("פרטי התיק עודכנו");
+      setOpen(false);
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "שגיאה בעדכון התיק");
+    }
+  });
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        <Button variant="outline" size="sm">
+          עריכת פרטי תיק
+        </Button>
+      </DialogTrigger>
+      <DialogContent className="sm:max-w-lg" dir="rtl">
+        <DialogHeader>
+          <DialogTitle>עריכת פרטי תיק {data.case_number}</DialogTitle>
+          <DialogDescription className="text-ink-muted">
+            השינויים נשמרים ישירות ל-FastAPI. השדות הריקים נשארים ללא שינוי.
+          </DialogDescription>
+        </DialogHeader>
+
+        <form onSubmit={onSubmit} className="space-y-4">
+          <div>
+            <Label htmlFor="title" className="text-navy">כותרת</Label>
+            <Input id="title" {...form.register("title")} className="mt-1" />
+            <FieldError message={form.formState.errors.title?.message} />
+          </div>
+
+          <div>
+            <Label htmlFor="subject" className="text-navy">נושא</Label>
+            <Input id="subject" {...form.register("subject")} className="mt-1" />
+            <FieldError message={form.formState.errors.subject?.message} />
+          </div>
+
+          <div className="grid grid-cols-2 gap-3">
+            <div>
+              <Label htmlFor="hearing_date" className="text-navy">תאריך דיון</Label>
+              <Input
+                id="hearing_date"
+                type="date"
+                {...form.register("hearing_date")}
+                className="mt-1 tabular-nums"
+              />
+              <FieldError message={form.formState.errors.hearing_date?.message} />
+            </div>
+
+            <div>
+              <Label className="text-navy">תוצאה צפויה</Label>
+              <Select
+                value={form.watch("expected_outcome") || "__none__"}
+                onValueChange={(v) =>
+                  form.setValue("expected_outcome", v === "__none__" ? "" : v)
+                }
+                dir="rtl"
+              >
+                <SelectTrigger className="mt-1">
+                  <SelectValue />
+                </SelectTrigger>
+                <SelectContent>
+                  {expectedOutcomes.map((o) => (
+                    <SelectItem key={o.value || "none"} value={o.value || "__none__"}>
+                      {o.label}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            </div>
+          </div>
+
+          <div>
+            <Label htmlFor="notes" className="text-navy">הערות (יתווספו לקיים)</Label>
+            <Textarea id="notes" rows={3} {...form.register("notes")} className="mt-1" />
+            <FieldError message={form.formState.errors.notes?.message} />
+          </div>
+
+          <DialogFooter className="gap-2">
+            <Button
+              type="button"
+              variant="ghost"
+              onClick={() => setOpen(false)}
+              disabled={mutate.isPending}
+            >
+              ביטול
+            </Button>
+            <Button
+              type="submit"
+              disabled={mutate.isPending}
+              className="bg-navy hover:bg-navy-soft text-parchment"
+            >
+              {mutate.isPending ? "שומר…" : "שמור שינויים"}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

web-ui/src/components/cases/case-header.tsx

@@ -1,6 +1,11 @@
 import Link from "next/link";
 import { Card, CardContent } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
 import { StatusBadge } from "@/components/cases/status-badge";
+import {
+  PRACTICE_AREA_LABELS,
+  APPEAL_SUBTYPE_LABELS,
+} from "@/lib/practice-area";
 import type { CaseDetail } from "@/lib/api/cases";
 
 function formatDate(iso?: string | null) {
@@ -30,11 +35,22 @@ export function CaseHeader({ data }: { data?: CaseDetail }) {
 
         <div className="flex items-start justify-between gap-6 flex-wrap">
           <div className="space-y-2">
-            <div className="flex items-center gap-3">
+            <div className="flex items-center gap-3 flex-wrap">
               <span className="font-display text-[2rem] font-black text-navy leading-none tabular-nums">
                 ערר {data?.case_number ?? "—"}
               </span>
               {data?.status && <StatusBadge status={data.status} />}
+              {data?.practice_area && (
+                <Badge
+                  variant="outline"
+                  className="rounded-full px-2.5 py-0.5 text-[0.72rem] font-medium bg-gold-wash text-gold-deep border-gold/40"
+                >
+                  {PRACTICE_AREA_LABELS[data.practice_area]}
+                  {data.appeal_subtype && data.appeal_subtype !== "unknown" && (
+                    <> · {APPEAL_SUBTYPE_LABELS[data.appeal_subtype]}</>
+                  )}
+                </Badge>
+              )}
             </div>
             <h1 className="text-navy text-xl font-bold leading-snug max-w-2xl mb-0">
               {data?.title ?? "טוען…"}
@@ -55,10 +71,6 @@ export function CaseHeader({ data }: { data?: CaseDetail }) {
               עודכן
             </dt>
             <dd className="text-ink-soft tabular-nums">{formatDate(data?.updated_at)}</dd>
-            <dt className="text-ink-muted text-[0.72rem] uppercase tracking-wider">
-              ועדה
-            </dt>
-            <dd className="text-ink-soft">{data?.committee_type ?? "—"}</dd>
           </dl>
         </div>
       </CardContent>

web-ui/src/components/cases/cases-table.tsx

@@ -17,6 +17,7 @@ import {
 import { Input } from "@/components/ui/input";
 import { Skeleton } from "@/components/ui/skeleton";
 import { StatusBadge } from "@/components/cases/status-badge";
+import { APPEAL_SUBTYPE_LABELS } from "@/lib/practice-area";
 import type { Case } from "@/lib/api/cases";
 
 function formatDate(iso?: string) {
@@ -59,6 +60,15 @@ const columns: ColumnDef<Case>[] = [
     header: "סטטוס",
     cell: ({ row }) => <StatusBadge status={row.original.status} />,
   },
+  {
+    accessorKey: "appeal_subtype",
+    header: "תחום",
+    cell: ({ row }) => {
+      const s = row.original.appeal_subtype;
+      if (!s || s === "unknown") return <span className="text-ink-muted">—</span>;
+      return <span className="text-ink-soft text-sm">{APPEAL_SUBTYPE_LABELS[s]}</span>;
+    },
+  },
   {
     accessorKey: "document_count",
     header: "מסמכים",

web-ui/src/components/cases/documents-panel.tsx

@@ -1,73 +1,389 @@
-import { Badge } from "@/components/ui/badge";
-import { ScrollArea } from "@/components/ui/scroll-area";
-import type { CaseDetail } from "@/lib/api/cases";
+"use client";
 
-function formatSize(bytes?: number) {
-  if (!bytes) return "";
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+import { useEffect, useState } from "react";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Progress } from "@/components/ui/progress";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from "@/components/ui/dialog";
+import {
+  CheckCircle2,
+  Clock,
+  Eye,
+  Loader2,
+  Trash2,
+  XCircle,
+} from "lucide-react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { apiRequest } from "@/lib/api/client";
+import { casesKeys } from "@/lib/api/cases";
+import type { CaseDetail, CaseDocument } from "@/lib/api/cases";
+
+/*
+ * Document list for the case detail "מסמכים" tab. Uses the real document
+ * row shape returned by the FastAPI case_get endpoint — see db.list_documents
+ * and the `documents` schema in legal_mcp/services/db.py:
+ *   id · case_id · doc_type · title · file_path · extraction_status ·
+ *   page_count · created_at · practice_area · appeal_subtype
+ */
+
+const DOC_TYPE_LABELS: Record<string, string> = {
+  appeal:    "כתב ערר",
+  response:  "כתב תשובה",
+  protocol:  "פרוטוקול",
+  decision:  "החלטת ועדה מקומית",
+  plan:      "תכנית",
+  reference: "חומר רקע",
+  auto:      "—",
+};
+
+function doctypeLabel(t: string): string {
+  return DOC_TYPE_LABELS[t] ?? t;
 }
 
-function categoryTone(category?: string | null) {
-  switch (category) {
-    case "appeal":        return "bg-info-bg text-info border-info/40";
-    case "response":      return "bg-gold-wash text-gold-deep border-gold/40";
-    case "decision":      return "bg-success-bg text-success border-success/40";
-    case "protocol":      return "bg-warn-bg text-warn border-warn/40";
-    default:              return "bg-rule-soft text-ink-muted border-rule";
+function doctypeTone(t: string): string {
+  switch (t) {
+    case "appeal":    return "bg-info-bg text-info border-info/40";
+    case "response":  return "bg-gold-wash text-gold-deep border-gold/40";
+    case "decision":  return "bg-success-bg text-success border-success/40";
+    case "protocol":  return "bg-warn-bg text-warn border-warn/40";
+    default:          return "bg-rule-soft text-ink-muted border-rule";
   }
 }
 
-export function DocumentsPanel({ data }: { data?: CaseDetail }) {
+const STATUS_LABELS: Record<string, string> = {
+  pending:    "בהמתנה",
+  processing: "בעיבוד",
+  completed:  "הושלם",
+  proofread:  "הוגה",
+  failed:     "נכשל",
+  error:      "שגיאה",
+};
+
+/** Sort priority — lower = higher in list */
+const STATUS_ORDER: Record<string, number> = {
+  failed:     0,
+  error:      0,
+  processing: 1,
+  pending:    2,
+  completed:  3,
+  proofread:  3,
+};
+
+function statusOrder(s: string): number {
+  return STATUS_ORDER[s] ?? 3;
+}
+
+function StatusIcon({ status }: { status: string }) {
+  switch (status) {
+    case "completed":
+    case "proofread":
+      return <CheckCircle2 className="w-4 h-4 text-success shrink-0" />;
+    case "processing":
+      return <Loader2 className="w-4 h-4 text-gold animate-spin shrink-0" />;
+    case "pending":
+      return <Clock className="w-4 h-4 text-ink-muted shrink-0" />;
+    case "failed":
+    case "error":
+      return <XCircle className="w-4 h-4 text-danger shrink-0" />;
+    default:
+      return <Clock className="w-4 h-4 text-ink-muted shrink-0" />;
+  }
+}
+
+function formatDate(iso: string) {
+  if (!iso) return "—";
+  try {
+    return new Date(iso).toLocaleDateString("he-IL");
+  } catch {
+    return iso;
+  }
+}
+
+function filenameFromPath(path: string): string {
+  const parts = path.split("/");
+  return parts[parts.length - 1] || path;
+}
+
+/* ── Document text preview dialog ──────────────────────────────── */
+
+function DocumentPreviewDialog({
+  doc,
+  open,
+  onOpenChange,
+}: {
+  doc: CaseDocument;
+  open: boolean;
+  onOpenChange: (v: boolean) => void;
+}) {
+  const [text, setText] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!open) {
+      setText(null);
+      setError(null);
+      return;
+    }
+    let cancelled = false;
+    setLoading(true);
+    setError(null);
+    apiRequest<{ text: string }>(`/api/documents/${doc.id}/text`)
+      .then((res) => { if (!cancelled) setText(res.text || "(ריק)"); })
+      .catch(() => { if (!cancelled) setError("המסמך עדיין לא עובד או שאין בו טקסט"); })
+      .finally(() => { if (!cancelled) setLoading(false); });
+    return () => { cancelled = true; };
+  }, [open, doc.id]);
+
+  const displayName = doc.title || filenameFromPath(doc.file_path);
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-2xl max-h-[80vh] flex flex-col" dir="rtl">
+        <DialogHeader>
+          <DialogTitle className="text-right">{displayName}</DialogTitle>
+        </DialogHeader>
+        <div className="flex-1 overflow-hidden">
+          {loading && (
+            <div className="flex items-center justify-center py-12">
+              <Loader2 className="w-6 h-6 animate-spin text-gold" />
+              <span className="ms-2 text-ink-muted text-sm">טוען מסמך...</span>
+            </div>
+          )}
+          {error && (
+            <div className="text-center py-12 text-danger text-sm">{error}</div>
+          )}
+          {text !== null && !loading && (
+            <div className="h-[60vh] overflow-y-auto" dir="rtl">
+              <pre className="whitespace-pre-wrap text-sm text-ink leading-relaxed font-sans p-2">
+                {text}
+              </pre>
+            </div>
+          )}
+        </div>
+        <DialogFooter showCloseButton />
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+/* ── Delete confirmation dialog ────────────────────────────────── */
+
+function DeleteConfirmDialog({
+  doc,
+  caseNumber,
+  open,
+  onOpenChange,
+}: {
+  doc: CaseDocument;
+  caseNumber: string;
+  open: boolean;
+  onOpenChange: (v: boolean) => void;
+}) {
+  const qc = useQueryClient();
+  const deleteMutation = useMutation({
+    mutationFn: () =>
+      apiRequest(`/api/cases/${caseNumber}/documents/${doc.id}`, {
+        method: "DELETE",
+      }),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: casesKeys.all });
+      onOpenChange(false);
+    },
+  });
+
+  const displayName = doc.title || filenameFromPath(doc.file_path);
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent dir="rtl">
+        <DialogHeader>
+          <DialogTitle className="text-right">מחיקת מסמך</DialogTitle>
+        </DialogHeader>
+        <p className="text-sm text-ink-muted text-right">
+          האם למחוק את המסמך <strong>&ldquo;{displayName}&rdquo;</strong>?
+          <br />
+          פעולה זו אינה ניתנת לביטול.
+        </p>
+        <DialogFooter>
+          <Button
+            variant="destructive"
+            onClick={() => deleteMutation.mutate()}
+            disabled={deleteMutation.isPending}
+          >
+            {deleteMutation.isPending ? (
+              <Loader2 className="w-4 h-4 animate-spin me-1" />
+            ) : (
+              <Trash2 className="w-4 h-4 me-1" />
+            )}
+            מחק
+          </Button>
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            ביטול
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+/* ── Single document row ───────────────────────────────────────── */
+
+function DocumentRow({
+  doc,
+  caseNumber,
+}: {
+  doc: CaseDocument;
+  caseNumber: string;
+}) {
+  const [previewOpen, setPreviewOpen] = useState(false);
+  const [deleteOpen, setDeleteOpen] = useState(false);
+  const displayName = doc.title || filenameFromPath(doc.file_path);
+  const canPreview =
+    doc.extraction_status === "completed" || doc.extraction_status === "proofread";
+
+  return (
+    <>
+      <li className="py-3 flex items-start gap-3 hover:bg-gold-wash/30 transition-colors px-2 -mx-2 rounded group">
+        <StatusIcon status={doc.extraction_status} />
+        <button
+          type="button"
+          className="flex-1 min-w-0 space-y-0.5 text-right cursor-pointer hover:underline decoration-gold/40 underline-offset-2 disabled:cursor-default disabled:no-underline"
+          disabled={!canPreview}
+          onClick={() => canPreview && setPreviewOpen(true)}
+          title={canPreview ? "לחץ לצפייה במסמך" : "המסמך עדיין לא עובד"}
+        >
+          <div className="text-ink font-medium truncate flex items-center gap-1.5">
+            {canPreview && <Eye className="w-3.5 h-3.5 text-ink-muted shrink-0" />}
+            <span>{displayName}</span>
+          </div>
+          <div className="text-[0.72rem] text-ink-muted flex items-center gap-3 flex-wrap">
+            {doc.page_count != null && (
+              <span className="tabular-nums">{doc.page_count} עמ׳</span>
+            )}
+            {doc.created_at && <span>{formatDate(doc.created_at)}</span>}
+          </div>
+        </button>
+        {doc.doc_type && (
+          <Badge
+            variant="outline"
+            className={`rounded-full px-2 py-0.5 text-[0.7rem] shrink-0 ${doctypeTone(doc.doc_type)}`}
+          >
+            {doctypeLabel(doc.doc_type)}
+          </Badge>
+        )}
+        <button
+          type="button"
+          className="shrink-0 p-1 rounded text-ink-muted/40 hover:text-danger hover:bg-danger-bg transition-colors opacity-0 group-hover:opacity-100"
+          onClick={() => setDeleteOpen(true)}
+          title="מחק מסמך"
+        >
+          <Trash2 className="w-4 h-4" />
+        </button>
+      </li>
+      {previewOpen && (
+        <DocumentPreviewDialog
+          doc={doc}
+          open={previewOpen}
+          onOpenChange={setPreviewOpen}
+        />
+      )}
+      {deleteOpen && (
+        <DeleteConfirmDialog
+          doc={doc}
+          caseNumber={caseNumber}
+          open={deleteOpen}
+          onOpenChange={setDeleteOpen}
+        />
+      )}
+    </>
+  );
+}
+
+/* ── Main panel ────────────────────────────────────────────────── */
+
+export function DocumentsPanel({
+  data,
+}: {
+  data?: CaseDetail;
+}) {
   const docs = data?.documents ?? [];
+  const caseNumber = data?.case_number ?? "";
 
   if (docs.length === 0) {
     return (
       <div className="text-center py-12 text-ink-muted">
-        <div className="text-gold text-2xl mb-2" aria-hidden>❦</div>
+        <div className="text-gold text-2xl mb-2" aria-hidden="true">❦</div>
         <p className="text-sm">אין מסמכים בתיק זה</p>
       </div>
     );
   }
 
+  const sorted = [...docs].sort(
+    (a, b) => statusOrder(a.extraction_status) - statusOrder(b.extraction_status),
+  );
+
+  const done = docs.filter(
+    (d) => d.extraction_status === "completed" || d.extraction_status === "proofread",
+  ).length;
+  const processing = docs.filter((d) => d.extraction_status === "processing").length;
+  const pending = docs.filter((d) => d.extraction_status === "pending").length;
+  const failed = docs.filter(
+    (d) => d.extraction_status === "failed" || d.extraction_status === "error",
+  ).length;
+  const hasIncomplete = processing > 0 || pending > 0 || failed > 0;
+  const pct = docs.length > 0 ? Math.round((done / docs.length) * 100) : 0;
+
   return (
-    <ScrollArea className="max-h-[520px]">
-      <ul className="divide-y divide-rule">
-        {docs.map((doc) => (
-          <li
-            key={doc.id}
-            className="py-3 flex items-start justify-between gap-4 hover:bg-gold-wash/30 transition-colors px-2 -mx-2 rounded"
-          >
-            <div className="flex-1 min-w-0 space-y-0.5">
-              <div className="text-ink font-medium truncate" title={doc.filename}>
-                {doc.filename}
-              </div>
-              <div className="text-[0.72rem] text-ink-muted flex items-center gap-3">
-                {doc.size_bytes && (
-                  <span className="tabular-nums">{formatSize(doc.size_bytes)}</span>
-                )}
-                {doc.uploaded_at && (
-                  <span>
-                    {new Date(doc.uploaded_at).toLocaleDateString("he-IL")}
-                  </span>
-                )}
-                {doc.status && doc.status !== "ready" && (
-                  <span className="text-warn">{doc.status}</span>
-                )}
-              </div>
-            </div>
-            {doc.category && (
-              <Badge
-                variant="outline"
-                className={`rounded-full px-2 py-0.5 text-[0.7rem] ${categoryTone(doc.category)}`}
-              >
-                {doc.category}
-              </Badge>
+    <div className="space-y-3">
+      {hasIncomplete && (
+        <div className="rounded-lg border border-rule bg-parchment/40 px-4 py-3 space-y-2" dir="rtl">
+          <div className="flex items-center gap-4 text-[0.78rem] flex-wrap">
+            {done > 0 && (
+              <span className="flex items-center gap-1 text-success">
+                <CheckCircle2 className="w-3.5 h-3.5" />
+                {done} {STATUS_LABELS.completed}
+              </span>
             )}
-          </li>
-        ))}
-      </ul>
-    </ScrollArea>
+            {processing > 0 && (
+              <span className="flex items-center gap-1 text-gold-deep">
+                <Loader2 className="w-3.5 h-3.5 animate-spin" />
+                {processing} {STATUS_LABELS.processing}
+              </span>
+            )}
+            {pending > 0 && (
+              <span className="flex items-center gap-1 text-ink-muted">
+                <Clock className="w-3.5 h-3.5" />
+                {pending} {STATUS_LABELS.pending}
+              </span>
+            )}
+            {failed > 0 && (
+              <span className="flex items-center gap-1 text-danger">
+                <XCircle className="w-3.5 h-3.5" />
+                {failed} {STATUS_LABELS.failed}
+              </span>
+            )}
+          </div>
+          <Progress
+            value={pct}
+            className={failed > 0 && done === 0 ? "[&>div]:bg-danger" : ""}
+          />
+        </div>
+      )}
+
+      <div className="max-h-[70vh] overflow-y-auto" dir="rtl">
+        <ul className="divide-y divide-rule" dir="rtl">
+          {sorted.map((doc) => (
+            <DocumentRow key={doc.id} doc={doc} caseNumber={caseNumber} />
+          ))}
+        </ul>
+      </div>
+    </div>
   );
 }

web-ui/src/components/cases/status-badge.tsx

@@ -1,5 +1,11 @@
 import { Badge } from "@/components/ui/badge";
+import {
+  FilePlus2, Upload, Loader2, FileCheck, Target,
+  Lightbulb, Compass, PenLine, SearchCheck, FileText,
+  FileOutput, CheckCircle2, Award,
+} from "lucide-react";
 import type { CaseStatus } from "@/lib/api/cases";
+import type { LucideIcon } from "lucide-react";
 
 const STATUS_LABELS: Record<CaseStatus, string> = {
   new: "חדש",
@@ -17,6 +23,38 @@ const STATUS_LABELS: Record<CaseStatus, string> = {
   final: "סופי",
 };
 
+const STATUS_ICONS: Record<CaseStatus, LucideIcon> = {
+  new:                FilePlus2,
+  uploading:          Upload,
+  processing:         Loader2,
+  documents_ready:    FileCheck,
+  outcome_set:        Target,
+  brainstorming:      Lightbulb,
+  direction_approved: Compass,
+  drafting:           PenLine,
+  qa_review:          SearchCheck,
+  drafted:            FileText,
+  exported:           FileOutput,
+  reviewed:           CheckCircle2,
+  final:              Award,
+};
+
+const STATUS_DESCRIPTIONS: Record<CaseStatus, string> = {
+  new:                "התיק נוצר וממתין להעלאת מסמכים",
+  uploading:          "מסמכים בתהליך העלאה לשרת",
+  processing:         "המערכת מעבדת ומנתחת את המסמכים",
+  documents_ready:    "כל המסמכים עובדו ומוכנים לעבודה",
+  outcome_set:        "נקבעה תוצאה צפויה לערר",
+  brainstorming:      "ניתוח כיוונים אפשריים להחלטה",
+  direction_approved: "כיוון ההחלטה אושר — ניתן להתחיל כתיבה",
+  drafting:           "טיוטת ההחלטה בתהליך כתיבה",
+  qa_review:          "הטיוטה בבדיקת איכות אוטומטית",
+  drafted:            "טיוטה ראשונה מוכנה לעיון",
+  exported:           "ההחלטה יוצאה לקובץ DOCX",
+  reviewed:           "ההחלטה נבדקה ע\"י היו\"ר",
+  final:              "החלטה סופית — מוכנה להגשה",
+};
+
 /* Status color groups:
  * intake  → new, uploading, processing          (muted parchment)
  * prep    → documents_ready, outcome_set        (info blue)
@@ -40,14 +78,16 @@ const STATUS_TONE: Record<CaseStatus, string> = {
 };
 
 export function StatusBadge({ status }: { status: CaseStatus }) {
+  const Icon = STATUS_ICONS[status];
   return (
     <Badge
       variant="outline"
-      className={`rounded-full px-2.5 py-0.5 text-[0.72rem] font-medium ${STATUS_TONE[status] ?? ""}`}
+      className={`rounded-full px-2.5 py-0.5 text-[0.72rem] font-medium inline-flex items-center gap-1 ${STATUS_TONE[status] ?? ""}`}
     >
+      {Icon && <Icon className="w-3 h-3 shrink-0" />}
       {STATUS_LABELS[status] ?? status}
     </Badge>
   );
 }
 
-export { STATUS_LABELS };
+export { STATUS_LABELS, STATUS_ICONS, STATUS_DESCRIPTIONS, STATUS_TONE };

web-ui/src/components/cases/status-changer.tsx

@@ -0,0 +1,84 @@
+"use client";
+
+import { useState } from "react";
+import { toast } from "sonner";
+import {
+  Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
+} from "@/components/ui/select";
+import { Button } from "@/components/ui/button";
+import { STATUS_LABELS, STATUS_ICONS } from "@/components/cases/status-badge";
+import { useUpdateCase, type CaseStatus } from "@/lib/api/cases";
+
+/*
+ * Dropdown for manually overriding the case status — skip a step
+ * or revert to an earlier stage. Calls PUT /api/cases/:caseNumber
+ * with { status: newValue }.
+ */
+
+const ALL_STATUSES: CaseStatus[] = [
+  "new", "uploading", "processing",
+  "documents_ready", "outcome_set",
+  "brainstorming", "direction_approved",
+  "drafting", "qa_review", "drafted",
+  "exported", "reviewed", "final",
+];
+
+export function StatusChanger({
+  caseNumber,
+  currentStatus,
+}: {
+  caseNumber: string;
+  currentStatus?: CaseStatus;
+}) {
+  const [selected, setSelected] = useState<CaseStatus | "">(currentStatus ?? "");
+  const mutate = useUpdateCase(caseNumber);
+
+  const handleSave = async () => {
+    if (!selected || selected === currentStatus) return;
+    try {
+      await mutate.mutateAsync({ status: selected });
+      toast.success(`הסטטוס עודכן ל${STATUS_LABELS[selected]}`);
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "שגיאה בעדכון הסטטוס");
+    }
+  };
+
+  return (
+    <div className="mt-4 border-t border-rule pt-3 space-y-2">
+      <label className="text-[0.72rem] text-ink-muted block">שינוי סטטוס ידני</label>
+      <div className="flex items-center gap-2">
+        <Select
+          value={selected || "__current__"}
+          onValueChange={(v) => setSelected(v === "__current__" ? "" : v as CaseStatus)}
+          dir="rtl"
+        >
+          <SelectTrigger className="text-[0.75rem] h-8">
+            <SelectValue />
+          </SelectTrigger>
+          <SelectContent>
+            {ALL_STATUSES.map((s) => {
+              const Icon = STATUS_ICONS[s];
+              return (
+                <SelectItem key={s} value={s} className="text-[0.75rem]">
+                  <span className="inline-flex items-center gap-1.5">
+                    <Icon className="w-3 h-3 shrink-0" />
+                    {STATUS_LABELS[s]}
+                  </span>
+                </SelectItem>
+              );
+            })}
+          </SelectContent>
+        </Select>
+        <Button
+          size="sm"
+          variant="outline"
+          className="h-8 text-[0.72rem] px-3 shrink-0"
+          disabled={!selected || selected === currentStatus || mutate.isPending}
+          onClick={handleSave}
+        >
+          {mutate.isPending ? "שומר…" : "עדכן"}
+        </Button>
+      </div>
+    </div>
+  );
+}

web-ui/src/components/cases/status-guide.tsx

@@ -0,0 +1,72 @@
+"use client";
+
+import { useState } from "react";
+import { ChevronDown, ChevronUp } from "lucide-react";
+import type { CaseStatus } from "@/lib/api/cases";
+import { STATUS_LABELS, STATUS_ICONS, STATUS_DESCRIPTIONS, STATUS_TONE } from "@/components/cases/status-badge";
+
+/*
+ * Collapsible guide showing all 13 statuses grouped by phase,
+ * each with its icon, Hebrew label, color badge, and description.
+ * Intended to sit below the WorkflowTimeline in the case sidebar.
+ */
+
+type PhaseGroup = {
+  label: string;
+  statuses: CaseStatus[];
+};
+
+const PHASE_GROUPS: PhaseGroup[] = [
+  { label: "קליטה ועיבוד",  statuses: ["new", "uploading", "processing"] },
+  { label: "הכנת תיק",       statuses: ["documents_ready", "outcome_set"] },
+  { label: "ניתוח וכיוון",   statuses: ["brainstorming", "direction_approved"] },
+  { label: "כתיבת טיוטה",    statuses: ["drafting", "qa_review", "drafted"] },
+  { label: "סגירה",          statuses: ["exported", "reviewed", "final"] },
+];
+
+export function StatusGuide() {
+  const [open, setOpen] = useState(false);
+
+  return (
+    <div className="mt-4 border-t border-rule pt-3">
+      <button
+        type="button"
+        onClick={() => setOpen(!open)}
+        className="flex items-center gap-1.5 text-[0.72rem] text-ink-muted hover:text-navy transition-colors w-full"
+      >
+        {open ? <ChevronUp className="w-3 h-3" /> : <ChevronDown className="w-3 h-3" />}
+        מפת סטטוסים
+      </button>
+
+      {open && (
+        <div className="mt-3 space-y-3">
+          {PHASE_GROUPS.map((group) => (
+            <div key={group.label}>
+              <h4 className="text-[0.7rem] font-semibold text-navy mb-1.5">
+                {group.label}
+              </h4>
+              <ul className="space-y-1.5">
+                {group.statuses.map((s) => {
+                  const Icon = STATUS_ICONS[s];
+                  return (
+                    <li key={s} className="flex items-start gap-2">
+                      <span
+                        className={`inline-flex items-center gap-1 rounded-full px-2 py-0.5 text-[0.65rem] font-medium shrink-0 ${STATUS_TONE[s]}`}
+                      >
+                        <Icon className="w-2.5 h-2.5" />
+                        {STATUS_LABELS[s]}
+                      </span>
+                      <span className="text-[0.65rem] text-ink-muted leading-snug">
+                        {STATUS_DESCRIPTIONS[s]}
+                      </span>
+                    </li>
+                  );
+                })}
+              </ul>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

web-ui/src/components/cases/workflow-timeline.tsx

@@ -1,7 +1,11 @@
 "use client";
 
 import type { CaseStatus } from "@/lib/api/cases";
-import { STATUS_LABELS } from "@/components/cases/status-badge";
+import { STATUS_LABELS, STATUS_ICONS, STATUS_DESCRIPTIONS } from "@/components/cases/status-badge";
+import {
+  FolderInput, ClipboardList, Brain, PenLine, CheckCircle2,
+} from "lucide-react";
+import type { LucideIcon } from "lucide-react";
 
 /*
  * Vertical RTL workflow timeline showing the 13-status case pipeline.
@@ -13,15 +17,16 @@ import { STATUS_LABELS } from "@/components/cases/status-badge";
 type Phase = {
   key: string;
   label: string;
+  icon: LucideIcon;
   statuses: CaseStatus[];
 };
 
 const PHASES: Phase[] = [
-  { key: "intake",   label: "קליטה ועיבוד",   statuses: ["new", "uploading", "processing"] },
-  { key: "prep",     label: "הכנת תיק",        statuses: ["documents_ready", "outcome_set"] },
-  { key: "thinking", label: "ניתוח וכיוון",    statuses: ["brainstorming", "direction_approved"] },
-  { key: "writing",  label: "כתיבת טיוטה",     statuses: ["drafting", "qa_review", "drafted"] },
-  { key: "done",     label: "סגירה",           statuses: ["exported", "reviewed", "final"] },
+  { key: "intake",   label: "קליטה ועיבוד",   icon: FolderInput,   statuses: ["new", "uploading", "processing"] },
+  { key: "prep",     label: "הכנת תיק",        icon: ClipboardList, statuses: ["documents_ready", "outcome_set"] },
+  { key: "thinking", label: "ניתוח וכיוון",    icon: Brain,         statuses: ["brainstorming", "direction_approved"] },
+  { key: "writing",  label: "כתיבת טיוטה",     icon: PenLine,       statuses: ["drafting", "qa_review", "drafted"] },
+  { key: "done",     label: "סגירה",           icon: CheckCircle2,  statuses: ["exported", "reviewed", "final"] },
 ];
 
 function phaseIndexOf(status?: CaseStatus): number {
@@ -55,19 +60,36 @@ export function WorkflowTimeline({ status }: { status?: CaseStatus }) {
           : state === "current" ? "text-navy font-semibold"
           : "text-ink-muted";
 
+        const iconTone =
+          state === "done"    ? "text-success"
+          : state === "current" ? "text-gold-deep"
+          : "text-ink-muted/50";
+
+        const PhaseIcon = phase.icon;
+        const StatusIcon = status ? STATUS_ICONS[status] : null;
+
         return (
           <li key={phase.key} className="relative flex items-start gap-3 ps-7">
             <span
               className={`absolute right-[5px] top-1 inline-block w-3 h-3 rounded-full border-2 ${dotTone}`}
               aria-hidden
             />
-            <div className="flex flex-col">
-              <span className={`text-sm ${labelTone}`}>{phase.label}</span>
+            <div className="flex flex-col gap-0.5">
+              <span className={`text-sm flex items-center gap-1.5 ${labelTone}`}>
+                <PhaseIcon className={`w-3.5 h-3.5 shrink-0 ${iconTone}`} />
+                {phase.label}
+              </span>
               {state === "current" && status && (
-                <span className="text-[0.72rem] text-gold-deep mt-0.5">
+                <span className="text-[0.72rem] text-gold-deep flex items-center gap-1">
+                  {StatusIcon && <StatusIcon className="w-3 h-3 shrink-0" />}
                   {STATUS_LABELS[status]}
                 </span>
               )}
+              {state === "current" && status && STATUS_DESCRIPTIONS[status] && (
+                <span className="text-[0.65rem] text-ink-muted leading-snug mt-0.5">
+                  {STATUS_DESCRIPTIONS[status]}
+                </span>
+              )}
             </div>
           </li>
         );

web-ui/src/components/compose/precedent-attacher.tsx

@@ -0,0 +1,229 @@
+"use client";
+
+import { useState } from "react";
+import { Plus, Paperclip } from "lucide-react";
+import { toast } from "sonner";
+import {
+  Popover, PopoverContent, PopoverTrigger,
+} from "@/components/ui/popover";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
+import { Label } from "@/components/ui/label";
+import {
+  useCreatePrecedent,
+  usePrecedentLibrarySearch,
+  uploadPrecedentPdf,
+} from "@/lib/api/precedents";
+import type { PracticeArea } from "@/lib/practice-area";
+
+/*
+ * Inline form for adding a new precedent. Opens in a Popover adjacent
+ * to the trigger button so the user can see the surrounding context
+ * (the threshold_claim body, the chair editor) while they fill it in.
+ *
+ * The citation field has cross-case typeahead: once the user types
+ * 2+ characters, we hit /api/precedents/search and show distinct
+ * matches. Picking one prefills quote + chair_note but keeps them
+ * editable — the new row is a copy, so a customized quote for this
+ * case doesn't affect the library.
+ */
+
+export function PrecedentAttacher({
+  caseNumber,
+  sectionId,
+  practiceArea,
+}: {
+  caseNumber: string;
+  sectionId: string | null;
+  practiceArea: PracticeArea | null | undefined;
+}) {
+  const [open, setOpen] = useState(false);
+  const [citation, setCitation] = useState("");
+  const [quote, setQuote] = useState("");
+  const [chairNote, setChairNote] = useState("");
+  const [pdfFile, setPdfFile] = useState<File | null>(null);
+  const [submitting, setSubmitting] = useState(false);
+  const [picked, setPicked] = useState(false);
+
+  const create = useCreatePrecedent(caseNumber);
+  const library = usePrecedentLibrarySearch(
+    citation,
+    practiceArea,
+    /* pause typeahead once the user has picked one and we're just editing */
+    !picked,
+  );
+
+  const reset = () => {
+    setCitation("");
+    setQuote("");
+    setChairNote("");
+    setPdfFile(null);
+    setPicked(false);
+  };
+
+  const onSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!quote.trim() || !citation.trim()) {
+      toast.error("ציטוט ומראה-מקום חובה");
+      return;
+    }
+    setSubmitting(true);
+    try {
+      let pdfDocumentId: string | undefined;
+      if (pdfFile) {
+        const res = await uploadPrecedentPdf(caseNumber, pdfFile);
+        pdfDocumentId = res.document_id;
+      }
+      await create.mutateAsync({
+        quote: quote.trim(),
+        citation: citation.trim(),
+        chair_note: chairNote.trim(),
+        section_id: sectionId ?? undefined,
+        pdf_document_id: pdfDocumentId,
+      });
+      toast.success("נוספה פסיקה");
+      reset();
+      setOpen(false);
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : "שגיאה בשמירה");
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  return (
+    <Popover open={open} onOpenChange={(v) => { setOpen(v); if (!v) reset(); }}>
+      <PopoverTrigger asChild>
+        <Button
+          type="button"
+          variant="outline"
+          size="sm"
+          className="border-dashed border-gold/50 text-gold-deep hover:bg-gold-wash"
+        >
+          <Plus className="w-4 h-4 me-1" aria-hidden="true" />
+          הוסף פסיקה תומכת
+        </Button>
+      </PopoverTrigger>
+      <PopoverContent
+        className="w-[520px] max-w-[90vw] p-5"
+        align="start"
+        dir="rtl"
+      >
+        <form onSubmit={onSubmit} className="space-y-3" dir="rtl">
+          <div>
+            <Label htmlFor="prec-citation" className="text-navy">
+              מראה מקום <span className="text-danger">*</span>
+            </Label>
+            <Input
+              id="prec-citation"
+              value={citation}
+              onChange={(e) => {
+                setCitation(e.target.value);
+                setPicked(false);
+              }}
+              placeholder="ערר (ירושלים) 1126-08-25 ... נ' ... (נבו 9.3.2026)"
+              autoComplete="off"
+              className="mt-1"
+            />
+            {!picked && library.data && library.data.length > 0 && citation.length >= 2 && (
+              <ul
+                className="
+                  mt-1 rounded border border-rule bg-surface shadow-sm
+                  max-h-44 overflow-y-auto divide-y divide-rule
+                "
+                role="listbox"
+              >
+                {library.data.map((m) => (
+                  <li key={m.id}>
+                    <button
+                      type="button"
+                      onClick={() => {
+                        setCitation(m.citation);
+                        setQuote(m.quote);
+                        setChairNote(m.chair_note || "");
+                        setPicked(true);
+                      }}
+                      className="w-full text-right px-3 py-2 hover:bg-gold-wash/60 transition-colors"
+                    >
+                      <div className="text-[0.78rem] text-gold-deep font-semibold truncate">
+                        {m.citation}
+                      </div>
+                      <div className="text-[0.72rem] text-ink-muted truncate">
+                        {m.quote}
+                      </div>
+                    </button>
+                  </li>
+                ))}
+              </ul>
+            )}
+          </div>
+
+          <div>
+            <Label htmlFor="prec-quote" className="text-navy">
+              ציטוט <span className="text-danger">*</span>
+            </Label>
+            <Textarea
+              id="prec-quote"
+              value={quote}
+              onChange={(e) => setQuote(e.target.value)}
+              rows={5}
+              placeholder="הטקסט המדויק שישולב בהחלטה"
+              className="mt-1"
+            />
+          </div>
+
+          <div>
+            <Label htmlFor="prec-note" className="text-navy">
+              הערה (אופציונלי)
+            </Label>
+            <Textarea
+              id="prec-note"
+              value={chairNote}
+              onChange={(e) => setChairNote(e.target.value)}
+              rows={2}
+              placeholder="למה הציטוט הזה תומך בעמדה"
+              className="mt-1"
+            />
+          </div>
+
+          <div>
+            <Label className="text-navy flex items-center gap-2">
+              <Paperclip className="w-3.5 h-3.5" aria-hidden="true" />
+              צירוף קובץ המקור (אופציונלי, לארכיון)
+            </Label>
+            <input
+              type="file"
+              accept=".pdf,.docx,.doc"
+              onChange={(e) => setPdfFile(e.target.files?.[0] ?? null)}
+              className="mt-1 w-full text-sm file:me-3 file:rounded file:border-0 file:bg-rule-soft file:px-3 file:py-1.5 file:text-navy file:text-sm hover:file:bg-rule"
+            />
+            {pdfFile && (
+              <p className="text-[0.72rem] text-ink-muted mt-1">
+                {pdfFile.name} · {(pdfFile.size / 1024).toFixed(1)} KB
+              </p>
+            )}
+          </div>
+
+          <div className="flex items-center justify-end gap-2 pt-2">
+            <Button
+              type="button"
+              variant="ghost"
+              onClick={() => { setOpen(false); reset(); }}
+              disabled={submitting}
+            >
+              ביטול
+            </Button>
+            <Button
+              type="submit"
+              disabled={submitting}
+              className="bg-navy hover:bg-navy-soft text-parchment"
+            >
+              {submitting ? "שומר…" : "שמור פסיקה"}
+            </Button>
+          </div>
+        </form>
+      </PopoverContent>
+    </Popover>
+  );
+}

web-ui/src/components/compose/precedent-card.tsx

@@ -0,0 +1,77 @@
+"use client";
+
+import { Trash2, FileText } from "lucide-react";
+import { toast } from "sonner";
+import { Button } from "@/components/ui/button";
+import { useDeletePrecedent, type CasePrecedent } from "@/lib/api/precedents";
+
+/*
+ * Read-only display of a single attached precedent. Layout is:
+ *
+ *   ┌───────────────────────────────────────────┐
+ *   │ citation (gold semibold)        [🗑]    │
+ *   │ ┌──┐                                     │
+ *   │ │╎ │  "quote text…"                      │
+ *   │ └──┘                                     │
+ *   │ chair_note (muted)                       │
+ *   │ 📄 קובץ מצורף                            │
+ *   └───────────────────────────────────────────┘
+ */
+
+export function PrecedentCard({
+  caseNumber,
+  precedent,
+}: {
+  caseNumber: string;
+  precedent: CasePrecedent;
+}) {
+  const del = useDeletePrecedent(caseNumber);
+
+  const onDelete = async () => {
+    if (!window.confirm("להסיר פסיקה זו מהתיק?")) return;
+    try {
+      await del.mutateAsync(precedent.id);
+      toast.success("הפסיקה הוסרה");
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "שגיאה בהסרה");
+    }
+  };
+
+  return (
+    <article className="rounded-lg border border-rule bg-parchment/40 px-4 py-3 space-y-2">
+      <div className="flex items-start gap-3">
+        <p className="flex-1 text-[0.82rem] text-gold-deep font-semibold leading-snug">
+          {precedent.citation}
+        </p>
+        <Button
+          type="button"
+          variant="ghost"
+          size="sm"
+          onClick={onDelete}
+          disabled={del.isPending}
+          aria-label="הסר פסיקה זו"
+          className="text-danger hover:text-danger hover:bg-danger-bg shrink-0 -mt-1 -me-2"
+        >
+          <Trash2 className="w-4 h-4" aria-hidden="true" />
+        </Button>
+      </div>
+
+      <blockquote className="border-e-2 border-gold pe-3 text-sm text-ink leading-relaxed whitespace-pre-line">
+        {precedent.quote}
+      </blockquote>
+
+      {precedent.chair_note && (
+        <p className="text-[0.78rem] text-ink-muted italic">
+          {precedent.chair_note}
+        </p>
+      )}
+
+      {precedent.pdf_document_id && (
+        <div className="flex items-center gap-1.5 text-[0.72rem] text-ink-muted">
+          <FileText className="w-3 h-3" aria-hidden="true" />
+          <span>קובץ מצורף</span>
+        </div>
+      )}
+    </article>
+  );
+}

web-ui/src/components/compose/precedents-section.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import { PrecedentCard } from "@/components/compose/precedent-card";
+import { PrecedentAttacher } from "@/components/compose/precedent-attacher";
+import type { CasePrecedent } from "@/lib/api/precedents";
+import type { PracticeArea } from "@/lib/practice-area";
+
+/*
+ * Wrapper that renders the list of precedents for one scope — either
+ * case-level (sectionId=null) or a specific threshold_claim / issue.
+ * The parent page fetches useCasePrecedents(caseNumber) once and
+ * passes a pre-filtered slice down, so each section doesn't re-query.
+ */
+
+export function PrecedentsSection({
+  caseNumber,
+  sectionId,
+  precedents,
+  practiceArea,
+  emptyHelperText,
+}: {
+  caseNumber: string;
+  sectionId: string | null;
+  precedents: CasePrecedent[];
+  practiceArea: PracticeArea | null | undefined;
+  emptyHelperText?: string;
+}) {
+  return (
+    <div className="space-y-3">
+      {precedents.length === 0 ? (
+        emptyHelperText && (
+          <p className="text-[0.78rem] text-ink-muted">{emptyHelperText}</p>
+        )
+      ) : (
+        <ul className="space-y-2">
+          {precedents.map((p) => (
+            <li key={p.id}>
+              <PrecedentCard caseNumber={caseNumber} precedent={p} />
+            </li>
+          ))}
+        </ul>
+      )}
+      <PrecedentAttacher
+        caseNumber={caseNumber}
+        sectionId={sectionId}
+        practiceArea={practiceArea}
+      />
+    </div>
+  );
+}

web-ui/src/components/compose/subsection-card.tsx

@@ -3,16 +3,24 @@
 import { useState } from "react";
 import { ChevronDown } from "lucide-react";
 import { ChairEditor } from "@/components/compose/chair-editor";
+import { PrecedentsSection } from "@/components/compose/precedents-section";
+import { Markdown } from "@/components/ui/markdown";
 import type { ResearchSubsection } from "@/lib/api/research";
+import type { CasePrecedent } from "@/lib/api/precedents";
+import type { PracticeArea } from "@/lib/practice-area";
 
 export function SubsectionCard({
   caseNumber,
   item,
   defaultOpen = false,
+  precedents = [],
+  practiceArea,
 }: {
   caseNumber: string;
   item: ResearchSubsection;
   defaultOpen?: boolean;
+  precedents?: CasePrecedent[];
+  practiceArea?: PracticeArea | null;
 }) {
   const [open, setOpen] = useState(defaultOpen);
   const isFilled = Boolean(item.chair_position?.trim());
@@ -69,8 +77,8 @@ export function SubsectionCard({
                   <dt className="text-[0.72rem] uppercase tracking-wider text-gold-deep font-semibold mb-1">
                     {f.label}
                   </dt>
-                  <dd className="text-sm text-ink-soft leading-relaxed whitespace-pre-line">
-                    {f.content}
+                  <dd>
+                    <Markdown content={f.content} />
                   </dd>
                 </div>
               ))}
@@ -81,6 +89,18 @@ export function SubsectionCard({
             sectionId={item.id}
             initialValue={item.chair_position ?? ""}
           />
+          <div className="border-t border-rule pt-4 mt-2">
+            <h4 className="text-[0.78rem] uppercase tracking-wider text-gold-deep font-semibold mb-2">
+              פסיקה תומכת
+            </h4>
+            <PrecedentsSection
+              caseNumber={caseNumber}
+              sectionId={item.id}
+              precedents={precedents}
+              practiceArea={practiceArea}
+              emptyHelperText="עדיין לא צורפה פסיקה לסעיף זה"
+            />
+          </div>
         </div>
       )}
     </article>

web-ui/src/components/documents/upload-sheet.tsx

@@ -0,0 +1,208 @@
+"use client";
+
+import { useCallback, useState } from "react";
+import { useDropzone } from "react-dropzone";
+import { Upload, FileText, CheckCircle2, XCircle, Loader2 } from "lucide-react";
+import {
+  Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, SheetTrigger,
+} from "@/components/ui/sheet";
+import { Button } from "@/components/ui/button";
+import { Progress } from "@/components/ui/progress";
+import {
+  Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
+} from "@/components/ui/select";
+import { useUploadDocument, useProgress, type ProgressEvent } from "@/lib/api/documents";
+
+/*
+ * Upload sheet — drag-drop zone + doc-type selector, with live SSE
+ * progress for the most-recent upload. Intentionally sequential:
+ * a single file at a time keeps the SSE subscription simple and
+ * matches how the FastAPI processor handles one task_id per file.
+ */
+
+const DOC_TYPES: { value: string; label: string }[] = [
+  { value: "auto",     label: "זיהוי אוטומטי" },
+  { value: "appeal",   label: "כתב ערר" },
+  { value: "response", label: "כתב תשובה" },
+  { value: "protocol", label: "פרוטוקול דיון" },
+  { value: "decision", label: "החלטת ועדה מקומית" },
+  { value: "plan",     label: "תכנית" },
+  { value: "reference",label: "חומר רקע" },
+];
+
+type UploadRow = {
+  id: string;
+  filename: string;
+  taskId: string | null;
+  error?: string;
+};
+
+function statusLabel(event: ProgressEvent | null): string {
+  if (!event) return "מתחיל…";
+  if (event.status === "queued") return "בתור";
+  if (event.status === "processing")
+    return event.step ? `בעיבוד · ${event.step}` : "בעיבוד";
+  if (event.status === "completed") return "הושלם";
+  if (event.status === "failed") return event.error ?? "נכשל";
+  return event.status;
+}
+
+function progressPercent(event: ProgressEvent | null): number {
+  if (!event) return 5;
+  if (event.status === "queued") return 10;
+  if (event.status === "processing") return 55;
+  if (event.status === "completed") return 100;
+  if (event.status === "failed") return 100;
+  return 25;
+}
+
+function UploadRowView({ row }: { row: UploadRow }) {
+  const progress = useProgress(row.taskId);
+  const pct = row.error ? 100 : progressPercent(progress);
+  const failed = row.error || progress?.status === "failed";
+  const done = progress?.status === "completed";
+
+  return (
+    <li className="rounded-lg border border-rule bg-parchment/40 px-4 py-3 space-y-2">
+      <div className="flex items-center gap-2">
+        {done ? (
+          <CheckCircle2 className="w-4 h-4 text-success shrink-0" />
+        ) : failed ? (
+          <XCircle className="w-4 h-4 text-danger shrink-0" />
+        ) : (
+          <Loader2 className="w-4 h-4 text-gold animate-spin shrink-0" />
+        )}
+        <FileText className="w-4 h-4 text-ink-muted shrink-0" />
+        <span className="text-sm text-ink truncate flex-1" title={row.filename}>
+          {row.filename}
+        </span>
+        <span
+          className={`text-[0.72rem] tabular-nums shrink-0 ${
+            done ? "text-success" : failed ? "text-danger" : "text-ink-muted"
+          }`}
+        >
+          {row.error ?? statusLabel(progress)}
+        </span>
+      </div>
+      <Progress
+        value={pct}
+        className={failed ? "[&>div]:bg-danger" : done ? "[&>div]:bg-success" : ""}
+      />
+    </li>
+  );
+}
+
+export function UploadSheet({ caseNumber }: { caseNumber: string }) {
+  const [open, setOpen] = useState(false);
+  const [docType, setDocType] = useState("auto");
+  const [rows, setRows] = useState<UploadRow[]>([]);
+  const mutate = useUploadDocument(caseNumber);
+
+  const onDrop = useCallback(
+    async (files: File[]) => {
+      for (const file of files) {
+        const rowId = crypto.randomUUID();
+        setRows((r) => [
+          ...r,
+          { id: rowId, filename: file.name, taskId: null },
+        ]);
+        try {
+          const res = await mutate.mutateAsync({ file, docType });
+          setRows((r) =>
+            r.map((row) =>
+              row.id === rowId ? { ...row, taskId: res.task_id } : row,
+            ),
+          );
+        } catch (e) {
+          setRows((r) =>
+            r.map((row) =>
+              row.id === rowId
+                ? { ...row, error: e instanceof Error ? e.message : "שגיאה" }
+                : row,
+            ),
+          );
+        }
+      }
+    },
+    [docType, mutate],
+  );
+
+  const dropzone = useDropzone({
+    onDrop,
+    accept: {
+      "application/pdf": [".pdf"],
+      "application/msword": [".doc"],
+      "application/vnd.openxmlformats-officedocument.wordprocessingml.document": [".docx"],
+      "text/plain": [".txt"],
+      "text/markdown": [".md"],
+    },
+    maxSize: 50 * 1024 * 1024,
+  });
+
+  return (
+    <Sheet open={open} onOpenChange={setOpen}>
+      <SheetTrigger asChild>
+        <Button variant="outline" size="sm">
+          <Upload className="w-4 h-4 me-1" /> העלאת מסמכים
+        </Button>
+      </SheetTrigger>
+      <SheetContent side="left" className="w-full sm:max-w-lg" dir="rtl">
+        <SheetHeader>
+          <SheetTitle className="text-navy">העלאת מסמכים לתיק {caseNumber}</SheetTitle>
+          <SheetDescription className="text-ink-muted">
+            PDF, DOCX, DOC, TXT, MD — עד 50MB לקובץ. הקבצים מעובדים ברקע
+            והסטטוס מתעדכן בזמן אמת.
+          </SheetDescription>
+        </SheetHeader>
+
+        <div className="mt-5 space-y-4 px-4 overflow-y-auto flex-1 min-h-0">
+          <div>
+            <label className="block text-sm font-medium text-navy mb-1.5">
+              סיווג
+            </label>
+            <Select value={docType} onValueChange={setDocType} dir="rtl">
+              <SelectTrigger><SelectValue /></SelectTrigger>
+              <SelectContent>
+                {DOC_TYPES.map((t) => (
+                  <SelectItem key={t.value} value={t.value}>{t.label}</SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          </div>
+
+          <div
+            {...dropzone.getRootProps()}
+            className={`
+              rounded-lg border-2 border-dashed p-8 text-center cursor-pointer
+              transition-colors
+              ${
+                dropzone.isDragActive
+                  ? "border-gold bg-gold-wash"
+                  : "border-rule bg-parchment/40 hover:bg-gold-wash/50 hover:border-gold/60"
+              }
+            `}
+          >
+            <input {...dropzone.getInputProps()} />
+            <Upload className="w-8 h-8 mx-auto mb-2 text-gold-deep" />
+            <p className="text-sm text-navy font-medium">
+              {dropzone.isDragActive
+                ? "שחרר כאן להעלאה"
+                : "גרור קבצים או לחץ לבחירה"}
+            </p>
+            <p className="text-[0.72rem] text-ink-muted mt-1">
+              ניתן להעלות מספר קבצים בבת אחת
+            </p>
+          </div>
+
+          {rows.length > 0 && (
+            <ul className="space-y-2">
+              {rows.map((row) => (
+                <UploadRowView key={row.id} row={row} />
+              ))}
+            </ul>
+          )}
+        </div>
+      </SheetContent>
+    </Sheet>
+  );
+}

web-ui/src/components/training/compare-panel.tsx

@@ -0,0 +1,189 @@
+"use client";
+
+import { useState } from "react";
+import { Card, CardContent } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import { Skeleton } from "@/components/ui/skeleton";
+import {
+  Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
+} from "@/components/ui/select";
+import {
+  useCorpus, useCompare, type CompareSide, type PatternEntry,
+} from "@/lib/api/training";
+
+/*
+ * Compare two decisions from the style corpus side-by-side. Uses the
+ * training/compare endpoint which already does the heavy lifting (pattern
+ * extraction, section stats, shared/unique pattern sets). Our job is
+ * layout: two columns of metadata + section bars, plus a third "shared"
+ * section listing patterns that appear in both.
+ */
+
+function SideColumn({ side }: { side: CompareSide }) {
+  return (
+    <Card className="bg-surface border-rule shadow-sm">
+      <CardContent className="px-5 py-4 space-y-3">
+        <header>
+          <h3 className="text-navy text-lg mb-0 tabular-nums">
+            {side.decision_number || "—"}
+          </h3>
+          <p className="text-[0.78rem] text-ink-muted tabular-nums">
+            {side.decision_date || "—"} · {(side.chars / 1000).toFixed(1)}K תווים
+          </p>
+        </header>
+        {side.subjects.length > 0 && (
+          <div className="flex flex-wrap gap-1">
+            {side.subjects.map((s) => (
+              <Badge
+                key={s}
+                variant="outline"
+                className="text-[0.7rem] bg-gold-wash text-gold-deep border-gold/40"
+              >
+                {s}
+              </Badge>
+            ))}
+          </div>
+        )}
+        {side.sections.length > 0 && (
+          <div>
+            <h4 className="text-[0.72rem] uppercase tracking-wider text-gold-deep font-semibold mb-1.5">
+              חלוקה לחלקים
+            </h4>
+            <ul className="space-y-1 text-[0.78rem]">
+              {side.sections.map((sec) => (
+                <li key={sec.type} className="flex items-center justify-between gap-2">
+                  <span className="text-ink-soft truncate">{sec.type}</span>
+                  <span className="text-ink-muted tabular-nums shrink-0">
+                    {(sec.chars / 1000).toFixed(1)}K
+                  </span>
+                </li>
+              ))}
+            </ul>
+          </div>
+        )}
+        <p className="text-[0.78rem] text-ink-muted">
+          דפוסי סגנון שנמצאו: <span className="text-navy font-semibold tabular-nums">{side.patterns_count}</span>
+        </p>
+      </CardContent>
+    </Card>
+  );
+}
+
+function PatternList({
+  title,
+  items,
+  tone,
+}: {
+  title: string;
+  items: PatternEntry[];
+  tone: "shared" | "a" | "b";
+}) {
+  const toneClass =
+    tone === "shared"
+      ? "bg-success-bg border-success/40"
+      : tone === "a"
+        ? "bg-info-bg border-info/40"
+        : "bg-gold-wash border-gold/40";
+  const toneHeading =
+    tone === "shared"
+      ? "text-success"
+      : tone === "a"
+        ? "text-info"
+        : "text-gold-deep";
+
+  return (
+    <Card className={`${toneClass} shadow-sm`}>
+      <CardContent className="px-5 py-4">
+        <h4 className={`${toneHeading} text-sm font-semibold mb-3 flex items-center gap-2`}>
+          {title}
+          <span className="text-[0.7rem] tabular-nums opacity-70">{items.length}</span>
+        </h4>
+        {items.length === 0 ? (
+          <p className="text-ink-muted text-[0.78rem]">—</p>
+        ) : (
+          <ul className="space-y-1.5 text-[0.78rem] max-h-60 overflow-y-auto">
+            {items.slice(0, 20).map((p) => (
+              <li key={p.id} className="text-ink leading-relaxed">
+                {p.text}
+              </li>
+            ))}
+          </ul>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
+export function ComparePanel() {
+  const { data: corpus, isPending } = useCorpus();
+  const [a, setA] = useState<string | null>(null);
+  const [b, setB] = useState<string | null>(null);
+  const cmp = useCompare(a, b);
+
+  return (
+    <div className="space-y-6">
+      <Card className="bg-surface border-rule shadow-sm">
+        <CardContent className="px-5 py-4">
+          <h3 className="text-navy text-base mb-3">בחר שתי החלטות להשוואה</h3>
+          <div className="grid gap-3 md:grid-cols-2">
+            {(["a", "b"] as const).map((slot) => (
+              <div key={slot}>
+                <label className="block text-[0.78rem] font-medium text-navy mb-1">
+                  {slot === "a" ? "החלטה א" : "החלטה ב"}
+                </label>
+                <Select
+                  disabled={isPending}
+                  value={(slot === "a" ? a : b) ?? ""}
+                  onValueChange={(v) => (slot === "a" ? setA(v) : setB(v))}
+                  dir="rtl"
+                >
+                  <SelectTrigger>
+                    <SelectValue placeholder={isPending ? "טוען…" : "בחר החלטה"} />
+                  </SelectTrigger>
+                  <SelectContent className="max-h-[300px]">
+                    {corpus?.map((c) => (
+                      <SelectItem key={c.id} value={c.id}>
+                        {c.decision_number || "—"}
+                        {c.decision_date ? ` · ${c.decision_date}` : ""}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              </div>
+            ))}
+          </div>
+        </CardContent>
+      </Card>
+
+      {a && b && a === b && (
+        <p className="text-ink-muted text-sm text-center">בחר שתי החלטות שונות</p>
+      )}
+
+      {cmp.error && (
+        <Card className="bg-danger-bg border-danger/40">
+          <CardContent className="px-6 py-5 text-danger text-center">
+            {cmp.error.message}
+          </CardContent>
+        </Card>
+      )}
+
+      {cmp.isPending && a && b && a !== b && (
+        <Skeleton className="h-60 w-full" />
+      )}
+
+      {cmp.data && (
+        <>
+          <div className="grid gap-4 md:grid-cols-2">
+            <SideColumn side={cmp.data.a} />
+            <SideColumn side={cmp.data.b} />
+          </div>
+          <div className="grid gap-4 md:grid-cols-3">
+            <PatternList title="דפוסים משותפים" items={cmp.data.shared} tone="shared" />
+            <PatternList title="רק בהחלטה א" items={cmp.data.only_a} tone="a" />
+            <PatternList title="רק בהחלטה ב" items={cmp.data.only_b} tone="b" />
+          </div>
+        </>
+      )}
+    </div>
+  );
+}

web-ui/src/components/training/corpus-panel.tsx

@@ -0,0 +1,140 @@
+"use client";
+
+import { Trash2 } from "lucide-react";
+import { toast } from "sonner";
+import {
+  Table, TableBody, TableCell, TableHead, TableHeader, TableRow,
+} from "@/components/ui/table";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import { Skeleton } from "@/components/ui/skeleton";
+import { useCorpus, useDeleteCorpusEntry, type CorpusDecision } from "@/lib/api/training";
+
+/*
+ * Corpus tab: table of all decisions currently in the style corpus, with a
+ * single destructive action (remove from corpus). Uses browser confirm() for
+ * the confirmation — a full shadcn AlertDialog would be overkill for an
+ * admin-only destructive action with a server-side safety net.
+ */
+
+function formatChars(n: number) {
+  return `${(n / 1000).toFixed(1)}K`;
+}
+
+function formatDate(iso: string) {
+  if (!iso) return "—";
+  try {
+    return new Date(iso).toLocaleDateString("he-IL");
+  } catch {
+    return iso;
+  }
+}
+
+function Row({ item }: { item: CorpusDecision }) {
+  const del = useDeleteCorpusEntry();
+  const onDelete = async () => {
+    if (!window.confirm(`למחוק את החלטה ${item.decision_number} מהקורפוס?`)) return;
+    try {
+      await del.mutateAsync(item.id);
+      toast.success("נמחק מהקורפוס");
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "שגיאה במחיקה");
+    }
+  };
+
+  return (
+    <TableRow className="border-rule hover:bg-gold-wash/30">
+      <TableCell className="font-semibold text-navy tabular-nums">
+        {item.decision_number || "—"}
+      </TableCell>
+      <TableCell className="text-ink-muted tabular-nums">
+        {formatDate(item.decision_date)}
+      </TableCell>
+      <TableCell>
+        {item.subject_categories.length === 0 ? (
+          <span className="text-ink-light">—</span>
+        ) : (
+          <div className="flex flex-wrap gap-1">
+            {item.subject_categories.map((s) => (
+              <Badge
+                key={s}
+                variant="outline"
+                className="text-[0.7rem] bg-gold-wash text-gold-deep border-gold/40"
+              >
+                {s}
+              </Badge>
+            ))}
+          </div>
+        )}
+      </TableCell>
+      <TableCell className="text-ink-soft tabular-nums">
+        {formatChars(item.chars)}
+      </TableCell>
+      <TableCell className="text-ink-muted tabular-nums text-[0.78rem]">
+        {formatDate(item.created_at)}
+      </TableCell>
+      <TableCell className="text-end">
+        <Button
+          variant="ghost"
+          size="sm"
+          onClick={onDelete}
+          disabled={del.isPending}
+          aria-label={`הסר את ${item.decision_number || "החלטה זו"} מהקורפוס`}
+          className="text-danger hover:text-danger hover:bg-danger-bg"
+        >
+          <Trash2 className="w-4 h-4" aria-hidden="true" />
+        </Button>
+      </TableCell>
+    </TableRow>
+  );
+}
+
+export function CorpusPanel() {
+  const { data, isPending, error } = useCorpus();
+
+  if (error) {
+    return (
+      <div className="rounded bg-danger-bg border border-danger/40 px-6 py-5 text-danger text-center">
+        {error.message}
+      </div>
+    );
+  }
+
+  return (
+    <div className="rounded-lg border border-rule bg-surface shadow-sm overflow-hidden">
+      <Table>
+        <TableHeader className="bg-rule-soft/60">
+          <TableRow className="border-rule">
+            <TableHead className="text-navy text-right">מס׳ החלטה</TableHead>
+            <TableHead className="text-navy text-right">תאריך</TableHead>
+            <TableHead className="text-navy text-right">נושאים</TableHead>
+            <TableHead className="text-navy text-right">תווים</TableHead>
+            <TableHead className="text-navy text-right">נוסף בתאריך</TableHead>
+            <TableHead className="text-navy" />
+          </TableRow>
+        </TableHeader>
+        <TableBody>
+          {isPending ? (
+            [...Array(4)].map((_, i) => (
+              <TableRow key={i} className="border-rule">
+                {[...Array(6)].map((_, j) => (
+                  <TableCell key={j}>
+                    <Skeleton className="h-4 w-24" />
+                  </TableCell>
+                ))}
+              </TableRow>
+            ))
+          ) : data?.length === 0 ? (
+            <TableRow>
+              <TableCell colSpan={6} className="text-center text-ink-muted py-12">
+                הקורפוס ריק
+              </TableCell>
+            </TableRow>
+          ) : (
+            data?.map((item) => <Row key={item.id} item={item} />)
+          )}
+        </TableBody>
+      </Table>
+    </div>
+  );
+}

web-ui/src/components/training/style-report-panel.tsx

@@ -0,0 +1,195 @@
+"use client";
+
+import { Card, CardContent } from "@/components/ui/card";
+import { Skeleton } from "@/components/ui/skeleton";
+import { SubjectDonut } from "@/components/training/subject-donut";
+import { useStyleReport } from "@/lib/api/training";
+
+function KPICard({
+  label,
+  value,
+  caption,
+}: {
+  label: string;
+  value: string;
+  caption?: string;
+}) {
+  return (
+    <Card className="bg-surface border-rule shadow-sm">
+      <CardContent className="px-5 py-4 flex flex-col gap-0.5">
+        <span className="text-[0.72rem] uppercase tracking-[0.08em] text-ink-muted">
+          {label}
+        </span>
+        <span className="font-display text-[2rem] font-black leading-none text-navy">
+          {value}
+        </span>
+        {caption && (
+          <span className="text-[0.78rem] text-ink-muted mt-1">{caption}</span>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
+export function StyleReportPanel() {
+  const { data, isPending, error } = useStyleReport();
+
+  if (error) {
+    return (
+      <Card className="bg-danger-bg border-danger/40">
+        <CardContent className="px-6 py-5 text-center text-danger">
+          {error.message}
+        </CardContent>
+      </Card>
+    );
+  }
+
+  if (isPending || !data) {
+    return (
+      <div className="space-y-4">
+        <Skeleton className="h-24 w-full" />
+        <Skeleton className="h-40 w-full" />
+      </div>
+    );
+  }
+
+  const c = data.corpus;
+  const dateRange =
+    c.date_range[0] && c.date_range[1]
+      ? `${c.date_range[0]} – ${c.date_range[1]}`
+      : undefined;
+  const total = c.decision_count;
+  const totalSubjects = c.subject_distribution.reduce((a, b) => a + b.count, 0);
+
+  return (
+    <div className="space-y-6">
+      {/* Headline */}
+      <Card className="bg-gold-wash border-gold/40 shadow-sm">
+        <CardContent className="px-6 py-4">
+          <p className="font-display text-gold-deep text-lg font-semibold leading-snug">
+            ★ {c.headline}
+          </p>
+        </CardContent>
+      </Card>
+
+      {/* KPIs */}
+      <div className="grid gap-4 grid-cols-2 lg:grid-cols-4">
+        <KPICard label="החלטות בקורפוס" value={String(c.decision_count)} />
+        <KPICard
+          label="סך תווים"
+          value={`${(c.total_chars / 1000).toFixed(0)}K`}
+        />
+        <KPICard
+          label="ממוצע להחלטה"
+          value={`${(c.avg_chars / 1000).toFixed(1)}K`}
+        />
+        <KPICard
+          label="דפוסי סגנון"
+          value={String(data.signature_phrases.items.length)}
+          caption={`מתוך ${data.contribution.total_patterns} שחולצו`}
+        />
+      </div>
+
+      {/* Subjects + anatomy */}
+      <div className="grid gap-6 lg:grid-cols-2">
+        <Card className="bg-surface border-rule shadow-sm">
+          <CardContent className="px-6 py-5">
+            <h3 className="text-navy text-lg mb-4">פיזור נושאים</h3>
+            <SubjectDonut
+              segments={c.subject_distribution}
+              total={totalSubjects}
+            />
+            {dateRange && (
+              <p className="text-[0.72rem] text-ink-muted mt-4">
+                טווח תאריכים: {dateRange}
+              </p>
+            )}
+          </CardContent>
+        </Card>
+
+        <Card className="bg-surface border-rule shadow-sm">
+          <CardContent className="px-6 py-5">
+            <h3 className="text-navy text-lg mb-1">אנטומיה של החלטה ממוצעת</h3>
+            {data.anatomy.headline && (
+              <p className="text-[0.78rem] text-gold-deep mb-4">
+                {data.anatomy.headline}
+              </p>
+            )}
+            {data.anatomy.sections.length === 0 ? (
+              <p className="text-ink-muted text-sm">אין נתונים על מבנה</p>
+            ) : (
+              <ul className="space-y-2.5">
+                {data.anatomy.sections.map((s) => {
+                  const pct = Math.round(s.pct * 100);
+                  return (
+                    <li key={s.type} className="space-y-1">
+                      <div className="flex items-center justify-between text-[0.78rem]">
+                        <span className="text-ink-soft font-medium">
+                          {s.label}
+                        </span>
+                        <span className="text-ink-muted tabular-nums">
+                          {pct}% · {s.avg_chars.toLocaleString()} תווים
+                        </span>
+                      </div>
+                      <div className="h-2 rounded bg-rule-soft overflow-hidden">
+                        <div
+                          className="h-full bg-gradient-to-l from-gold to-gold-deep"
+                          style={{ width: `${pct}%` }}
+                        />
+                      </div>
+                    </li>
+                  );
+                })}
+              </ul>
+            )}
+          </CardContent>
+        </Card>
+      </div>
+
+      {/* Signature phrases */}
+      <Card className="bg-surface border-rule shadow-sm">
+        <CardContent className="px-6 py-5">
+          <h3 className="text-navy text-lg mb-1">ביטויי חתימה</h3>
+          {data.signature_phrases.headline && (
+            <p className="text-[0.78rem] text-gold-deep mb-4">
+              {data.signature_phrases.headline}
+            </p>
+          )}
+          {data.signature_phrases.items.length === 0 ? (
+            <p className="text-ink-muted text-sm">אין ביטויים שחולצו עדיין</p>
+          ) : (
+            <ol className="space-y-2">
+              {data.signature_phrases.items.slice(0, 12).map((p, i) => (
+                <li
+                  key={`${p.type}-${i}`}
+                  className="flex items-start gap-3 rounded border border-rule bg-parchment/40 px-3 py-2"
+                >
+                  <span className="text-[0.7rem] text-ink-muted tabular-nums shrink-0 mt-0.5">
+                    #{i + 1}
+                  </span>
+                  <div className="flex-1 min-w-0">
+                    <p className="text-ink leading-relaxed text-sm">{p.text}</p>
+                    {p.context && (
+                      <p className="text-[0.7rem] text-ink-muted mt-0.5">
+                        {p.context}
+                      </p>
+                    )}
+                  </div>
+                  <span
+                    className="
+                      shrink-0 text-[0.72rem] rounded-full
+                      bg-gold-wash text-gold-deep border border-gold/40
+                      px-2 py-0.5 tabular-nums
+                    "
+                  >
+                    ×{p.frequency}
+                  </span>
+                </li>
+              ))}
+            </ol>
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

web-ui/src/components/training/subject-donut.tsx

@@ -0,0 +1,72 @@
+"use client";
+
+/*
+ * Corpus subject-distribution donut.
+ *
+ * Pure CSS conic-gradient — same recipe as the cases StatusDonut, but
+ * uses a palette-of-gold instead of a status-tone palette. Ported from
+ * legal-ai/web/static/index.html `renderHero`.
+ */
+
+const DONUT_COLORS = [
+  "var(--color-navy)",
+  "var(--color-gold)",
+  "var(--color-info)",
+  "var(--color-warn)",
+  "var(--color-success)",
+  "var(--color-ink-muted)",
+  "var(--color-gold-deep)",
+];
+
+export function SubjectDonut({
+  segments,
+  total,
+}: {
+  segments: Array<{ label: string; count: number }>;
+  total: number;
+}) {
+  let pct = 0;
+  const parts = segments.map((s, i) => {
+    const start = total === 0 ? 0 : (pct / total) * 360;
+    pct += s.count;
+    const end = total === 0 ? 360 : (pct / total) * 360;
+    return { ...s, start, end, color: DONUT_COLORS[i % DONUT_COLORS.length] };
+  });
+
+  const background =
+    total === 0
+      ? "conic-gradient(var(--color-rule-soft) 0deg 360deg)"
+      : `conic-gradient(${parts
+          .map((p) => `${p.color} ${p.start}deg ${p.end}deg`)
+          .join(", ")})`;
+
+  return (
+    <div className="flex items-center gap-6">
+      <div
+        className="relative w-[140px] h-[140px] rounded-full shadow-sm shrink-0"
+        style={{ background }}
+        aria-label="פיזור נושאים בקורפוס"
+      >
+        <div className="absolute inset-[18px] bg-surface rounded-full flex flex-col items-center justify-center">
+          <span className="font-display text-2xl font-black text-navy leading-none">
+            {total}
+          </span>
+          <span className="text-[0.7rem] text-ink-muted mt-1">החלטות</span>
+        </div>
+      </div>
+
+      <ul className="flex flex-col gap-1.5 text-sm min-w-0">
+        {parts.map((p) => (
+          <li key={p.label} className="flex items-center gap-2">
+            <span
+              className="inline-block w-2.5 h-2.5 rounded-full shrink-0"
+              style={{ background: p.color }}
+            />
+            <span className="text-ink-soft truncate">{p.label}</span>
+            <span className="text-ink-muted tabular-nums ms-1">{p.count}</span>
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}

web-ui/src/components/ui/dialog.tsx

@@ -0,0 +1,168 @@
+"use client"
+
+import * as React from "react"
+import { Dialog as DialogPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+import { Button } from "@/components/ui/button"
+import { XIcon } from "lucide-react"
+
+function Dialog({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Root>) {
+  return <DialogPrimitive.Root data-slot="dialog" {...props} />
+}
+
+function DialogTrigger({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Trigger>) {
+  return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />
+}
+
+function DialogPortal({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Portal>) {
+  return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />
+}
+
+function DialogClose({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Close>) {
+  return <DialogPrimitive.Close data-slot="dialog-close" {...props} />
+}
+
+function DialogOverlay({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Overlay>) {
+  return (
+    <DialogPrimitive.Overlay
+      data-slot="dialog-overlay"
+      className={cn(
+        "fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function DialogContent({
+  className,
+  children,
+  showCloseButton = true,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Content> & {
+  showCloseButton?: boolean
+}) {
+  return (
+    <DialogPortal>
+      <DialogOverlay />
+      <DialogPrimitive.Content
+        data-slot="dialog-content"
+        className={cn(
+          "fixed top-1/2 start-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 rtl:translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl bg-popover p-4 text-sm text-popover-foreground ring-1 ring-foreground/10 duration-100 outline-none sm:max-w-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        {showCloseButton && (
+          <DialogPrimitive.Close data-slot="dialog-close" asChild>
+            <Button
+              variant="ghost"
+              className="absolute top-2 end-2"
+              size="icon-sm"
+            >
+              <XIcon
+              />
+              <span className="sr-only">Close</span>
+            </Button>
+          </DialogPrimitive.Close>
+        )}
+      </DialogPrimitive.Content>
+    </DialogPortal>
+  )
+}
+
+function DialogHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="dialog-header"
+      className={cn("flex flex-col gap-2", className)}
+      {...props}
+    />
+  )
+}
+
+function DialogFooter({
+  className,
+  showCloseButton = false,
+  children,
+  ...props
+}: React.ComponentProps<"div"> & {
+  showCloseButton?: boolean
+}) {
+  return (
+    <div
+      data-slot="dialog-footer"
+      className={cn(
+        "-mx-4 -mb-4 flex flex-col-reverse gap-2 rounded-b-xl border-t bg-muted/50 p-4 sm:flex-row sm:justify-end",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      {showCloseButton && (
+        <DialogPrimitive.Close asChild>
+          <Button variant="outline">Close</Button>
+        </DialogPrimitive.Close>
+      )}
+    </div>
+  )
+}
+
+function DialogTitle({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Title>) {
+  return (
+    <DialogPrimitive.Title
+      data-slot="dialog-title"
+      className={cn(
+        "font-heading text-base leading-none font-medium",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function DialogDescription({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Description>) {
+  return (
+    <DialogPrimitive.Description
+      data-slot="dialog-description"
+      className={cn(
+        "text-sm text-muted-foreground *:[a]:underline *:[a]:underline-offset-3 *:[a]:hover:text-foreground",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export {
+  Dialog,
+  DialogClose,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogOverlay,
+  DialogPortal,
+  DialogTitle,
+  DialogTrigger,
+}

web-ui/src/components/ui/label.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import * as React from "react"
+import { Label as LabelPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }

web-ui/src/components/ui/markdown.tsx

@@ -0,0 +1,116 @@
+"use client";
+
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+
+/*
+ * Tiny markdown renderer for Hebrew prose blocks — paragraphs, lists,
+ * emphasis, and GFM tables (the main reason this exists). The parsed
+ * research_md fields and the conclusions field both contain tables
+ * like "ציר דיוני" that we want to render as real <table>s, RTL, with
+ * auto-sized columns that line up row-to-row.
+ *
+ * Table styling uses `table-auto` + `whitespace-nowrap` on header cells
+ * so the column widths are dictated by the longest cell in that column,
+ * and every row's borders align exactly underneath each other. The
+ * overflow-x-auto wrapper catches extremely wide tables on narrow
+ * viewports without letting the parent card grow.
+ */
+
+export function Markdown({ content }: { content: string }) {
+  return (
+    <div className="prose-md text-sm text-ink-soft leading-relaxed" dir="rtl">
+      <ReactMarkdown
+        remarkPlugins={[remarkGfm]}
+        components={{
+          p: ({ node: _n, ...props }) => (
+            <p className="mb-2 last:mb-0 text-justify" {...props} />
+          ),
+          strong: ({ node: _n, ...props }) => (
+            <strong className="text-navy font-semibold" {...props} />
+          ),
+          em: ({ node: _n, ...props }) => (
+            <em className="text-ink" {...props} />
+          ),
+          a: ({ node: _n, ...props }) => (
+            <a
+              className="text-gold-deep hover:text-gold underline underline-offset-2"
+              target="_blank"
+              rel="noreferrer"
+              {...props}
+            />
+          ),
+          ul: ({ node: _n, ...props }) => (
+            <ul className="list-disc ps-5 mb-2 space-y-1" {...props} />
+          ),
+          ol: ({ node: _n, ...props }) => (
+            <ol className="list-decimal ps-5 mb-2 space-y-1" {...props} />
+          ),
+          li: ({ node: _n, ...props }) => (
+            <li className="text-ink" {...props} />
+          ),
+          h1: ({ node: _n, ...props }) => (
+            <h3 className="text-navy text-base font-semibold mt-3 mb-1" {...props} />
+          ),
+          h2: ({ node: _n, ...props }) => (
+            <h4 className="text-navy text-sm font-semibold mt-3 mb-1" {...props} />
+          ),
+          h3: ({ node: _n, ...props }) => (
+            <h5 className="text-navy text-sm font-semibold mt-2 mb-1" {...props} />
+          ),
+          blockquote: ({ node: _n, ...props }) => (
+            <blockquote
+              className="border-e-2 border-gold-soft pe-3 text-ink italic my-2"
+              {...props}
+            />
+          ),
+          code: ({ node: _n, ...props }) => (
+            <code
+              className="rounded bg-rule-soft px-1 py-0.5 font-mono text-[0.78rem] text-ink"
+              {...props}
+            />
+          ),
+          /* ── Tables ─────────────────────────────────────────────────
+             Wrapped in an overflow-x-auto so very wide tables don't push
+             the parent card out of its track. table-auto lets the browser
+             size columns by their longest cell (that's what keeps borders
+             aligned row-to-row) and whitespace-nowrap on the headers
+             ensures the header row sets column widths instead of
+             breaking mid-word. */
+          table: ({ node: _n, ...props }) => (
+            <div className="my-3 -mx-1 overflow-x-auto">
+              <table
+                className="w-full table-auto border-collapse border border-rule text-sm text-right"
+                {...props}
+              />
+            </div>
+          ),
+          thead: ({ node: _n, ...props }) => (
+            <thead className="bg-rule-soft/70" {...props} />
+          ),
+          tbody: ({ node: _n, ...props }) => <tbody {...props} />,
+          tr: ({ node: _n, ...props }) => (
+            <tr className="border-b border-rule last:border-b-0" {...props} />
+          ),
+          th: ({ node: _n, ...props }) => (
+            <th
+              className="border border-rule px-3 py-2 text-right text-navy font-semibold whitespace-nowrap align-top"
+              {...props}
+            />
+          ),
+          td: ({ node: _n, ...props }) => (
+            <td
+              className="border border-rule px-3 py-2 text-right text-ink align-top"
+              {...props}
+            />
+          ),
+          hr: ({ node: _n, ...props }) => (
+            <hr className="my-3 border-rule" {...props} />
+          ),
+        }}
+      >
+        {content}
+      </ReactMarkdown>
+    </div>
+  );
+}

web-ui/src/components/ui/popover.tsx

@@ -0,0 +1,89 @@
+"use client"
+
+import * as React from "react"
+import { Popover as PopoverPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+
+function Popover({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Root>) {
+  return <PopoverPrimitive.Root data-slot="popover" {...props} />
+}
+
+function PopoverTrigger({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
+  return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />
+}
+
+function PopoverContent({
+  className,
+  align = "center",
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Content>) {
+  return (
+    <PopoverPrimitive.Portal>
+      <PopoverPrimitive.Content
+        data-slot="popover-content"
+        align={align}
+        sideOffset={sideOffset}
+        className={cn(
+          "z-50 flex w-72 origin-(--radix-popover-content-transform-origin) flex-col gap-2.5 rounded-lg bg-popover p-2.5 text-sm text-popover-foreground shadow-md ring-1 ring-foreground/10 outline-hidden duration-100 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
+          className
+        )}
+        {...props}
+      />
+    </PopoverPrimitive.Portal>
+  )
+}
+
+function PopoverAnchor({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
+  return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />
+}
+
+function PopoverHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="popover-header"
+      className={cn("flex flex-col gap-0.5 text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function PopoverTitle({ className, ...props }: React.ComponentProps<"h2">) {
+  return (
+    <div
+      data-slot="popover-title"
+      className={cn("font-heading font-medium", className)}
+      {...props}
+    />
+  )
+}
+
+function PopoverDescription({
+  className,
+  ...props
+}: React.ComponentProps<"p">) {
+  return (
+    <p
+      data-slot="popover-description"
+      className={cn("text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Popover,
+  PopoverAnchor,
+  PopoverContent,
+  PopoverDescription,
+  PopoverHeader,
+  PopoverTitle,
+  PopoverTrigger,
+}

web-ui/src/components/ui/progress.tsx

@@ -0,0 +1,31 @@
+"use client"
+
+import * as React from "react"
+import { Progress as ProgressPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+
+function Progress({
+  className,
+  value,
+  ...props
+}: React.ComponentProps<typeof ProgressPrimitive.Root>) {
+  return (
+    <ProgressPrimitive.Root
+      data-slot="progress"
+      className={cn(
+        "relative flex h-1 w-full items-center overflow-x-hidden rounded-full bg-muted",
+        className
+      )}
+      {...props}
+    >
+      <ProgressPrimitive.Indicator
+        data-slot="progress-indicator"
+        className="size-full flex-1 bg-primary transition-all"
+        style={{ transform: `translateX(-${100 - (value || 0)}%)` }}
+      />
+    </ProgressPrimitive.Root>
+  )
+}
+
+export { Progress }

web-ui/src/components/ui/select.tsx

@@ -0,0 +1,192 @@
+"use client"
+
+import * as React from "react"
+import { Select as SelectPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+import { ChevronDownIcon, CheckIcon, ChevronUpIcon } from "lucide-react"
+
+function Select({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Root>) {
+  return <SelectPrimitive.Root data-slot="select" {...props} />
+}
+
+function SelectGroup({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Group>) {
+  return (
+    <SelectPrimitive.Group
+      data-slot="select-group"
+      className={cn("scroll-my-1 p-1", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectValue({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Value>) {
+  return <SelectPrimitive.Value data-slot="select-value" {...props} />
+}
+
+function SelectTrigger({
+  className,
+  size = "default",
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Trigger> & {
+  size?: "sm" | "default"
+}) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      data-size={size}
+      className={cn(
+        "flex w-fit items-center justify-between gap-1.5 rounded-lg border border-input bg-transparent py-2 pe-2 ps-2.5 text-sm whitespace-nowrap transition-colors outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 data-placeholder:text-muted-foreground data-[size=default]:h-8 data-[size=sm]:h-7 data-[size=sm]:rounded-[min(var(--radius-md),10px)] *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-1.5 dark:bg-input/30 dark:hover:bg-input/50 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon asChild>
+        <ChevronDownIcon className="pointer-events-none size-4 text-muted-foreground" />
+      </SelectPrimitive.Icon>
+    </SelectPrimitive.Trigger>
+  )
+}
+
+function SelectContent({
+  className,
+  children,
+  position = "item-aligned",
+  align = "center",
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Content>) {
+  return (
+    <SelectPrimitive.Portal>
+      <SelectPrimitive.Content
+        data-slot="select-content"
+        data-align-trigger={position === "item-aligned"}
+        className={cn("relative z-50 max-h-(--radix-select-content-available-height) min-w-36 origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-lg bg-popover text-popover-foreground shadow-md ring-1 ring-foreground/10 duration-100 data-[align-trigger=true]:animate-none data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", position ==="popper"&&"data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 rtl:data-[side=left]:translate-x-1 data-[side=right]:translate-x-1 rtl:data-[side=right]:-translate-x-1 data-[side=top]:-translate-y-1", className )}
+        position={position}
+        align={align}
+        {...props}
+      >
+        <SelectScrollUpButton />
+        <SelectPrimitive.Viewport
+          data-position={position}
+          className={cn(
+            "data-[position=popper]:h-(--radix-select-trigger-height) data-[position=popper]:w-full data-[position=popper]:min-w-(--radix-select-trigger-width)",
+            position === "popper" && ""
+          )}
+        >
+          {children}
+        </SelectPrimitive.Viewport>
+        <SelectScrollDownButton />
+      </SelectPrimitive.Content>
+    </SelectPrimitive.Portal>
+  )
+}
+
+function SelectLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Label>) {
+  return (
+    <SelectPrimitive.Label
+      data-slot="select-label"
+      className={cn("px-1.5 py-1 text-xs text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Item>) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "relative flex w-full cursor-default items-center gap-1.5 rounded-md py-1 pe-8 ps-1.5 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute end-2 flex size-4 items-center justify-center">
+        <SelectPrimitive.ItemIndicator>
+          <CheckIcon className="pointer-events-none" />
+        </SelectPrimitive.ItemIndicator>
+      </span>
+      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
+    </SelectPrimitive.Item>
+  )
+}
+
+function SelectSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Separator>) {
+  return (
+    <SelectPrimitive.Separator
+      data-slot="select-separator"
+      className={cn("pointer-events-none -mx-1 my-1 h-px bg-border", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectScrollUpButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>) {
+  return (
+    <SelectPrimitive.ScrollUpButton
+      data-slot="select-scroll-up-button"
+      className={cn(
+        "z-10 flex cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <ChevronUpIcon
+      />
+    </SelectPrimitive.ScrollUpButton>
+  )
+}
+
+function SelectScrollDownButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>) {
+  return (
+    <SelectPrimitive.ScrollDownButton
+      data-slot="select-scroll-down-button"
+      className={cn(
+        "z-10 flex cursor-default items-center justify-center bg-popover py-1 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <ChevronDownIcon
+      />
+    </SelectPrimitive.ScrollDownButton>
+  )
+}
+
+export {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectScrollDownButton,
+  SelectScrollUpButton,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+}

web-ui/src/components/ui/sonner.tsx

@@ -0,0 +1,49 @@
+"use client"
+
+import { useTheme } from "next-themes"
+import { Toaster as Sonner, type ToasterProps } from "sonner"
+import { CircleCheckIcon, InfoIcon, TriangleAlertIcon, OctagonXIcon, Loader2Icon } from "lucide-react"
+
+const Toaster = ({ ...props }: ToasterProps) => {
+  const { theme = "system" } = useTheme()
+
+  return (
+    <Sonner
+      theme={theme as ToasterProps["theme"]}
+      className="toaster group"
+      icons={{
+        success: (
+          <CircleCheckIcon className="size-4" />
+        ),
+        info: (
+          <InfoIcon className="size-4" />
+        ),
+        warning: (
+          <TriangleAlertIcon className="size-4" />
+        ),
+        error: (
+          <OctagonXIcon className="size-4" />
+        ),
+        loading: (
+          <Loader2Icon className="size-4 animate-spin" />
+        ),
+      }}
+      style={
+        {
+          "--normal-bg": "var(--popover)",
+          "--normal-text": "var(--popover-foreground)",
+          "--normal-border": "var(--border)",
+          "--border-radius": "var(--radius)",
+        } as React.CSSProperties
+      }
+      toastOptions={{
+        classNames: {
+          toast: "cn-toast",
+        },
+      }}
+      {...props}
+    />
+  )
+}
+
+export { Toaster }

web-ui/src/components/ui/textarea.tsx

@@ -0,0 +1,18 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        "flex field-sizing-content min-h-16 w-full rounded-lg border border-input bg-transparent px-2.5 py-2 text-base transition-colors outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 md:text-sm dark:bg-input/30 dark:disabled:bg-input/80 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Textarea }

web-ui/src/components/wizard/case-wizard.tsx

@@ -0,0 +1,344 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import { useRouter } from "next/navigation";
+import { useForm, Controller } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { toast } from "sonner";
+import { Card, CardContent } from "@/components/ui/card";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
+import { Label } from "@/components/ui/label";
+import {
+  Select, SelectContent, SelectItem, SelectTrigger, SelectValue,
+} from "@/components/ui/select";
+import { PartiesField } from "@/components/wizard/parties-field";
+import { useCreateCase } from "@/lib/api/cases";
+import {
+  caseCreateSchema, expectedOutcomes,
+  type CaseCreateInput,
+} from "@/lib/schemas/case";
+import {
+  PRACTICE_AREAS, APPEAL_SUBTYPES, deriveSubtype,
+  type AppealSubtype,
+} from "@/lib/practice-area";
+
+const STEPS = [
+  { key: "basics",  label: "פרטי יסוד" },
+  { key: "parties", label: "צדדים"      },
+  { key: "details", label: "השלמות"     },
+] as const;
+
+type StepKey = (typeof STEPS)[number]["key"];
+
+/* Fields validated at each step — lets the user fix just what's on screen
+ * before moving forward, instead of surfacing all errors from page 1. */
+const STEP_FIELDS: Record<StepKey, (keyof CaseCreateInput)[]> = {
+  basics:  ["case_number", "title", "practice_area", "appeal_subtype"],
+  parties: ["appellants", "respondents"],
+  details: ["subject", "hearing_date", "expected_outcome", "notes", "property_address", "permit_number"],
+};
+
+function FieldError({ message }: { message?: string }) {
+  if (!message) return null;
+  return <p className="text-[0.72rem] text-danger mt-1">{message}</p>;
+}
+
+export function CaseWizard() {
+  const router = useRouter();
+  const [step, setStep] = useState<StepKey>("basics");
+  const mutate = useCreateCase();
+
+  const form = useForm<CaseCreateInput>({
+    resolver: zodResolver(caseCreateSchema),
+    mode: "onBlur",
+    defaultValues: {
+      case_number: "",
+      title: "",
+      appellants: [],
+      respondents: [],
+      subject: "",
+      property_address: "",
+      permit_number: "",
+      hearing_date: "",
+      notes: "",
+      expected_outcome: "",
+      practice_area: "appeals_committee",
+      appeal_subtype: "unknown",
+    },
+  });
+
+  /*
+   * Auto-fill appeal_subtype from the case number as the user types, but
+   * stop the moment they manually pick a value from the dropdown. Mirrors
+   * the wireSubtypeAutofill() behaviour of the vanilla UI
+   * (legal-ai/web/static/index.html around line 2770).
+   */
+  const userTouchedSubtype = useRef(false);
+  const caseNumber = form.watch("case_number");
+  const practiceArea = form.watch("practice_area");
+  useEffect(() => {
+    if (userTouchedSubtype.current) return;
+    const derived = deriveSubtype(caseNumber, practiceArea);
+    if (derived !== form.getValues("appeal_subtype")) {
+      form.setValue("appeal_subtype", derived, { shouldValidate: false });
+    }
+  }, [caseNumber, practiceArea, form]);
+
+  const stepIndex = STEPS.findIndex((s) => s.key === step);
+  const isLast = stepIndex === STEPS.length - 1;
+
+  const goNext = async () => {
+    const ok = await form.trigger(STEP_FIELDS[step]);
+    if (!ok) return;
+    setStep(STEPS[stepIndex + 1].key);
+  };
+  const goBack = () => setStep(STEPS[stepIndex - 1].key);
+
+  const onSubmit = form.handleSubmit(async (values) => {
+    try {
+      const res = await mutate.mutateAsync(values);
+      toast.success("תיק חדש נוצר");
+      const created = res?.case_number || values.case_number;
+      router.push(`/cases/${encodeURIComponent(created)}`);
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "שגיאה ביצירת תיק");
+    }
+  });
+
+  return (
+    <Card className="bg-surface border-rule shadow-sm max-w-3xl">
+      <CardContent className="px-6 py-6 space-y-6">
+        {/* Stepper */}
+        <ol className="flex items-center gap-2 text-sm">
+          {STEPS.map((s, i) => {
+            const active = i === stepIndex;
+            const done = i < stepIndex;
+            return (
+              <li key={s.key} className="flex items-center gap-2">
+                <span
+                  className={`
+                    inline-flex items-center justify-center w-7 h-7 rounded-full
+                    font-display font-bold text-sm tabular-nums transition-colors
+                    ${done ? "bg-success text-parchment" : active ? "bg-navy text-parchment" : "bg-rule text-ink-muted"}
+                  `}
+                >
+                  {done ? "✓" : i + 1}
+                </span>
+                <span className={active ? "text-navy font-semibold" : "text-ink-muted"}>
+                  {s.label}
+                </span>
+                {i < STEPS.length - 1 && (
+                  <span className="w-8 h-px bg-rule mx-1" aria-hidden />
+                )}
+              </li>
+            );
+          })}
+        </ol>
+
+        <form onSubmit={onSubmit} className="space-y-5">
+          {step === "basics" && (
+            <div className="space-y-4">
+              <div>
+                <Label htmlFor="case_number" className="text-navy">
+                  מספר תיק <span className="text-danger">*</span>
+                </Label>
+                <Input
+                  id="case_number"
+                  placeholder="1033-25 או 1000-04-26"
+                  {...form.register("case_number")}
+                  className="mt-1 tabular-nums"
+                />
+                <FieldError message={form.formState.errors.case_number?.message} />
+              </div>
+              <div>
+                <Label htmlFor="title" className="text-navy">
+                  כותרת <span className="text-danger">*</span>
+                </Label>
+                <Input id="title" {...form.register("title")} className="mt-1" />
+                <FieldError message={form.formState.errors.title?.message} />
+              </div>
+              <div className="grid grid-cols-2 gap-3">
+                <div>
+                  <Label className="text-navy">תחום משפטי</Label>
+                  <Controller
+                    control={form.control}
+                    name="practice_area"
+                    render={({ field }) => (
+                      <Select value={field.value} onValueChange={field.onChange} dir="rtl">
+                        <SelectTrigger className="mt-1">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          {PRACTICE_AREAS.map((p) => (
+                            <SelectItem
+                              key={p.value}
+                              value={p.value}
+                              disabled={!p.enabled}
+                            >
+                              {p.label}{!p.enabled && " (בקרוב)"}
+                            </SelectItem>
+                          ))}
+                        </SelectContent>
+                      </Select>
+                    )}
+                  />
+                </div>
+                <div>
+                  <Label className="text-navy">סוג ערר</Label>
+                  <Controller
+                    control={form.control}
+                    name="appeal_subtype"
+                    render={({ field }) => (
+                      <Select
+                        value={field.value}
+                        onValueChange={(v) => {
+                          userTouchedSubtype.current = true;
+                          field.onChange(v as AppealSubtype);
+                        }}
+                        dir="rtl"
+                      >
+                        <SelectTrigger className="mt-1">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          {APPEAL_SUBTYPES.map((s) => (
+                            <SelectItem key={s.value} value={s.value}>
+                              {s.label}
+                            </SelectItem>
+                          ))}
+                        </SelectContent>
+                      </Select>
+                    )}
+                  />
+                  <p className="text-[0.7rem] text-ink-muted mt-1">
+                    מזוהה אוטומטית ממספר התיק
+                  </p>
+                </div>
+              </div>
+            </div>
+          )}
+
+          {step === "parties" && (
+            <div className="space-y-5">
+              <Controller
+                control={form.control}
+                name="appellants"
+                render={({ field, fieldState }) => (
+                  <PartiesField
+                    label="עוררים *"
+                    value={field.value}
+                    onChange={field.onChange}
+                    error={fieldState.error?.message}
+                  />
+                )}
+              />
+              <div className="h-px bg-rule" />
+              <Controller
+                control={form.control}
+                name="respondents"
+                render={({ field, fieldState }) => (
+                  <PartiesField
+                    label="משיבים *"
+                    value={field.value}
+                    onChange={field.onChange}
+                    error={fieldState.error?.message}
+                  />
+                )}
+              />
+            </div>
+          )}
+
+          {step === "details" && (
+            <div className="space-y-4">
+              <div>
+                <Label htmlFor="subject" className="text-navy">נושא</Label>
+                <Input id="subject" {...form.register("subject")} className="mt-1" />
+              </div>
+              <div className="grid grid-cols-2 gap-3">
+                <div>
+                  <Label htmlFor="property_address" className="text-navy">כתובת הנכס</Label>
+                  <Input id="property_address" {...form.register("property_address")} className="mt-1" />
+                </div>
+                <div>
+                  <Label htmlFor="permit_number" className="text-navy">מס׳ תכנית/בקשה</Label>
+                  <Input id="permit_number" {...form.register("permit_number")} className="mt-1" />
+                </div>
+              </div>
+              <div className="grid grid-cols-2 gap-3">
+                <div>
+                  <Label htmlFor="hearing_date" className="text-navy">תאריך דיון</Label>
+                  <Input
+                    id="hearing_date"
+                    type="date"
+                    {...form.register("hearing_date")}
+                    className="mt-1 tabular-nums"
+                  />
+                  <FieldError message={form.formState.errors.hearing_date?.message} />
+                </div>
+                <div>
+                  <Label className="text-navy">תוצאה צפויה</Label>
+                  <Controller
+                    control={form.control}
+                    name="expected_outcome"
+                    render={({ field }) => (
+                      <Select
+                        value={field.value || "__none__"}
+                        onValueChange={(v) => field.onChange(v === "__none__" ? "" : v)}
+                        dir="rtl"
+                      >
+                        <SelectTrigger className="mt-1">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          {expectedOutcomes.map((o) => (
+                            <SelectItem key={o.value || "none"} value={o.value || "__none__"}>
+                              {o.label}
+                            </SelectItem>
+                          ))}
+                        </SelectContent>
+                      </Select>
+                    )}
+                  />
+                </div>
+              </div>
+              <div>
+                <Label htmlFor="notes" className="text-navy">הערות</Label>
+                <Textarea id="notes" rows={4} {...form.register("notes")} className="mt-1" />
+              </div>
+            </div>
+          )}
+
+          <div className="flex items-center justify-between gap-3 pt-2">
+            <Button
+              type="button"
+              variant="ghost"
+              onClick={goBack}
+              disabled={stepIndex === 0 || mutate.isPending}
+            >
+              ← הקודם
+            </Button>
+            {isLast ? (
+              <Button
+                type="submit"
+                disabled={mutate.isPending}
+                className="bg-navy hover:bg-navy-soft text-parchment"
+              >
+                {mutate.isPending ? "יוצר תיק…" : "צור תיק"}
+              </Button>
+            ) : (
+              <Button
+                type="button"
+                onClick={goNext}
+                className="bg-navy hover:bg-navy-soft text-parchment"
+              >
+                הבא →
+              </Button>
+            )}
+          </div>
+        </form>
+      </CardContent>
+    </Card>
+  );
+}

web-ui/src/components/wizard/parties-field.tsx

@@ -0,0 +1,95 @@
+"use client";
+
+import { useState } from "react";
+import { X, Plus } from "lucide-react";
+import { Input } from "@/components/ui/input";
+import { Button } from "@/components/ui/button";
+
+/*
+ * Minimal tag-style editor for a list of party names (appellants / respondents).
+ * Backed by a controlled string[] — submits as the same shape the FastAPI
+ * CaseCreateRequest expects. Enter adds the current draft; X removes a chip.
+ */
+
+export function PartiesField({
+  label,
+  value,
+  onChange,
+  error,
+}: {
+  label: string;
+  value: string[];
+  onChange: (next: string[]) => void;
+  error?: string;
+}) {
+  const [draft, setDraft] = useState("");
+
+  const add = () => {
+    const trimmed = draft.trim();
+    if (!trimmed) return;
+    if (value.includes(trimmed)) {
+      setDraft("");
+      return;
+    }
+    onChange([...value, trimmed]);
+    setDraft("");
+  };
+
+  const remove = (name: string) => {
+    onChange(value.filter((v) => v !== name));
+  };
+
+  return (
+    <div>
+      <label className="block text-sm font-medium text-navy mb-1.5">{label}</label>
+      {value.length > 0 && (
+        <ul className="flex flex-wrap gap-2 mb-2">
+          {value.map((name) => (
+            <li
+              key={name}
+              className="
+                inline-flex items-center gap-1.5 rounded-full
+                bg-gold-wash text-gold-deep border border-gold/40
+                px-3 py-1 text-sm
+              "
+            >
+              <span>{name}</span>
+              <button
+                type="button"
+                onClick={() => remove(name)}
+                className="hover:text-danger transition-colors"
+                aria-label={`הסר ${name}`}
+              >
+                <X className="w-3.5 h-3.5" />
+              </button>
+            </li>
+          ))}
+        </ul>
+      )}
+      <div className="flex gap-2">
+        <Input
+          value={draft}
+          onChange={(e) => setDraft(e.target.value)}
+          onKeyDown={(e) => {
+            if (e.key === "Enter") {
+              e.preventDefault();
+              add();
+            }
+          }}
+          placeholder="שם מלא של הצד"
+          dir="rtl"
+        />
+        <Button
+          type="button"
+          variant="outline"
+          size="sm"
+          onClick={add}
+          aria-label={`הוסף ${label}`}
+        >
+          <Plus className="w-4 h-4" aria-hidden="true" />
+        </Button>
+      </div>
+      {error && <p className="text-[0.72rem] text-danger mt-1">{error}</p>}
+    </div>
+  );
+}

web-ui/src/lib/api/cases.ts

@@ -8,8 +8,10 @@
  * surfaces as a runtime TypeScript error the first time a property is touched.
  */
 
-import { useQuery } from "@tanstack/react-query";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { apiRequest } from "./client";
+import type { CaseCreateInput, CaseUpdateInput } from "@/lib/schemas/case";
+import type { PracticeArea, AppealSubtype } from "@/lib/practice-area";
 
 export type CaseStatus =
   | "new"
@@ -34,6 +36,9 @@ export type Case = {
   expected_outcome?: string | null;
   created_at?: string;
   updated_at?: string;
+  /* Multi-tenant axis — populated by backfill + server-side derive */
+  practice_area?: PracticeArea;
+  appeal_subtype?: AppealSubtype;
   /* Present when loaded with detail=true */
   document_count?: number;
   processing_count?: number;
@@ -41,15 +46,21 @@ export type Case = {
   hearing_date?: string | null;
 };
 
+export type CaseDocument = {
+  id: string;
+  case_id: string;
+  doc_type: string;
+  title: string;
+  file_path: string;
+  page_count: number | null;
+  extraction_status: string;
+  created_at: string;
+  practice_area?: PracticeArea;
+  appeal_subtype?: AppealSubtype;
+};
+
 export type CaseDetail = Case & {
-  documents?: Array<{
-    id: number | string;
-    filename: string;
-    category?: string | null;
-    status?: string;
-    uploaded_at?: string;
-    size_bytes?: number;
-  }>;
+  documents?: CaseDocument[];
   blocks?: Array<{ code: string; status?: string; char_count?: number }>;
 };
 
@@ -95,6 +106,41 @@ export type WorkflowStatus = {
   [key: string]: unknown;
 };
 
+export function useCreateCase() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (input: CaseCreateInput) =>
+      apiRequest<{ case_number?: string; message?: string; [k: string]: unknown }>(
+        `/api/cases/create`,
+        { method: "POST", body: input },
+      ),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: casesKeys.all });
+    },
+  });
+}
+
+export function useUpdateCase(caseNumber: string | undefined) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (input: CaseUpdateInput) =>
+      apiRequest<CaseDetail>(`/api/cases/${caseNumber}`, {
+        method: "PUT",
+        body: input,
+      }),
+    onSuccess: (data) => {
+      /* Patch cached detail and nudge the list to refetch on next focus */
+      if (caseNumber) {
+        qc.setQueryData<CaseDetail | undefined>(
+          casesKeys.detail(caseNumber),
+          (prev) => (prev ? { ...prev, ...data } : prev),
+        );
+      }
+      qc.invalidateQueries({ queryKey: casesKeys.all });
+    },
+  });
+}
+
 export function useWorkflowStatus(caseNumber: string | undefined) {
   return useQuery({
     queryKey: [...casesKeys.all, "workflow", caseNumber ?? ""] as const,

web-ui/src/lib/api/documents.ts

@@ -0,0 +1,111 @@
+/**
+ * Document upload + progress hooks.
+ *
+ * Upload hits `POST /api/cases/{n}/documents/upload-tagged` as multipart
+ * form-data (FastAPI UploadFile), and receives a `task_id` that streams
+ * progress events via `GET /api/progress/{task_id}` (SSE). We expose
+ * both as a single `useUploadDocument` mutation returning the task id
+ * plus a `useProgress(taskId)` hook that subscribes to the stream.
+ */
+
+import { useEffect, useState } from "react";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { ApiError } from "./client";
+import { casesKeys } from "./cases";
+import { openSSE } from "@/lib/sse";
+
+export type UploadTaggedResponse = {
+  task_id: string;
+  filename: string;
+  original_name: string;
+  doc_type: string;
+};
+
+export type ProgressEvent = {
+  status: "queued" | "processing" | "completed" | "failed" | string;
+  filename?: string;
+  step?: string;
+  error?: string;
+  result?: unknown;
+  case_number?: string;
+  doc_type?: string;
+};
+
+export type UploadVars = {
+  caseNumber: string;
+  file: File;
+  docType?: string;
+  partyName?: string;
+  title?: string;
+};
+
+async function uploadTagged({
+  caseNumber,
+  file,
+  docType = "auto",
+  partyName = "",
+  title = "",
+}: UploadVars): Promise<UploadTaggedResponse> {
+  const fd = new FormData();
+  fd.append("file", file);
+  fd.append("doc_type", docType);
+  fd.append("party_name", partyName);
+  fd.append("title", title);
+
+  const res = await fetch(
+    `/api/cases/${encodeURIComponent(caseNumber)}/documents/upload-tagged`,
+    { method: "POST", body: fd },
+  );
+  const contentType = res.headers.get("content-type") ?? "";
+  const parsed = contentType.includes("application/json")
+    ? await res.json().catch(() => null)
+    : await res.text().catch(() => null);
+  if (!res.ok) {
+    throw new ApiError(
+      `Upload failed with ${res.status}`,
+      res.status,
+      parsed,
+    );
+  }
+  return parsed as UploadTaggedResponse;
+}
+
+export function useUploadDocument(caseNumber: string) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (vars: Omit<UploadVars, "caseNumber">) =>
+      uploadTagged({ caseNumber, ...vars }),
+    onSuccess: () => {
+      /* Nudge the case detail to refetch so the new document row appears
+       * immediately — the actual "processing" badge will update once the
+       * SSE stream reports status=completed. */
+      qc.invalidateQueries({ queryKey: casesKeys.detail(caseNumber) });
+    },
+  });
+}
+
+export function useProgress(taskId: string | null) {
+  const [event, setEvent] = useState<ProgressEvent | null>(null);
+
+  useEffect(() => {
+    if (!taskId) return;
+    setEvent(null);
+    const close = openSSE<ProgressEvent>(
+      `/api/progress/${encodeURIComponent(taskId)}`,
+      {
+        onMessage: (data) => {
+          setEvent(data);
+          if (data.status === "completed" || data.status === "failed") {
+            /* Close from within the callback — the backend ends the stream
+             * naturally, but closing eagerly avoids the auto-reconnect loop
+             * EventSource does after EOF. */
+            close();
+          }
+        },
+      },
+    );
+    return () => close();
+  }, [taskId]);
+
+  return event;
+}

web-ui/src/lib/api/feedback.ts

@@ -0,0 +1,112 @@
+/**
+ * Chair feedback hooks — recording and managing Dafna's feedback on drafts.
+ */
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiRequest } from "./client";
+
+export type FeedbackCategory =
+  | "missing_content"
+  | "wrong_tone"
+  | "wrong_structure"
+  | "factual_error"
+  | "style"
+  | "other";
+
+export type ChairFeedback = {
+  id: string;
+  case_id: string | null;
+  case_number: string;
+  block_id: string;
+  category: FeedbackCategory;
+  feedback_text: string;
+  lesson_extracted: string;
+  resolved: boolean;
+  applied_to: string[];
+  created_at: string | null;
+};
+
+export type CreateFeedbackInput = {
+  case_number?: string;
+  block_id?: string;
+  feedback_text: string;
+  category?: FeedbackCategory;
+  lesson_extracted?: string;
+};
+
+const feedbackKeys = {
+  all: ["feedback"] as const,
+  list: (filters: { category?: string; unresolved_only?: boolean }) =>
+    [...feedbackKeys.all, "list", filters] as const,
+};
+
+export function useFeedbackList(filters: {
+  category?: string;
+  unresolved_only?: boolean;
+} = {}) {
+  const params = new URLSearchParams();
+  if (filters.category) params.set("category", filters.category);
+  if (filters.unresolved_only) params.set("unresolved_only", "true");
+  const qs = params.toString();
+
+  return useQuery({
+    queryKey: feedbackKeys.list(filters),
+    queryFn: ({ signal }) =>
+      apiRequest<ChairFeedback[]>(`/api/feedback${qs ? `?${qs}` : ""}`, { signal }),
+  });
+}
+
+export function useCreateFeedback() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (data: CreateFeedbackInput) =>
+      apiRequest<{ id: string; status: string }>("/api/feedback/json", {
+        method: "POST",
+        body: data,
+      }),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: feedbackKeys.all });
+    },
+  });
+}
+
+export function useResolveFeedback() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      feedbackId,
+      applied_to,
+    }: {
+      feedbackId: string;
+      applied_to: string[];
+    }) =>
+      apiRequest<{ status: string }>(
+        `/api/feedback/${feedbackId}/resolve`,
+        { method: "PATCH", body: { applied_to } },
+      ),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: feedbackKeys.all });
+    },
+  });
+}
+
+/** Hebrew labels for feedback categories */
+export const CATEGORY_LABELS: Record<FeedbackCategory, string> = {
+  missing_content: "תוכן חסר",
+  wrong_tone: "טון שגוי",
+  wrong_structure: "מבנה שגוי",
+  factual_error: "שגיאה עובדתית",
+  style: "סגנון",
+  other: "אחר",
+};
+
+/** Block ID labels */
+export const BLOCK_LABELS: Record<string, string> = {
+  "block-he": "ה — פתיחה",
+  "block-vav": "ו — רקע עובדתי",
+  "block-zayin": "ז — טענות הצדדים",
+  "block-chet": "ח — הליכים",
+  "block-tet": "ט — תכניות חלות",
+  "block-yod": "י — דיון והכרעה",
+  "block-yod-alef": "יא — סיכום",
+};

web-ui/src/lib/api/precedents.ts

@@ -0,0 +1,140 @@
+/**
+ * Attached-precedent hooks — user-supplied case-law quotes that
+ * justify chair positions in the compose screen.
+ *
+ * Backed by POST/GET/DELETE /api/cases/{n}/precedents and the
+ * cross-case library search at GET /api/precedents/search. The
+ * optional PDF archive chains through POST .../upload-pdf before
+ * precedent creation; that's a plain async function, not a mutation
+ * hook, because it has no cache invalidation of its own.
+ */
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiRequest, ApiError } from "./client";
+import type { PracticeArea } from "@/lib/practice-area";
+
+export type CasePrecedent = {
+  id: string;
+  case_id: string;
+  section_id: string | null;
+  quote: string;
+  citation: string;
+  chair_note: string;
+  pdf_document_id: string | null;
+  practice_area: PracticeArea | null;
+  created_at: string;
+  updated_at: string;
+};
+
+export type PrecedentCreateInput = {
+  quote: string;
+  citation: string;
+  section_id?: string;
+  chair_note?: string;
+  pdf_document_id?: string;
+};
+
+export type LibraryMatch = {
+  id: string;
+  citation: string;
+  quote: string;
+  chair_note: string;
+  practice_area: PracticeArea | null;
+  created_at: string;
+};
+
+export const precedentKeys = {
+  all: ["precedents"] as const,
+  forCase: (caseNumber: string) =>
+    [...precedentKeys.all, "case", caseNumber] as const,
+  librarySearch: (q: string, area: string) =>
+    [...precedentKeys.all, "library", area, q] as const,
+};
+
+export function useCasePrecedents(caseNumber: string | undefined) {
+  return useQuery({
+    queryKey: precedentKeys.forCase(caseNumber ?? ""),
+    queryFn: ({ signal }) =>
+      apiRequest<CasePrecedent[]>(
+        `/api/cases/${caseNumber}/precedents`,
+        { signal },
+      ),
+    enabled: Boolean(caseNumber),
+    staleTime: 30_000,
+  });
+}
+
+export function useCreatePrecedent(caseNumber: string) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (input: PrecedentCreateInput) =>
+      apiRequest<CasePrecedent>(`/api/cases/${caseNumber}/precedents`, {
+        method: "POST",
+        body: input,
+      }),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: precedentKeys.forCase(caseNumber) });
+      qc.invalidateQueries({ queryKey: [...precedentKeys.all, "library"] });
+    },
+  });
+}
+
+export function useDeletePrecedent(caseNumber: string) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (precedentId: string) =>
+      apiRequest<{ deleted: boolean }>(`/api/precedents/${precedentId}`, {
+        method: "DELETE",
+      }),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: precedentKeys.forCase(caseNumber) });
+    },
+  });
+}
+
+export function usePrecedentLibrarySearch(
+  query: string,
+  practiceArea: PracticeArea | null | undefined,
+  enabled: boolean,
+) {
+  return useQuery({
+    queryKey: precedentKeys.librarySearch(query, practiceArea ?? ""),
+    queryFn: ({ signal }) => {
+      const params = new URLSearchParams({ q: query });
+      if (practiceArea) params.set("practice_area", practiceArea);
+      return apiRequest<LibraryMatch[]>(
+        `/api/precedents/search?${params.toString()}`,
+        { signal },
+      );
+    },
+    enabled: enabled && query.trim().length >= 2,
+    staleTime: 10_000,
+    placeholderData: (prev) => prev,
+  });
+}
+
+/**
+ * One-shot PDF archive upload. Returns the new document_id so the
+ * caller can pass it into useCreatePrecedent. No cache invalidation
+ * — we only care about the id as a handle.
+ */
+export async function uploadPrecedentPdf(
+  caseNumber: string,
+  file: File,
+): Promise<{ document_id: string; filename: string }> {
+  const fd = new FormData();
+  fd.append("file", file);
+  const res = await fetch(
+    `/api/cases/${encodeURIComponent(caseNumber)}/precedents/upload-pdf`,
+    { method: "POST", body: fd },
+  );
+  const parsed = await res.json().catch(() => null);
+  if (!res.ok) {
+    throw new ApiError(
+      `Upload failed with ${res.status}`,
+      res.status,
+      parsed,
+    );
+  }
+  return parsed as { document_id: string; filename: string };
+}

web-ui/src/lib/api/skills.ts

@@ -0,0 +1,30 @@
+/**
+ * Paperclip skills — listing + sync actions.
+ *
+ * Skills live in Paperclip's database (separate from the main legal-ai DB)
+ * and are exposed via /api/admin/skills. The UI just needs read access for
+ * Phase 5; install/sync/delete mutations can follow in Phase 6.
+ */
+
+import { useQuery } from "@tanstack/react-query";
+import { apiRequest } from "./client";
+
+export type Skill = {
+  slug: string;
+  name: string;
+  db_markdown_chars: number;
+  file_inventory: Array<{ path: string; size?: number }> | null;
+  updated_at: string | null;
+  disk_exists: boolean;
+  disk_skill_md_bytes: number | null;
+  not_in_db?: boolean;
+};
+
+export function useSkills() {
+  return useQuery({
+    queryKey: ["skills", "list"] as const,
+    queryFn: ({ signal }) =>
+      apiRequest<Skill[]>("/api/admin/skills", { signal }),
+    staleTime: 30_000,
+  });
+}

web-ui/src/lib/api/system.ts

@@ -0,0 +1,42 @@
+/**
+ * System-level hooks: diagnostics + active task snapshot.
+ *
+ * The vanilla UI polled /api/system/diagnostics and /api/system/tasks on
+ * an interval. We replace the polling with TanStack Query's refetchInterval
+ * — same effect, but participates in the shared cache and survives route
+ * transitions without setting up its own setInterval bookkeeping.
+ */
+
+import { useQuery } from "@tanstack/react-query";
+import { apiRequest } from "./client";
+
+export type DiagDoc = {
+  id: string;
+  title: string;
+  status: string;
+  case_number: string;
+  created_at: string | null;
+};
+
+export type Diagnostics = {
+  db_ok: boolean;
+  tables: Record<string, number | null>;
+  failed_documents: DiagDoc[];
+  stuck_documents: DiagDoc[];
+  active_tasks: Array<{
+    task_id: string;
+    filename: string;
+    status: string;
+    step: string;
+  }>;
+};
+
+export function useDiagnostics() {
+  return useQuery({
+    queryKey: ["system", "diagnostics"] as const,
+    queryFn: ({ signal }) =>
+      apiRequest<Diagnostics>("/api/system/diagnostics", { signal }),
+    refetchInterval: 10_000,
+    staleTime: 5_000,
+  });
+}

web-ui/src/lib/api/training.ts

@@ -0,0 +1,151 @@
+/**
+ * Training / style corpus hooks.
+ *
+ * Endpoints touched (all under /api/training/):
+ *   - GET /style-report → the dashboard payload (corpus stats + anatomy
+ *     + signature phrases + per-decision contribution)
+ *   - GET /corpus → flat list of decisions for the corpus tab / compare tool
+ *   - GET /compare?a=UUID&b=UUID → side-by-side comparison
+ *   - DELETE /corpus/{id} → remove a decision from the corpus
+ */
+
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiRequest } from "./client";
+
+export type StyleReport = {
+  corpus: {
+    decision_count: number;
+    total_chars: number;
+    avg_chars: number;
+    date_range: [string | null, string | null];
+    decisions: Array<{
+      number: string;
+      date: string;
+      chars: number;
+      subjects: string[];
+    }>;
+    subject_distribution: Array<{ label: string; count: number }>;
+    headline: string;
+  };
+  anatomy: {
+    sections: Array<{
+      type: string;
+      label: string;
+      avg_chars: number;
+      pct: number;
+      coverage: number;
+    }>;
+    total_coverage: number;
+    headline: string;
+  };
+  signature_phrases: {
+    items: Array<{
+      type: string;
+      text: string;
+      context: string;
+      frequency: number;
+      examples: string[];
+    }>;
+    total_decisions: number;
+    top_display: string;
+    headline: string;
+  };
+  contribution: {
+    growth_curve: Array<{
+      decision_number: string;
+      date: string;
+      cumulative: number;
+    }>;
+    decision_contributions: unknown[];
+    total_patterns: number;
+    headline: string;
+  };
+};
+
+export type CorpusDecision = {
+  id: string;
+  decision_number: string;
+  decision_date: string;
+  subject_categories: string[];
+  chars: number;
+  created_at: string;
+};
+
+export type CompareResult = {
+  a: CompareSide;
+  b: CompareSide;
+  shared: PatternEntry[];
+  only_a: PatternEntry[];
+  only_b: PatternEntry[];
+};
+
+export type CompareSide = {
+  id: string;
+  decision_number: string;
+  decision_date: string;
+  chars: number;
+  subjects: string[];
+  sections: Array<{ type: string; chars: number }>;
+  patterns_count: number;
+};
+
+export type PatternEntry = {
+  id: string;
+  type: string;
+  text: string;
+  context: string;
+};
+
+export const trainingKeys = {
+  all: ["training"] as const,
+  report: () => [...trainingKeys.all, "style-report"] as const,
+  corpus: () => [...trainingKeys.all, "corpus"] as const,
+  compare: (a: string, b: string) =>
+    [...trainingKeys.all, "compare", a, b] as const,
+};
+
+export function useStyleReport() {
+  return useQuery({
+    queryKey: trainingKeys.report(),
+    queryFn: ({ signal }) =>
+      apiRequest<StyleReport>("/api/training/style-report", { signal }),
+    staleTime: 60_000,
+  });
+}
+
+export function useCorpus() {
+  return useQuery({
+    queryKey: trainingKeys.corpus(),
+    queryFn: ({ signal }) =>
+      apiRequest<CorpusDecision[]>("/api/training/corpus", { signal }),
+    staleTime: 60_000,
+  });
+}
+
+export function useCompare(a: string | null, b: string | null) {
+  return useQuery({
+    queryKey: trainingKeys.compare(a ?? "", b ?? ""),
+    queryFn: ({ signal }) =>
+      apiRequest<CompareResult>(
+        `/api/training/compare?a=${encodeURIComponent(a!)}&b=${encodeURIComponent(b!)}`,
+        { signal },
+      ),
+    enabled: Boolean(a && b && a !== b),
+    staleTime: Infinity,
+  });
+}
+
+export function useDeleteCorpusEntry() {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (id: string) =>
+      apiRequest<{ deleted: boolean }>(
+        `/api/training/corpus/${encodeURIComponent(id)}`,
+        { method: "DELETE" },
+      ),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: trainingKeys.corpus() });
+      qc.invalidateQueries({ queryKey: trainingKeys.report() });
+    },
+  });
+}

web-ui/src/lib/practice-area.ts

@@ -0,0 +1,72 @@
+/**
+ * Client-side mirror of mcp-server/src/legal_mcp/services/practice_area.py.
+ *
+ * Keep the enum values and derivation logic in sync with the backend — the
+ * server is the authority, but the UI needs the labels and derivation for
+ * UX (auto-fill, badges, filters). If the server adds a new practice_area
+ * or subtype, extend the arrays below.
+ *
+ * See also: legal-ai/docs/practice-area-separation.md
+ */
+
+export type PracticeArea =
+  | "appeals_committee"
+  | "national_insurance"
+  | "labor_law";
+
+export type AppealSubtype =
+  | "building_permit"
+  | "betterment_levy"
+  | "compensation_197"
+  | "unknown";
+
+export const PRACTICE_AREAS: ReadonlyArray<{
+  value: PracticeArea;
+  label: string;
+  enabled: boolean;
+}> = [
+  { value: "appeals_committee",  label: "ועדת ערר",     enabled: true  },
+  { value: "national_insurance", label: "ביטוח לאומי",  enabled: false },
+  { value: "labor_law",          label: "דיני עבודה",   enabled: false },
+];
+
+export const APPEAL_SUBTYPES: ReadonlyArray<{
+  value: AppealSubtype;
+  label: string;
+}> = [
+  { value: "building_permit",  label: "רישוי ובנייה"      },
+  { value: "betterment_levy",  label: "היטל השבחה"        },
+  { value: "compensation_197", label: "פיצויים (ס' 197)"  },
+  { value: "unknown",          label: "לא ידוע"           },
+];
+
+export const PRACTICE_AREA_LABELS: Record<PracticeArea, string> =
+  Object.fromEntries(PRACTICE_AREAS.map((p) => [p.value, p.label])) as Record<
+    PracticeArea,
+    string
+  >;
+
+export const APPEAL_SUBTYPE_LABELS: Record<AppealSubtype, string> =
+  Object.fromEntries(APPEAL_SUBTYPES.map((s) => [s.value, s.label])) as Record<
+    AppealSubtype,
+    string
+  >;
+
+/*
+ * Derive the appeal_subtype from a case number. Mirrors the Python
+ * `derive_subtype` in practice_area.py. The convention is the case-number
+ * first digit: 1xxx → building_permit, 8xxx → betterment_levy,
+ * 9xxx → compensation_197. Everything else, including non-appeals_committee
+ * domains, returns 'unknown'.
+ */
+export function deriveSubtype(
+  caseNumber: string,
+  practiceArea: PracticeArea = "appeals_committee",
+): AppealSubtype {
+  if (practiceArea !== "appeals_committee") return "unknown";
+  const first = caseNumber.trim().match(/^(\d)/)?.[1];
+  if (first === "1") return "building_permit";
+  if (first === "8") return "betterment_levy";
+  if (first === "9") return "compensation_197";
+  return "unknown";
+}

web-ui/src/lib/providers.tsx

@@ -2,6 +2,7 @@
 
 import { useState, type ReactNode } from "react";
 import { QueryClientProvider } from "@tanstack/react-query";
+import { Toaster } from "@/components/ui/sonner";
 import { makeQueryClient } from "@/lib/api/client";
 
 /**
@@ -12,6 +13,9 @@ import { makeQueryClient } from "@/lib/api/client";
 export function Providers({ children }: { children: ReactNode }) {
   const [queryClient] = useState(() => makeQueryClient());
   return (
-    <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+    <QueryClientProvider client={queryClient}>
+      {children}
+      <Toaster position="top-left" richColors closeButton dir="rtl" />
+    </QueryClientProvider>
   );
 }