Um Claude Skill que transforma o dossiê de um caso de danos pessoais — prontuários médicos, faturas, documentação de perda salarial, o boletim de ocorrência e as anotações do caso do escritório — em um primeiro rascunho de carta de demanda de acordo. Ele monta uma cronologia médica datada com uma citação à página do dossiê atrás de cada entrada, itemiza os danos especiais a partir das faturas, calcula uma faixa de danos gerais a partir do playbook de multiplicadores do escritório e monta a carta a partir do template do escritório. Cada valor no rascunho remete a uma página fonte; cada afirmação que os prontuários não sustentam fica listada sob “dados insuficientes” em vez de ser escrita na carta. O advogado edita e assina. O skill nunca define o valor de demanda final e nunca envia.
A revisão do advogado é obrigatória. Este skill rascunha; ele não advoga. A faixa de danos gerais que ele produz é aritmética sobre o próprio playbook do escritório, não uma avaliação jurídica. O advogado define o valor da demanda, confirma cada fato citado contra o dossiê e responde pela carta que sai.
Quando usar
Um escritório de danos pessoais do lado do autor onde os paralegais montam os pacotes de demanda e uma carta de 6 a 12 páginas leva de 3 a 6 horas de redação além da revisão dos prontuários. O gargalo é o primeiro rascunho, não o juízo jurídico.
O escritório tem um template de carta de demanda escrito e uma metodologia de danos (faixas de multiplicador por gravidade da lesão, ou uma diária). O skill estrutura o rascunho em torno do método do escritório; ele não inventa um.
Os prontuários já estão coletados e convertidos em texto (PDF com OCR, ou uma exportação de recuperação de prontuários). O skill rascunha a partir dos prontuários que existem — ele não corre atrás de faturas faltantes.
Quando NÃO usar
Definir o valor da demanda. O skill produz uma faixa a partir do playbook de multiplicadores. O advogado define o valor — o número é uma decisão estratégica que pondera o foro, o regulador de sinistros, a força da responsabilidade e os limites da apólice que o skill não modela.
Casos com responsabilidade disputada ou complexidade de culpa comparativa. Quando a responsabilidade é toda a briga, a carta de demanda é um documento de advocacia que o advogado redige. O skill é para casos de responsabilidade clara, de tecido mole a moderados, onde o trabalho é montar o dossiê, não discutir o nexo causal.
Peças de litígio. Uma carta de demanda é pré-processual. Petições, moções e respostas de descoberta são documentos judiciais com suas próprias regras — fora de escopo.
Opinião médica. O skill resume o que os prontuários dizem (diagnóstico, tratamento, impressões do provedor). Ele não infere prognóstico, nexo causal ou permanência além do que um provedor escreveu. Essas são opiniões médicas; vêm do médico assistente ou de um perito contratado.
Prontuários com PHI que você não pode processar sob seus acordos. Informação de saúde protegida (PHI) circula por este skill. Confirme que seu deploy do Claude e seus termos de contratação com o cliente a cobrem antes de qualquer prontuário entrar (ver Pontos de atenção).
Setup
Coloque o bundle. Ponha apps/web/public/artifacts/demand-letter-drafter-claude-skill/SKILL.md no seu diretório de skills do Claude Code junto com a pasta references/.
Escreva o template de demanda do escritório. Substitua o esqueleto em references/1-demand-letter-template.md pela carta real do escritório — ordem das seções, boilerplate, o parágrafo de demanda e prazo, o bloco de assinatura. O skill monta dentro deste template; é a voz do escritório, não a do skill.
Codifique o playbook de danos. Preencha references/2-damages-playbook.md com a metodologia do escritório: faixas de multiplicador por gravidade da lesão (a faixa comum é 1.5-5× dos danos especiais; lesões graves ou desfigurantes correm mais alto), a diária se o escritório usa uma, e quaisquer tetos ou regras específicas de jurisdição que o escritório acompanhe. Sem este arquivo o skill não tem base para uma faixa de danos gerais e se recusará a produzir uma.
Defina o schema da cronologia.references/3-medical-chronology-schema.md define as colunas (data do atendimento, provedor, tratamento, valor faturado, página do dossiê) e o formato de citação. Mantenha o formato de citação que o escritório usa para que o advogado possa verificar contra as mesmas referências de página.
Faça um dry-run em três casos encerrados. Rode o skill em três dossiês já resolvidos onde a demanda é conhecida. Compare o total de danos especiais dele com os especiais reais, a cronologia dele com a do paralegal, e a faixa de danos gerais dele com o que o escritório demandou. Ajuste as faixas do playbook até que a faixa enquadre a demanda histórica.
O que o skill faz
Sete passos. A cronologia médica é montada antes da aritmética de danos, porque cada dólar de especiais e cada linha da narrativa de lesões cita uma entrada da cronologia, e cada entrada da cronologia cita uma página do dossiê.
Indexa o conjunto de prontuários. Ingere os prontuários, faturas, documentação salarial, boletim de ocorrência e anotações do caso. Monta um índice de páginas para que cada citação posterior resolva para um documento e página específicos. Arquivos ilegíveis (OCR falho, só imagem) são listados, não pulados em silêncio.
Monta a cronologia médica datada. Uma linha por data de atendimento: provedor, queixa, tratamento, valor faturado e a página do dossiê de onde veio. As lacunas no tratamento são sinalizadas (uma lacuna de 6 semanas entre a visita ao pronto-socorro e o primeiro retorno é um fato que o regulador vai usar; o advogado deveria saber antes de a carta sair, não depois).
Itemiza os danos especiais. Totaliza as faturas médicas por provedor, soma a perda salarial documentada e soma os custos do próprio bolso. Cada linha cita a página da sua fatura. O skill sinaliza faturas referenciadas nos prontuários mas ausentes do dossiê, e gravames ou saldos que ele não consegue conciliar — esses vão para o advogado como “confirmar antes de enviar”, não para o total como um chute.
Rascunha a narrativa de responsabilidade e fatos. A partir do boletim de ocorrência e das anotações do caso, rascunha a seção do como-aconteceu. Afirmações que o boletim não sustenta são sinalizadas, não escritas. Onde o boletim e o relato do cliente divergem, o skill expõe o conflito em vez de escolher um.
Rascunha a narrativa de lesões e tratamento. Fundamentada na cronologia — diagnóstico, curso do tratamento, impressões do provedor, status atual conforme os prontuários enunciam. Sem linguagem de prognóstico ou permanência a menos que um provedor a tenha escrito; se o escritório quer um argumento de permanência, isso é sinalizado como exigindo a declaração do médico assistente.
Calcula a faixa de danos gerais. Aplica a faixa de multiplicador do playbook aos especiais (ou o método de diária, conforme o playbook). A saída é uma faixa com a banda mostrada — “$X-$Y a 2.5-4× de especiais de $Z” — explicitamente rotulada como um ponto de partida. O skill não escolhe um ponto na faixa.
Monta o rascunho e o checklist de revisão. Preenche o template do escritório. Produz um checklist pareado: cada valor com sua citação fonte, cada lacuna sinalizada, cada item de “dados insuficientes”, e a linha do prazo de resposta deixada como um placeholder para o advogado definir. A carta é um rascunho; o checklist é como o advogado a verifica em minutos em vez de reler o dossiê.
Realidade de custo
Tokens do LLM — um dossiê completo são 40-120k tokens de entrada (prontuários, faturas, boletim) e 4-8k de saída (cronologia + rascunho). Às taxas do Claude Sonnet isso é aproximadamente $0.30-0.90 por demanda; em um conjunto de prontuários pesado com Opus, $1.50-4. Centavos a dólares contra as horas de redação que compensa.
Tempo de paralegal / advogado — o ganho. Um pacote de demanda é comumente citado em 3-6 horas de redação de paralegal. O skill produz a cronologia e o primeiro rascunho em minutos; o paralegal verifica e preenche as lacunas, o advogado edita e define o valor. A economia realista é a metade de redação, não a metade de revisão — chame de 2-4 horas por demanda.
Tempo de setup — 45 minutos mais a redação do template e do playbook do escritório (uma ou duas horas únicas que se pagam ao longo de cada caso).
Métrica de sucesso
Tempo de rascunho-ao-advogado — tempo de relógio de “prontuários coletados” até “rascunho na mesa do advogado”. Deve cair de 1-2 dias (na fila de um paralegal) para o mesmo dia.
Taxa de conciliação de especiais — proporção de demandas onde o total de danos especiais do skill bate com o total verificado sem correção. Mire acima de 90%; as falhas apontam para uma lacuna de indexação de prontuários ou de parsing de faturas, não para uma razão de abandonar o rascunho.
Profundidade de edição do advogado — quanto do rascunho sobrevive até a carta assinada. Acompanhe; se a narrativa está sendo reescrita por completo, o template ou os critérios de seleção de casos precisam de ajuste, não o skill.
Frente às alternativas
Frente ao EvenUp Express Demands e serviços gerenciados similares. O EvenUp combina redação com IA com redatores humanos e entrega um pacote pronto; o turnaround anunciado é de 1-24 horas, embora os escritórios reportem entrega de vários dias na prática. A troca é controle e residência de dados: o serviço gerenciado guarda seu PHI e é dono do playbook; este skill roda no seu próprio Claude com seu template e seu método de danos, e o rascunho nunca sai do seu ambiente. Use o serviço gerenciado quando quiser o pacote devolvido pronto e estiver confortável com os termos de dados e turnaround; use o skill quando quiser o rascunho internamente, hoje, sobre sua própria metodologia.
Frente ao Eve e plataformas de preparação completa de caso. O Eve e as plataformas de IA para litígio trabalham o caso inteiro, não só a demanda. Se o escritório quer avaliação de caso, analytics de lacunas de tratamento e preparação de litígio como uma suíte, isso é uma compra de plataforma. O skill é um passo desse pipeline — o rascunho de demanda — para escritórios que não estão prontos para comprar a plataforma.
Frente ao paralegal rascunhando do zero. O status quo. Produz a voz e o juízo do escritório mas é o caminho mais lento e o que mais varia conforme quem rascunhou. O skill padroniza o primeiro rascunho e a disciplina de citações; o juízo do paralegal se move para a verificação e os casos de borda.
Pontos de atenção
Fatos ou valores médicos alucinados. Uma carta de demanda com um diagnóstico inventado ou uma fatura inflada é uma perda de credibilidade que o regulador vai explorar, e um risco de sanções se chegar a uma peça. Proteção: cada entrada da cronologia, cada linha de danos especiais e cada afirmação de fato cita uma página do dossiê; qualquer coisa que o skill não consiga citar vai para a lista de “dados insuficientes”, não para a carta. O advogado verifica contra as páginas citadas.
A faixa de multiplicador lida como uma avaliação. A banda de danos gerais é aritmética sobre o playbook do escritório, cega ao foro, ao histórico do regulador, à força da responsabilidade e aos limites da apólice. Proteção: a saída é uma faixa rotulada com a banda mostrada, nunca um único número; o advogado define a demanda.
Exposição de PHI. O skill processa prontuários médicos — informação de saúde protegida. Proteção: confirme os termos de dados do deploy do Claude (postura de retenção zero / sem treinamento, e um BAA onde seu programa de compliance exigir) e que seus termos de contratação com o cliente cobrem o processamento com IA antes de qualquer prontuário entrar. Rode em um deploy que cumpra o programa HIPAA do escritório; nunca um endpoint de consumidor.
Lacunas de tratamento e conflitos de responsabilidade enterrados. Um rascunho que se lê limpo mas omite uma lacuna de tratamento ou um conflito boletim-vs-cliente prepara o advogado para ser surpreendido pelo regulador. Proteção: lacunas e conflitos são expostos no checklist como sinalizações explícitas, não suavizados na narrativa.
Faturas faltantes contadas como zero. Se a fatura de um provedor é referenciada mas está ausente do dossiê, totalizar só o que está presente subestima os especiais e a demanda. Proteção: faturas referenciadas-mas-faltantes são sinalizadas “confirmar antes de enviar” e excluídas do total em vez de chutadas; o paralegal as recupera antes de a demanda ser finalizada.
Playbook desatualizado ou de jurisdição errada. Tetos de danos, regras de honorários e exigências de notificação pré-processual variam por jurisdição e mudam. Proteção: o arquivo do playbook é a única fonte que o skill cita para suas faixas; revise-o contra as regras vigentes por caso, e trate tetos e exigências de notificação como confirmados pelo advogado, não afirmados pelo skill.
Stack
O bundle fica em apps/web/public/artifacts/demand-letter-drafter-claude-skill/:
SKILL.md — a definição do skill
references/1-demand-letter-template.md — o esqueleto de carta de demanda do escritório para substituir pelo template real do escritório
references/2-damages-playbook.md — a metodologia de danos do escritório (faixas de multiplicador, diária, notas de jurisdição)
references/3-medical-chronology-schema.md — o schema da tabela de cronologia e o formato de citação
Ferramentas: Claude. Para o padrão de extração estruturada por trás do passo de cronologia, ver extração de dados de contratos. Ferramentas adjacentes no cluster de danos pessoais: EvenUp, Eve.
---
name: demand-letter-drafter
description: Draft a first-pass personal-injury settlement demand letter from a case file (medical records, bills, wage-loss docs, police report, case notes). Build a cited medical chronology, itemize special damages, compute a general-damages range from the firm's playbook, and assemble the letter into the firm's template. Every figure cites a record page; unsupported claims go to an "insufficient data" list. Attorney review required — never sets the demand number, never sends.
---
# Personal-injury demand letter drafter
## When to invoke
Use this skill when a paralegal or attorney has a collected, text-readable PI case file and wants a first-draft demand letter — a cited medical chronology, itemized special damages, a general-damages range, and a letter assembled into the firm's template.
Do NOT invoke this skill for:
- **Setting the final demand number** — output is a range; the attorney sets the figure.
- **Disputed-liability or comparative-fault cases** — the demand is an advocacy document the attorney drafts; this skill is for clear-liability assembly work.
- **Litigation filings** — complaints, motions, discovery responses are court documents, out of scope.
- **Medical opinion** — the skill reports what providers wrote; it does not infer prognosis, causation, or permanency.
**Attorney review is required on every draft.** The skill assembles and cites; the attorney verifies every cited fact, sets the demand number, and signs.
## Inputs
- Required: `case_file_path` — directory of text-readable records (OCR'd PDFs, exports). Bills, medical records, wage-loss docs, police report, case notes.
- Required: `template` — path to the firm's demand-letter template (`references/1-demand-letter-template.md` is the starting skeleton).
- Required: `damages_playbook` — path to the firm's damages methodology (`references/2-damages-playbook.md`).
- Optional: `chronology_schema` — path to the chronology schema (`references/3-medical-chronology-schema.md`); defaults to the bundled schema.
- Optional: `client_account` — the client's written/recorded account of the incident, for the facts-conflict check.
## Reference files
- `references/1-demand-letter-template.md` — the firm's demand-letter skeleton.
- `references/2-damages-playbook.md` — multiplier bands, per-diem rate, jurisdiction notes.
- `references/3-medical-chronology-schema.md` — chronology columns and citation format.
## Method
Seven steps. Chronology before damages, because every special-damages line and every injuries-narrative sentence cites a chronology entry, and every chronology entry cites a record page.
### 1. Index the record set
Ingest every file. Build a page index keyed by document name + page so later citations resolve. List unreadable files (failed OCR, image-only, password-locked) in an `unprocessed` block — never silently skip them. Stop and report if the bills or the medical records are entirely absent; there is no demand to draft without them.
### 2. Build the dated medical chronology
One row per date of service, per the chronology schema:
| Date | Provider | Complaint / treatment | Billed | Record page |
- Sort by date.
- Flag treatment gaps over the playbook's gap threshold (default 30 days between consecutive visits) — adjusters use gaps to argue the injury resolved.
- Flag any entry where the date, provider, or billed amount is unreadable in the source — cite the page and mark `[illegible — confirm]`.
### 3. Itemize special damages
- **Medical specials** — total billed by provider, citing each bill page. Use billed amounts, not paid/adjusted, unless the playbook says otherwise (jurisdictions differ on the collateral-source and billed-vs-paid question — the playbook controls).
- **Wage loss** — from the documentation (employer letter, pay stubs, tax records), citing the page.
- **Out-of-pocket** — mileage, devices, co-pays, with citations.
- Flag bills referenced in records but missing from the file as `missing — retrieve before sending`. Exclude them from the total. Do not estimate a missing bill.
- Flag liens and unreconciled balances for attorney confirmation.
### 4. Draft the liability and facts narrative
From the police report and case notes, draft how the incident happened. Statements the report does not support are flagged, not written. If `client_account` is provided and it conflicts with the report, surface the conflict — do not pick one side.
### 5. Draft the injuries and treatment narrative
Grounded in the chronology: diagnosis, course of treatment, provider impressions, current status as the records state it. No prognosis, permanency, or causation language beyond what a provider wrote. If the firm wants a permanency argument, emit a flag: `permanency argument requires treating-physician statement — not in record`.
### 6. Compute the general-damages range
Per the playbook:
- **Multiplier method** — apply the severity band to the medical specials. Output `range_low = band_low × specials`, `range_high = band_high × specials`. Show the band.
- **Per-diem method** — if the playbook uses it, multiply the daily rate by the documented recovery period.
Output a labelled range, never a single number:
```
General damages (starting point — attorney sets the figure):
$X – $Y (2.5–4.0× medical specials of $Z, per playbook §severity-moderate)
```
### 7. Assemble the draft and the review checklist
Fill the firm's template. Leave the response-deadline line as a placeholder (`[ATTORNEY: set response deadline — commonly 30 days]`). Produce the review checklist alongside the letter (see Output format) so the attorney verifies in minutes.
## Output format
Two artifacts: the draft letter (firm template, filled) and the review checklist below.
```markdown
# Demand draft — {matter_id} — REVIEW CHECKLIST
⚠️ DRAFT. Attorney sets the demand number and confirms every cited fact. Not sent.
## Figures and citations
| Item | Amount | Source page |
|---|---|---|
| Medical specials — City ER | $4,210 | bills.pdf p.3 |
| Medical specials — Apex PT | $6,880 | bills.pdf p.7-9 |
| Wage loss | $3,100 | wages.pdf p.1 |
| **Special damages total** | **$14,190** | (sum, verified) |
| General damages range | $35,000–$57,000 | playbook §severity-moderate (2.5–4.0×) |
## Flags — resolve before sending
- ⚠️ Treatment gap: 41 days between ER (03-04) and first PT (04-14). records.pdf p.12.
- ⚠️ Missing bill: imaging referenced (records.pdf p.15) — no bill in file. Retrieve.
- ⚠️ Lien: hospital lien noted (records.pdf p.4) — confirm amount.
- ⚠️ Facts conflict: report says "stopped"; client account says "slowing." report.pdf p.2.
## Insufficient data — not written into the letter
- Permanency: no treating-physician permanency statement in record.
- Future medical: no life-care plan or future-treatment estimate in record.
## Provenance
- Case file: {path} ({N} files indexed, {M} unprocessed)
- Template: {path}
- Playbook: {path} §{section}
- Drafted: {ISO timestamp} · Skill v1.0 · {model}
```
## Watch-outs
- **Hallucinated facts/figures.** *Guard:* every figure and factual claim cites a record page; uncitable claims go to "insufficient data," never into the letter.
- **Range read as a valuation.** *Guard:* general damages is always a labelled range with the band shown; the attorney sets the number.
- **PHI exposure.** *Guard:* run only on a Claude deployment whose data terms (zero-retention, BAA where required) meet the firm's HIPAA program. Never a consumer endpoint.
- **Missing bills counted as zero.** *Guard:* referenced-but-absent bills are flagged and excluded, not estimated.
- **Jurisdiction-wrong playbook.** *Guard:* caps, fee rules, and notice requirements are attorney-confirmed; the skill cites the playbook, it does not assert the law.
# Demand-letter template (firm skeleton — replace with the firm's actual letter)
This is a starting skeleton. Replace it with the firm's real demand letter so the skill assembles into the firm's voice, section order, and boilerplate. Keep the `{{placeholder}}` tokens — the skill fills them. Everything else is the firm's prose.
The skill assembles into this template. It does not invent sections. If the firm's letter has a section this skeleton lacks (e.g. a punitive-damages paragraph, a UM/UIM section), add it here with its own placeholders.
---
**{{firm_letterhead}}**
{{date}}
{{adjuster_name}}
{{insurer_name}}
{{insurer_address}}
**RE:** Claim of {{client_name}} · Claim No. {{claim_number}} · Date of loss: {{date_of_loss}} · Your insured: {{insured_name}}
Dear {{adjuster_name}},
This firm represents {{client_name}} for injuries sustained in the {{incident_type}} of {{date_of_loss}}. This letter presents our client's claim and our demand for settlement.
## 1. Facts and liability
{{facts_narrative}}
<!-- Skill fills from police report + case notes. Statements unsupported by the report are flagged in the checklist, not written here. Report-vs-client conflicts are surfaced, not resolved. -->
## 2. Injuries and treatment
{{injuries_narrative}}
<!-- Skill fills from the medical chronology. Diagnosis, course of treatment, provider impressions, current status as the records state it. No prognosis/permanency/causation beyond what a provider wrote. -->
### Treatment chronology
{{chronology_table}}
<!-- The dated medical chronology, per references/3-medical-chronology-schema.md. -->
## 3. Damages
### Special damages
{{special_damages_itemization}}
<!-- Itemized, each line citing its source page. Missing/unreconciled items are flagged in the checklist and excluded here. -->
**Total special damages: {{special_damages_total}}**
### General damages
{{general_damages_narrative}}
<!-- The pain-and-suffering / non-economic narrative. The amount is the attorney's; the skill provides the range in the checklist, not in this paragraph, unless the firm's template states a number here (in which case the attorney inserts it). -->
## 4. Demand
Based on the foregoing, {{client_name}} demands **{{demand_amount}}** to resolve this claim in full.
<!-- {{demand_amount}} is left for the attorney. The skill never fills it. -->
This demand remains open until **{{response_deadline}}**, after which we reserve all rights, including filing suit.
<!-- {{response_deadline}}: attorney sets it. Commonly 30 days; jurisdiction and pre-suit notice rules vary — confirm. -->
Please direct all communication regarding this claim to this office.
Sincerely,
{{attorney_name}}
{{firm_name}}
**Enclosures:** {{enclosures_list}}
<!-- Medical records, bills, wage documentation, photographs, etc. The skill lists what it indexed; the attorney confirms the production. -->
---
## How to adapt this template
1. Paste the firm's actual demand letter over this skeleton.
2. Mark every spot the skill should fill with a `{{placeholder}}` token. The tokens above are the minimum set; add more (UM/UIM, future medicals, lien summary) as the firm's letter requires.
3. Leave `{{demand_amount}}` and `{{response_deadline}}` as placeholders the attorney fills — the skill is configured never to set them.
4. Keep boilerplate (reservation of rights, confidentiality, FRE 408 "for settlement purposes only" legend if the firm uses one) as fixed prose, not placeholders.
# Damages playbook (firm methodology — fill before first use)
The skill computes the general-damages range from this file and nothing else. If a band is not here, the skill refuses to produce a range rather than guessing. Fill every section with the firm's actual methodology and review it against current law per matter.
**This is methodology, not legal advice.** Multiplier bands, caps, and notice rules vary by jurisdiction and change. The attorney confirms the numbers in this file against current rules before they drive a demand.
## 1. Method selection
Choose the firm's default and when it switches:
- **Multiplier method** (default for most soft-tissue to moderate cases): general damages = band × medical specials.
- **Per-diem method** (use when the recovery period is long and well-documented, or when the firm prefers it for a venue): general damages = daily rate × documented recovery days.
State the rule for which method applies to which case type. The skill follows it.
## 2. Multiplier bands by injury severity
Common practice puts the multiplier in the 1.5–5× range, higher for severe or disfiguring injuries. Replace these placeholders with the firm's calibrated bands:
| Severity tier | Definition (firm's criteria) | Band (× specials) |
|---|---|---|
| Minor | Soft-tissue, full resolution < 90 days, no injections/surgery | 1.5 – 2.0 |
| Moderate | Soft-tissue with injections or extended PT, resolution 3–9 months | 2.5 – 4.0 |
| Serious | Fracture, surgery, or documented lasting limitation | 4.0 – 5.0 |
| Severe / catastrophic | Permanent impairment, disfigurement, TBI, spinal | attorney-set; multiplier insufficient |
For the severe/catastrophic tier the skill does NOT output a multiplier range — it flags the case as requiring attorney valuation. A multiplier on specials understates these.
## 3. Per-diem rate
- Daily rate: `${{per_diem_rate}}` (the firm's chosen rate; some firms anchor to the client's daily wage, others to a fixed figure — state which and why).
- Recovery period: documented start (date of loss) to documented end (release from care / maximum medical improvement as the records state it). The skill uses documented dates only — it does not estimate an end date.
## 4. Billed vs. paid
State the firm's position, because it changes the specials total the multiplier runs on:
- [ ] Use **billed** amounts (gross charges).
- [ ] Use **paid/adjusted** amounts.
- [ ] Per jurisdiction — note the rule and the venues where each applies.
Collateral-source rules and billed-vs-paid admissibility vary by jurisdiction. This is an attorney call; the skill applies whatever this section states.
## 5. Jurisdiction notes (attorney-maintained)
The skill cites this section; it does not assert the law. Maintain per venue the firm practices in:
- **Damages caps** — non-economic caps, if any, and the case types they apply to.
- **Pre-suit notice** — required notice periods (e.g. claims against government entities), and the deadline math.
- **Comparative fault** — the rule (pure / modified / contributory) and how the firm reflects it in the demand.
- **Statute of limitations** — for the deadline-awareness flag, not for legal advice.
## 6. Gap threshold
- Treatment-gap flag threshold: `{{gap_days}}` days (default 30). Gaps at or above this are flagged in the checklist for the attorney.
## How to update
Review §2 and §5 at least annually and whenever the firm enters a new venue. The skill's output is only as current as this file; a stale playbook produces a stale range.
# Medical chronology schema (citation format the attorney verifies against)
The chronology is the spine of the demand. Every special-damages line and every sentence of the injuries narrative cites a chronology row; every chronology row cites a record page. Keep the citation format identical to what the firm uses so the attorney verifies against the same references.
## Columns
| Column | Content | Rule |
|---|---|---|
| `Date` | Date of service (YYYY-MM-DD) | Sort ascending. Illegible date → `[illegible — confirm]` + page cite. |
| `Provider` | Treating provider / facility | As named in the record. No normalization that loses the source name. |
| `Complaint / treatment` | The visit's complaint and what was done | From the record only. No inferred diagnosis. |
| `Billed` | Billed amount for the date of service | Per the playbook's billed-vs-paid rule. `[no bill in file]` if records reference it but the bill is absent. |
| `Record page` | `document.pdf p.N` | Every row. A row with no citation is invalid — drop it to the checklist instead. |
## Citation format
`{document_name} p.{page}` — e.g. `records-apex-pt.pdf p.7`. For a page range: `bills.pdf p.7-9`. The skill reuses the exact filenames from the indexed case file so the attorney opens the same document.
## Worked row
| Date | Provider | Complaint / treatment | Billed | Record page |
|---|---|---|---|---|
| 2026-03-04 | City General ER | Neck/back pain post-MVA; X-ray, discharged | $4,210 | bills.pdf p.3 |
| 2026-04-14 | Apex Physical Therapy | Eval + start of PT, 2×/week | $880 | records-apex.pdf p.2 |
## Gaps and flags
- A gap between consecutive `Date` rows at or above the playbook's gap threshold (default 30 days) is flagged in the review checklist with both dates and the page cites bracketing the gap.
- An entry the skill cannot fully read (illegible billed amount, ambiguous provider) is kept in the chronology with the legible fields, the unreadable field marked `[illegible — confirm]`, and the page cited.
## What does NOT go in the chronology
- Prognosis, permanency, causation — unless a provider wrote it, and then it is quoted, not paraphrased into a stronger claim.
- Bills with no corresponding date of service in the records — those go to the checklist as `bill — no matching service date — confirm`, not into a chronology row.
