ספ המערכת + מפת-פערים (System Spec-Set & Gap Audit) #8

chaim · 2026-05-30T17:29:32Z

chaim commented

2026-05-30 17:29:32 +00:00

מהלך-יסוד לסגירת כשל-שורש חוזר (מזהים לא-קנוניים · מסלולי ingest אסימטריים · שערים ידניים שקופים): שכבת "מהו תקין" — חוקה + invariants מאומתים + מפת-פערים.

תת-פרויקט 1 — ספ המערכת (docs/spec/, 14 קבצים): 00-constitution (11 invariants גלובליים G1–G11), מחזור-חיים 01–07, חוצי-שלבים X1–X5. שלושה מודלי-סמכות (הנדסה ≥3 מקורות חיצוניים / תוכן-משפטי = יו"ר+מסמכי-פרויקט / פרויקטלי-תפעולי = runbooks).

תת-פרויקט 2 — מפת-פערים (docs/spec/gap-audit.md): 23 פערים → 8 יחידות-תיקון (4 קריטיים).

בסיס: docs/superpowers/specs/2026-05-30-system-spec-design.md + plans/2026-05-30-system-spec-set.md

היקף: תיעוד בלבד, אין שינויי קוד. היישום = תת-פרויקט 3.

🤖 Generated with Claude Code

מהלך-יסוד לסגירת כשל-שורש חוזר (מזהים לא-קנוניים · מסלולי ingest אסימטריים · שערים ידניים שקופים): שכבת "מהו תקין" — חוקה + invariants מאומתים + מפת-פערים. **תת-פרויקט 1 — ספ המערכת** (`docs/spec/`, 14 קבצים): 00-constitution (11 invariants גלובליים G1–G11), מחזור-חיים 01–07, חוצי-שלבים X1–X5. שלושה מודלי-סמכות (הנדסה ≥3 מקורות חיצוניים / תוכן-משפטי = יו"ר+מסמכי-פרויקט / פרויקטלי-תפעולי = runbooks). **תת-פרויקט 2 — מפת-פערים** (`docs/spec/gap-audit.md`): 23 פערים → 8 יחידות-תיקון (4 קריטיים). בסיס: docs/superpowers/specs/2026-05-30-system-spec-design.md + plans/2026-05-30-system-spec-set.md היקף: תיעוד בלבד, אין שינויי קוד. היישום = תת-פרויקט 3. 🤖 Generated with Claude Code

chaim added 28 commits 2026-05-30 17:29:32 +00:00

docs(spec): master design for system spec + integrity layer a5b22dadf3

Establishes the foundation to fix a recurring root-cause failure class
(non-canonical identifiers, asymmetric ingest paths, silent manual gates):

- Confirmed system mission (quasi-judicial decision assistant; human decides)
- Decomposition into 5 sub-projects (spec → audit → integrity layer → re-check → process agents)
- spec-set structure under docs/spec/ (lifecycle-organized + cross-cutting files)
- 11 global invariants + engineering rules, each backed by ≥3 authoritative sources
  (NCSC/JTC, FJC, CEPEJ, South Bucks; RAG/Lewis, Manning IR, Elastic/Pinecone/Weaviate;
   DAMA-DMBOK, ISO 8000, ISO 15489, Kleppmann, Codd, Fowler)
- 3-source verification protocol; UNVERIFIED items escalated, not decided solo

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(plan): implementation plan for system spec-set (sub-project 1) 1d01135e32

13 tasks across 3 phases (keystone constitution → lifecycle files → cross-cutting),
each verification-gated (≥3 sources or UNVERIFIED+escalate) with review checkpoints.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): scaffold docs/spec/ living spec-set c351d6d714

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 00-constitution — mission, 11 global invariants, engineering rules fd682d130f

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): reframe G2 example as structural asymmetry + note forthcoming files 1daaa4861b

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): scope ≥3-source rule to engineering decisions; reframe legal-content (G11) 6afd155dc1

Per chair clarification: the ≥3-authoritative-source verification protocol governs
ENGINEERING/architecture decisions only (G1–G10). Legal-domain content (G11) is the
authority of the chair + project docs (block-schema, decision-methodology, lessons,
skills/decision) — NOT externally triple-sourced.

- §2/§4/§5 scoped to engineering invariants; added the two-authority distinction
- G11 reframed: source-of-authority = chair + project docs; removed FJC/South Bucks/
  1958-statute as "sources to verify" and the UNVERIFIED flag
- Removed the "open items — primary-source verification" section (the over-application)
- Pruned now-orphaned legal sources from the appendix (kept NCSC/CEPEJ/FJC for G9/G10)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 01-ingest unified intake contract da80bcf0fe

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 01-ingest — trim §4 redundancy (reference INV-ING3) 9199214b7c

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 02-data-model entities + completeness contract 998194462f

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 03-retrieval corpora + retrieval invariants 72737df154

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): constitution index — add G9 to 03-retrieval row (consistency) 5e80bf560d

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 04-analysis-writing — 12 blocks + reasoned-decision invariants 1582556b0b

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 05-qa-review — QA gates + human gates c1872aa214

docs(spec): 05-qa-review — clarify neutral_background dual return path (critical fallback w/ passed=True); fix line ref c0ef90d722

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 06-export DOCX contract 0fd06659da

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): 07-learning loop b46d25f605

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X1-identifiers canonical model b0e4e14832

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X2-multi-company sync rules f0fd405f4e

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): constitution — document third authority model (project-operational) a0004f0274

X2/X3/X4 invariants are facts about this system's own integration/ops (no external
authority); they use מקור-סמכות=project runbooks, tied to a global engineering invariant.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X3-integration-deploy 951f2366e6

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X3 — replace out-of-repo memory links with plain mentions (self-containment) 7fd6d8cb95

docs(spec): constitution index — X3 enforces G2,G9 (operational) c881665b7c

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X4-agents map + reserved process-agents section b0351958db

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X5-audit-provenance 8c4b8cf19e

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X5 — file:line/name precision (log_search_bg, user param, active_draft_path) 380998da17

docs(spec): sign-off fixes — 06 index row (G2,G9), refresh stale §7 note, fix X3 G9 anchor niqqud e3880aef4e

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(spec): X1 — canonical case_number = official assigned number (no month invention); mixed-form reconciliation is a migration task ebfda74575

docs(spec): gap-audit — 23 findings mapped to invariants + proposed fix-units (sub-project 2) 28bed4906c

chaim added 1 commit 2026-05-30 17:38:33 +00:00

tasks(legal-ai): 8 fix-unit tasks (59-66) + 23 GAP subtasks from gap-audit d72d5429ed

Granularity (epic-per-fix-unit + subtask-per-gap) and dependency-aware/WSJF
prioritization both backed by ≥3 authoritative sources (SAFe/Pichler/OWASP/CVSS;
Wake-INVEST/Cohn/Agile-Alliance/Atlassian/SAFe).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

chaim referenced this issue from a commit

2026-05-30 17:53:47 +00:00

merge: System Spec-set + gap-audit (sub-projects 1+2)

chaim commented

2026-05-30 19:41:41 +00:00

נסגר: כל הקומיטים של ענף זה כבר מוכלים במלואם ב-main (מוזגו מוקדם יותר). אין diff למזג — סגירה לניקוי, התוכן כבר משולב.

chaim closed this pull request

2026-05-30 19:41:42 +00:00