# Presentation Family Notes

This folder is the self-contained archive for Stefan Krastanov's "Full-stack Quantum Hardware Design" talk family and its later QuantumSavory / QuantumClifford / composable quantum networking variants. The root `HEADER.md` links the family to `QuantumClifford.jl` and `QuantumSavory.jl`; it also records the key audience split for the first two versions: Amherst is a gentle quantum-information introduction, while Chicago assumes more familiarity.

Treat each immediate child folder as an archived, independently runnable talk version. Do not deduplicate shared images, movies, copied reveal.js files, or local libraries across sibling decks unless a user explicitly asks for archival cleanup. Redundancy is intentional here so that each version remains self-contained.

## Entry Points

- `2022-Full_Stack_Quantum_Design_in_Amherst/presentation.html`: Feb 2022 UMass Amherst version, broad intro-first "Full-stack Quantum Hardware Design".
- `2022-Full_Stack_Quantum_Design_in_Chicago/presentation.html`: Jun 2022 UChicago version, "Digital Twins for Quantum Hardware: Multi-formalism and Mixed-signal".
- `2023-CAJUN_Boston_Julia_meet_talk/index.html`: Mar 2023 CAJUN/Boston Julia meetup version, intro plus Julia tooling.
- `2023-CQN_retreat_sim_talk/index.html`: Feb 2023 CQN retreat simulation talk.
- `2023-CQN_industry_update/presentation/index.html`: May 2023 CQN industry update, with a PDF copy at `2023-CQN_industry_update/Krastanov_cqn_industry_update.pdf`.
- `2023-CQN_October_site_visit_industry_update/index.html`: Oct 2023 CQN virtual testbed/site-visit industry update.
- `2023-JuliaCon/index.html`: Jul 2023 JuliaCon formalism-agnostic quantum hardware simulation talk.
- `2024-JuliaCon/index.html`: Jul 2024 JuliaCon composable quantum networking protocol API talk.
- `2024-CISCO/index.html`: Sep 2024 CISCO Quantum Summit composable quantum network modeling talk.
- `2024-IEEE/index.html`: Sep 2024 IEEE Quantum Week version, close sibling of CISCO.
- `2024-IMSI_Chicago/index.html`: Oct 2024 IMSI Chicago version with extra formalism/purification framing.
- `2025-IEEE/index.html`: Sep 2025 IEEE QCE version, extends the 2024 network-modeling deck.
- `2025-Optica-veryshort/index.html`: very short Optica deck, mainly funding/bounty, purification, QuantumSavory, and model-overview slides.

Most decks use `index.html`; the two 2022 versions use `presentation.html`; the May 2023 CQN industry update nests the reveal deck under `presentation/`.

## Content Themes

- Full-stack quantum technology framing: materials, analog control, noisy digital circuits, error correction, and algorithms.
- Quantum information introductions: classical/probabilistic/quantum computation, interference, qubits, entanglement, and why hardware is difficult.
- Analog and mixed-signal hardware design: photonic logical qubits, nonlinear optical cavities, coherent feedback-free error correction, microwave devices, spin-mechanics, and control.
- Multi-formalism simulation: continuous dynamics, discrete gates/circuits/schedules, stochastic feedback, kets, density matrices, tableaux, graphs, tensor networks, and backend translation.
- Julia ecosystem tooling: `QuantumClifford.jl`, `QuantumSavory.jl`, `BPGates.jl`, `WaveguideQED.jl`, `QuantumInterface.jl`, `Symbolics.jl`, `CUDA.jl`, `Nemo.jl`, and simulator/backend interop.
- CQN simulation and virtual-testbed messaging: full-stack design toolkit, declarative noise models, symbolic algebra, discrete event scheduling, repeater simulations, and in-house simulator performance.
- Composable quantum networking: entanglement swapping, repeaters, protocol metadata, tag/query APIs, switches, grid swappers, and later Quantum TCP / MBQC examples.
- Recruiting and development support: CQN logos, UMass slides, code bounties, mini grants, and calls for software engineering / quantum science contributors.

## Recurring Assets And Patterns

- Reveal.js decks are plain HTML with local `dist/`, `plugin/`, `custom.css`, copied images, and copied video assets. There is usually no project-level build step.
- Frequent visual assets include `CQN_Horizontal_White.png`, `savorylogo.png`, `umass_lib.jpg`, `alice.png`, `bob.png`, `models.png`, `bp_benchmark.png`, `purify_opt_results.png`, `lossvsdistance.png`, `tagged_entanglement.png`, `mermaid-*.png`, `savoryplot_*.png`, and `savorycirc*.png`.
- Frequent videos include `art_installation.mp4`, `firstgenrepeater-02.entangler.mp4`, `firstgenrepeater-07.observable.mp4`, `repeater_chain.webm`, `switch.webm`, `grid.mp4`, and `cqnvirttestbedvideo_v1.mp4`.
- Some decks include a module import for Mermaid from CDN. Keep already-rendered `mermaid-*.png` diagrams in sync if changing the underlying story.
- `three.js-r145/`, `js/three.js`, and `tween/` are copied support libraries in several CQN decks. Treat them as vendored unless the user asks specifically for library changes.
- `demo.html`, `dist/`, `plugin/`, `.vscode/`, `three.js-r145/`, `node_modules/`, and nested reveal support trees are not talk source. Avoid adding instruction files or making content edits inside those trees.

## Editing Guidance

- Preserve the archival nature of each version. Edit the local deck file and local assets for the specific talk version being changed.
- Use the helper from the archive root to inspect slide text before making content changes:
  `python3 tools/reveal_text.py 2022-Full_Stack_Quantum_Design/<deck>/index.html`
  or, for the 2022 decks, pass `presentation.html`.
- If working from inside this project folder, the helper is at `../tools/reveal_text.py`.
- Keep relative asset paths unchanged unless moving the referenced asset inside the same talk folder. Many slides use inline styles and fragment classes; avoid broad HTML reformatting.
- Do not edit the root archive `AGENTS.md` or `tools/reveal_text.py` from this folder.
- Do not edit sibling top-level presentation families. Other workers may be editing them concurrently.
- For a quick local check, run a simple HTTP server from either this folder or the specific deck folder and open the entry point in a browser. This is especially useful for decks with module imports, local media, or nested entry points.

