# AGENTS.md

Scope: this file applies to the `2025-qnumerics` folder.

## Folder Purpose

This is a flat 2025 quantum numerics workshop or course recording archive. It is not currently a reveal.js deck or source repository. At the time this file was written, the folder contains MP4 recordings only, with no immediate subfolders and no `index.html` or `presentation.html`.

The filenames encode weekday, time block, and session topics. Treat those filenames as the archive's primary schedule metadata.

## Content Inventory

The folder contains six MP4 recordings:

- `Mon-MorningAfternoonEvening-Intro_to_Julia.mp4`.
- `Tuesda-Morning-Fast_State_Vec_Sim-AfternoonEvening-State_Vector_Dynamics.mp4`.
- `Wed-Morning-Optimal_Control-Afternoon-GPU.mp4`.
- `Wed-Evening-Hackathon_Intro.mp4`.
- `Thu-Morning-Clifford_Formalism-AfternoonEvening-Tensor_Networks.mp4`.
- `Fri-Morning-Discrete_Event_Sim-Afternoon-QuantumSavory-Evening-HPC.mp4`.

The spelling `Tuesda` appears in an existing filename. Preserve it unless all dependent references are intentionally migrated.

## Content Themes

The archive appears to cover a week-long quantum numerics program centered on Julia and computational methods for quantum science. Topics inferred from filenames include:

- Introductory Julia programming.
- Fast state-vector simulation and state-vector dynamics.
- Optimal control and GPU computing.
- Hackathon orientation.
- Clifford formalism and tensor networks.
- Discrete-event simulation, QuantumSavory, and high-performance computing.

The recordings combine multiple time blocks into single files, so a filename may represent morning, afternoon, and evening sessions together.

## Editing And Organization Guidance

- Preserve weekday/time-block ordering in filenames. These names are effectively the workshop schedule.
- Do not split or rename the all-day recordings without adding clear manifests that map the original recording to derived segments.
- If adding transcripts, captions, notes, thumbnails, or checksums, use the exact MP4 stem so derivative files sort beside their source recording.
- If producing summaries, call out time-block boundaries when they are visible from the filename, but do not invent exact timestamps without inspecting the media.
- Preserve project-specific names such as `QuantumSavory`, `Clifford_Formalism`, and `Tensor_Networks`.
- If future notebooks, source code, or package environments are added, document whether they are workshop exercises, demos, or post-hoc supporting materials.
- If a future `index.html` or `presentation.html` appears here, inspect it with `tools/reveal_text.py` from the repository root before making deck-specific edits.