Define subject content format

This commit is contained in:
2026-05-19 15:42:55 -07:00
parent 8e33068d01
commit 7b1f9b81c0
3 changed files with 76 additions and 1 deletions
+32
View File
@@ -379,3 +379,35 @@ Non-punitive practice paths:
Accessibility rule: learning should make players more capable without making
them feel trapped, shamed, or forced into a classroom flow.
## Subject Content Format
Learning content should use a small structured format so topics can become data
assets later without rewriting design intent.
Required fields:
- `topic`: stable identifier and display name, such as `fire.clearance`.
- `concepts`: one or more concept tags the player may learn or demonstrate.
- `difficulty_tier`: `elementary`, `practical`, `advanced`, or `expert`.
- `prerequisite_concepts`: concept tags that should be known first, if any.
- `in_game_effect`: the warning, modifier, feedback, unlock, or quality effect
this topic can influence.
- `practice_action`: the action that can build practical experience for the
topic.
- `source_note`: a short design/source note explaining why the topic matters.
Example:
```text
topic: fire.clearance
concepts: fire_safety, dry_fuel, wind_spread
difficulty_tier: elementary
prerequisite_concepts: none
in_game_effect: clearer fire-risk warning and lower unsafe-placement mistakes
practice_action: clear area, contain fire, maintain fire, extinguish fire
source_note: Open flame near dry fuel and wind can spread beyond the campfire.
```
Format rule: content records should be small enough to review in source control
and explicit enough to become data assets later.