# AGENTS.md

Scope: this file applies to the `2024-648_Intro_QIS_grad` folder.

## Folder Purpose

This is a flat graduate Introduction to Quantum Information Science course archive, mostly MP4 lecture recordings with one PDF course-page export. It is not currently a reveal.js deck or source-code project. At the time this file was written, there were no immediate subfolders and no `index.html` or `presentation.html` files.

The filenames are the primary source of sequence and topic metadata. Preserve them unless there is a deliberate archival migration with references updated elsewhere.

## Content Inventory

The archive contains 27 top-level files:

- 26 MP4 recordings.
- One PDF: `canvas_page.pdf`, a 7-page letter-size PDF produced through Firefox/cairo on December 22, 2024, likely representing a course page or Canvas export.

The numbered MP4 sequence runs from `02` through `25`, plus `2025-01-intro_videoconference.mp4`. There is no `01-...` lecture recording in this folder as currently organized.

Notable auxiliary or variant files include:

- `13-hardware_zoo.mp4` and `13-hardware_zoo_slides.mp4`.
- `2025-01-intro_videoconference.mp4`, which is cross-year relative to the 2024 folder name.
- `canvas_page.pdf`, which should be treated as course metadata/supporting material rather than a lecture recording.

## Content Themes

The course is a graduate quantum information sequence. Topics inferred from filenames include:

- Quantum probability amplitudes, including bomb-defusing or interaction-free measurement material.
- Multiple qubits, circuits, measurements, entanglement, projectors, superdense coding, teleportation, and quantum key distribution.
- Query complexity, oracles, Deutsch/Simon-style algorithms, nonlocal games, Fourier transform material, RSA, factoring, period finding, and Grover search.
- Quantum hardware survey material.
- Quantum error correction, multiqubit Pauli measurements, stabilizer formalism, stabilizer measurements, density matrices, quantum channels, toric code, and destabilizer formalism.
- Hamiltonians, adiabatic algorithms, variational methods, QOAO/QAOA-like material as named in the file, and measurement-based quantum computation.

Some filenames contain spellings or abbreviations that may be intentional or simply historical, such as `Deutch` and `QOAO`. Do not silently normalize those names in-place.

## Editing And Organization Guidance

- Keep the archive flat unless adding a real exported course version, captions bundle, or separate derived publication package.
- Preserve numeric ordering in filenames. If adding missing lecture material, use the same leading-number style and avoid renumbering existing files.
- Treat `2025-01-intro_videoconference.mp4` as intentional unless a human maintainer says it belongs elsewhere.
- If adding transcripts, captions, thumbnails, checksums, or notes, reuse the media stem exactly, for example `12-period_finding_grover.vtt`.
- If adding notes for the PDF, keep them tied to `canvas_page` and identify it as supporting metadata rather than a lecture.
- Do not rewrite media filenames to correct typos, expand abbreviations, or standardize capitalization unless all dependent manifests, links, and notes are updated in the same change.
- If a future `index.html` or `presentation.html` appears here, inspect it with `tools/reveal_text.py` from the repository root before making slide-content claims.