Skip to documentation
ReferenceScenario content

Scenario content

Education and objectives

Keep learning intent beside the scenario behavior.

Format definition

Define prerequisites, observable objectives, assessment criteria, and debrief prompts.

Scenario standard · Execution capabilities

Parameters

education.rationale

string

Optional; omitted means unspecified

Explain why this case is educationally useful and how its decisions and challenges support the learning objectives.

education.preparation[]

object

Optional; omitted means unspecified

Preparation activities and packaged resources, with an explicit audience for each item. Instructions may use Markdown for formatted module directions and links; assetIds reference packaged learning documents. This describes preparation, not completion tracking or an enforced start gate. Builder presents prerequisite instructions and documents in Teaching context alongside the educational rationale.

education.objectives[].domain

"knowledge" | "reasoning" | "technical-skill" | "communication" | "teamwork" | "professionalism" | "systems"

Optional; omitted means unspecified

Optional classification for discovery; it does not select a scoring algorithm.

education.objectives[].performance

object

Optional; omitted means unspecified

Observable behavior, conditions of performance, and acceptable standard. Team evidence cannot be attributed automatically to each individual.

education.objectives[].curriculumMappings[]

object

Optional; omitted means unspecified

Curriculum or competency references; mappings are author assertions, not accreditation or equivalence. ACGME core competency mappings use framework https://www.acgme.org/programs-and-institutions/programs/common-program-requirements/, version core-competencies-2026-09, and codes PC, MK, PBLI, ICS, PROF, SBP. Specialty-specific Milestones require their own framework and version; do not infer levels from scenario scores.

education.objectives[].learnerBrief

string

Optional; omitted means unspecified

Learner-facing statement of the task or objective. Facilitator success criteria may contain spoilers and are not included implicitly.

education.objectives[]

object

Optional; omitted means unspecified

One observable learning goal, using an action verb such as recognize, assess, communicate, or initiate.

education.assessment[]

object

Optional; omitted means unspecified

One scored criterion linking an observable skill to a recorded action, with points and debrief feedback.

education.debriefPrompts[]

object

Optional; omitted means unspecified

One reflection prompt with a stable ID and optional objective references and facilitator notes. Builder edits the primary question in the single Debrief prompt field and preserves additional existing questions and notes in scenario data without displaying them in the Builder.

Behavior and validation

  • Builder provides a single primary Debrief prompt editor without add/remove controls. Additional existing prompt records retain their IDs, questions, objective references, and facilitator notes; these additional details are preserved in scenario data and are not displayed in the Builder. The canonical debriefPrompts array supports multiple records.
  • Objective evidence actions and debrief objective references resolve to their declared entity type. Reference lists contain no duplicates.
  • Preparation instructions may use Markdown and links. Supporting documents reference packaged assets. Builder keeps prerequisite instructions and documents in Teaching context alongside the educational rationale. Attach documents by clicking the shared dropzone or dropping a file onto it.
  • Objective learnerBrief is learner-facing. Preparation follows its declared audience. Rationale, performance criteria, and debrief rationales are facilitator-only by default. Release debrief questions through an explicit delivery view; includeIds never overrides audience restrictions.
  • Assessment criteria link learner actions to points, optional deadlines, feedback, and learning materials. Conclusion states close the scenario; reaching a conclusion does not establish that objectives were met.
  • Keep learner identities, scores, actual timing, feedback, recordings, and progress outside the portable scenario. Delivery records identify scenarioId and metadata.revision.
  • Do not infer competence solely from a transition. Event evidence can establish that an action occurred; quality of communication or procedure performance may require facilitator judgment.

Shared format conventions · All format elements · Download specification

Field reference

50 records in this view
objectApplication field

Learning goals, learner preparation, assessment criteria, and guidance for reflection after the case.

  • Required when the containing object is present.
stringApplication field

Explain why this case is educationally useful and how its decisions and challenges support the learning objectives.

  • Optional; omitted values remain unspecified.
arrayApplication field

Preparation activities and learner or facilitator materials. Asset references retain the source documents. Builder groups prerequisite instructions and documents in Teaching context alongside the educational rationale.

  • Optional; omitted values remain unspecified.
objectApplication field

Preparation activities and packaged resources, with an explicit audience for each item. Instructions may use Markdown for formatted module directions and links; assetIds reference packaged learning documents. This describes preparation, not completion tracking or an enforced start gate. Builder presents prerequisite instructions and documents in Teaching context alongside the educational rationale.

  • Required when the containing object is present.
stringApplication field

Stable identifier for this entry. Keep it unchanged when editing its content.

  • Required when the containing object is present.
valueApplication field

Select one of the declared Audience alternatives; use the fields belonging to that alternative.

Allowed values

  • learner
  • facilitator
  • Required when the containing object is present.
stringApplication field

Rich-text instructions stored as Markdown for knowledge, skills, modules, or preparation learners should complete before starting.

  • Required when the containing object is present.
arrayApplication field

Entries for Supporting materials. An empty list means no entries have been authored.

  • Required when the containing object is present.
stringApplication field

Identifier of an existing assets entry. Preserve the referenced entry when editing this field.

  • Required when the containing object is present.
arrayApplication field

The observable knowledge, skills, or behaviors learners should demonstrate.

  • Required when the containing object is present.
objectApplication field

One observable learning goal, using an action verb such as recognize, assess, communicate, or initiate.

  • Required when the containing object is present.
stringApplication field

A stable objective identifier. Preserve it when editing or reordering the objective.

  • Required when the containing object is present.
stringApplication field

An observable learning outcome, using an action verb such as recognize, assess, communicate, or initiate.

  • Required when the containing object is present.
stringApplication field

Identifier of an existing events.actions entry. Preserve the referenced entry when editing this field.

  • Required when the containing object is present.
arrayApplication field

Optional author-selected ACGME core competency codes. Omitted or empty means unmapped. This is not a Milestone level or a judgment of competence. Do not infer mappings from source text that does not explicitly supply them.

  • Optional; omitted values remain unspecified.
valueApplication field

One of the six ACGME core domain codes: PC, MK, PBLI, ICS, PROF, or SBP. Each code may appear only once per objective.

Allowed values

  • PC
  • MK
  • PBLI
  • ICS
  • PROF
  • SBP
  • Required when the containing object is present.
valueApplication field

Optional classification for discovery; it does not select a scoring algorithm.

Allowed values

  • knowledge
  • reasoning
  • technical-skill
  • communication
  • teamwork
  • professionalism
  • systems
  • Optional; omitted values remain unspecified.
objectApplication field

Observable behavior, conditions of performance, and acceptable standard. Team evidence cannot be attributed automatically to each individual.

  • Optional; omitted values remain unspecified.
valueApplication field

Select one of the declared Scope alternatives; use the fields belonging to that alternative.

Allowed values

  • individual
  • team
  • Required when the containing object is present.
objectApplication field

Curriculum or competency references; mappings are author assertions, not accreditation or equivalence. ACGME core competency mappings use framework https://www.acgme.org/programs-and-institutions/programs/common-program-requirements/, version core-competencies-2026-09, and codes PC, MK, PBLI, ICS, PROF, SBP. Specialty-specific Milestones require their own framework and version; do not infer levels from scenario scores.

  • Required when the containing object is present.
stringApplication field

Learner-facing statement of the task or objective. Facilitator success criteria may contain spoilers and are not included implicitly.

  • Optional; omitted values remain unspecified.
arrayApplication field

Reflection prompts stored as a canonical array supporting multiple records. Builder provides a single primary Debrief prompt editor without add/remove controls. Additional existing records retain their IDs, questions, objective references, and facilitator notes; these additional details are preserved in scenario data and are not displayed in the Builder.

  • Required when the containing object is present.
objectApplication field

One reflection prompt with a stable ID and optional objective references and facilitator notes. Builder edits the primary question in the single Debrief prompt field and preserves additional existing questions and notes in scenario data without displaying them in the Builder.

  • Required when the containing object is present.
stringApplication field

Stable identifier for this entry. Keep it unchanged when editing its content.

  • Required when the containing object is present.
stringApplication field

Identifier of an existing education.objectives entry. Preserve the referenced entry when editing this field.

  • Required when the containing object is present.
stringApplication field

A prompt for facilitated reflection after the scenario. Formatting is stored as Markdown.

  • Required when the containing object is present.
arrayApplication field

The authored criteria used to assess learner performance.

  • Optional; omitted values remain unspecified.
objectApplication field

One scored criterion linking an observable skill to a recorded action, with points and debrief feedback.

  • Required when the containing object is present.
stringApplication field

Optional link to the stable ID of a structured learning objective. Multiple criteria may support one objective. No link means unspecified, never a failed objective.

  • Optional; omitted values remain unspecified.
stringApplication field

A stable identifier used to reference this entry. Keep it unchanged when editing the entry's name or content.

  • Required when the containing object is present.
stringApplication field

Name the observable skill or objective being assessed, such as recognizing deterioration.

  • Required when the containing object is present.
stringApplication field

Select the learner action that earns credit for this criterion. Scheduled transitions cannot earn action credit.

  • Required when the containing object is present.
stringApplication field

Single equivalent resource. Used when objectIds is omitted; the required action's linked resource is used when both are omitted.

  • Optional; omitted values remain unspecified.
arrayApplication field

Alternative learner-requestable resources that earn credit for this criterion. Any selected request qualifies, using the earliest request time regardless of result delay. Points are awarded once. Omit to use objectId or the required action's linked resource when present.

  • Optional; omitted values remain unspecified.
stringApplication field

The identifier of a learner-requestable resource accepted as an alternative for this assessment criterion.

  • Required when the containing object is present.
numberApplication field

The weight of this criterion in the total score, from 1 to 100. Credit is awarded once when the criterion is met.

  • Required when the containing object is present.
numberApplication field

Latest qualifying action time in seconds from the start of the run, inclusive. Omit to assess the action without a deadline.

  • Optional; omitted values remain unspecified.
stringApplication field

Explain the expected behavior, why it matters, and what to discuss when the action is completed or missed.

  • Required when the containing object is present.
stringApplication field

An HTTPS link to learning material relevant to this criterion, such as a guideline or teaching resource.

  • Optional; omitted values remain unspecified.