docs(ia): אבחון משטח-ההפעלה + ספ-יעד X17 — מפה אחת לכל הדפים/כפילויות/סנכרון (#127) #206

Merged
chaim merged 1 commits from worktree-ia-audit-docs into main 2026-06-11 20:19:59 +00:00
Owner

הקשר

חיים (2026-06-11): "המערכת מסובכת מדי לתפעול… כל הדפים מפוזרים ואין לי מושג מה כל אחד עושה והאם יש כפילויות." יוזמת #127, היקף=משטח-ההפעלה (1א), תוצר=מסמך-אבחון+ספ-יעד X17 (2א), עוצרים על המסמך (3א).

איך הופק

סריקת-עומק רב-סוכנית: 18 סוכנים, 6 אשכולות × 3 שלבים (קטלוג → אימות-אדוורסרי מול הקוד → תכנון-יעד מגובה-מקורות). 34 משטחים קוטלגו · 37 ממצאים אומתו ב-file:line · 80+ מקורות סמכותיים (≥3 לכל עקרון).

תוצרים

  • docs/ia-audit-redesign.md — מצב-קיים: 5 מחלות-שורש (16 פערי-סנכרון · משטחי-אישור כפולים · 6 נתונים-שגויים · 5 מתים · כפילות-ניווט) + ממצאים פר-אשכול בטבלאות.
  • docs/spec/X17-information-architecture.md — ספ-יעד: INV-IA1–IA6 מרימים את G2 (מקור-אמת יחיד) ו-G10 (שערים-אנושיים) לשכבת-המשטח; משטח-יעד (3 משטחי-intent: /approvals=לאשר · /operations=לנטר · /settings=להגדיר + בעלים-יחיד לכל ישות).
  • docs/spec/README.md — אינדקס מעודכן.

התובנה המרכזית

רוב 37 הממצאים הם ביטוי-UI אחד של G2 מופר שלא הורחב לשכבת-ה-UI — אותו מספר ב-2 מקומות, 2 שערים לאותה החלטה, מספרים שלא מתעדכנים. זה בדיוק "המסובך לתפעול". הקריטי: אשכול למידה+סגנון (10 ממצאים) — שני שערי-אישור ו-applied_to_skill אינפורמטיבי-בלבד.

דאבל-צ'ק מול הקיים

  • ui-audit.md = שכבת-קוד פר-רכיב (FU-10). X17 = שכבת-IA מעל X6. לא כופל — מפנה.
  • G10 נשמר 100% — מסירים משטח/ערוץ כפול, לא שער. "שער אחד" = מקום-אחד-להחליט, לא אפס-החלטה.

Invariants

  • מקיים G2 — מזהה וממפה את הפרות-ה-UI; X17 מקדד את התיקון.
  • מקיים G10 / INV-LRN1 — כל שער-אנושי נשמר; רק כפילות-משטח מוסרת.
  • דלתות-ספ מומלצות (לאישור-יו"ר): X6 (INV-UI7/8), 07-learning §0.4/0.6 (שער+ערוץ אחד, הסרת applied_to_skill), 00-constitution G2 (תאום-מתודולוגיה).

הבא (לא בוצע — 3א)

בקלוג-איחוד מתועדף ב-#127.6, ב-3 גלים (sync-fixes זולים → איחוד-משטחים → ניווט). הכרעת-יו"ר לפני גל-2/3.

ref: #127 · feedback_operational_simplicity

🤖 Generated with Claude Code

## הקשר חיים (2026-06-11): *"המערכת מסובכת מדי לתפעול… כל הדפים מפוזרים ואין לי מושג מה כל אחד עושה והאם יש כפילויות."* יוזמת **#127**, היקף=משטח-ההפעלה (1א), תוצר=מסמך-אבחון+ספ-יעד X17 (2א), עוצרים על המסמך (3א). ## איך הופק סריקת-עומק רב-סוכנית: **18 סוכנים, 6 אשכולות × 3 שלבים** (קטלוג → אימות-אדוורסרי מול הקוד → תכנון-יעד מגובה-מקורות). **34 משטחים קוטלגו · 37 ממצאים אומתו ב-`file:line` · 80+ מקורות סמכותיים (≥3 לכל עקרון).** ## תוצרים - **`docs/ia-audit-redesign.md`** — מצב-קיים: 5 מחלות-שורש (16 פערי-סנכרון · משטחי-אישור כפולים · 6 נתונים-שגויים · 5 מתים · כפילות-ניווט) + ממצאים פר-אשכול בטבלאות. - **`docs/spec/X17-information-architecture.md`** — ספ-יעד: **INV-IA1–IA6** מרימים את **G2** (מקור-אמת יחיד) ו-**G10** (שערים-אנושיים) לשכבת-המשטח; משטח-יעד (3 משטחי-intent: `/approvals`=לאשר · `/operations`=לנטר · `/settings`=להגדיר + בעלים-יחיד לכל ישות). - **`docs/spec/README.md`** — אינדקס מעודכן. ## התובנה המרכזית רוב 37 הממצאים הם ביטוי-UI אחד של **G2 מופר שלא הורחב לשכבת-ה-UI** — אותו מספר ב-2 מקומות, 2 שערים לאותה החלטה, מספרים שלא מתעדכנים. זה בדיוק "המסובך לתפעול". הקריטי: אשכול **למידה+סגנון** (10 ממצאים) — שני שערי-אישור ו-`applied_to_skill` אינפורמטיבי-בלבד. ## דאבל-צ'ק מול הקיים - `ui-audit.md` = שכבת-**קוד** פר-רכיב (FU-10). X17 = שכבת-**IA** מעל X6. **לא כופל** — מפנה. - **G10 נשמר 100%** — מסירים משטח/ערוץ **כפול**, לא שער. "שער אחד" = מקום-אחד-להחליט, לא אפס-החלטה. ## Invariants - **מקיים G2** — מזהה וממפה את הפרות-ה-UI; X17 מקדד את התיקון. - **מקיים G10 / INV-LRN1** — כל שער-אנושי נשמר; רק כפילות-משטח מוסרת. - **דלתות-ספ מומלצות (לאישור-יו"ר):** X6 (INV-UI7/8), 07-learning §0.4/0.6 (שער+ערוץ אחד, הסרת applied_to_skill), 00-constitution G2 (תאום-מתודולוגיה). ## הבא (לא בוצע — 3א) בקלוג-איחוד מתועדף ב-#127.6, ב-3 גלים (sync-fixes זולים → איחוד-משטחים → ניווט). **הכרעת-יו"ר לפני גל-2/3.** ref: #127 · feedback_operational_simplicity 🤖 Generated with [Claude Code](https://claude.com/claude-code)
chaim added 1 commit 2026-06-11 20:19:51 +00:00
חיים (2026-06-11): "המערכת מסובכת מדי לתפעול." סריקת-עומק רב-סוכנית (18 סוכנים,
6 אשכולות × קטלוג→אימות-אדוורסרי→תכנון-יעד) מיפתה 34 משטחים ואימתה 37 ממצאים
(file:line). כולם ביטוי-UI אחד של G2 מופר שלא הורחב לשכבת-ה-UI.

תוצרים:
- docs/ia-audit-redesign.md — מצב-קיים: 5 מחלות-שורש (16 פערי-סנכרון, משטחי-אישור
  כפולים, 6 נתונים-שגויים, 5 מתים, כפילות-ניווט), ממצאים פר-אשכול בטבלאות.
- docs/spec/X17-information-architecture.md — ספ-יעד: INV-IA1..IA6 מרימים את G2
  (מקור-אמת יחיד) ו-G10 (שערים-אנושיים) לשכבת-המשטח; משטח-יעד (3 משטחי-intent +
  בעלים-יחיד לכל ישות); כל invariant מגובה ≥3 מקורות (NN/g, GOV.UK, USWDS,
  Rosenfeld/Morville, TkDodo/TanStack, Krug).
- docs/spec/README.md — אינדקס מעודכן (X1–X17 + ia-audit-redesign).

יחס לקיים (דאבל-צ'ק): ui-audit.md=שכבת-קוד (FU-10); X17=שכבת-IA מעל X6. לא כופל.
G10 נשמר 100% — מסירים משטח/ערוץ כפול, לא שער ("שער אחד"=מקום-אחד-להחליט).
עוצרים על המסמך (3א) — בקלוג-איחוד ב-#127.6, ביצוע באישור-יו"ר.

Invariants: מקיים G2 (מזהה+ממפה הפרות-UI), מקיים G10/INV-LRN1 (שערים נשמרים),
ממליץ דלתות-ספ ל-X6/07-learning/00-constitution (לאישור).

ref: #127 · feedback_operational_simplicity

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
chaim scheduled this pull request to auto merge when all checks succeed 2026-06-11 20:19:58 +00:00
chaim merged commit f1ea4fc00a into main 2026-06-11 20:19:59 +00:00
chaim deleted branch worktree-ia-audit-docs 2026-06-11 20:20:00 +00:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ezer-mishpati/legal-ai#206