@ztothez/design-engineering 2.0.0

package/knowledge-base/benchmarks/scenestart/MANIFEST.md

@@ -0,0 +1,53 @@
+# SceneStart Benchmark Manifest
+
+This benchmark defines SceneStart as a local-first demoscene learning and production system. It evaluates task completion, state ownership, export integrity, learning continuity, release provenance, and honest product boundaries. It is not a visual template and does not treat neon styling as evidence of product quality.
+
+## Authority Order
+
+1. The current SceneStart implementation and root README are authoritative for supported behavior, routes, storage, exports, and technology choices.
+2. `SOURCE-EVIDENCE.md` records the implementation snapshot used to create this benchmark without creating a runtime dependency on the separate SceneStart workspace.
+3. `product-contract.yaml` is the normalized contract used by ZtotheZ Design Engineering validation tools.
+4. Current design and responsive behavior may guide presentation, but task integrity and accessible operation override fixed visual composition.
+5. Historical Hello, Scene! research explains product intent only. It cannot restore obsolete features or override the current implementation.
+
+## Benchmark Boundaries
+
+- SceneStart is user-owned source material, not a third-party design-skill dependency.
+- No SceneStart source code is imported or packaged by this benchmark.
+- The benchmark stores independently authored behavioral requirements and source hashes only.
+- The product remains useful without accounts, application databases, analytics, or cloud project storage.
+- External learning links are optional departures from the application, not runtime dependencies of exported productions.
+- SceneStart assists preparation but does not certify originality, rights ownership, competition eligibility, or acceptance by an event organizer.
+
+## Required Profiles
+
+| Profile | Product question |
+|---|---|
+| `studio-export` | Can a maker edit a coherent multi-scene project and download both editable and playable artifacts? |
+| `guided-workshop` | Can a beginner complete the six-step guided route and continue with the same project? |
+| `learning-persistence` | Does completed learning progress survive navigation and remain attributable to the same local device state? |
+| `release-provenance` | Can a producer document asset provenance and generate a release readme without implying certification? |
+
+The `release-provenance` profile includes a blocker manual-review criterion for the local-first boundary. It must remain `UNVERIFIED` until an attributable human reviews the build and evidence. An AI agent must not create that attestation.
+
+## Commands
+
+Validate the benchmark:
+
+```bash
+npm run validate-contract -- \
+  --contract knowledge-base/benchmarks/scenestart/product-contract.yaml
+```
+
+Run one profile against an already-running SceneStart application:
+
+```bash
+npm run quality-gate -- \
+  --contract knowledge-base/benchmarks/scenestart/product-contract.yaml \
+  --repo /home/ztothez/Studio/portfolio/scenestart \
+  --url http://127.0.0.1:3000 \
+  --profile studio-export \
+  --output .ztothez-design-quality-gate/scenestart-studio
+```
+
+Use `attestations.template.yaml` only as an empty structure. Reviewer observations belong in `human-review.template.md` first and may be converted to an attestation only after the named reviewer approves the final wording and evidence.

package/knowledge-base/benchmarks/scenestart/SOURCE-EVIDENCE.md

@@ -0,0 +1,43 @@
+# SceneStart Source Evidence
+
+## Snapshot
+
+- Source workspace: `/home/ztothez/Studio/portfolio/scenestart`
+- Observed: 2026-08-26
+- Ownership context: user-owned portfolio project
+- Runtime dependency: none; these paths are provenance references only
+- Current stack: TanStack Start, React, TypeScript, Tailwind CSS, Canvas 2D, browser localStorage
+
+## Observed Product Contracts
+
+- `/studio` composes one to eight timed scenes, persists a version 2 project locally, previews the complete timeline, saves an editable JSON recipe, and exports a self-contained HTML production once at least three scenes exist.
+- Studio scene duration is clamped between 2 and 60 seconds. Total duration is derived from scene state rather than entered as an unrelated display metric.
+- Studio imports accept version 2 JSON under 64 KB, coerce known fields, clamp parameter values, reject malformed input, and do not upload the file.
+- Exported productions embed sanitized project data and deterministic effect renderers. They start through keyboard or pointer input, support Escape, contain inline CSS and JavaScript, and do not call remote resources.
+- `/workshop` provides six persisted steps that produce a three-scene project. Completion can export the artifact or save the same project into Studio.
+- `/learn` exposes hands-on labs, guided tool paths, and hardware or submission companions without pretending every discipline is a browser editor.
+- Learning and workshop progress use versioned localStorage records. Restored values are coerced against current registries and impossible values are discarded or clamped.
+- `/learn/release` stores a local provenance ledger, distinguishes unresolved rights, generates plain-text `readme.txt`, and states that SceneStart does not certify rights or competition eligibility.
+- `/privacy` states that creative state is local, identifies the hosting boundary, distinguishes optional external links, and explains deletion through browser site data.
+
+## Integrity Boundaries
+
+- Public application pages can link to independent learning tools and support services, but those links are not required for authoring or exported playback.
+- The hosted application itself uses same-origin assets and hosting infrastructure. Only the downloaded production is required to run without network access.
+- Canvas screenshots prove that pixels render, not that the artistic result is correct or pedagogically effective.
+- Completion counters are derived from owned state; they are not community statistics, certification, or evidence of representative-user success.
+
+## Snapshot Hashes
+
+| Source | SHA-256 |
+|---|---|
+| `README.md` | `f9b08941a1ae4993021060a261b4ce4a9ed9af07da784dfff9a2cacb5fd5f59c` |
+| `package.json` | `987424a9ad604b9c8ef254f60656560b64f4da18ef8b9c72cc62418ed0bf10b4` |
+| `src/lib/demo/studio-project.ts` | `ab92e84cf1c3243b374903b1c08d3e01b8a6048a99157dd2f2f32b99e7c61bf7` |
+| `src/lib/demo/studio-export.ts` | `250467ac0fb602609d9d9acb41afe6ca92ed60cd31dc00ebf197b953956967c6` |
+| `src/components/demo/GuidedWorkshop.tsx` | `b49aa880e8cf22cf729e450468b4b4e878fc84aa8284cdf4c932fbe2124383fc` |
+| `src/lib/demo/foundation-progress.ts` | `961acfebfe90c9bb2fc1bfbacb83d6be3eaac8745c3d9466e08054b855a2ed0c` |
+| `src/lib/demo/release.ts` | `6abd81738ad566ba6aaaf10b869e4fe306614b8903c06f5c1a16491cdd659195` |
+| `src/routes/privacy.tsx` | `f9d3efe82efd9b175a6ccc0647fc8047b3719e99a6a3dea00e86ce1f470e868e` |
+
+If a source hash changes, inspect the current implementation and update this evidence record before changing the contract. A hash mismatch is a review trigger, not proof of regression.

package/knowledge-base/benchmarks/scenestart/acceptance-criteria.md

@@ -0,0 +1,59 @@
+# SceneStart Acceptance Guide
+
+The machine-readable criteria are in `product-contract.yaml`. This guide explains how to interpret their evidence without confusing interface appearance with product validity.
+
+## Studio And Export
+
+- Project identity, scene order, timing, transitions, messages, cues, effect parameters, preview, and downloads must derive from one current sanitized project.
+- A downloaded JSON recipe proves a file was emitted only after its version, filename, limits, and current values are checked.
+- A downloaded HTML file proves export mechanics only after its current values, start behavior, Escape behavior, deterministic renderers, and lack of playback-time network dependencies are inspected.
+- Canvas pixels must be nonblank at required viewports. Pixel presence does not prove artistic quality, scene coherence, or learning effectiveness.
+- Invalid import must not erase or silently replace the current production.
+
+## Guided Workshop
+
+- The six steps must communicate current and remaining work without a countdown or false urgency.
+- A user may change parameters, preview the production, export it, and continue in Studio with the same handle and scenes.
+- Completion means the workflow reached its defined terminal state. It does not mean the user learned the concepts unless representative-user evidence supports that conclusion.
+
+## Learning Progress
+
+- Progress is computed from current versioned state and the current lesson or requirement registry.
+- Navigation or reload must not reset valid progress while localStorage remains available.
+- Corrupt, obsolete, or impossible stored values must not create impossible completion.
+- Estimated minutes are planning guidance, not measured user performance.
+
+## Release Provenance
+
+- Asset provenance remains unresolved until required fields and explicit rights confirmation exist.
+- Rights confirmation records the producer's decision; it is not legal verification by SceneStart.
+- The generated readme must include the current disclosure, credits, run instructions, and unresolved status.
+- Checklist completion cannot be labeled competition-ready, accepted, certified, or original.
+
+## Local-First Evidence
+
+The interface and source contract can state local-first behavior, but screenshots cannot prove absence of upload. A human reviewer must inspect current network behavior, storage ownership, server routes, third-party scripts, and exported HTML before attesting to `local-first-boundary`.
+
+Public pages may contain optional external links. The relevant distinction is whether authoring state is transmitted and whether exported playback requires the network, not whether the product contains any hyperlink.
+
+## Responsive And Accessible Operation
+
+At 320, 390, 768, 1024, and 1440 CSS pixels:
+
+- Timeline entries, labels, values, and action groups remain readable.
+- Preview regions maintain stable dimensions without covering authoring controls.
+- Long concepts, cues, filenames, and disclosure text wrap without page-level horizontal overflow.
+- Focus remains visible and unobscured through navigation, forms, range controls, downloads, and workshop progression.
+- Status changes are textual and announced where consequential.
+- Authoring motion respects reduced-motion preferences; exported artistic playback remains explicitly user-started.
+
+## Evidence Limits
+
+- `contract` proves the expected source of truth and behavior are specified.
+- `runtime` proves the configured rendered journey completed.
+- `screenshot` proves required viewport evidence exists and automated geometry checks passed.
+- `accessibility` proves the automated name, focus, contrast, target, reflow, and motion checks passed.
+- `export` proves a configured download occurred with the expected filename and captured artifact.
+- `manual-review` proves only the named reviewer made the recorded decision at the recorded time.
+
+No evidence type may be silently substituted for another.

package/knowledge-base/benchmarks/scenestart/anti-patterns.md

@@ -0,0 +1,26 @@
+# SceneStart Anti-Patterns
+
+Use these as rejection examples when generating or reviewing SceneStart behavior.
+
+| Anti-pattern | Why it fails | Required correction |
+|---|---|---|
+| Neon shell without a production model | The page resembles demoscene art but scenes cannot be ordered, timed, previewed, saved, or exported coherently | Start from the versioned project, timeline, playback states, and artifact contracts; style afterward |
+| Generic SaaS dashboard | Marketing metrics, subscriptions, team cards, or analytics replace direct creation and learning | Put the authoring canvas, current task, local progress, and outputs first |
+| Cloud-first project wrapper | Accounts, uploads, or remote persistence are added to a local-first workflow without a required product decision | Preserve local storage and explicit downloads; propose cloud features only as a separately reviewed mode |
+| Export theater | A button downloads placeholder HTML or values unrelated to the current project | Generate from the current sanitized project and verify filename, embedded state, controls, and offline playback |
+| Network-dependent offline export | Exported HTML loads fonts, scripts, images, audio, analytics, or APIs from remote origins | Inline required runtime resources and reject playback-time remote references |
+| Destructive project import | Invalid or unsupported JSON clears the current production | Validate size and version first, preserve current state, and show an actionable rejection |
+| Preset ownership confusion | Default scenes or tutorial values are presented as original user work | Label starter content and require the maker to own authorship and rights decisions |
+| Canvas-only workflow | Critical controls, state, progress, or explanations exist only inside pixels | Keep semantic HTML controls, labels, status, and text alternatives outside the canvas |
+| Automatic artistic playback | Motion starts without user intent or ignores reduced-motion needs in the authoring interface | Require explicit playback and reduce nonessential authoring animation |
+| Fake progress | Completion percentages or checkmarks are hard-coded, duplicated, or unrelated to current state | Derive progress from the versioned registry and stored completion evidence |
+| Countdown workshop | The fifteen-minute estimate becomes a timer, expiry, or pressure mechanic | Present it as guidance only and preserve progress without punishment |
+| Quiz-first teaching | Terminology questions replace changing parameters and observing cause and effect | Use make, change, observe, complete, explain, and keep as the learning sequence |
+| One universal editor | Specialist music, graphics, hardware, and release disciplines are represented by shallow fake controls | Use honest interactive labs, guided external-tool paths, or hardware/submission companions |
+| Certification theater | Checklist completion is labeled Assembly-ready, rights-cleared, original, or competition-compliant | Preserve the non-certification disclaimer and direct users to current independent review |
+| Fabricated community proof | User counts, success rates, streaks, testimonials, or completion times appear without evidence | Remove the claim or attach consented, current, inspectable research evidence |
+| Hidden unresolved rights | Incomplete asset records disappear from the readme or are visually minimized | Keep unresolved entries visible in UI and generated output until explicitly resolved |
+| External-link ambiguity | Optional learning or support links appear to be required product services | Label departures and keep creation, progress, and export independent of them |
+| Fixed desktop composition | Timeline, canvas, controls, or provenance forms clip at narrow widths | Recompose at product viewports and verify 200 percent reflow and text resizing |
+| Decorative status color | Completion, unresolved rights, or export readiness is conveyed only through cyan, amber, or magenta | Add explicit status text and assistive-technology announcements |
+| Pixel screenshot as correctness proof | A nonblank canvas is treated as proof of scene quality or renderer parity | Pair pixel checks with deterministic tests and human visual review appropriate to the claim |

package/knowledge-base/benchmarks/scenestart/attestations.template.yaml

@@ -0,0 +1,3 @@
+version: "1.0"
+contract: scenestart
+attestations: []

package/knowledge-base/benchmarks/scenestart/attestations.yaml

@@ -0,0 +1,21 @@
+version: "1.0"
+contract: scenestart
+attestations:
+  - criterion: local-first-boundary
+    status: pass
+    reviewer: ZtotheZ
+    reviewedAt: 2026-08-27T11:05:01+03:00
+    notes: >-
+      The SceneStart product owner and maintainer completed the Workshop-to-Studio workflow,
+      confirmed that handle and scene state remained intact, saved the editable project, exported
+      the offline HTML, documented and confirmed one release asset, downloaded readme.txt, and
+      reported that no creative-data upload was apparent and the exported HTML worked offline.
+      This observed review is supported by the retained automated journey, network, and download
+      evidence. A separate Core Demo Craft 6-of-9 usability defect was recorded and remediated
+      without altering this local-first decision.
+    evidence:
+      - knowledge-base/benchmarks/scenestart/human-review.md
+      - evidence/interface-quality/scenestart/guided-workshop/runtime/runtime-report.json
+      - evidence/interface-quality/scenestart/studio-export/runtime/runtime-report.json
+      - evidence/interface-quality/scenestart/release-provenance/runtime/runtime-report.json
+      - evidence/interface-quality/scenestart/release-provenance/runtime/journey-document-asset-and-readme-step-12-readme.txt

package/knowledge-base/benchmarks/scenestart/human-review.md

@@ -0,0 +1,99 @@
+# SceneStart Human Review Record
+
+## Review Metadata
+
+- Reviewer: ZtotheZ
+- Reviewer role and relevant expertise: SceneStart product owner and maintainer
+- Review date and timezone: 2026-08-27T11:05:01+03:00
+- SceneStart build or revision: Current local working tree reviewed at `http://127.0.0.1:4173`
+- Browser, operating system, and input method: Not supplied by reviewer
+- Viewports reviewed: Reviewer-operated viewport; exact dimensions not supplied
+- Related quality-gate report: `evidence/interface-quality/scenestart/release-provenance/quality-gate.json`
+
+## Expert Review
+
+### Local-First Boundary
+
+- [x] Workshop project creation and the transition into Studio completed without losing the local project.
+- [x] The handle and scene state remained intact in Studio.
+- [x] The editable project and offline HTML production downloaded successfully.
+- [x] Release provenance accepted an asset record and rights confirmation and downloaded `readme.txt`.
+- [x] No creative-data upload was apparent during the reviewed workflow, and the exported HTML worked offline.
+
+Observation:
+
+The reviewer marked all five local-first workflow checks as PASS. This is an observed product
+review, not independent network forensics. Automated runtime evidence separately records the
+journeys, downloads, and observed network behavior.
+
+Evidence paths or network records:
+
+- `evidence/interface-quality/scenestart/guided-workshop/runtime/runtime-report.json`
+- `evidence/interface-quality/scenestart/guided-workshop/runtime/journey-complete-guided-production-step-18-my-production.html`
+- `evidence/interface-quality/scenestart/studio-export/runtime/runtime-report.json`
+- `evidence/interface-quality/scenestart/studio-export/runtime/journey-compose-save-export-step-11-scenestart-production.json`
+- `evidence/interface-quality/scenestart/studio-export/runtime/journey-compose-save-export-step-13-my-production.html`
+- `evidence/interface-quality/scenestart/release-provenance/runtime/runtime-report.json`
+- `evidence/interface-quality/scenestart/release-provenance/runtime/journey-document-asset-and-readme-step-12-readme.txt`
+
+Decision for `local-first-boundary`: PASS
+
+### Semantic And Visual Integrity
+
+Observation:
+
+The Core Demo Craft route reported `6/9 LESSONS COMPLETE` after the reviewer completed every
+visible confirmation action. The three interactive visual lessons exposed parameter controls but
+no explicit completion action, so the reviewer could not intentionally mark those lessons
+complete. This is tracked as a product usability defect and does not alter the separate
+local-first decision.
+
+Evidence path:
+
+- `http://127.0.0.1:4173/learn/core-demo-craft`
+
+## Findings
+
+- Task: Complete all nine Core Demo Craft lessons.
+- Observation: The six concept lessons provide confirmation buttons, while the three interactive
+  visual lessons rely on hidden automatic completion conditions and provide no explicit check or
+  completion action. The visible result remains `6/9 LESSONS COMPLETE`.
+- Evidence: Reviewer observation on `/learn/core-demo-craft`.
+- Severity, 0 to 4: 3
+- Confidence: High
+- Remediation: Give each interactive lesson an explicit action that checks its stated goal,
+  explains an unmet condition, and completes the lesson after the condition is satisfied.
+- Validation method: Component regression test plus the `learning-persistence` browser journey.
+- Evidence class: human maintainer
+
+## Final Decision
+
+- Approved criteria: `local-first-boundary`
+- Failed criteria: None in the release-provenance profile
+- Unresolved criteria at review time: Core Demo Craft explicit interactive-lesson completion
+- Reviewer signature or approval reference: ZtotheZ review supplied in the active engineering session
+- Approval timestamp: 2026-08-27T11:05:01+03:00
+
+## Engineering Resolution
+
+- Resolution timestamp: 2026-08-27T11:14:37+03:00
+- Status: Resolved
+- Change: Every interactive visual lesson now provides an explicit `CHECK GOAL AND COMPLETE`
+  action. Failed checks expose the lesson hint; successful checks require learner confirmation.
+- Component evidence: Two focused tests verify unmet-goal guidance and confirmation-only
+  completion.
+- Browser evidence: The `learning-persistence` journey completes all nine lessons and preserves
+  `9/9 DONE` across navigation with zero runtime findings.
+- Release evidence: The aggregate SceneStart gate passes 4 of 4 profiles and 10 of 10 acceptance
+  criteria.
+
+## Post-Fix Human Validation
+
+- Reviewer: ZtotheZ
+- Evidence level: Attributable human maintainer review
+- Validation timestamp: 2026-08-27T11:29:47+03:00
+- Result: Pass
+- Observation: The reviewer repeated the Core Demo Craft path after the completion-control fix and
+  confirmed `9/9 LESSONS COMPLETE · PATH COMPLETE`.
+- Scope: This closes the SceneStart maintainer acceptance finding. It does not claim independent
+  expert review or representative-user research.

package/knowledge-base/benchmarks/scenestart/human-review.template.md

@@ -0,0 +1,105 @@
+# SceneStart Human Review Record
+
+This file is a blank review instrument, not evidence. An AI agent may prepare the structure but must not fill reviewer identity, observations, decisions, participant outcomes, timestamps, or evidence claims.
+
+## Review Metadata
+
+- Reviewer:
+- Reviewer role and relevant expertise:
+- Review date and timezone:
+- SceneStart build or revision:
+- Runtime URL or artifact:
+- Browser, operating system, and input method:
+- Viewports reviewed:
+- Related quality-gate report:
+
+## Expert Review
+
+### Local-First Boundary
+
+- [ ] No creative project fields or progress records were transmitted to an application backend during the reviewed journeys.
+- [ ] Browser storage keys and deletion behavior matched the privacy explanation.
+- [ ] Third-party scripts, pixels, analytics, and background service calls were inspected.
+- [ ] Optional external links were distinguishable from required product services.
+- [ ] Downloaded production HTML ran without network access and contained no remote runtime resources.
+
+Observation:
+
+Evidence paths or network records:
+
+Decision for `local-first-boundary`: PASS / FAIL
+
+### Semantic And Visual Integrity
+
+- [ ] The three-scene production read as an opening, build, and ending rather than unrelated presets.
+- [ ] Canvas output was visible and meaningfully changed with configured parameters.
+- [ ] Playback, pause, restart, completion, and Escape behavior were understandable.
+- [ ] Starter content was not mistaken for authorship or rights evidence.
+- [ ] Release documentation did not imply certification.
+
+Observation:
+
+Evidence paths:
+
+## Representative-User Session
+
+Complete this section only for a consented participant session. Use a non-identifying participant code.
+
+- Participant code:
+- Recruitment context:
+- Prior demoscene experience:
+- Assistive technology or access needs voluntarily disclosed:
+- Facilitator:
+- Consent record location:
+
+### Task 1: Guided First Production
+
+Start at `/workshop`. Create a handle, complete the six steps, preview the complete arc, and keep the result.
+
+- Completed without verbal assistance: YES / NO
+- Time to first meaningful preview:
+- Time to completed export:
+- Assistance provided:
+- Main confusion point:
+- Participant explanation of one parameter effect:
+- Export opened successfully offline: YES / NO / NOT TESTED
+
+### Task 2: Resume And Edit
+
+Continue into Studio, change one scene, save the editable project, and identify how to reopen it.
+
+- Completed: YES / NO
+- Existing handle and scenes preserved: YES / NO
+- Participant could distinguish JSON project from HTML production: YES / NO
+- Observation:
+
+### Task 3: Release Provenance
+
+Document one external asset, resolve or leave its rights honestly, and generate `readme.txt`.
+
+- Completed: YES / NO
+- Participant understood rights confirmation was not certification: YES / NO
+- Observation:
+
+## Findings
+
+For every finding record:
+
+- Task:
+- Observation:
+- Evidence:
+- Severity, 0 to 4:
+- Confidence:
+- Remediation:
+- Validation method:
+- Evidence class: human-expert / representative-user
+
+## Final Decision
+
+- Approved criteria:
+- Failed criteria:
+- Unresolved criteria:
+- Reviewer signature or approval reference:
+- Approval timestamp:
+
+Only after the reviewer approves this record may its decisions be represented in an attestation file.

package/knowledge-base/benchmarks/scenestart/journeys.json

@@ -0,0 +1,141 @@
+{
+  "version": "1.0",
+  "contract": "scenestart",
+  "profiles": [
+    {
+      "id": "studio-export",
+      "name": "Compose, save and export a production",
+      "environment": [
+        "SceneStart is running with a fresh browser context",
+        "Downloads are enabled",
+        "No cloud project service is configured"
+      ],
+      "journeys": [
+        {
+          "id": "compose-save-export",
+          "name": "compose-save-export",
+          "steps": [
+            { "action": "navigate", "value": "/studio" },
+            { "action": "expectText", "selector": "h1", "value": "Demo Studio" },
+            { "action": "fill", "selector": "label:has-text(\"HANDLE\") input", "value": "ZSCENE" },
+            { "action": "fill", "selector": "label:has-text(\"CONCEPT\") input", "value": "A local-first three-scene arc" },
+            { "action": "fill", "selector": "label:has-text(\"TITLE\") input", "value": "Signal opening" },
+            { "action": "expectValue", "selector": "label:has-text(\"HANDLE\") input", "value": "ZSCENE" },
+            { "action": "expectValue", "selector": "label:has-text(\"TITLE\") input", "value": "Signal opening" },
+            { "action": "click", "selector": "button:has-text(\"PLAY PRODUCTION\")" },
+            { "action": "expectText", "selector": "button", "value": "PAUSE" },
+            { "action": "click", "selector": "button:has-text(\"RESTART\")" },
+            { "action": "expectDownload", "selector": "button:has-text(\"SAVE PROJECT\")", "filenameIncludes": "scenestart-production.json" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "Project saved locally." },
+            { "action": "expectDownload", "selector": "button:has-text(\"EXPORT OFFLINE HTML\")", "filenameIncludes": "my-production.html" }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "guided-workshop",
+      "name": "Complete the guided first production",
+      "environment": [
+        "SceneStart is running with a fresh browser context",
+        "Browser localStorage and downloads are available",
+        "The workshop uses its deterministic default three-scene project"
+      ],
+      "journeys": [
+        {
+          "id": "complete-guided-production",
+          "name": "complete-guided-production",
+          "steps": [
+            { "action": "navigate", "value": "/workshop" },
+            { "action": "expectText", "selector": "h1", "value": "Build your first production" },
+            { "action": "fill", "selector": "label:has-text(\"YOUR HANDLE\") input", "value": "NOVA" },
+            { "action": "expectValue", "selector": "label:has-text(\"YOUR HANDLE\") input", "value": "NOVA" },
+            { "action": "click", "selector": "button:has-text(\"NEXT STEP\")" },
+            { "action": "expectText", "selector": "h2", "value": "Create depth" },
+            { "action": "click", "selector": "button:has-text(\"NEXT STEP\")" },
+            { "action": "expectText", "selector": "h2", "value": "Build interference" },
+            { "action": "click", "selector": "button:has-text(\"NEXT STEP\")" },
+            { "action": "expectText", "selector": "h2", "value": "Aim for the ending" },
+            { "action": "click", "selector": "button:has-text(\"NEXT STEP\")" },
+            { "action": "expectText", "selector": "h2", "value": "Watch the whole arc" },
+            { "action": "click", "selector": "button:has-text(\"PLAY THE 20-SECOND PRODUCTION\")" },
+            { "action": "expectText", "selector": "button", "value": "PAUSE" },
+            { "action": "click", "selector": "button:has-text(\"PAUSE\")" },
+            { "action": "click", "selector": "button:has-text(\"FINISH WORKSHOP\")" },
+            { "action": "expectText", "selector": "body", "value": "You built a timed opening, escalation and ending." },
+            { "action": "expectDownload", "selector": "button:has-text(\"EXPORT OFFLINE HTML\")", "filenameIncludes": "my-production.html" },
+            { "action": "click", "selector": "a:has-text(\"CONTINUE IN DEMO STUDIO\")" },
+            { "action": "expectText", "selector": "h1", "value": "Demo Studio" },
+            { "action": "expectValue", "selector": "label:has-text(\"HANDLE\") input", "value": "NOVA" }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "learning-persistence",
+      "name": "Complete and resume local learning progress",
+      "environment": [
+        "SceneStart is running with a fresh browser context",
+        "Browser localStorage is available",
+        "Core Demo Craft begins with no completed lessons"
+      ],
+      "journeys": [
+        {
+          "id": "complete-and-resume-lesson",
+          "name": "complete-and-resume-lesson",
+          "steps": [
+            { "action": "navigate", "value": "/learn/core-demo-craft" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "0/9 LESSONS COMPLETE" },
+            { "action": "click", "selector": "button:has-text(\"I understand what a demo is\")" },
+            { "action": "click", "selector": "button:has-text(\"I understand scene time\")" },
+            { "action": "press", "selector": "#remix-plasma-waveScale", "value": "Home" },
+            { "action": "press", "selector": "#remix-plasma-colorSpeed", "value": "Home" },
+            { "action": "click", "selector": "section:has(#lesson-waves) button:has-text(\"CHECK GOAL AND COMPLETE\")" },
+            { "action": "press", "selector": "#remix-starfield-fieldOfView", "value": "End" },
+            { "action": "click", "selector": "section:has(#lesson-one-effect) button:has-text(\"CHECK GOAL AND COMPLETE\")" },
+            { "action": "click", "selector": "button:has-text(\"I know how to save a variation\")" },
+            { "action": "press", "selector": "#remix-tunnel-ringSpacing", "value": "End" },
+            { "action": "press", "selector": "#remix-tunnel-travelSpeed", "value": "Home" },
+            { "action": "click", "selector": "section:has(#lesson-combining-effects) button:has-text(\"CHECK GOAL AND COMPLETE\")" },
+            { "action": "click", "selector": "button:has-text(\"I understand sync in principle\")" },
+            { "action": "click", "selector": "button:has-text(\"I understand pacing and flow\")" },
+            { "action": "click", "selector": "button:has-text(\"I understand what a release needs\")" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "9/9 LESSONS COMPLETE · PATH COMPLETE" },
+            { "action": "navigate", "value": "/learn" },
+            { "action": "expectText", "selector": "body", "value": "9/9 DONE" },
+            { "action": "navigate", "value": "/learn/core-demo-craft" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "9/9 LESSONS COMPLETE · PATH COMPLETE" }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "release-provenance",
+      "name": "Document provenance and export release notes",
+      "environment": [
+        "SceneStart is running with a fresh browser context",
+        "Browser localStorage and downloads are available",
+        "No legal or competition certification service is present"
+      ],
+      "journeys": [
+        {
+          "id": "document-asset-and-readme",
+          "name": "document-asset-and-readme",
+          "steps": [
+            { "action": "navigate", "value": "/learn/release" },
+            { "action": "expectText", "selector": "body", "value": "does not certify originality, authorship, rights ownership, or official competition eligibility" },
+            { "action": "click", "selector": "button:has-text(\"ADD ASSET\")" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "1 entry has unresolved rights" },
+            { "action": "fill", "selector": "label:has-text(\"Asset name\") + input", "value": "Original soundtrack" },
+            { "action": "fill", "selector": "label:has-text(\"Creator\") + input", "value": "NOVA" },
+            { "action": "fill", "selector": "label:has-text(\"Licence\") + input", "value": "Creator-owned" },
+            { "action": "click", "selector": "label:has-text(\"RIGHTS CONFIRMED\") input" },
+            { "action": "expectText", "selector": "[role=\"status\"]", "value": "No unresolved asset rights." },
+            { "action": "fill", "selector": "#release-productionTitle", "value": "Signal Arc" },
+            { "action": "fill", "selector": "#release-aiDisclosure", "value": "Interface planning assistance disclosed by the creator." },
+            { "action": "expectDownload", "selector": "button:has-text(\"DOWNLOAD readme.txt\")", "filenameIncludes": "readme.txt" }
+          ]
+        }
+      ]
+    }
+  ]
+}