Add decision-writing methodology based on FJC, Garner, Posner sources

"בית ספר להחלטות" Phase 2 — the system now has formal analytical
methodology for building quasi-judicial decisions, separate from
Dafna's writing style (SKILL.md) and content checklists.

What was done:
- Downloaded 5 authoritative sources (~341K words): FJC Judicial
  Writing Manual (1991+2020), Garner Legal Writing in Plain English,
  Posner How Judges Think, Scalia/Garner Making Your Case
- Extracted principles from all sources into intermediate docs
- Synthesized into docs/decision-methodology.md (3,400 words,
  12 sections, 10 guiding principles)
- Integrated methodology into block-yod prompt via {methodology_guidance}
- Restructured legal-writer agent workflow to follow analytical stages
- Made "answer all claims" flexible (bundle/skip via chair_directions)
- Added methodology compliance check (#7) to legal-qa agent
- Updated all knowledge files (CLAUDE.md, SKILL.md, lessons, corpus)

Three-layer architecture:
1. Methodology (decision-methodology.md) — universal, how to think
2. Content checklists (lessons.py) — specific per appeal subtype
3. Style (SKILL.md) — Dafna's personal writing patterns

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-12 23:29:16 +00:00
parent ed8502d46b
commit be9fa9e712
25 changed files with 28217 additions and 36 deletions

View File

@@ -202,3 +202,53 @@ Licensing appeals are not homogeneous — the discussion structure varies signif
- 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