case-summary

# Case Summary

A user arrives with a pile of legal documents — often hundreds or thousands — and asks for a summary. This skill is the playbook for doing that well, across any practice area.

The work is map-reduce: **map** the corpus across the dimensions that matter, **reduce** the hits into a memo. The skill does not prescribe a specific search tool — it describes the work. `references/BACKENDS.md` lists concrete implementations the agent can use today.

The core describes what every case has (parties, timeline, evidence, claims, exposure, defenses, procedural status, red flags). Practice-area playbooks (`references/PLAYBOOK-*.md`) specialize the core for specific domains. Specialized document types (depositions, medicals, discovery, liens) route out to dedicated sibling skills per `references/ROUTING.md`.

---

## Related skills

- `case-chronology` — when the deliverable is a dated timeline rather than a full memo
- `case-intake-initial-fact-memo` — for commercial-litigation intake memos
- `case-viability-report` — for go/no-go screening before accepting a matter
- `pi-demand-summary` — when the objective is a PI settlement package, not a case evaluation
- `demand-letter` — when the objective is a pre-suit demand letter
- `deposition-summary` — for deposition transcripts; route per `ROUTING.md`
- `discovery-summary` — for interrogatory/RFP/RFA responses; route per `ROUTING.md`
- `medical-record-chronology` — for dense medical-records sets; route per `ROUTING.md`
- `medical-treatment-summary` — for causation-focused treatment narratives
- `evidence-liability-summary` — for plaintiff-side liability element breakdowns
- `lien-resolution-summary` — for post-settlement lien tracking
- `legal-strategy-summary` — for motion-and-discovery roadmap deliverables
- `settlement-summarization` — for post-memo settlement activity

---

## Checkpoint A: pre-ingest intake (mandatory)

Ask every time unless the user says "use defaults" or "just go." Gather:

1. **Practice area guess** — PI, commercial, IP, regulatory, criminal, family, bankruptcy, etc. The agent can update this after Inventory, but a guess narrows the initial playbook loader.
2. **Expected document types** — pleadings, discovery, depositions, medicals, contracts, corporate records.
3. **Custodians / sources** — who produced the files, and in what posture (client production, opposing-counsel production, third-party subpoena).
4. **Date range** — anchor the timeline.
5. **User objective** — evaluation memo, viability screen, demand prep, settlement prep, strategy roadmap. Different objectives trigger different sibling skills per `ROUTING.md`.
6. **Privilege posture** — work-product only, attorney-client privileged, or litigation-ready.
7. **Venue / jurisdiction** — affects SOL, statutory-notice requirements, governing law.

**Defaults** (if the user doesn't answer): PI/tort playbook; evaluation memo; attorney work-product; U.S. state-court posture. Label every default explicitly in the memo header.

---

## The loop

**1. Ingest.** Put the corpus into something searchable. See `references/WORKFLOW.md` for the phase description and `references/BACKENDS.md` for implementations.

**2. OCR.** Any PDF that isn't already searchable will not be indexed usefully. Handle OCR before searching on files that need it. Asynchronous — keep moving.

**3. Inventory.** Pull the object list. Skim filenames to build a mental model: what practice area, what kinds of documents, how many of each. This is the only time the agent cares about every file.

**4. Diagnose practice area.** From the inventory plus a single global-overview query, pick one or more playbook modules from `references/PLAYBOOK-*.md`. Each has `triggers` in its frontmatter that match filenames and content signals. Record the choice in the memo header. When no module fits, proceed core-only and note it.

**5. Map — iterative search per dimension.** For each of the eight core dimensions in `references/CORE-DIMENSIONS.md`:

- Run the base queries from `references/SEARCH-PLAYBOOK.md`.
- Run the module queries from each loaded playbook for that dimension.
- Read the top 3–10 chunks per query. Cite everything the memo will rely on by object name + page.
- Where the corpus contains specialized document clusters (≥1 full deposition, dense medical records set, discovery responses, lien correspondence), **delegate** per `references/ROUTING.md` and consume the sibling skill's output rather than summarizing inline.

Don't brute-force read every file. Drive the search with focused queries, pull the 3–10 most relevant chunks per query, follow up when hits are load-bearing, route when a cluster warrants a sibling skill.

**6. Reduce — synthesize.** Assemble the memo using `references/OUTPUT-TEMPLATE.md`'s core skeleton, plus the output sections contributed by each loaded playbook. Every claim cites an object + page (or chunk ID). No citation = cut or label as assumption.

**7. Review.** Run the quality checklist below (core items + playbook-specific items). Flag any unsatisfied items.

---

## Checkpoint B: post-memo alignment (mandatory)

After delivering the draft, ask:

1. Did the right playbook module(s) get loaded? (List them.)
2. Which sibling skills were invoked, and did their outputs get integrated correctly?
3. Are there coverage gaps — dimensions the agent couldn't populate from the corpus?
4. Any claims in the memo that depend on unverified legal citations flagged `[VERIFY]`?
5. Is attorney review explicitly required before any downstream use?

If the user doesn't answer, default to: list the loaded playbooks and invoked siblings; flag any dimension that returned "no evidence found"; require attorney review.

---

## What this skill does not do

- It does not value the case. Ranges belong in the memo when a loaded playbook supplies the methodology, but the skill doesn't substitute for attorney judgment about jurisdiction, venue, or negotiation posture.
- It does not resolve liens, draft pleadings, or send demands. It identifies them and routes to the sibling skill that does.
- It does not replace an attorney review of the final memo. Always label the memo AI-generated and require sign-off.

---

## Scale notes

- **< 20 files:** skip the search loop; read every document directly. See `references/BACKENDS.md` small-corpus recipe.
- **20–200 files:** one pass through the search playbook, one memo. ~1 hour.
- **200–2,000 files:** expect 40–80 targeted searches across the dimensions, checkpoint notes as the agent goes. Multi-hour run.
- **2,000+ files:** expect 100+ targeted queries; tighten scoping with module-specific filters and entity-mode searches; budget multi-hour run time. One corpus — the agent works it harder, not by fragmenting it.

---

## Core quality checklist

Every matter:

- [ ] Every file is either searched-over or explicitly noted as out-of-scope
- [ ] Every OCR job finished (or its absence is noted in the memo)
- [ ] Parties, venue, posture correct with citations
- [ ] Timeline continuous; gaps >30 days flagged
- [ ] Each claim element has at least one evidentiary citation or explicit gap note
- [ ] Each asserted defense has supporting-evidence citation or a "pled without support" note
- [ ] Exposure/remedies section shows methodology, not an attorney valuation
- [ ] Red flags section is honest, not decorative — each item names a next action
- [ ] Every claim in the memo traces to an object + page or is labeled an assumption
- [ ] Unverified statutes/rules/cases marked `[VERIFY]`
- [ ] Memo labeled AI-generated, requires attorney review

**Plus** every playbook-specific item from each loaded `PLAYBOOK-*.md`'s Quality checklist section.

---

## Troubleshooting

- **OCR didn't run on a file.** The file isn't searchable. Record the file in the memo's out-of-scope list, try a different OCR engine if the backend supports one, or ask the user to re-upload a text-searchable version.
- **Search returns noise, not relevant hits.** Run a global-overview query first to discover the vocabulary the documents use; re-issue targeted queries using that vocabulary. Narrow with keyword anchors (party names, dates, case numbers) once known.
- **Practice area ambiguous; no playbook fits cleanly.** Proceed core-only (core dimensions + `SEARCH-PLAYBOOK.md` base queries). Note the ambiguity in `VIII Strengths / Weaknesses / Red Flags`. Offer the user a recommendation to narrow.
- **Wrong playbook picked.** Re-enter step 4 (Diagnose practice area) with the new information. Load the correct module; keep hits from the previous pass that still apply.
- **Corpus too large for a single pass.** Prioritize the dimensions that matter for the user's stated objective. Run a triage pass (parties, posture, top 3 claims, headline exposure) first, then expand to full coverage if time allows. Surface to the user which dimensions are deep vs. triage in the memo header.
- **Sibling skill unavailable or returns nothing useful.** Note it in the memo header (`Sibling skills invoked`), record the cluster the agent wanted to route, and summarize the cluster inline with reduced depth. Attorney review should consider whether a focused sibling-skill run is warranted before the memo is used downstream.
- **Multi-matter corpus (the folder mixes unrelated cases).** Surface to the user before proceeding. The skill summarizes one matter at a time; don't silently merge.