diff --git a/.agent/knowledge/html5-activities-index.md b/.agent/knowledge/html5-activities-index.md
new file mode 100644
index 0000000..3032c06
--- /dev/null
+++ b/.agent/knowledge/html5-activities-index.md
@@ -0,0 +1,82 @@
+# Reusable Deck-Local HTML5 Activities
+
+Index of custom interactive widgets built directly inside a presentation's own
+HTML/CSS/JS (vanilla, no external libraries). These are distinct from
+ActiveBits-hosted "embedded activities" (see
+`.agent/skills/vendor/syncdeck/references/AVAILABLE_ACTIVITIES.md`) — everything
+here lives inline in the deck itself and is meant to be copied/adapted, not
+launched.
+
+When building a new interactive moment, check this list first. If an existing
+engine fits the shape of the interaction (classify items, trace state
+step-by-step, select-all-that-apply, timed random prompt, progressive reveal,
+drag-to-correct-target), copy the relevant `init*` function and markup from the
+source file and re-skin it with new content rather than inventing a new
+mechanism.
+
+## Generic, highly reusable engines
+
+### Variable-box code trace
+- **Where:** `Decks/HPy/Unit 1 - Basic Programming Constructs/1.2 - Data, Expressions, and Variables/1.2-data-expressions-and-variables.html` (`initVarBoxTrace`, JS ~1938-2115, HTML ~362-383)
+- **Also reimplemented as:** `initCallTrace` in `.../1.3 - Functions/1.3-functions.html` (JS ~1793-1981); `initBranchTrace` in `.../1.4 - Conditionals/1.4-conditionals.html` (JS ~1737-1927)
+- **Concept:** step through a code listing line-by-line (`done`/`current`/`pending` highlighting) while dragging value "chips" onto empty variable boxes to trace program state.
+- **Mechanism:** native HTML5 drag-and-drop (`draggable`, `dragstart`/`dragover`/`drop`) with a click-to-select fallback for accessibility; a state object tracks the current step index and box values, with correct/incorrect feedback.
+- **Reuse:** very generic — works for any procedural code sequence where you want learners to predict variable state at each step. Follows the `data-fragment-trace` code-tracing convention in AGENTS.md (current-line-is-next-to-execute).
+
+### Chip-to-bin classifier
+- **Where:** same file as above, `initTypeSort` (HTML ~775, JS ~2115+) — sorts values into data-type bins (int/float/str/bool)
+- **Also reimplemented as:** `initTruthySort` in `1.3-functions.html` (truthy/falsy); `initBoolSort` in `1.4-conditionals.html` (boolean-expression sort)
+- **Concept:** drag chips from a tray into labeled bins; a "N of M sorted" counter tracks progress and correctly-placed chips are removed from the tray.
+- **Mechanism:** same drag/drop + click-fallback mechanism as the variable-box trace.
+- **Reuse:** very generic classification pattern — swap bin labels and chip data for any "sort these into categories" exercise (data types, even/odd, parts of speech, etc.).
+
+### Select-all-that-apply scenario matcher
+- **Where:** `Decks/AR2/ShopSafety/Industrial_Warning_Signs.html`, `initChooseGame` (section ~595-616, JS ~877-990)
+- **Concept:** present a scenario, learner multi-selects applicable chips from a bank, "Check Answer" marks each `state-correct`/`state-incorrect`/`state-missed` with a scored summary ("N of M correct, X missed, Y extra").
+- **Mechanism:** pure click-based (no drag), `chosen` map tracks selection state, resets on `Reveal slidechanged`.
+- **Reuse:** strong generic fit for any "select all that apply against a scenario" assessment.
+
+### Staged progressive-reveal scenario
+- **Where:** `Decks/AR2/ShopSafety/Making_Warnings_Unnecessary.html` — three instances of the same engine: `initBeyondGame` (~1324-1391, section `#beyond-game` ~661), `initPpeGame` (~1391-1466, `#ppe-game` ~835), `initRiskyGame` (~1466-1523, `#risky-game` ~962)
+- **Concept:** a scenario description with a sequence of hidden "stage" panels; each button click reveals the next stage (marking prior ones `.done`) until all are shown, then advances to the next scenario.
+- **Mechanism:** click-driven progressive reveal, per-scenario reset on slide change, no drag/drop.
+- **Reuse:** generic step-by-step walkthrough pattern (hazard→control→limit, cause→effect chains, any staged reveal).
+
+### Timed random-prompt game shell
+- **Where:** `Decks/AR1/Engineering Communication/Disruptus.html` (section ~274-307, JS ~343-465)
+- **Concept:** round-based brainstorming game — reveals a random "mode," deals random cards, runs a 60s countdown with low-time warning and completion sound.
+- **Mechanism:** `data-state` attribute state machine (`idle`→`mode`→`cards`→`done`), plain `setInterval` timer, resets on `Reveal slidechanged`. No external libraries.
+- **Reuse:** generic "randomized-prompt + timed-round" mini-game shell, independent of the card art — good for any brainstorming/warm-up activity.
+
+### Flip-card flashcard quiz
+- **Where:** `Decks/AR2/ShopSafety/Industrial_Warning_Signs.html`, `initSignGame` (section ~437-459, JS ~807-877)
+- **Concept:** click-to-reveal meaning, with prev/next navigation through a deck of items.
+- **Mechanism:** simple click handler toggling a revealed state; no drag/drop or scoring.
+- **Reuse:** lightweight, generic flashcard-style reveal pattern.
+
+### Algorithm growth-rate race
+- **Where:** `Decks/CSP/Algorithms/unreasonable-time.html` (HTML ~856-920, JS ~1140-1270)
+- **Concept:** simulates multiple algorithms (log n, n, n², 2ⁿ) racing to complete n "steps" on a shared clock, driven by a slider for n; bars fill proportionally with live counts/percentages.
+- **Mechanism:** `requestAnimationFrame` timing loop, no canvas, pure DOM/CSS bars.
+- **Reuse:** generic "race N processes against a shared clock" pattern, reusable for any compare-growth-curves topic beyond Big-O.
+
+## Topic-coupled but reusable *mechanism*
+
+### Drag-to-correct-target credential/tool matching
+- **Where:** `Decks/CSP/Cybersecurity/public-private-key-lab.html` (cards ~500-1050, staged wiring/validation ~1280-1433); adapted again in `Decks/CSP/Cybersecurity/protecting-data.html` (cards ~710-1050, wiring ~1950-2059)
+- **Concept:** draggable `.key-card` elements (public/private keys) dropped onto `[data-drop-zone]` targets across multiple staged slides (`data-crypto-lab="encrypt"|"decrypt"|"signature"|"tamper"|...`), validating whether the correct key was used, plus a tamper-detection text input.
+- **Mechanism:** native drag-and-drop with click/keyboard fallback, per-slide state machine keyed off `data-crypto-lab`.
+- **Reuse:** content (asymmetric encryption) is specific, but the drag-a-labeled-card-onto-a-labeled-slot-with-correctness-validation mechanism generalizes to any "which credential/tool goes where" simulation.
+
+### Fragment-synced diagram morph
+- **Where:** `Decks/AR1/DCCircuits/EX7_Parallel_and_Mixed_Circuits.html` (JS ~1994-2110)
+- **Concept:** as Reveal fragments advance/reverse across several slides, a parallel-branch circuit diagram visually collapses into its series equivalent (and expands back) in sync with fragment navigation.
+- **Mechanism:** toggles a `.collapsing` class deferred via `requestAnimationFrame` to guarantee the CSS transition starts from the correct state, avoiding a transition/reflow race condition.
+- **Reuse:** diagram-specific, but the "rAF-deferred class toggle synced to fragment events" technique generalizes to any before/after visual transformation tied to slide progression (equivalent circuits, chemical reactions, state diagrams, etc.).
+
+---
+
+*Last surveyed 2026-07-26 across Decks/HPy, Decks/CSP, Decks/AR1, Decks/AR2.
+Line numbers are approximate — re-check with the file itself before copying.
+When you build a new substantial, reusable deck-local activity, add an entry
+here.*
diff --git a/.claude/knowledge b/.claude/knowledge
new file mode 120000
index 0000000..e82cad8
--- /dev/null
+++ b/.claude/knowledge
@@ -0,0 +1 @@
+../.agent/knowledge
\ No newline at end of file
diff --git a/.claude/skills b/.claude/skills
index eb079bd..0f30350 120000
--- a/.claude/skills
+++ b/.claude/skills
@@ -1 +1 @@
-.agent/skills
\ No newline at end of file
+../.agent/skills/
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
index 82eb04e..d84bd6a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,7 +2,7 @@
 
 This repository contains HTML slide presentations built with **Reveal.js**, published via GitHub Pages. Shared runtime/plugin code is consumed from the `SyncDeck-Reveal` git submodule at `vendor/SyncDeck-Reveal/`.
 
-Presentation source folders live under `Decks/`, while deployment remaps
+Presentation source folders now live under `Decks/`, while deployment remaps
 their contents to the site root. For example, `Decks/AR1/...` is published as
 `/AR1/...`.
 
@@ -141,7 +141,7 @@ Full message schema: `vendor/SyncDeck-Reveal/reveal-iframe-sync-message-schema.m
    ```
    Only add a `<style>` block after that link for styles that are specific to this presentation. If no `theme.css` exists and the new deck needs its own theme, consider extracting it to a `theme.css` so future decks in the same folder can share it.
    Check the parent folder heirarchy for a `theme.css` and place a new `theme.css` at the highest place
-   in the heirarchy that makes sense (e.g. the course level). 
+   in the heirarchy that makes sense (e.g. the course level).
 3. Load the bundled runtime with a relative path from the deck's published
    location. For the current `Decks/<course>/<unit>/deck.html` layout, use
    `../../runtime/`:
@@ -175,6 +175,32 @@ Full message schema: `vendor/SyncDeck-Reveal/reveal-iframe-sync-message-schema.m
    - Use **`px`** for all font sizes and spacing in CSS custom properties (not `em`/`clamp`/`vw`) — Reveal scales the canvas via CSS transform; `em` values double-scale
    - Never set `position` on `.reveal .slides > section` — Reveal needs `position: absolute` there for fade transitions; put padding/centering in a `.slide-inner` div inside each section instead
 5. Check the style tokens for the chosen preset in `.agent/skills/STYLE_PRESETS_EXTENDED.md` (full library) or `.agent/skills/vendor/syncdeck/references/STYLE_PRESETS.md` (short reference).
+6. If the deck needs a custom interactive widget (drag-and-drop, a classification/matching exercise, a code trace, a timed prompt game, a scored scenario, etc.), check `.agent/knowledge/html5-activities-index.md` first for an existing engine to copy and re-skin before building one from scratch. Add a new entry there if you build a substantial, reusable one.
+7. Run `node scripts/generate-permalink.mjs Decks/<path>/<deck>.html` to give the new deck a stable permalink before committing. See "Presentation Permalinks" below.
+
+## Presentation Permalinks
+
+Every deck under `Decks/` carries a `<meta name="syncdeck-permalink" content="<hash>">` tag,
+written once by `scripts/generate-permalink.mjs` and never hand-edited. The hash is derived
+from the deck's filename stem when first generated (with automatic collision resolution) and
+never changes afterward, even if the deck is later moved or renamed, so it's safe to share as
+a stable short link.
+
+- `config/permalinks.json` is the committed manifest (`hash -> { path, title }`) and the single
+  source of truth for collision detection.
+- `node scripts/generate-permalink.mjs Decks/<path>/<deck>.html` assigns a permalink to a new
+  deck, or re-syncs the manifest's cached path if an existing deck was moved.
+- `node scripts/generate-permalink.mjs --all` does the same across every deck; safe to re-run.
+- `node scripts/generate-permalink.mjs --check` (run in CI on every PR and before deploy) fails
+  if any deck is missing the tag, two decks share a hash, or the manifest disagrees with the
+  decks themselves.
+- At build time, `scripts/generate-permalink-redirects.mjs` emits a static redirect stub per
+  manifest entry at `/p/<hash>.html` that immediately `location.replace()`s to the deck's real,
+  current URL — this is what makes the permalink stable across reorganization.
+- The index pages (`scripts/site-indexes.mjs`) surface three links per deck: "Start as
+  instructor" and "Syncdeck link" (both ActiveBits-hosted, built from the deck's real current
+  URL) and "Permalink" (the short `/p/<hash>.html` link, safe to share or feed into the
+  ActiveBits launcher directly).
 
 ---
 
@@ -190,6 +216,24 @@ Full message schema: `vendor/SyncDeck-Reveal/reveal-iframe-sync-message-schema.m
 | Overview → storyboard | `overview: true` in any synced state is intercepted and routed to `reveal-storyboard-set` rather than `deck.setState()`, so students see the custom strip, not Reveal's grid. |
 | No `chalkboard.storage` | The vendored chalkboard plugin does not write to `sessionStorage`. The host page is the source of truth (snapshot + delta buffer). Setting `storage` would cause divergence on reload. |
 | Role starts as `standalone` | `reveal-iframe-sync.js` always initialises in `standalone` mode. The host must send `setRole` to promote to `instructor` or `student`. Never rely on the `role` config field. |
+| Never hand-edit `syncdeck-permalink` meta tag or `config/permalinks.json` | The hash is generated once by `scripts/generate-permalink.mjs` and must stay stable across moves/renames. CI (`--check`) fails if a deck's tag and the manifest disagree. |
+
+## Code Tracing Convention
+
+Decks that trace code execution line-by-line (`data-fragment-trace` sections driving `.code-line.current`/`.done`/`.pending`/`.active-call` highlighting) must follow this rule:
+
+**The highlighted "current" line always indicates the next line about to execute, not the line that just ran.** A line's effects (a `print()` writing to the console, an assignment populating a var-box, a function call returning to its call site) must not be revealed on the fragment that arrives at that line. They are revealed only on the fragment where the caret moves past it, i.e. one step later, when the following line becomes current.
+
+A line that raises an exception never completes, so the caret never advances past it. Its effect (the traceback) is revealed on a later fragment that keeps `data-trace-current` pointing at that same crashing line rather than a following one, since there is no line the program reached afterward.
+
+This applies uniformly to console output, variable assignment, and function-return-to-call-site reveals. When authoring or editing a `data-fragment-trace` section, structure fragments so that any line producing an observable effect fires a hidden fragment on arrival (`data-trace-current="N"` with no visible content) followed by the visible reveal on the fragment that advances `data-trace-current` to `N+1` (using a virtual line number past the end of the snippet if there is no real next line, or reusing `N` if the line crashes instead of completing).
+
+## Writing Style
+
+- **No em dashes (—).** Always substitute context-appropriate punctuation: colon for introductory/defining clauses, comma for parenthetical asides or conjunctions, semicolon for contrasting independent clauses, period for abrupt follow-up sentences.
+- **Sentences not fragments.** Avoid telegraphic style; write in full sentences for clarity and professionalism. Students may miss class and need to read the slides independently, so they should be as self-contained and clear as possible. Sentences and short paragraphs  improve readability and break up large blocks of text.
+- **Inline color emphasis over bullets.** Prefer prose sentences with key terms highlighted via a theme color span (e.g. `<span style="color:var(--phosphor);">`) over bullet lists. Check the deck's theme for available color tokens before writing spans. Color-pop the term or phrase that carries the weight of the sentence, not the whole sentence. Use `.bullets` lists only when the items are genuinely enumerable and parallel; otherwise, fold the ideas into sentences and let inline emphasis do the work of drawing the eye. Keep color usage semantically consistent within a deck: if one color is used for a concept (e.g. a keyword, a class name, an action), use that same color for the same concept throughout the presentation.
+- **Interactivity**: use Reveal's built-in interactivity features (fragments, nested sections, etc.) to pace the information flow and keep students engaged. Avoid overwhelming slides with too much information at once. Use syncdeck's embedded activities to encourage active learning and exploration.
 
 ## Local Preview
 
diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 100644
index aa1015e..0000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1,242 +0,0 @@
-# AGENTS.md
-
-This repository contains HTML slide presentations built with **Reveal.js**, published via GitHub Pages. Shared runtime/plugin code is consumed from the `SyncDeck-Reveal` git submodule at `vendor/SyncDeck-Reveal/`.
-
-Presentation source folders now live under `Decks/`, while deployment remaps
-their contents to the site root. For example, `Decks/AR1/...` is published as
-`/AR1/...`.
-
-## Agent Skills Subtree
-
-The shared SyncDeck agent skill lives at `.agent/skills/vendor/syncdeck/` and is
-managed as a **git subtree** (not a submodule) backed by the
-`syncdeck-agent-skills` remote.
-
-- **Commit model:** edit files inside `.agent/skills/vendor/syncdeck/` normally
-  and commit them to the parent repo as you would any other file. The subtree
-  has no separate working tree — changes land directly in the parent history.
-- **Push upstream after committing:** after committing changes to the parent
-  repo, push them back to the subtree remote:
-  ```
-  git subtree push --prefix=.agent/skills/vendor/syncdeck syncdeck-agent-skills main
-  ```
-- **Pull upstream changes:** to incorporate updates published to the subtree
-  remote:
-  ```
-  git subtree pull --prefix=.agent/skills/vendor/syncdeck syncdeck-agent-skills main --squash
-  ```
-- **Do not** run `git subtree push/pull` until the parent repo commit is in
-  place — the subtree commands rewrite history based on the current index.
-
----
-
-## Runtime Source
-
-- Shared runtime source: `vendor/SyncDeck-Reveal/` git submodule.
-- CI readiness: `.github/workflows/static.yml` is configured with `submodules: recursive` so Pages deployments include submodule contents.
-- Local submodule workflow: for local testing, edit files directly in `vendor/SyncDeck-Reveal/`; the parent repo will use those working-tree changes immediately.
-- Detached HEAD warning: submodules are often checked out at a raw commit hash, which makes local commits easy to lose track of. Before committing inside the submodule, create or switch to a branch, e.g. `git -C vendor/SyncDeck-Reveal switch -c fix/my-bug`.
-- Commit model: commit and push code changes from inside the submodule repo first, then commit the updated submodule pointer in the parent repo with `git add vendor/SyncDeck-Reveal`.
-
-## Shared Runtime
-
-Presentations load the bundled public runtime from
-`runtime/syncdeck-reveal/dist/` in the published site. The bundler, source
-entrypoint, and npm workflow live in `vendor/SyncDeck-Reveal/`; the parent repo
-should only reference the built assets through the public runtime path.
-
-**Required HTML inside the presentation:**
-```html
-<div id="storyboard" class="storyboard" aria-hidden="true">
-    <div id="storyboard-track" class="storyboard-track"></div>
-</div>
-```
-
-**Initialise with the bundled runtime:**
-
-The runtime lives at `/runtime/syncdeck-reveal/` in the published site. Use a
-relative path from the deck's published location (eg. `/Decks/CSA/2DArrays/2d-arrays.html` will publish to `/CSA/2DArrays/2d-arrays.html` and use the following):
-
-```html
-<link rel="stylesheet" href="../../runtime/syncdeck-reveal/dist/syncdeck-reveal.css">
-<script src="../../runtime/syncdeck-reveal/dist/syncdeck-reveal.js"></script>
-<script>
-initSyncDeckReveal({
-    deckId: 'your-deck-name',
-});
-</script>
-```
-
-**DOM events (dispatched on `window`):**
-
-| Event | Detail | Effect |
-|-------|--------|--------|
-| `reveal-storyboard-toggle` | — | Toggle open/closed |
-| `reveal-storyboard-set` | `{ open: true\|false }` | Explicitly show or hide |
-
-These events are the integration point for `reveal-iframe-sync.js` and any container-page UI.
-
----
-
-### Submodule Internal: `vendor/SyncDeck-Reveal/chalkboard/chalkboard.js`
-
-This section is for contributors working inside the `SyncDeck-Reveal` submodule. Presentations in this repo should continue to load only the bundled `dist/` assets described above.
-
-Vendored and extended copy of the [reveal.js-plugins chalkboard](https://github.com/rajgoel/reveal.js-plugins/tree/master/chalkboard). **Do not replace with a CDN link** — the local copy has two additions required for iframe sync:
-
-**Key constraint — do not set `storage`:** the plugin's built-in `sessionStorage` persistence is intentionally disabled. The **host page** is the source of truth for drawing state (snapshot + delta buffer). Do not add `chalkboard: { storage: '...' }` to `Reveal.initialize()` — doing so would cause the local in-memory state and the host's buffer to diverge after a reload.
-
-**Student canvas is read-only:** when the plugin receives `setRole: student` it calls `RevealChalkboard.configure({ readOnly: true })` automatically via `reveal-iframe-sync.js`. No manual config needed.
-
-**Overview / storyboard routing:**
-Reveal.js's built-in grid overview (`O` key) is intentionally **not** propagated to students as a native Reveal overview. Instead, `overview: true/false` in any `setState` command is stripped from the Reveal state and converted to `reveal-storyboard-set` DOM events — so the custom storyboard strip appears on the student side rather than Reveal's grid.
-
-The container site can also trigger the storyboard directly by sending a command:
-```js
-// From the container/host page
-iframe.contentWindow.postMessage({
-    type: 'reveal-sync',
-    action: 'command',
-    payload: { name: 'toggleOverview' }   // or showOverview / hideOverview
-}, '*');
-```
-
----
-
-### Submodule Internal: `vendor/SyncDeck-Reveal/reveal-iframe-sync.js`
-
-This section is for contributors working inside the `SyncDeck-Reveal` submodule. Presentations in this repo should continue to load only the bundled `dist/` assets described above.
-
-Registers a Reveal.js **plugin** (`RevealIframeSync`) that syncs navigation and state between an instructor page and one or more student iframes via `window.postMessage`.
-
-**Register as a Reveal plugin:**
-```js
-Reveal.initialize({
-    plugins: [RevealIframeSync],
-    iframeSync: {
-        deckId: 'my-deck',
-        hostOrigin: '*',
-        allowedOrigins: ['*'],
-    }
-});
-```
-
-> **Role lifecycle:** the plugin always initialises as `'standalone'` regardless of any `role` config field. The host must explicitly promote the iframe via a `setRole` command (`instructor` or `student`). This prevents boundary controls from appearing in direct-browser or VS Code preview contexts.
-
-
-**Supported commands (host → iframe):** `next`, `prev`, `slide`, `setState`, `togglePause`, `pause`, `resume`, `setRole`, `allowStudentForwardTo`, `setStudentBoundary`, `toggleOverview`, `showOverview`, `hideOverview`, `chalkboardCall`, `toggleChalkboard`, `toggleNotesCanvas`, `clearChalkboard`, `resetChalkboard`, `chalkboardStroke`, `chalkboardState`, `requestChalkboardState`, `ping`
-
-Full message schema: `vendor/SyncDeck-Reveal/reveal-iframe-sync-message-schema.md`
-
-**Vertical stack pattern:** a vertical Reveal stack can be used as a student-controlled series once the instructor reaches that horizontal position. Treat vertical stacks as the planned release mechanism, and use storyboard boundary controls as the ad hoc release mechanism. The host/plugin should treat the stack as a bounded local-navigation region rather than unlocking the whole deck. When YouTube slides appear inside such a stack, local student playback control may be enabled if the stack/slide config allows it; student audio mode should still be honored unless the instructor changes it from the host toolbar. The storyboard should highlight the full released region and represent vertical stacks with clear grouping rather than a flat list of indistinguishable thumbnails.
-
----
-
-## Adding a New Presentation
-
-1. Create `Decks/<topic>/<subfolder>/presentation-name.html` (subdirectory keeps the repo organised).
-2. **Check for a shared `theme.css` in the same folder.** If one exists, link it instead of writing a new `<style>` block:
-   ```html
-   <link rel="stylesheet" href="theme.css">
-   ```
-   Only add a `<style>` block after that link for styles that are specific to this presentation. If no `theme.css` exists and the new deck needs its own theme, consider extracting it to a `theme.css` so future decks in the same folder can share it.
-3. Load the bundled runtime with a relative path from the deck's published
-   location. For the current `Decks/<course>/<unit>/deck.html` layout, use
-   `../../runtime/`:
-   ```html
-   <link rel="stylesheet" href="../../runtime/syncdeck-reveal/dist/syncdeck-reveal.css">
-   <script src="../../runtime/syncdeck-reveal/dist/syncdeck-reveal.js"></script>
-   ```
-   Use `initSyncDeckReveal(...)` from the bundled runtime instead of writing `Reveal.initialize(...)` inline. Use a unique `deckId` derived from the presentation filename (kebab-case). The bundle provides `Reveal`, `RevealNotes`, `RevealChalkboard`, `RevealIframeSync`, `initRevealStoryboard`, and `initSyncDeckReveal`. **Do not** add a `chalkboard.storage` value — the host manages drawing state.
-   ```js
-   initSyncDeckReveal({
-       deckId: 'your-deck-name', // kebab-case, unique per deck
-       iframeSyncOverrides: {
-           // Optional per-deck iframeSync overrides
-       },
-       revealOverrides: {
-           // Optional per-deck Reveal overrides
-       },
-       chalkboardOverrides: {
-           // Optional per-deck chalkboard overrides (no storage)
-       },
-       storyboard: {
-           // Optional: storyboardId / trackId / toggleKey
-       },
-       afterInit: function (Reveal) {
-           // Optional deck-specific hooks/listeners
-       },
-   });
-   ```
-4. Follow the architecture in `.agent/skills/vendor/syncdeck/SKILL.md` and the repo-specific overrides in `.agent/skills/syncdeck-local.md` — in particular:
-   - Apply theme colors with explicit CSS rules on `.reveal-viewport`, `.reveal`, `.reveal h1-h6`, etc. — **not** `--r-*` CSS variables (those only work with Reveal's bundled theme files)
-   - Use **`px`** for all font sizes and spacing in CSS custom properties (not `em`/`clamp`/`vw`) — Reveal scales the canvas via CSS transform; `em` values double-scale
-   - Never set `position` on `.reveal .slides > section` — Reveal needs `position: absolute` there for fade transitions; put padding/centering in a `.slide-inner` div inside each section instead
-5. Check the style tokens for the chosen preset in `.agent/skills/STYLE_PRESETS_EXTENDED.md` (full library) or `.agent/skills/vendor/syncdeck/references/STYLE_PRESETS.md` (short reference).
-6. Run `node scripts/generate-permalink.mjs Decks/<path>/<deck>.html` to give the new deck a stable permalink before committing. See "Presentation Permalinks" below.
-
-## Presentation Permalinks
-
-Every deck under `Decks/` carries a `<meta name="syncdeck-permalink" content="<hash>">` tag,
-written once by `scripts/generate-permalink.mjs` and never hand-edited. The hash is derived
-from the deck's filename stem when first generated (with automatic collision resolution) and
-never changes afterward, even if the deck is later moved or renamed, so it's safe to share as
-a stable short link.
-
-- `config/permalinks.json` is the committed manifest (`hash -> { path, title }`) and the single
-  source of truth for collision detection.
-- `node scripts/generate-permalink.mjs Decks/<path>/<deck>.html` assigns a permalink to a new
-  deck, or re-syncs the manifest's cached path if an existing deck was moved.
-- `node scripts/generate-permalink.mjs --all` does the same across every deck; safe to re-run.
-- `node scripts/generate-permalink.mjs --check` (run in CI on every PR and before deploy) fails
-  if any deck is missing the tag, two decks share a hash, or the manifest disagrees with the
-  decks themselves.
-- At build time, `scripts/generate-permalink-redirects.mjs` emits a static redirect stub per
-  manifest entry at `/p/<hash>.html` that immediately `location.replace()`s to the deck's real,
-  current URL — this is what makes the permalink stable across reorganization.
-- The index pages (`scripts/site-indexes.mjs`) surface three links per deck: "Start as
-  instructor" and "Syncdeck link" (both ActiveBits-hosted, built from the deck's real current
-  URL) and "Permalink" (the short `/p/<hash>.html` link, safe to share or feed into the
-  ActiveBits launcher directly).
-
----
-
-## Key Architecture Notes
-
-| Rule | Why |
-|------|-----|
-| `px` for all font/spacing tokens | Reveal scales slides via `transform: scale()`. `em` values also respond to Reveal's JS-computed base font-size (~28 px at 720 px viewport height), causing double-shrinking. `px` bypasses this. |
-| No `position` on `<section>` | Reveal sets `position: absolute` on sections to layer and fade them. Overriding with `position: relative` makes every slide after the first appear blank. |
-| Explicit CSS rules, not `--r-*` | `--r-background-color` etc. are only consumed by Reveal's bundled CSS theme files. Without one, those variables are ignored. |
-| `max-height: none` on `pre code` | Reveal's base CSS caps code blocks at 400 px. |
-| `box-shadow: none; width: auto` on `pre` | Reveal's base CSS adds a drop shadow and forces `width: 90%`. |
-| Overview → storyboard | `overview: true` in any synced state is intercepted and routed to `reveal-storyboard-set` rather than `deck.setState()`, so students see the custom strip, not Reveal's grid. |
-| No `chalkboard.storage` | The vendored chalkboard plugin does not write to `sessionStorage`. The host page is the source of truth (snapshot + delta buffer). Setting `storage` would cause divergence on reload. |
-| Role starts as `standalone` | `reveal-iframe-sync.js` always initialises in `standalone` mode. The host must send `setRole` to promote to `instructor` or `student`. Never rely on the `role` config field. |
-| Never hand-edit `syncdeck-permalink` meta tag or `config/permalinks.json` | The hash is generated once by `scripts/generate-permalink.mjs` and must stay stable across moves/renames. CI (`--check`) fails if a deck's tag and the manifest disagree. |
-
-## Code Tracing Convention
-
-Decks that trace code execution line-by-line (`data-fragment-trace` sections driving `.code-line.current`/`.done`/`.pending`/`.active-call` highlighting) must follow this rule:
-
-**The highlighted "current" line always indicates the next line about to execute, not the line that just ran.** A line's effects (a `print()` writing to the console, an assignment populating a var-box, a function call returning to its call site) must not be revealed on the fragment that arrives at that line. They are revealed only on the fragment where the caret moves past it, i.e. one step later, when the following line becomes current.
-
-A line that raises an exception never completes, so the caret never advances past it. Its effect (the traceback) is revealed on a later fragment that keeps `data-trace-current` pointing at that same crashing line rather than a following one, since there is no line the program reached afterward.
-
-This applies uniformly to console output, variable assignment, and function-return-to-call-site reveals. When authoring or editing a `data-fragment-trace` section, structure fragments so that any line producing an observable effect fires a hidden fragment on arrival (`data-trace-current="N"` with no visible content) followed by the visible reveal on the fragment that advances `data-trace-current` to `N+1` (using a virtual line number past the end of the snippet if there is no real next line, or reusing `N` if the line crashes instead of completing).
-
-## Writing Style
-
-- **No em dashes (—).** Always substitute context-appropriate punctuation: colon for introductory/defining clauses, comma for parenthetical asides or conjunctions, semicolon for contrasting independent clauses, period for abrupt follow-up sentences.
-- **Sentences not fragments.** Avoid telegraphic style; write in full sentences for clarity and professionalism. Students may miss class and need to read the slides independently, so they should be as self-contained and clear as possible. Sentences and short paragraphs  improve readability and break up large blocks of text.
-- **Inline color emphasis over bullets.** Prefer prose sentences with key terms highlighted via a theme color span (e.g. `<span style="color:var(--phosphor);">`) over bullet lists. Check the deck's theme for available color tokens before writing spans. Color-pop the term or phrase that carries the weight of the sentence, not the whole sentence. Use `.bullets` lists only when the items are genuinely enumerable and parallel; otherwise, fold the ideas into sentences and let inline emphasis do the work of drawing the eye. Keep color usage semantically consistent within a deck: if one color is used for a concept (e.g. a keyword, a class name, an action), use that same color for the same concept throughout the presentation.
-- **Interactivity**: use Reveal's built-in interactivity features (fragments, nested sections, etc.) to pace the information flow and keep students engaged. Avoid overwhelming slides with too much information at once. Use syncdeck's embedded activities to encourage active learning and exploration.
-
-## Local Preview
-
-- Use `npm run dev` from the repo root for day-to-day presentation authoring.
-- The dev server serves the deployed site layout directly from source mounts:
-  `Decks/AR1 -> /AR1`, `Decks/CSA -> /CSA`, and
-  `vendor/SyncDeck-Reveal -> /runtime/syncdeck-reveal`.
-- Refresh the browser after edits; no separate staging step is needed for
-  normal deck work.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file