Blacksite/docs/adr/0006-scene-schema-versioning.md
Rbanh f29712d158
Some checks are pending
CI / Format, lint, test, build (push) Waiting to run
Initial project import
2026-06-05 21:44:45 -04:00

21 lines
602 B
Markdown

# ADR 0006: Scene Schema Versioning
## Status
Accepted
## Context
Levels under `assets/levels/` need forward-compatible migrations as authoring components evolve (M5).
## Decision
- Track `schema_version` in scene files (wrapper or sidecar during transition).
- Provide `scene_schema` module with `migrate_scene_text` and `validate_level_file`.
- CI / `xtask validate-levels` loads all committed levels and fails on unknown versions.
## Consequences
- Breaking component changes require a migration step and version bump.
- Editor save may wrap scenes with schema header in a follow-up change.