MedicAITutor Docs

Station Review Guide

Professional guidance for using MedicAITutor station review before publication.

Live API Station schema OpenAPI JSON

Table of Contents

What station review is for

Station review is a quality-assurance step for checking whether a station is publishable, coherent, and safe for simulation and evaluation. It helps reviewers spot weak schema content, weak persona definition, missing rubric signals, and obvious simulation risks before a station goes live.

Interpretation

Use review output as QA support, not sole publication approval. Confirm rubric completeness, persona specificity, key points, and simulation safety before publishing.

Who should use it

Required inputs

Station review is strongest when you provide the full station JSON or an equivalent structured summary.

Important

Incomplete stations can still be reviewed, but the output will usually be more generic and less reliable. Weak input produces weak review signals.

How to interpret the output

Treat the review as a structured second check, not an automatic approval system.

Do not over-read a pass-like answer

A positive review does not guarantee clinical correctness, live simulator quality, or final publication readiness. Human review is still required.

Good-review examples

Clearly publishable station

Complete rubric, specific persona, explicit safety boundaries

What the reviewer submitted

{
  "text": "Please review this station for publication readiness. Focus on rubric completeness, persona specificity, key points, and simulation safety.\n\n{\n  \"title\": \"ABUSE IN INTELLECTUALLY DISABLED PERSON - history\",\n  \"station_slug\": \"abuse-in-intellectually-disabled-person-history-taking\",\n  \"persona\": {\n    \"name\": \"Mrs Whitlock\",\n    \"communication_style\": \"anxious but cooperative\",\n    \"goals_concerns\": [\n      \"Wants her symptoms taken seriously\",\n      \"Worries she is losing control\"\n    ]\n  },\n  \"key_points\": [\n    \"timeline\",\n    \"functional impact\",\n    \"risk\",\n    \"ideas/concerns/expectations\"\n  ],\n  \"rubric_domains\": [\n    \"History structure and signposting\",\n    \"Focused symptom exploration\",\n    \"Risk and safety assessment\"\n  ],\n  \"guardrails\": [\n    \"Do not volunteer risk content unless asked clearly\",\n    \"Escalate if immediate harm is disclosed\"\n  ]\n}",
  "station_slug": "abuse-in-intellectually-disabled-person-history-taking",
  "category": "station-review"
}

What the review flagged

  • Minor tightening only: one rubric item could be more measurable.
  • Lead line should stay aligned with the case synopsis.
  • Guardrail wording is already specific enough for publish decision support.

What action should be taken

Make the small wording fix, re-run if needed, then send for human clinical/content sign-off.

Needs revision

Generic persona, weak rubric, missing key points

What the reviewer submitted

{
  "text": "Please review this draft station before publication.\n\n{\n  \"title\": \"Untitled station\",\n  \"station_slug\": \"draft-station\",\n  \"persona\": {\n    \"name\": \"Patient\",\n    \"communication_style\": \"brief\"\n  },\n  \"key_points\": [],\n  \"rubric_domains\": [\n    \"Communication\"\n  ],\n  \"guardrails\": []\n}",
  "station_slug": "draft-station",
  "category": "station-review"
}

What the review flagged

  • Persona is default and not station-specific.
  • Rubric is too shallow to support reliable evaluation.
  • Key points are empty, so the simulator and examiner signals are under-specified.
  • No meaningful guardrail or escalation content is present.

What action should be taken

Do not publish. Repair the station content first, then re-run review and require human approval after the fixes.

Common failure modes and caveats

Review checklist

Copy into SOP

  • Rubric has at least 3 meaningful competency items.
  • Key points are specific and non-empty.
  • Persona is specific, plausible, and non-default.
  • Guardrails are present where needed.
  • Lead/opening line matches station type.
  • Station behaviour is safe and coherent.
  • A station-specific candidate test has completed and its evaluation includes domains, ratings, rationales, and evidence.
  • Publication status, reason, expert-review provenance, revision, and current S3 object match the approved station.