Chaim
927be5c6bb
Documents the prospective held-out methodology shipped in PR #337: why a clean retrospective held-out is impossible (lessons stored universal/untagged → no leave-one-out), and how the system instead captures a clean generalization datapoint at final-upload — before this case's lessons are folded — via a style_distance snapshot + lesson-pool size into style_distance_history, surfaced by GET /api/learning/style-distance-history. Adds §0.7, wires step [7] MEASUREMENT and INV-LRN4 to it. Notes the change_percent style/content confound and the one-time clean window. Invariants documented: INV-LRN4 (this is its trend surface), G2 (reuses style_distance + appeal_type_rules — no parallel metric path). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
ספ המערכת — עוזר משפטי (Living System Spec)
זהו מקור-האמת הקנוני ל"מהו תקין" במערכת. שער-הכניסה: 00-constitution.md. כל invariant מגובה ב-≥3 מקורות סמכותיים; פריט לא-מאומת מסומן ⚠ UNVERIFIED ומועלה ליו"ר.
מבנה: 00 חוקה · 01–07 מחזור-חיים · X1–X17 חוצי-שלבים. ראה אינדקס מלא בחוקה.
- X1–X5: מזהים · רב-חברתי · אינטגרציה+deploy · סוכנים · audit.
- X6–X10 (מחזור-2, 8 משטחי-האפליקציה): חוזה UI↔API · לקוח-Paperclip · מילוי-שדות · חוזה כלי-MCP · deploy/env/secrets.
- X11–X14 (הרחבות-תחום): citator פנימי (תיקוף-הלכות) · יומונים כשכבת-גילוי (radar) · אחזור-פסיקה אוטומטי מנט המשפט (שירות) · אחסון-אובייקטים (MinIO/S3, הגירת
data/). - X15–X16 (ארכיטקטורת-יסוד): שער-הפלטפורמה (Paperclip מאחורי Port — G12, מיישם G2) · עמידות-פייפליין (LangGraph כספרייה — checkpointing/replay, מחזק G3).
- X17 (ארכיטקטורת-מידע): X17-information-architecture.md — משטח-ההפעלה (דפים/תורים/ניווט/cache); INV-IA1–IA6 מרימים את G2 ו-G10 לשכבת-ה-UI. מיישם feedback_operational_simplicity.
מפות-ממצאים: gap-audit.md (GAP-01..62 → FU-1..15; מחזור-1 ✅ הושלם, מחזור-2 פתוח) · ui-audit.md (ביקורת 13 דפי-UI, שכבת-קוד) · ia-audit-redesign.md (34 משטחים, 37 ממצאים, שכבת-IA/הפעלה → X17, #127). בסיס-עיצוב: docs/superpowers/specs/2026-05-30-system-spec-design.md