Завершить контентную архитектуру этапа 4

README.md

@@ -7,6 +7,7 @@ Project documents:
 - [`docs/DEVELOPMENT_PLAN.md`](docs/DEVELOPMENT_PLAN.md) — approved GDD + TDD + production roadmap;
 - [`docs/CURRENT_ROADMAP.md`](docs/CURRENT_ROADMAP.md) — execution roadmap for the existing vertical slice;
 - [`docs/LEVEL_SOLUTION_GRAPHS.md`](docs/LEVEL_SOLUTION_GRAPHS.md) — source-backed intended solution graph for every current level;
+- [`docs/STAGE4_CONTENT_FORMAT.md`](docs/STAGE4_CONTENT_FORMAT.md) — versioned JSON contract, validator, preview, and bot-trace format;
 - [`docs/BEADS_WORKFLOW.md`](docs/BEADS_WORKFLOW.md) — local backlog structure and daily Beads commands.
 
 ## Playable content
@@ -51,6 +52,20 @@ Requirements: JDK 17 and Android SDK Platform/Build Tools 34.
 ./gradlew testDebugUnitTest assembleDebug
 ```
 
+Level content is stored in `level-format/src/main/resources/levels`. Android and
+the desktop tools use the same dependency-free parser and validator. Android
+packaging automatically depends on validation. To validate explicitly or export
+deterministic SVG/TSV previews:
+
+```sh
+./gradlew :level-format:validateLevels
+./gradlew :level-format:previewLevels
+```
+
+Previews are written to `level-format/build/level-previews`. Invalid geometry,
+versions, moving-platform destinations, switch parameters, or signal references
+fail the build with a JSON path diagnostic.
+
 All ten levels have device-level acceptance bots. They drive the production
 `GameView` through the same movement and jump inputs as the touch controls and
 run each intended solution three times. Level 8 also has a dedicated recovery
@@ -69,6 +84,12 @@ The Stage 3 device suite additionally checks persisted controls, RU/EN copy,
 accessibility presets, tutorial/result navigation, Back behavior, and safe viewports
 on 20:9, 16:9, and 16:10 tablet-sized displays.
 
+Stage 4 keeps the same gameplay and UI matrix after migrating all ten levels to
+JSON. Its final unfiltered Android 16 run passed all 30 instrumentation methods
+in one process (`OK (30 tests)`, 1,096.448 seconds). Acceptance bots now attach a
+versioned deterministic input/checkpoint trace and SHA-256 trace ID to their
+result diagnostics.
+
 The debug APK is written to `app/build/outputs/apk/debug/app-debug.apk`. It is signed with Android's standard debug key and can be installed with:
 
 ```sh