Rubrics & Actions

Rubrics encoding action, movement, posture, force, and performer.

A Rubric encodes what is done, by whom, where, with what force, and under what conditions.

{
  "id": "rb-gospel-procession",
  "category": "movement",
  "subtype": "procession",
  "force": "required",
  "actors": ["role-deacon"],
  "object": "gospel-book",
  "from": "qeddest",
  "to": "qene_mahlet",
  "path": ["qeddest", "qene_mahlet"],
  "description": {
    "en": "The deacon processes with the Gospel book."
  }
}

Rubric Categories

action posture movement sound setting instruction permission

Separate Instructions from Speech

Use a rubric for an action or instruction and an utterance for words that are performed. For “The deacon raises the Gospel book and says, ‘Wisdom,’” encode two ordered elements: a rubric for raising the object and an utterance for the spoken word.

Choose force carefully:

ForceConsumer behavior
requiredTreat omission as a validation or execution error.
recommendedPreserve by default; allow an explained local exception.
optionalPresent as an available action without assuming execution.

Conditions should be machine-readable and use vocabulary defined by the core schema or active profile. Free-form prose can explain a condition, but it cannot be the only representation when deterministic service resolution depends on it.

Schemas and supported values

Rubric category

rubric.category Definition ↗

Machine-readable class of liturgical action. Values outside this closed list are invalid.

actionposturemovementsoundsettinginstructionpermission

Rubric force

rubric.force Definition ↗

Required behavior when executing a rubric. Values outside this closed list are invalid.

requiredrecommendedoptional