# Clinical Content, Sources & Review

> **Read this before deploying LINGULIA in any real clinical setting.**

## Sources & anchoring

- **Clinical framing** follows the **WHO mhGAP Intervention Guide (mhGAP-IG 2.0)** — the
  international standard for mental, neurological and substance-use care by non-specialists, and
  the framework adopted by the Ethiopian Federal Ministry of Health for primary care.
- **Screening instruments**: **PHQ-9** (depression) and **GAD-7** (anxiety), developed by Drs
  Robert L. Spitzer, Janet B.W. Williams, Kurt Kroenke and colleagues (Pfizer). Both are **free
  to use without permission or licensing fees**.
- **Coding**: ICD-10 codes are included on terms where they apply, for interoperability and
  reference.

## The honest status of the translations ⚠️

**Every Amharic and Afaan Oromo entry in this repository is a `draft`.** The English clinical
content is reliable; the local-language translations are a careful first pass that **must be
reviewed by native-speaker clinicians before field use**. This matters more in mental health than
in most of medicine because:

- A mistranslated symptom or instruction can cause real harm.
- **Idioms of distress** (`buda`/evil eye, `zar`/spirit, "thinking too much") carry cultural
  weight that a literal translation misses. They are included precisely because they are how
  patients describe suffering — but their wording and handling need local validation.
- Afaan Oromo medical terminology is still consolidating; several terms here have more than one
  acceptable form and should be standardised with reviewers.

This honesty is built into the product: the `review` flag on each entry drives a **"draft —
pending clinical / linguistic review"** chip in the app, so nothing reads as authoritative until
a reviewer signs off.

## Review workflow

1. **Linguistic review** — a native Amharic speaker and a native Afaan Oromo speaker check each
   `am` / `om` term, `lay` idioms, `phonetic`, and `def` for accuracy and natural wording.
2. **Clinical review** — a mental-health clinician (psychiatrist, psychiatric nurse, or
   mhGAP-trained officer) checks that meanings and guidance are clinically correct and mhGAP-
   aligned.
3. **Instrument validation** — replace the draft PHQ-9 / GAD-7 translations with **officially
   validated** Amharic/Afaan Oromo versions where they exist (validated Amharic versions of these
   scales have been published; source and substitute them).
4. **Flip the flag** — change `"review": "draft"` → `"reviewed"` for each verified entry, and bump
   the `CACHE` version in `sw.js`.
5. **Field testing** — pilot with HEWs/health-center staff and incorporate feedback.

## Limitations (state these to any user or partner)

- LINGULIA is a **language and job-aid tool, NOT a diagnostic device**.
- Screening scores are **not diagnoses**; they support a trained clinician's judgement.
- v1 covers **mental health only**.
- On-device TTS quality depends entirely on the voices installed on the phone; many devices have
  no Amharic or Afaan Oromo voice (high-quality neural TTS is on the roadmap).
- The optional AI assistant is **decision support**, can be wrong, and must never be given patient
  identifiers.

## Attribution

- WHO mhGAP Intervention Guide — © World Health Organization. Used as a clinical reference; verify
  against the current edition.
- PHQ-9 / GAD-7 — © Pfizer Inc.; free to use without permission.
