Skip to main content
The Luria report templates are scaffolded Markdown files that mirror the section structure of a polished neuropsychological evaluation. Each context — adult, pediatric, geriatric, forensic, and screening — has its own template. You start with the right headings, the right placeholders, and the right tone for the audience that will read the report. These templates ship as plain Markdown under agents/visit2_nt/templates/. They are the input that the agent pipeline fills in during Phases B–D, and they are also useful as standalone starting points when you are writing a report by hand.

Choosing a template

If you are unsure, start with full_neuropsych_report_template.md and switch to a context-specific template once the referral question is clear.

What each template gives you

Every template ships with the same backbone so the resulting reports are interchangeable across clinicians:
  • A CONFIDENTIAL header block and patient identifiers
  • Reason for Referral and Sources of Information sections with placeholder prose
  • Background sections organized by domain (medical, psychiatric, developmental, educational, social)
  • Behavioral Observations and Validity sections
  • Test Results by Domain scaffolding compatible with the score_table_template.md block
  • Summary, Diagnostic Impression, and Recommendations — the SIRF half of the report
  • A Signature block
Context-specific templates add their own sections on top of this backbone. The pediatric template adds developmental and school history; the geriatric template adds capacity and IADL fields; the forensic template adds notification of purpose, limits of confidentiality, and an opinions-to-a-reasonable-degree-of-certainty block.

Using a template by hand

The templates are plain Markdown. Copy one into your case folder, fill in the placeholders, and convert to PDF however you normally would.
Replace each [bracketed placeholder] with the corresponding patient data, then render through your normal pipeline.

Using a template through the pipeline

Inside the pipeline, the assembly agent (report_assemble, Phase D) selects the template based on the report_type field in config.patient.yml:
The agent loads the matching template, fills the placeholders from the patient context (the same context used by the prompts system), and writes a draft .qmd to data/reports/. You then review, revise, and render to PDF.

When to extend the templates

Does your clinic see a recurring evaluation type that none of the shipped templates fit — say, a return-to-play concussion evaluation or a pre-surgical capacity screen? Copy the closest existing template, adjust the section headings, and save it next to the others under agents/visit2_nt/templates/. The assembly agent picks it up as soon as you reference it by name in config.patient.yml. Keep the patient identifier block, the validity section, and the signature block — those are the parts that make the document defensible regardless of context.
Last modified on June 3, 2026