Add docs, scripts, skills, commands, and taskmaster config to repo

Includes: - docs/: architecture, block-schema, migration-plan, product-specification - scripts/: bidi_table, decompose-decisions, extract-claims, seed-knowledge, etc. - skill-legal-decision/: SKILL.md + references + block-schema - skill-legal-assistant/: SKILL.md - skill-legal-docx/: SKILL.md + references - .claude/commands/: bidi-table skill - .taskmaster/: task config + PRDs - .gitignore: exclude legacy/, kiryat-yearim/, node_modules/, memory/ Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-04 14:19:17 +00:00
parent bacb330a2a
commit d5ccf03e4c
41 changed files with 9356 additions and 2 deletions
--- a/skill-legal-decision/references/block-schema.md
+++ b/skill-legal-decision/references/block-schema.md
@@ -0,0 +1,574 @@
+# Block Schema — ארכיטקטורת מסמך החלטת ועדת ערר
+
+מסמך זה מגדיר את המבנה הפורמלי של החלטת ועדת ערר לתכנון ובניה. הוא משמש כמקור סמכותי להגדרת בלוקים, משקלות, פרמטרי עיבוד, וכללי ולידציה.
+
+**הפניה:** SKILL.md סעיפים 11-12 מכילים סיכום מהיר והנחיות תהליך. מסמך זה מכיל את ההגדרות המלאות.
+
+---
+
+## 1. יסודות תיאורטיים
+
+ארכיטקטורת המסמך מבוססת על שילוב של ארבעה frameworks מוכרים:
+
+### CREAC — מתודולוגיית כתיבה משפטית
+Conclusion → Rule → Explanation → Application → Conclusion.
+מקור: Columbia Law School, Legal Writing methodology.
+**מיפוי:** חל על בלוק י (דיון) ובלוק יא (סיכום). בלוק י פותח במסקנה (C), מציג כלל משפטי (R), מסביר באמצעות פסיקה (E), מיישם על העובדות (A), וחוזר למסקנה (C). בלוק יא = C אחרון בלבד.
+
+### Federal Judicial Center — Judicial Writing Manual
+מגדיר תפקוד פונקציונלי לכל חלק בהחלטה שיפוטית:
+- **Orientation** (אוריינטציה) — מי, מה, איפה → בלוקים א-ה
+- **Framing** (מסגור) — הקשר עובדתי ותכנוני → בלוק ו
+- **Argumentation** (טיעון) — עמדות הצדדים → בלוק ז
+- **Procedural record** (תיעוד הליכי) — מה עשינו → בלוק ח
+- **Deliberation** (דיון) — ניתוח משפטי → בלוקים ט-י
+- **Disposition** (החלטה) — תוצאה אופרטיבית → בלוק יא
+
+### DITA — Darwin Information Typing Architecture
+סטנדרט OASIS להגדרת סוגי תוכן מובנים. מספק:
+- **Content model** — אילו אלמנטים מותרים בכל בלוק
+- **Constraints** — מה אסור (חשוב יותר ממה שמותר)
+- **Specialization** — ירושה מסוג בסיסי עם התאמות
+- **Relationships** — תלויות בין בלוקים
+
+### Akoma Ntoso / LegalDocumentML
+סטנדרט OASIS בינלאומי למסמכים משפטיים מובנים (UN/DESA). מספק:
+- **Semantic mapping** — כל בלוק ממופה לרכיב מוכר בסטנדרט
+- **Document class** — "judgment" (פסק דין / החלטה)
+
+
+---
+
+## 2. הגדרות בלוקים
+
+### Block א: כותרת מוסדית / Institutional Header
+
+**ID:** `block-alef`
+**Akoma Ntoso:** `meta > identification`
+**CREAC role:** none
+**Functional purpose (JWM):** Orientation — מזהה את המוסד, התיק והגורם המחליט.
+
+**Content model:**
+- Types: template-field
+- Elements: טבלה 2 טורים (מוסד | מספרי תיק)
+- Sources: מערכת ניהול תיקים
+
+**Constraints:**
+- MUST: שם מוסד, מספר תיק, מספר תכנית/בקשה
+- MUST NOT: תוכן מהותי כלשהו
+- Dependencies: none
+
+**Weight:** 1% (קבוע, לא משתנה בין סוגי עררים)
+
+**Processing:**
+- Generation type: template-fill
+- Temperature: 0 | Thinking: off | Effort: min | Model: script
+
+
+### Block ב: הרכב הוועדה / Panel Composition
+
+**ID:** `block-bet`
+**Akoma Ntoso:** `meta > references > TLCPerson`
+**CREAC role:** none
+**Functional purpose (JWM):** Orientation — מזהה את ההרכב המחליט. חשוב לביקורת שיפוטית (הרכב כשיר).
+
+**Content model:**
+- Types: template-field
+- Elements: "בפני:" + יו"ר + חברים
+- Sources: מערכת ניהול
+
+**Constraints:**
+- MUST: יו"ר + לפחות חבר אחד
+- MUST NOT: תוכן מהותי
+- Dependencies: none
+
+**Weight:** 1% (קבוע)
+
+**Processing:**
+- Generation type: template-fill
+- Temperature: 0 | Thinking: off | Effort: min | Model: script
+
+
+### Block ג: צדדים / Parties
+
+**ID:** `block-gimel`
+**Akoma Ntoso:** `meta > references > TLCPerson` (appellants, respondents)
+**CREAC role:** none
+**Functional purpose (JWM):** Orientation — מזהה את הצדדים וב"כ. מגדיר את מסגרת הדיון.
+
+**Content model:**
+- Types: template-field
+- Elements: עוררים + "נגד" + משיבים + ב"כ
+- Sources: כתב ערר, כתב תשובה
+
+**Constraints:**
+- MUST: שם כל צד, "נגד" כמפריד
+- MUST NOT: תוכן מהותי, תיאור הערר
+- Dependencies: none
+
+**Weight:** 1% (קבוע)
+
+**Processing:**
+- Generation type: template-fill
+- Temperature: 0 | Thinking: off | Effort: min | Model: script
+
+
+### Block ד: כותרת "החלטה" / Decision Title
+
+**ID:** `block-dalet`
+**Akoma Ntoso:** `body > judgment > header`
+**CREAC role:** none
+**Functional purpose (JWM):** Orientation — סימון פורמלי של תחילת ההחלטה.
+
+**Content model:**
+- Types: template-field
+- Elements: מילה אחת: "החלטה"
+- Sources: none
+
+**Constraints:**
+- MUST: David 16pt, bold, מרכז
+- Dependencies: none
+
+**Weight:** 0% (שורה אחת)
+
+**Processing:**
+- Generation type: template-fill
+- Temperature: 0 | Thinking: off | Effort: min | Model: script
+
+
+### Block ה: פתיחה / Opening
+
+**ID:** `block-he`
+**Akoma Ntoso:** `body > judgment > introduction`
+**CREAC role:** C (מסקנה ראשונית — הצגת מה לפנינו)
+**Functional purpose (JWM):** Orientation — מכוון את הקורא למהות הערר במשפט אחד. מגדיר "להלן" מרכזיים.
+
+**Content model:**
+- Types: narrative (1-2 סעיפים)
+- Elements: numbered-para עם הגדרות "להלן"
+- Sources: כתב ערר, החלטת ועדה מקומית
+
+**Constraints:**
+- MUST: "לפנינו...", הגדרת הוועדה המקומית, הגדרת התכנית/הבקשה, הגדרת המגרש
+- MUST NOT: ניתוח, ערכי שיפוט, ציטוטים מצדדים
+- Dependencies: block-gimel (שמות צדדים להגדרות)
+
+**Weight:** 1% (קבוע — 1-2 סעיפים)
+
+**Processing:**
+- Generation type: paraphrase
+- Temperature: 0.2 | Thinking: low | Effort: low | Model: sonnet
+
+
+### Block ו: רקע עובדתי / Factual Background ("פתח דבר")
+
+**ID:** `block-vav`
+**Akoma Ntoso:** `body > judgment > background`
+**CREAC role:** none (עובדות בלבד, לא ניתוח)
+**Functional purpose (JWM):** Framing — מספק את התשתית העובדתית שעליה נבנה הדיון. השופט חייב להבין את המציאות בשטח לפני שקורא טענות.
+
+**Content model:**
+- Types: narrative, citation-block, image-placeholder
+- Elements: numbered-para, blockquote (ציטוט מפרוטוקול), image-box
+- Sources: כתבי טענות, תשריטים, פרוטוקולים, החלטות קודמות, GIS
+
+**סדר תוכן פנימי:**
+1. מקרקעין — מיקום, שטח, מאפיינים
+2. סביבת מקרקעין — בנייה סמוכה, אופי
+3. 📷 תמונה: מיקום GIS
+4. היסטוריה תכנונית — תכניות, החלטות (עובדות יבשות בלבד)
+5. מהות הבקשה/תכנית
+6. 📷 תמונה: תשריט
+7. ציטוט מפרוטוקול ועדה מקומית
+8. החלטת הוועדה + תנאים
+9. 📷 תמונה: צילום אוויר (אופציונלי)
+10. הגשת הערר
+
+**Constraints:**
+- MUST: מקרקעין, מהות הבקשה, החלטת הוועדה, הגשת הערר
+- MUST: לפחות 2 תמונות (מיקום + תשריט)
+- MUST: ציטוט מפרוטוקול הוועדה המקומית
+- ⚠️ **MUST NOT ("רקע ניטרלי"):** ציטוטים ישירים מצדדים, מילות ערך/שיפוט ("חריג", "חטא", "בעייתי"). החלטות קודמות = עובדה יבשה ("ביום X נדחתה תכנית Y"), ללא נימוקים וציטוטים מהן.
+- Dependencies: block-he (הגדרות "להלן")
+
+**Weight:**
+
+| סוג ערר | משקל | הערות |
+|---------|------|-------|
+| רישוי — דחייה | 15-25% | רקע מפורט עם הקשר תכנוני |
+| רישוי — קבלה | 30-40% | כולל ציטוט מפרוטוקול |
+| רישוי — קבלה חלקית | 25-35% | כולל ציטוט מפרוטוקול |
+| היטל השבחה | 6-18% | רקע מצומצם |
+
+**Weight methodology:**
+- Communicative weight (40%): גבוה — מספק את "התמונה" לשופט שלא מכיר את התיק
+- Reader attention (20%): בינוני-גבוה — primacy effect, הקורא קשוב בהתחלה
+- Judicial review (25%): גבוה — שופט בודק שהעובדות מלאות ומדויקות
+- Empirical (15%): מבוסס על מדידת החלטות דפנה (3.2 ב-SKILL.md)
+
+**Processing:**
+- Generation type: reproduction (העתקה נאמנה ממקורות)
+- Cognitive complexity: lookup (ארגון, לא ניתוח)
+- Accuracy: high-precision
+- Temperature: 0 | Thinking: off | Effort: low | Model: sonnet
+
+
+### Block ז: טענות הצדדים / Parties' Claims
+
+**ID:** `block-zayin`
+**Akoma Ntoso:** `body > judgment > arguments`
+**CREAC role:** none (הצגת טענות, לא ניתוח)
+**Functional purpose (JWM):** Argumentation — מציג את עמדות הצדדים בנאמנות, כך שהקורא יבין את המחלוקת לפני שקורא את ההכרעה.
+
+**Content model:**
+- Types: narrative
+- Elements: section-heading ("תמצית טענות הצדדים"), sub-headings (לכל צד), numbered-para
+- Sources: כתב ערר, כתב תשובה — **כתבי טענות מקוריים בלבד** (לא השלמות טיעון)
+
+**סדר קבוע:**
+1. כותרת: "תמצית טענות הצדדים"
+2. "טענות העוררים" (אם כמה עוררים — תתי-כותרות לכל אחד)
+3. "עמדת הוועדה המקומית"
+4. "עמדת מבקשי ההיתר" / "עמדת מגישי התכנית"
+
+**Constraints:**
+- MUST: כל טענה בסעיף נפרד, גוף שלישי ("העורר טוען כי...")
+- MUST: כל צד בפרק נפרד, סדר קבוע
+- MUST NOT: ניתוח, מסקנות, הערכת הוועדה ("טענה זו חלשה...")
+- MUST NOT: תוכן מהשלמות טיעון (→ block-chet)
+- Dependencies: block-vav (מספור רציף)
+
+**Weight:**
+
+| סוג ערר | משקל | הערות |
+|---------|------|-------|
+| רישוי — דחייה | 30-40% | טענות מפורטות |
+| רישוי — קבלה | 20-30% | כולל השלמות |
+| רישוי — קבלה חלקית | 25-30% | |
+| היטל השבחה | 13-25% | |
+
+**Weight methodology:**
+- Communicative weight (40%): בינוני — הצגה, לא הכרעה
+- Reader attention (20%): נמוך-בינוני — scanning attention, הקורא מחפש טענות ספציפיות
+- Judicial review (25%): גבוה — שופט בודק ש"נשמעו כל הצדדים"
+- Empirical (15%): מבוסס על מדידת החלטות דפנה
+
+**Processing:**
+- Generation type: paraphrase (סיכום נאמן בשפה של דפנה)
+- Cognitive complexity: medium-synthesis (קיבוץ וסידור טענות)
+- Accuracy: high-precision (לא לפספס טענה, לא לעוות)
+- Temperature: 0.1 | Thinking: low | Effort: medium | Model: sonnet
+
+
+### Block ח: הליכים בפני ועדת הערר / Proceedings
+
+**ID:** `block-chet`
+**Akoma Ntoso:** `body > judgment > proceedings` (custom extension)
+**CREAC role:** none (תיעוד, לא ניתוח)
+**Functional purpose (JWM):** Procedural record — מתעד שהוועדה פעלה כדין ונתנה מלוא יום בבית דין. קריטי ל"מבחן השופט" — שופט בעתמ"ם בודק שהצדדים קיבלו הזדמנות הוגנת.
+
+**Content model:**
+- Types: narrative, image-placeholder
+- Elements: section-heading ("ההליכים בפני ועדת הערר"), numbered-para, image-box
+- Sources: פרוטוקול דיון, תמונות סיור, החלטות ביניים, השלמות טיעון
+
+**סדר כרונולוגי:**
+1. דיון — תאריך, נוכחים
+2. סיור — תאריך, תיאור
+3. 📷 תמונה: צילומים מהסיור
+4. השלמות טיעון — עם תוכן מפורט (כל השלמה = סעיף נפרד)
+5. החלטות ביניים
+6. תגובות לתגובות — כרונולוגי
+7. 📷 תמונה: הדמיות/חתכים (אם צורפו)
+8. עררים מקבילים (אם יש)
+
+**Constraints:**
+- MUST: תאריכים מדויקים, כרונולוגיה ברורה
+- MUST: תוכן השלמות טיעון מפורט — כל השלמה בסעיף נפרד עם תמצית תוכן
+- MUST NOT: ניתוח או הערכה של ההשלמות ("טענה חזקה/חלשה")
+- Dependencies: block-zayin (מספור רציף)
+- References: block-zayin (הפניה לטענות מקוריות כשיש חפיפה)
+
+**Weight:**
+
+| סוג ערר | משקל | הערות |
+|---------|------|-------|
+| ערר פשוט (ללא השלמות) | 3-5% | דיון + סיור בלבד |
+| ערר מורכב (השלמות רבות) | 8-15% | כמו אריאלי: 31 סעיפים |
+| היטל השבחה | 2-4% | בדרך כלל מינימלי |
+
+**Weight methodology:**
+- Communicative weight (40%): נמוך-בינוני — תיעוד, לא הכרעה
+- Reader attention (20%): נמוך — scanning, אלא אם יש ממצאים חדשים מסיור/השלמות
+- Judicial review (25%): **גבוה מאוד** — שופט בודק שנתנו procedural fairness
+- Empirical (15%): מגוון רחב — תלוי בכמות ההשלמות
+
+**Processing:**
+- Generation type: reproduction + paraphrase (תאריכים מדויקים + תמצית תוכן)
+- Cognitive complexity: low (סידור כרונולוגי)
+- Accuracy: high-precision (תאריכים, שמות מסמכים)
+- Temperature: 0 | Thinking: off | Effort: low | Model: sonnet
+
+
+### Block ט: תכניות חלות / Applicable Plans (אופציונלי)
+
+**ID:** `block-tet`
+**Akoma Ntoso:** `body > judgment > motivation > background` (extended)
+**CREAC role:** R (Rule — הצגת הכללים המשפטיים/תכנוניים)
+**Functional purpose (JWM):** Deliberation (preliminary) — מציג את המסגרת הנורמטיבית שלאורה ייבחנו הטענות. בלוק גשר בין עובדות לניתוח.
+
+**Content model:**
+- Types: narrative, citation-block
+- Elements: section-heading, numbered-para, blockquote (ציטוט מהוראות תכנית)
+- Sources: הוראות תכנית (PDF), נספחי בינוי, החלטות מרכזות
+
+**Constraints:**
+- MUST: ציטוט ישיר מהוראות תכנית עם הדגשת (bold) מילים מכריעות
+- MUST NOT: ניתוח מעמיק (→ block-yod), הכרעה בין פרשנויות
+- Dependencies: block-chet (מספור), block-vav (הגדרות תכניות)
+- Condition: **אופציונלי** — רק כשיש מורכבות תכנונית (תכניות סותרות, תמ"א 38 + שימור, פרשנות)
+
+**Weight:**
+
+| מתי קיים | משקל |
+|----------|------|
+| תמ"א 38 + שימור | 8-12% |
+| פרשנות תכנית | 5-10% |
+| לא קיים | 0% |
+
+**Weight methodology:**
+- Communicative weight (40%): בינוני — הנחת תשתית נורמטיבית
+- Reader attention (20%): נמוך — טכני, אלא אם פרשנות שנויה במחלוקת
+- Judicial review (25%): בינוני — שופט בודק שהוועדה הבינה את הדין
+- Empirical (15%): אריאלי — 14 סעיפים; בית הכרם — משולב בדיון
+
+**Processing:**
+- Generation type: guided-synthesis (ציטוט + ניתוח ראשוני)
+- Cognitive complexity: medium (פרשנות טקסט משפטי)
+- Accuracy: precision + interpretation
+- Temperature: 0.2 | Thinking: medium | Effort: medium | Model: opus
+
+
+### Block י: דיון והכרעה / Discussion and Decision
+
+**ID:** `block-yod`
+**Akoma Ntoso:** `body > judgment > motivation`
+**CREAC role:** **full-CREAC** — C (מסקנה בפתיחה) → R (כלל משפטי) → E (ציטוט פסיקה) → A (יישום על העובדות) → C (מסקנת ביניים)
+**Functional purpose (JWM):** Deliberation — ליבת ההחלטה. כאן הוועדה מנתחת, מאזנת, ומכריעה. זהו ה-ratio decidendi.
+
+**Content model:**
+- Types: narrative, citation-block, image-placeholder
+- Elements: numbered-para (אסה רציפה ללא כותרות משנה), blockquote (ציטוטי פסיקה ותכנית), image-box
+- Sources: **כל** הבלוקים הקודמים + פסיקה + skill
+
+**מבנה פנימי (לפי סוג ערר — ראה SKILL.md סעיף 7.3):**
+- דחייה: שכבות הגנה (concentric circles)
+- קבלה: נימוק-נימוק
+- קבלה חלקית: מיפוי מתחים + ניתוח נושאי
+- היטל השבחה: פתיחה ישירה עם מסקנה
+
+**Constraints:**
+- MUST: מסקנה בפתיחת הדיון (לא בסוף)
+- MUST: מענה לכל טענה שהוצגה בבלוק ז
+- MUST: ציטוט פסיקה בבלוקים ארוכים (200-600 מילים)
+- ⚠️ **MUST NOT ("ללא כפילות"):** חזרה על עובדות/טענות מבלוקים קודמים. השתמש בהפניות: "כאמור בסעיף X לעיל", "כפי שפורט", "כפי שציינו"
+- MUST NOT: כותרות משנה (חריג: נושאים נפרדים לחלוטין)
+- Dependencies: **ALL** previous blocks (ה-ט)
+
+**Weight:**
+
+| סוג ערר | משקל | הערות |
+|---------|------|-------|
+| רישוי — דחייה | 37-50% | פתיחה רחבה + שכבות |
+| רישוי — קבלה | 35-45% | נימוק-נימוק |
+| רישוי — קבלה חלקית | 40-47% | מיפוי מתחים + ניתוח נושאי |
+| היטל השבחה | 32-48% | ציטוטי פסיקה מרובים |
+
+**Weight methodology:**
+- Communicative weight (40%): **מקסימלי** — זהו ה-ratio decidendi, תכלית ההחלטה
+- Reader attention (20%): **גבוה** — deep reading, הקורא מחפש את הנימוקים
+- Judicial review (25%): **מקסימלי** — שופט בוחן סבירות, מידתיות, התייחסות לטענות
+- Empirical (15%): 35-50% באופן עקבי בכל החלטות דפנה
+
+**Processing:**
+- Generation type: **rhetorical-construction** (בניית טיעון, איזון, רטוריקה)
+- Cognitive complexity: **high-reasoning** (CREAC מלא, שכבות, חידוד)
+- Accuracy: **precision + creativity** (ניתוח מדויק + ביטוי אלגנטי)
+- Temperature: **0.4** | Thinking: **max (budget 16K+)** | Effort: **max** | Model: **opus בלבד**
+
+
+### Block יא: סיכום / סוף דבר / Summary
+
+**ID:** `block-yod-alef`
+**Akoma Ntoso:** `body > judgment > decision`
+**CREAC role:** C (Conclusion אחרון — תמצית אופרטיבית)
+**Functional purpose (JWM):** Disposition — ההוראה האופרטיבית שמבצעים. זה מה שהצדדים צריכים לדעת "מה עכשיו."
+
+**Content model:**
+- Types: narrative
+- Elements: section-heading ("סיכום"/"סוף דבר"), numbered-para, sub-items (א. ב. ג.)
+- Sources: block-yod (מסקנות)
+
+**מבנה לפי תוצאה (ראה SKILL.md סעיף 8):**
+- דחייה: "הערר נדחה" + תתי-סעיפים + פסקה חמה (רישוי בלבד)
+- קבלה: "הערר מתקבל בכפוף ל..." + פרוזה
+- קבלה חלקית: "הערר מתקבל באופן חלקי" + 2-3 הוראות אופרטיביות
+- היטל השבחה: יבש
+
+**Constraints:**
+- MUST: תוצאה ברורה (נדחה/מתקבל/מתקבל חלקית)
+- MUST NOT (בקבלה חלקית): חזרה על נימוקים — ההנמקה כבר בדיון
+- Dependencies: block-yod (מסקנות)
+
+**Weight:**
+
+| סוג ערר | משקל |
+|---------|------|
+| דחייה | 2-9% |
+| קבלה | 3-5% |
+| קבלה חלקית | 2-3% |
+| היטל השבחה | 3-4% |
+
+**Processing:**
+- Generation type: paraphrase (עיבוד מסקנות בלוק י)
+- Cognitive complexity: low
+- Accuracy: high-precision (הוראות חייבות להיות חד-משמעיות)
+- Temperature: 0.1 | Thinking: low | Effort: low | Model: sonnet
+
+
+### Block יב: חתימות / Signatures
+
+**ID:** `block-yod-bet`
+**Akoma Ntoso:** `conclusions > signature`
+**CREAC role:** none
+**Functional purpose (JWM):** Authentication — אישור פורמלי של ההחלטה.
+
+**Content model:**
+- Types: template-field
+- Elements: "ניתנה פה אחד" + תאריך עברי/לועזי + טבלת חתימות
+- Sources: none
+
+**Constraints:**
+- MUST: "ניתנה פה אחד", תאריך, יו"ר + מזכיר/ה
+- Dependencies: none
+
+**Weight:** 1% (קבוע)
+
+**Processing:**
+- Generation type: template-fill
+- Temperature: 0 | Thinking: off | Effort: min | Model: script
+
+
+---
+
+## 3. כללי גזירת פרמטרים
+
+פרמטרי העיבוד נגזרים ממאפייני התוכן, לא נקבעים שרירותית:
+
+### Temperature — נגזר מסוג הייצור
+
+| Generation type | Temperature | נימוק |
+|----------------|-------------|-------|
+| template-fill | 0 | אין צורך בשפה — מילוי שדות |
+| reproduction | 0 | נאמנות מוחלטת למקור. אפס יצירתיות |
+| paraphrase | 0.1 | מרווח מינימלי לניסוח בשפה של דפנה |
+| guided-synthesis | 0.2 | גמישות בארגון וחיבור מקורות, לא בתוכן |
+| analytical-reasoning | 0.3-0.4 | צריך ליצור קשרים בין עקרונות משפטיים |
+| rhetorical-construction | 0.4-0.5 | טווח ביטוי רחב לכתיבה משכנעת ואלגנטית |
+
+### Thinking budget — נגזר ממורכבות קוגניטיבית
+
+| Cognitive task | Budget | נימוק |
+|---------------|--------|-------|
+| template-fill / lookup | off | אין צורך בחשיבה |
+| sequential-extraction | low | חילוץ מידע חד-שלבי |
+| multi-source-integration | medium | צריך להצליב מקורות |
+| legal-analysis-with-CREAC | max (16K+) | חשיבה רב-שלבית: מסקנה → כלל → הסבר → יישום |
+
+### Model — נגזר מדרישת דיוק
+
+| Accuracy profile | Model | נימוק |
+|-----------------|-------|-------|
+| factual-precision | sonnet | מהיר, מדויק לחילוץ עובדות |
+| precision + interpretation | opus | נדרש לפרשנות תכנית / ציטוט מובנה |
+| precision + creativity | opus | נדרש לניתוח משפטי מורכב ורטוריקה |
+
+
+---
+
+## 4. מתודולוגיית משקלות
+
+משקל כל בלוק נקבע על ידי שקלול 4 גורמים:
+
+### 4.1 Communicative Weight (40%)
+מה חלקו של הבלוק בתכלית ההחלטה? ההחלטה באה לעשות דבר אחד: להכריע במחלוקת ולנמק. בלוק י (דיון) הוא ליבת התכלית. בלוקים א-ד (כותרות) הם עטיפה.
+
+### 4.2 Reader Attention Distribution (20%)
+מבוסס על מחקרי F-pattern ו-primacy/recency:
+- **פתיחה** (בלוקים ה-ו): קשב גבוה (primacy effect)
+- **אמצע** (בלוקים ז-ח): scanning — הקורא מחפש טענות ספציפיות
+- **דיון** (בלוק י): deep reading — הקורא מחפש נימוקים
+- **סיום** (בלוק יא): קשב גבוה (recency effect)
+
+### 4.3 Judicial Review Requirement (25%)
+מה שופט בבית משפט לעניינים מנהליים יבדוק ("מבחן השופט"):
+- **תשתית עובדתית** (בלוק ו): מלאה ומדויקת?
+- **שמיעת צדדים** (בלוקים ז-ח): נתנו מלוא יום בבית דין?
+- **סבירות ומידתיות** (בלוק י): ההכרעה מנומקת ומאוזנת?
+- **התייחסות לטענות** (בלוק י): כל טענה קיבלה מענה?
+
+### 4.4 Empirical Basis (15%)
+מבוסס על מדידה מהחלטות שפורסמו:
+- הכט 1180-1181 (דחייה, 02.2026)
+- בית הכרם 1126/25 (קבלה חלקית, 03.2026)
+- אריאלי 1078+1083 (קבלה, 03.2026)
+
+המשקלות ב-SKILL.md סעיף 3.2 (יחסי הזהב) משמשים כבסיס אמפירי שאומת על ידי שלושת הגורמים האנליטיים.
+
+
+---
+
+## 5. כללי ולידציה
+
+### 5.1 סדר בלוקים
+- בלוקים חייבים להופיע בסדר א עד יב
+- בלוקים א-ה ויב נדרשים בכל החלטה
+- בלוק ט אופציונלי (רק כשיש מורכבות תכנונית)
+
+### 5.2 Content Constraints
+- **רקע ניטרלי (בלוק ו):** אם סעיף מכיל ציטוט ישיר מצד או מילת שיפוט → לא שייך כאן
+- **טענות מקוריות בלבד (בלוק ז):** רק מכתבי ערר/תשובה. השלמות → בלוק ח
+- **ללא כפילות (בלוק י):** הפניה לבלוקים קודמים, לא חזרה. חריג: "נשוב על כך כי..." (חזרה מכוונת עם שכבה חדשה)
+- **הליכים ללא הערכה (בלוק ח):** תיעוד מה הוגש, לא הערכה של חוזק הטענות
+
+### 5.3 Weight Compliance
+- משקל כל בלוק (ספירת מילים / סה"כ) צריך להיות בטווח המוגדר **±10%**
+- אם בלוק י < 30% → flag: דיון לא מפותח מספיק
+- אם בלוק ו > 35% → flag: רקע מנופח, בדוק שאין תוכן טענתי
+
+### 5.4 Structural Integrity
+- מספור סעיפים רציף מ-1 עד הסוף, ללא איפוס בין בלוקים
+- כל הגדרת "להלן" חייבת להופיע לפני השימוש הראשון בה
+- כל טענה בבלוק ז חייבת לקבל מענה בבלוק י (ישיר או "למעלה מן הצורך")
+- כותרות פרקים: David 14pt, bold, קו תחתון, מרכז
+- כותרות משנה: David 12pt, bold, מרכז, ללא קו תחתון
+
+
+---
+
+## 6. גרף תלויות בין בלוקים
+
+```
+א (כותרת)     → עצמאי
+ב (הרכב)      → עצמאי
+ג (צדדים)     → עצמאי
+ד (כותרת)     → עצמאי
+ה (פתיחה)     → תלוי ב: ג (שמות צדדים להגדרות "להלן")
+ו (רקע)       → תלוי ב: ה (הגדרות). מספור ממשיך מ-ה.
+ז (טענות)     → תלוי ב: ו (מספור). מפנה ל: ה, ו (הגדרות)
+ח (הליכים)    → תלוי ב: ז (מספור). מפנה ל: ז (טענות מקוריות)
+ט (תכניות)    → תלוי ב: ח (מספור). אופציונלי. מפנה ל: ו (הגדרות תכניות)
+י (דיון)      → תלוי ב: **כל** הבלוקים ה-ט. מפנה ל: כולם.
+יא (סיכום)    → תלוי ב: י (מסקנות). מפנה ל: י בלבד.
+יב (חתימות)   → עצמאי
+```
--- a/skill-legal-decision/references/decision-template.json
+++ b/skill-legal-decision/references/decision-template.json
@@ -0,0 +1,97 @@
+{
+  "_comment": "תבנית JSON לייצור טיוטת מבנה החלטה — כל שדה עם '_comment' הוא הסבר, לא תוכן",
+  "_usage": "node .claude/skills/legal-decision/scripts/create-decision-structure.cjs <this-file.json> [output.docx]",
+
+  "type": "permit | plan | betterment",
+
+  "case_numbers": ["1130/25"],
+  "plan_number": "152-1257682",
+  "request_number": null,
+
+  "panel": {
+    "chair": "עו\"ד דפנה תמיר",
+    "members": [
+      "יעקב אנוקה, נציג מתכנן המחוז",
+      "יצחק ליר ליפובצקי, נציג ארגון האדריכלים"
+    ]
+  },
+
+  "appellants": [
+    { "name": "1. מרק קובר", "representative": null },
+    { "name": "2. יצחק מטמון", "representative": null }
+  ],
+
+  "respondents": [
+    { "name": "הוועדה המרחבית לתכנון ולבניה הראל", "representative": "עו\"ד ליאורה אפרתי" },
+    { "name": "אסתר שרה ליבמן", "representative": null },
+    { "name": "יוסף חיים ליבמן", "representative": "עו\"ד משה ברקוביץ" }
+  ],
+
+  "appeal_description": "ערר על החלטת הוועדה המרחבית לתכנון ולבניה הראל מיום 23.7.2025, לדחות את ההתנגדויות ולאשר את תכנית מס' 152-1257682",
+
+  "opening_paragraphs": [
+    "לפנינו ערר על החלטת הוועדה המרחבית לתכנון ולבניה הראל (להלן: \"הוועדה המקומית\") מיום 23.7.2025, לדחות את ההתנגדויות ולאשר את תכנית מס' 152-1257682 (להלן: \"התכנית\") ברחוב אבינדב 23, קריית יערים, גוש 29536 חלקה 244 (להלן: \"המגרש\" או \"המקרקעין\")."
+  ],
+
+  "use_petach_davar": true,
+
+  "property_description": "המגרש מצוי ברחוב אבינדב בקריית יערים, מועצה מקומית המוגדרת בתמ\"א 35 כ\"ישוב שמור משולב\" ובתמ\"מ 30/1 כ\"ישוב פרברי\". רחוב אבינדב הינו מדרחוב צר ומפותל, מתאפיין בבנייה כפרית של וילות צמודות קרקע חד-משפחתיות, עם חניה בתוך תחום המגרשים, על פי תכנית מי/135 משנת 1972 (להלן: \"תכנית 135\").",
+
+  "planning_history": [
+    "בשנת 1992 אושרה תכנית מי/135/א (להלן: \"תכנית 135/א\"), אשר שינתה מהותית את ייעוד מספר מגרשים ברחוב...",
+    "ביום 29.6.2017 דחתה ועדת המשנה להתנגדויות של הוועדה המחוזית ירושלים את תכנית מס' 152-0137067..."
+  ],
+
+  "request_essence": "התכנית נשוא הערר (152-1257682) עוסקת בתוספת זכויות בנייה למבנה הקיים ברחוב אבינדב 23, וכוללת: הגדלת זכויות בנייה בשיעור של 50%...",
+
+  "committee_protocol_quote": "[ציטוט מלא מתוך פרוטוקול הדיון בוועדה המקומית]",
+
+  "committee_decision": "ביום 23.7.2025 קיימה הוועדה המקומית דיון בהתנגדויות שהוגשו לתכנית. לאחר שמיעת ההתנגדויות, החליטה הוועדה המקומית פה אחד לדחות את ההתנגדויות ולאשר את התכנית כפי שהופקדה.",
+
+  "include_aerial_photo": true,
+
+  "surroundings": "[תיאור סביבת המקרקעין — מבנים סמוכים, אופי שכונתי]",
+
+  "appeal_filing": "ביום 14.8.2025 הגיש העורר את הערר שבפנינו. ביום 22.10.2025 הגיש מטמון כתב ערר/תשובה בו הצטרף לערר.",
+
+  "_comment_claims": "אפשר להשתמש ב-appellant_claims (רשימה אחת) או ב-appellant_claims_sections (כמה עוררים עם כותרות נפרדות)",
+
+  "appellant_claims_sections": [
+    {
+      "title": "טענות העורר מר קובר",
+      "claims": [
+        "העורר טוען כי לוועדה המקומית לא הייתה סמכות לאשר את התכנית...",
+        "עוד טוען העורר כי חישוב תוספת שטחי הבנייה שגוי..."
+      ]
+    },
+    {
+      "title": "טענות מטמון",
+      "claims": [
+        "מטמון מדגיש את העיוות התכנוני ההיסטורי שנוצר בשנת 1992..."
+      ]
+    }
+  ],
+
+  "committee_position": [
+    "הוועדה המקומית טוענת כי לוועדה מקומית סמכות לדון בתכנית...",
+    "באשר להחלטת הוועדה המחוזית משנת 2017, טוענת הוועדה המקומית כי..."
+  ],
+
+  "applicant_position": [
+    "מגישי התכנית טוענים כי התכנית אינה מוסיפה יחידות דיור מעבר למותר...",
+    "במסגרת השלמת הטיעון, הציגו מגישי התכנית תמונה תכנונית רחבה..."
+  ],
+
+  "proceedings": [
+    { "type": "text", "text": "ביום 27.10.2025 התקיים דיון בפני ועדת הערר, בו נשמעו העורר, מטמון, הוועדה המקומית ומגישי התכנית." },
+    { "type": "text", "text": "ביום 30.11.2025 נערך סיור במקום." },
+    { "type": "image", "description": "צילומים מהסיור ברחוב אבינדב — מבט על הבניין הקיים" },
+    { "type": "text", "text": "ביום 31.12.2025 ניתנה החלטת ביניים..." },
+    { "type": "text", "text": "בעקבות החלטת הביניים הוגשו השלמות טיעון מכל הצדדים..." }
+  ],
+
+  "skip_plans_section": true,
+  "_comment_plans": "אם skip_plans_section=false, אפשר להוסיף applicable_plans עם פירוט תכניות",
+
+  "secretary": ""
+}
--- a/skill-legal-decision/references/israeli-planning-law-basics.md
+++ b/skill-legal-decision/references/israeli-planning-law-basics.md
@@ -0,0 +1,186 @@
+# יסודות דיני תכנון ובניה בישראל
+## מדריך עזר למומחה הגישה השיפוטית
+
+---
+
+## מבנה מערכת התכנון והבניה בישראל
+
+### רמות התכנון
+
+**1. רמה ארצית**
+- המועצה הארצית לתכנון ובניה
+- תכניות מתאר ארציות (תמ"א)
+
+**2. רמה מחוזית**
+- ועדות מחוזיות (6 מחוזות)
+- תכניות מתאר מחוזיות (תמ"מ)
+
+**3. רמה מקומית**
+- ועדות מקומיות (לפי רשויות מקומיות)
+- תכניות מפורטות
+
+**4. ועדות ערר**
+- ועדות ערר מחוזיות (מטפלות בערעורים על החלטות ועדות מקומיות)
+- ועדת הערר הארצית (מטפלת בערעורים על החלטות ועדות מחוזיות)
+
+---
+
+## חוקים ותקנות מרכזיים
+
+### 1. חוק התכנון והבניה, התשכ"ה-1965
+
+**סעיפים חשובים:**
+
+- **סעיף 19** - היטל השבחה
+- **סעיף 62** - הוועדה המקומית
+- **סעיף 149** - היתר בניה
+- **סעיף 150** - תנאים למתן היתר
+- **סעיף 151** - היתר בנייה בסטייה מזניחה
+- **סעיף 197** - הקלות בניה
+- **סעיף 204** - ועדות ערר
+- **סעיף 205** - סמכויות ועדת הערר
+- **סעיף 228** - עבירות בניה ללא היתר
+
+### 2. חוק המקרקעין, התשכ"ט-1969
+
+**סעיפים חשובים:**
+- זכויות קנייניות במקרקעין
+- העברת זכויות
+
+### 3. תקנות התכנון והבניה (בקשה להיתר, תנאיו ואגרות), התש"ל-1970
+
+---
+
+## סוגי ערעורים נפוצים
+
+### 1. ערעורים על החלטות בעניין רישוי
+- דחיית בקשה להיתר בניה
+- מתן היתר בתנאים
+- היתר בסטייה מזניחה
+- הקלות בניה
+
+### 2. ערעורים על החלטות בעניין היטל השבחה
+- חישוב היטל
+- שיעור ההשבחה
+- פטור מהיטל
+- ערעורי שומה
+
+### 3. ערעורים על החלטות בעניין תכניות
+- אישור/דחיית תכנית
+- תנאים בתכנית
+- התנגדויות לתכניות
+
+### 4. ערעורים על צווי הריסה
+- צווים מנהליים
+- הליכי אכיפה
+
+---
+
+## פסקי דין חשובים בתחום
+
+### בנושא היטל השבחה
+- **ע"א 6339/97 עיריית רמת השרון נ' פנחס** - עקרונות יסוד בהיטל השבחה
+- **ע"א 2892/07 בן ארי נ' הוועדה המקומית** - חישוב שיעור השבחה
+
+### בנושא רישוי והיתרים
+- **בג"ץ 5060/94 ד"ר ניימן נ' יו"ר ועדת הערר** - גבולות שיקול הדעת של ועדות
+- **ע"א 1845/04 אושרי נ' הוועדה המקומית** - הקלות בניה
+
+### בנושא שימוש חורג
+- **בג"ץ 244/00 עמותת יער חמ"ד נ' ועדת הערר** - שימושים חורגים
+
+### בנושא זכויות קנייניות מול אינטרס ציבורי
+- **בג"ץ 6698/95 קעדאן נ' מינהל מקרקעי ישראל** - איזון בין זכויות
+- **בג"ץ 2390/96 קרסיק נ' הממשלה** - זכות הקניין
+
+---
+
+## מושגי יסוד
+
+### תכנון
+
+**תכנית מתאר** - תכנית כללית לשטח מסוים, קובעת ייעודי קרקע, צפיפות, זכויות בניה.
+
+**תכנית מפורטת** - תכנית המפרטת פרטי בניה, קווי בניין, גבהים.
+
+**שימוש חורג** - שימוש שונה מהייעוד בתכנית.
+
+**הקלה** - סטייה קלה מתכנית שניתן לאשר ללא שינוי התכנית (סעיף 197).
+
+**סטייה מזניחה** - סטייה קלה מאוד מהיתר שניתן לאשר (סעיף 151).
+
+### רישוי
+
+**היתר בניה** - אישור לבנות על פי תכנית.
+
+**תנאים להיתר** - דרישות שיש לעמוד בהן לפני מתן היתר או במהלך הבניה.
+
+**פקיעת היתר** - תום תוקף היתר אם לא הוחל בבניה.
+
+### היטל השבחה
+
+**השבחה** - עליית ערך מקרקעין כתוצאה מתכנית או היתר.
+
+**היטל השבחה** - תשלום חובה בשיעור של 50% מההשבחה (בדרך כלל).
+
+**מימוש זכויות** - התחלת בנייה או מכירה המחייבת בתשלום היטל.
+
+**פטור מהיטל** - מקרים בהם החוק פוטר מתשלום (למשל: בניית דירת מגורים יחידה).
+
+### הליכים
+
+**ערר** - ערעור על החלטת ועדה מקומית לועדת ערר מחוזית.
+
+**ערעור מינהלי** - ערעור מועדת ערר לבית משפט.
+
+**בקשה מנהלית** - פנייה לביה"מ ללא צורך בערר קודם (במקרים מסוימים).
+
+---
+
+## סמכויות ועדת הערר (סעיף 205)
+
+ועדת ערר רשאית:
+1. לאשר את ההחלטה
+2. לבטל את ההחלטה
+3. להורות על שינוי בהחלטה
+4. להחזיר לועדה המקומית לדיון נוסף
+
+ועדת הערר פועלת כערכאה מינהלית וסמכויותיה דומות לאלו של בית משפט.
+
+---
+
+## עקרונות פסיקתיים נפוצים
+
+### 1. שיקול דעת מנהלי
+- לועדות תכנון יש שיקול דעת רחב
+- בית המשפט (וועדת הערר) יתערב רק אם השיקול לא סביר, שרירותי, או בחוסר סמכות
+
+### 2. האיזון בין זכויות קנייניות לאינטרס ציבורי
+- יש לאזן בין זכות הקניין של הפרט לבין האינטרס הציבורי
+- שני הערכים חשובים ויש לשקלם
+
+### 3. ההסתמכות על מומחים
+- חוות דעת מומחה חשובה אך לא קובעת
+- הועדה רשאית לסטות מחוות דעת אם תנמק
+
+### 4. הנמקת החלטות
+- כל החלטה חייבת להיות מנומקת
+- חוסר נימוק או נימוק לקוני עלול להביא לביטול ההחלטה
+
+### 5. שימת לב להשפעות
+- על הועדה לשקול השפעות על הסביבה, שכנים, תשתיות
+
+---
+
+## טיפים למומחה הגישה השיפוטית
+
+כשאתה מנתח החלטות בדיני תכנון ובניה, שים לב:
+
+1. **לאיזה סעיפים בחוק מתייחסים** - אלו המקורות המשפטיים הבסיסיים
+2. **אילו פסקי דין מצוטטים** - אלו המקורות הפסיקתיים שהשופט מסתמך עליהם
+3. **איך מאזנים בין ערכים מנוגדים** - זכות קניין מול אינטרס ציבורי
+4. **רמת ההתערבות** - האם השופט נוטה להתערב או להותיר החלטות בעינן
+5. **יחס לחוות דעת מומחים** - האם סומך עליהן או ביקורתי
+6. **רמת הנמקה** - האם מפורט או תמציתי
+
+זכור - זהו תחום משפטי טכני שדורש ידע מקצועי. השופטים בועדות ערר הם לרוב עורכי דין או אנשי מקצוע בתחום התכנון.