# AGENTS.md

Scope: this file applies to the `2024-490Q_Intro_QIS` folder.

## Folder Purpose

This is a flat Spring 2024 COMPSCI 490Q Introduction to Quantum Information Science course recording archive. It is not a reveal.js slide deck or source tree. At the time this file was written, the folder contains MP4 media only, with no `index.html`, `presentation.html`, notebooks, transcripts, or nested course-version folders.

The filenames encode lecture order, course number, term, topic, and known recording issues. Treat those filenames as the main metadata for the archive.

## Content Inventory

The archive contains 28 MP4 files:

- Numbered lecture recordings `COMPSCI-490Q-S2024-01` through `COMPSCI-490Q-S2024-26`.
- Extra media variants for lecture 16: `Hardware_gallery` and `Hardware_gallery_(slide_deck)`.
- Extra media variants for lecture 18: `Intro_to_error_correction_and_numerical_experiments` and `Intro_to_error_correction_and_numerical_experiments_(julia_notebook)`.

Known recording notes are present in filenames and should be preserved:

- Lectures 01, 02, and 03 are marked `(cuts_off_early)`.
- Lecture 06 is marked `(no_sound)`.
- Lectures 09 and 10 are marked `(on_zoom)`.

## Content Themes

The course begins with probability and quantum-state basics, then builds through canonical quantum information protocols and algorithms before moving into quantum error correction and dynamics. Topics inferred from filenames include:

- Classical probability and quantum probability amplitudes.
- Interaction-free measurements.
- Multipartite systems, gates, measurements, and basis measurements.
- Superdense coding, quantum teleportation, and quantum key distribution.
- Query complexity, Simon's algorithm, RSA encryption, Shor's algorithm, period finding, the quantum Fourier transform, and Grover search.
- Quantum hardware survey material.
- Algebra review for quantum information.
- Introductory quantum error correction, numerical experiments, bit-flip detection, multiqubit measurements, Pauli measurement conventions, correcting non-Pauli errors, toric code, and the stabilizer formalism.
- Schroedinger equation material in the final numbered lecture.

## Editing And Organization Guidance

- Keep this folder flat unless adding a genuinely distinct course export or talk version. Do not invent subfolders for individual lectures unless there is a clear archival reason.
- Preserve the `COMPSCI-490Q-S2024-NN-Topic` naming pattern and the two-digit lecture sequence.
- Preserve parenthetical recording caveats such as `(cuts_off_early)`, `(no_sound)`, `(on_zoom)`, `(slide_deck)`, and `(julia_notebook)`.
- If adding transcripts, captions, thumbnails, checksums, or notes, use the exact MP4 stem and a clear extension or suffix, for example `COMPSCI-490Q-S2024-08-Quantum_teleportation_and_quantum_key_distribution.vtt`.
- Do not rename the media files just to normalize capitalization, punctuation, or spelling. External notes and playlists may already depend on the current names.
- If generating summaries, distinguish between lecture content and recording-quality metadata. For example, do not treat `(no_sound)` or `(cuts_off_early)` as part of the topic title.
- If a future `index.html` or `presentation.html` is added, use `tools/reveal_text.py` from the repository root to inspect slide text before making deck-specific edits.