diff --git a/discussion/index.ndjson b/discussion/index.ndjson new file mode 100644 index 00000000..1ee467b7 --- /dev/null +++ b/discussion/index.ndjson @@ -0,0 +1,2 @@ +{"type":"meta","next_id":{"DSC":2,"AGD":1,"DEC":1,"PLN":1,"LSN":19,"CLSN":1}} +{"type":"discussion","id":"DSC-0001","status":"done","ticket":"legacy-runtime-learn-import","title":"Import legacy runtime learn into discussion lessons","created_at":"2026-03-27","updated_at":"2026-03-27","tags":["migration","tech-debt"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0001","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0002","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0003","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0004","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0005","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0006","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0007","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0008","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0009","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0010","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0011","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0012","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0013","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0014","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0015","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0016","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0017","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"},{"id":"LSN-0018","file":"lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md","status":"done","created_at":"2026-03-27","updated_at":"2026-03-27"}]} diff --git a/docs/runtime/learn/README.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md similarity index 55% rename from docs/runtime/learn/README.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md index d005c2c1..78870d5e 100644 --- a/docs/runtime/learn/README.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0001-prometeu-learn-index.md @@ -1,3 +1,11 @@ +--- +id: LSN-0001 +ticket: legacy-runtime-learn-import +title: PROMETEU Learn +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # PROMETEU Learn This area contains pedagogical material about the PROMETEU machine. @@ -6,7 +14,7 @@ It exists to explain the fantasy handheld's mental model, influences, tradeoffs, ## Authority -- `docs/runtime/learn/` is not a canonical source of technical contract. +- `discussion/lessons/` is not a canonical source of technical contract. - The machine's normative surfaces live in [`../specs/`](../../specs/README.md). - The VM/runtime's internal invariants live in [`../virtual-machine/ARCHITECTURE.md`](../../vm-arch/ARCHITECTURE.md). @@ -14,38 +22,38 @@ It exists to explain the fantasy handheld's mental model, influences, tradeoffs, If someone is entering the machine model now, the most useful order is: -1. [`mental-model-time-and-cycles.md`](mental-model-time-and-cycles.md) -2. [`mental-model-portability-and-cross-platform.md`](mental-model-portability-and-cross-platform.md) -3. [`mental-model-observability-and-debugging.md`](mental-model-observability-and-debugging.md) -4. [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +1. [`mental-model-time-and-cycles.md`](LSN-0017-mental-model-time-and-cycles.md) +2. [`mental-model-portability-and-cross-platform.md`](LSN-0014-mental-model-portability-and-cross-platform.md) +3. [`mental-model-observability-and-debugging.md`](LSN-0013-mental-model-observability-and-debugging.md) +4. [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) 5. then the peripherals and specific domains ## Core Mental Models -- [`mental-model-time-and-cycles.md`](mental-model-time-and-cycles.md) -- [`mental-model-portability-and-cross-platform.md`](mental-model-portability-and-cross-platform.md) -- [`mental-model-observability-and-debugging.md`](mental-model-observability-and-debugging.md) -- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +- [`mental-model-time-and-cycles.md`](LSN-0017-mental-model-time-and-cycles.md) +- [`mental-model-portability-and-cross-platform.md`](LSN-0014-mental-model-portability-and-cross-platform.md) +- [`mental-model-observability-and-debugging.md`](LSN-0013-mental-model-observability-and-debugging.md) +- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) ## Peripheral Mental Models -- [`mental-model-gfx.md`](mental-model-gfx.md) -- [`mental-model-audio.md`](mental-model-audio.md) -- [`mental-model-asset-management.md`](mental-model-asset-management.md) -- [`mental-model-input.md`](mental-model-input.md) -- [`mental-model-touch.md`](mental-model-touch.md) -- [`mental-model-save-memory-and-memcard.md`](mental-model-save-memory-and-memcard.md) +- [`mental-model-gfx.md`](LSN-0011-mental-model-gfx.md) +- [`mental-model-audio.md`](LSN-0010-mental-model-audio.md) +- [`mental-model-asset-management.md`](LSN-0009-mental-model-asset-management.md) +- [`mental-model-input.md`](LSN-0012-mental-model-input.md) +- [`mental-model-touch.md`](LSN-0018-mental-model-touch.md) +- [`mental-model-save-memory-and-memcard.md`](LSN-0015-mental-model-save-memory-and-memcard.md) ## Historical Snapshots These files preserve the rationale of decisions already absorbed by specs and/or implementation. They are useful for context, but they should not be read as the primary current contract. -- [`historical-gfx-status-first-fault-and-return-contract.md`](historical-gfx-status-first-fault-and-return-contract.md) -- [`historical-audio-status-first-fault-and-return-contract.md`](historical-audio-status-first-fault-and-return-contract.md) -- [`historical-asset-status-first-fault-and-return-contract.md`](historical-asset-status-first-fault-and-return-contract.md) -- [`historical-cartridge-boot-protocol-and-manifest-authority.md`](historical-cartridge-boot-protocol-and-manifest-authority.md) -- [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md) -- [`historical-retired-fault-and-input-decisions.md`](historical-retired-fault-and-input-decisions.md) +- [`historical-gfx-status-first-fault-and-return-contract.md`](LSN-0006-historical-gfx-status-first-fault-and-return-contract.md) +- [`historical-audio-status-first-fault-and-return-contract.md`](LSN-0003-historical-audio-status-first-fault-and-return-contract.md) +- [`historical-asset-status-first-fault-and-return-contract.md`](LSN-0002-historical-asset-status-first-fault-and-return-contract.md) +- [`historical-cartridge-boot-protocol-and-manifest-authority.md`](LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md) +- [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md) +- [`historical-retired-fault-and-input-decisions.md`](LSN-0007-historical-retired-fault-and-input-decisions.md) ## Naming Convention diff --git a/docs/runtime/learn/historical-asset-status-first-fault-and-return-contract.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md similarity index 92% rename from docs/runtime/learn/historical-asset-status-first-fault-and-return-contract.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md index 95cae8e2..e80bedd3 100644 --- a/docs/runtime/learn/historical-asset-status-first-fault-and-return-contract.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0002-historical-asset-status-first-fault-and-return-contract.md @@ -1,3 +1,11 @@ +--- +id: LSN-0002 +ticket: legacy-runtime-learn-import +title: Historical Snapshot - Asset Status-First Fault and Return Contract +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical Snapshot - Asset Status-First Fault and Return Contract Status: historical snapshot in `learn`, not normative. @@ -5,7 +13,7 @@ Current normative anchors: - [`../specs/15-asset-management.md`](../../specs/15-asset-management.md) - [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md) -- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) ## Status diff --git a/docs/runtime/learn/historical-audio-status-first-fault-and-return-contract.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md similarity index 91% rename from docs/runtime/learn/historical-audio-status-first-fault-and-return-contract.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md index 39d6845f..5f128853 100644 --- a/docs/runtime/learn/historical-audio-status-first-fault-and-return-contract.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0003-historical-audio-status-first-fault-and-return-contract.md @@ -1,3 +1,11 @@ +--- +id: LSN-0003 +ticket: legacy-runtime-learn-import +title: Historical Snapshot - Audio Status-First Fault and Return Contract +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical Snapshot - Audio Status-First Fault and Return Contract Status: historical snapshot in `learn`, not normative. @@ -5,7 +13,7 @@ Current normative anchors: - [`../specs/05-audio-peripheral.md`](../../specs/05-audio-peripheral.md) - [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md) -- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) ## Status diff --git a/docs/runtime/learn/historical-cartridge-boot-protocol-and-manifest-authority.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md similarity index 95% rename from docs/runtime/learn/historical-cartridge-boot-protocol-and-manifest-authority.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md index 478eae7b..c632e241 100644 --- a/docs/runtime/learn/historical-cartridge-boot-protocol-and-manifest-authority.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0004-historical-cartridge-boot-protocol-and-manifest-authority.md @@ -1,3 +1,11 @@ +--- +id: LSN-0004 +ticket: legacy-runtime-learn-import +title: Historical Cartridge Boot Protocol and Manifest Authority +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical Cartridge Boot Protocol and Manifest Authority Status: pedagogical / historical diff --git a/docs/runtime/learn/historical-game-memcard-slots-surface-and-semantics.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md similarity index 92% rename from docs/runtime/learn/historical-game-memcard-slots-surface-and-semantics.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md index e63e3978..fc4d3619 100644 --- a/docs/runtime/learn/historical-game-memcard-slots-surface-and-semantics.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0005-historical-game-memcard-slots-surface-and-semantics.md @@ -1,3 +1,11 @@ +--- +id: LSN-0005 +ticket: legacy-runtime-learn-import +title: Historical Snapshot - Game Memcard Slots Surface and Semantics +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical Snapshot - Game Memcard Slots Surface and Semantics Status: historical snapshot in `learn`, not normative. @@ -6,8 +14,8 @@ Current normative anchors: - [`../specs/08-save-memory-and-memcard.md`](../../specs/08-save-memory-and-memcard.md) - [`../specs/16-host-abi-and-syscalls.md`](../../specs/16-host-abi-and-syscalls.md) - [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md) -- [`mental-model-save-memory-and-memcard.md`](mental-model-save-memory-and-memcard.md) -- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +- [`mental-model-save-memory-and-memcard.md`](LSN-0015-mental-model-save-memory-and-memcard.md) +- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) ## Status diff --git a/docs/runtime/learn/historical-gfx-status-first-fault-and-return-contract.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md similarity index 91% rename from docs/runtime/learn/historical-gfx-status-first-fault-and-return-contract.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md index 77f1f99d..8ff5916b 100644 --- a/docs/runtime/learn/historical-gfx-status-first-fault-and-return-contract.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0006-historical-gfx-status-first-fault-and-return-contract.md @@ -1,3 +1,11 @@ +--- +id: LSN-0006 +ticket: legacy-runtime-learn-import +title: Historical Snapshot - GFX Status-First Fault and Return Contract +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical Snapshot - GFX Status-First Fault and Return Contract Status: historical snapshot in `learn`, not normative. @@ -5,7 +13,7 @@ Current normative anchors: - [`../specs/04-gfx-peripheral.md`](../../specs/04-gfx-peripheral.md) - [`../specs/16a-syscall-policies.md`](../../specs/16a-syscall-policies.md) -- [`mental-model-status-first-and-fault-thinking.md`](mental-model-status-first-and-fault-thinking.md) +- [`mental-model-status-first-and-fault-thinking.md`](LSN-0016-mental-model-status-first-and-fault-thinking.md) ## Status diff --git a/docs/runtime/learn/historical-retired-fault-and-input-decisions.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md similarity index 89% rename from docs/runtime/learn/historical-retired-fault-and-input-decisions.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md index c030cd48..34d65484 100644 --- a/docs/runtime/learn/historical-retired-fault-and-input-decisions.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0007-historical-retired-fault-and-input-decisions.md @@ -1,3 +1,11 @@ +--- +id: LSN-0007 +ticket: legacy-runtime-learn-import +title: Retired Decisions 004-005 (Historical Notes) +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Retired Decisions 004-005 (Historical Notes) This file keeps historical rationale from decisions that were retired after being absorbed by specs. diff --git a/docs/runtime/learn/historical-vm-core-and-assets.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md similarity index 95% rename from docs/runtime/learn/historical-vm-core-and-assets.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md index 05330e6d..6c943b90 100644 --- a/docs/runtime/learn/historical-vm-core-and-assets.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0008-historical-vm-core-and-assets.md @@ -1,3 +1,11 @@ +--- +id: LSN-0008 +ticket: legacy-runtime-learn-import +title: Historical VM Core and Assets (Retired Decisions) +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Historical VM Core and Assets (Retired Decisions) This document consolidates the historical rationale and mental models from retired decisions regarding VM-owned stateful core, byte transfer protocol, filesystem fault policies, and asset management. diff --git a/docs/runtime/learn/mental-model-asset-management.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md similarity index 97% rename from docs/runtime/learn/mental-model-asset-management.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md index aa706594..59e6a78b 100644 --- a/docs/runtime/learn/mental-model-asset-management.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0009-mental-model-asset-management.md @@ -1,3 +1,11 @@ +--- +id: LSN-0009 +ticket: legacy-runtime-learn-import +title: Asset Management Mental Model +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Asset Management Mental Model Status: pedagogical diff --git a/docs/runtime/learn/mental-model-audio.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md similarity index 92% rename from docs/runtime/learn/mental-model-audio.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md index 3e3089b7..70da7df7 100644 --- a/docs/runtime/learn/mental-model-audio.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0010-mental-model-audio.md @@ -1,3 +1,11 @@ +--- +id: LSN-0010 +ticket: legacy-runtime-learn-import +title: Audio Mental Model +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Audio Mental Model Status: pedagogical diff --git a/docs/runtime/learn/mental-model-gfx.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md similarity index 95% rename from docs/runtime/learn/mental-model-gfx.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md index b2874c4c..36c0a623 100644 --- a/docs/runtime/learn/mental-model-gfx.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0011-mental-model-gfx.md @@ -1,3 +1,11 @@ +--- +id: LSN-0011 +ticket: legacy-runtime-learn-import +title: GFX Mental Model +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # GFX Mental Model Status: pedagogical diff --git a/docs/runtime/learn/mental-model-input.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md similarity index 89% rename from docs/runtime/learn/mental-model-input.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md index 991d043a..d72049f9 100644 --- a/docs/runtime/learn/mental-model-input.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0012-mental-model-input.md @@ -1,3 +1,11 @@ +--- +id: LSN-0012 +ticket: legacy-runtime-learn-import +title: Input Mental Model +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Input Mental Model Status: pedagogical diff --git a/docs/runtime/learn/mental-model-observability-and-debugging.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md similarity index 87% rename from docs/runtime/learn/mental-model-observability-and-debugging.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md index d078fa84..bbed3f17 100644 --- a/docs/runtime/learn/mental-model-observability-and-debugging.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0013-mental-model-observability-and-debugging.md @@ -1,3 +1,11 @@ +--- +id: LSN-0013 +ticket: legacy-runtime-learn-import +title: Observability and Debugging +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Observability and Debugging Status: pedagogical diff --git a/docs/runtime/learn/mental-model-portability-and-cross-platform.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md similarity index 91% rename from docs/runtime/learn/mental-model-portability-and-cross-platform.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md index a88a53e1..ee07dea1 100644 --- a/docs/runtime/learn/mental-model-portability-and-cross-platform.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0014-mental-model-portability-and-cross-platform.md @@ -1,3 +1,11 @@ +--- +id: LSN-0014 +ticket: legacy-runtime-learn-import +title: Portability and Cross-Platform Execution +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Portability and Cross-Platform Execution Status: pedagogical diff --git a/docs/runtime/learn/mental-model-save-memory-and-memcard.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md similarity index 93% rename from docs/runtime/learn/mental-model-save-memory-and-memcard.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md index ef13c427..cf924fe4 100644 --- a/docs/runtime/learn/mental-model-save-memory-and-memcard.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0015-mental-model-save-memory-and-memcard.md @@ -1,8 +1,16 @@ +--- +id: LSN-0015 +ticket: legacy-runtime-learn-import +title: Save Memory and MEMCARD +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Save Memory and MEMCARD Status: pedagogical Companion spec: [`../specs/08-save-memory-and-memcard.md`](../../specs/08-save-memory-and-memcard.md) -Historical snapshot: [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md) +Historical snapshot: [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md) PROMETEU treats persistence as explicit hardware, not as invisible save behavior. diff --git a/docs/runtime/learn/mental-model-status-first-and-fault-thinking.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md similarity index 87% rename from docs/runtime/learn/mental-model-status-first-and-fault-thinking.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md index d69af0e8..2b5dd920 100644 --- a/docs/runtime/learn/mental-model-status-first-and-fault-thinking.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0016-mental-model-status-first-and-fault-thinking.md @@ -1,3 +1,11 @@ +--- +id: LSN-0016 +ticket: legacy-runtime-learn-import +title: Status-First and Fault Thinking +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Status-First and Fault Thinking Status: pedagogical @@ -146,10 +154,10 @@ Signs that the contract is still weak: This guide consolidates the intuition that first appeared in these historical snapshots: -- [`historical-gfx-status-first-fault-and-return-contract.md`](historical-gfx-status-first-fault-and-return-contract.md) -- [`historical-audio-status-first-fault-and-return-contract.md`](historical-audio-status-first-fault-and-return-contract.md) -- [`historical-asset-status-first-fault-and-return-contract.md`](historical-asset-status-first-fault-and-return-contract.md) -- [`historical-game-memcard-slots-surface-and-semantics.md`](historical-game-memcard-slots-surface-and-semantics.md) -- [`historical-retired-fault-and-input-decisions.md`](historical-retired-fault-and-input-decisions.md) +- [`historical-gfx-status-first-fault-and-return-contract.md`](LSN-0006-historical-gfx-status-first-fault-and-return-contract.md) +- [`historical-audio-status-first-fault-and-return-contract.md`](LSN-0003-historical-audio-status-first-fault-and-return-contract.md) +- [`historical-asset-status-first-fault-and-return-contract.md`](LSN-0002-historical-asset-status-first-fault-and-return-contract.md) +- [`historical-game-memcard-slots-surface-and-semantics.md`](LSN-0005-historical-game-memcard-slots-surface-and-semantics.md) +- [`historical-retired-fault-and-input-decisions.md`](LSN-0007-historical-retired-fault-and-input-decisions.md) Use the snapshots for historical context. Use the specs for the current normative contract. diff --git a/docs/runtime/learn/mental-model-time-and-cycles.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md similarity index 91% rename from docs/runtime/learn/mental-model-time-and-cycles.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md index c81a526b..4a839ace 100644 --- a/docs/runtime/learn/mental-model-time-and-cycles.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0017-mental-model-time-and-cycles.md @@ -1,3 +1,11 @@ +--- +id: LSN-0017 +ticket: legacy-runtime-learn-import +title: Time Model and Cycles +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Time Model and Cycles Status: pedagogical diff --git a/docs/runtime/learn/mental-model-touch.md b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md similarity index 89% rename from docs/runtime/learn/mental-model-touch.md rename to discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md index fd8e9402..0208cd05 100644 --- a/docs/runtime/learn/mental-model-touch.md +++ b/discussion/lessons/DSC-0001-runtime-learn-legacy-import/LSN-0018-mental-model-touch.md @@ -1,3 +1,11 @@ +--- +id: LSN-0018 +ticket: legacy-runtime-learn-import +title: Touch Mental Model +created: 2026-03-27 +tags: [migration, tech-debt] +--- + # Touch Mental Model Status: pedagogical